Changes on 2026-02-19

1. **Analyze the Request**: * **Role**: World-class programmer analyzing documentation changes. * **Output Format**: Markdown, concise, insightful, Chinese. * **Input**: 4 pages of changes (`common-workflows.md`, `data-usage.md`, `hooks.md`, `CHANGELOG.md.md`). 2. **Analyze the Input Data**: * **Page 1: `common-workflows.md` (+30 lines)**: * New section: "Get notified when Claude needs your attention". * Content: Describes how to set up desktop notifications using the `Notification` hook event. * Details: Provides specific OS commands (macOS `osascript`, Linux `notify-send`, Windows PowerShell). * Context: Useful for long-running tasks. * **Page 2: `data-usage.md` (+1/-1 lines)**: * Change: Updated the URL hash for an image (`claude-code-data-flow.svg`). * Significance: Trivial asset update, likely re-uploaded to CDN. No functional change to documentation content. * **Page 3: `hooks.md` (+2/-2 lines)**: * Change: Updated URL hashes for two images (`hooks-lifecycle.svg`, `hook-resolution.svg`). * Significance: Trivial asset update, similar to page 2. No functional content change. * **Page 4: `CHANGELOG.md.md` (+27 lines)**: * Version: 2.1.49. * Key changes: * `--worktree` flag and subagent isolation. * Ctrl+F to kill background agents. * Plugins can ship `settings.json`. * Performance improvements (startup, WASM memory, cache). * Bug fixes (file path suggestions, Ctrl+C handling, verbose mode). * Model changes: Sonnet 4.5 1M context replaced by Sonnet 4.6 (1M context). * New hook event: `ConfigChange`. * Simple mode now includes file edit tool. 3. **Synthesize Key Themes**: * **Notifications/Workflows**: Introduction of desktop notifications via hooks. * **Performance & Stability**: Significant focus on memory leaks (WASM), startup speed, and caching. * **Git/Workflow Enhancements**: Git worktree support for isolated operations. * **Agent Management**: Better control over background agents (`Ctrl+F`, `background: true`). * **Model Updates**: Shift from Sonnet 4.5 to 4.6 for 1M context. * **Asset Updates**: Minor image URL refreshes (likely internal CDN management). 4. **Determine Impact Level**: * **Reasoning**: * New features (Worktree, Notifications, ConfigChange hook) are additive. * Model change (4.5 -> 4.6) is a forced migration/upgrade path but usually additive/better. * Performance fixes improve stability significantly. * No breaking API changes mentioned in the diff (though `Sonnet 4.5` removal might force a config change for some users). * **Verdict**: Medium to High (leaning towards High due to the model switch for heavy users and the new git worktree feature which is a major workflow improvement). Let's stick with **Medium** as the default for doc updates unless it's a major version bump, but given the specific model migration for Max plan users, it's significant. Let's call it **Medium** to be safe, or **High** if emphasizing the model switch. I'll go with **Medium** because the documentation changes mostly highlight *new* capabilities rather than breaking the core system, although the changelog implies significant backend improvements. Actually, the `ConfigChange` hook and Worktree support are fairly significant developer-facing features. 5. **Formulate Action Items**: * Switch to Sonnet 4.6 (if using 1M context on Max plan). * Check out the new `Notification` hook for long-running tasks. * Explore `--worktree` for safer git operations. * Update plugins if shipping default settings. * Review `ConfigChange` hook for enterprise auditing. 6. **Draft the Response (in Chinese)**: * *Summary*: Claude Code v2.1.49 更新文档，主要引入了桌面通知钩子、Git Worktree 支持以及一系列性能和稳定性修复，同时将 1M 上下文模型从 Sonnet 4.5 迁移至 4.6。 * *Themes*: * **桌面通知集成**: 新增通过 Hook 配置原生 OS 通知的文档。 * **Git 隔离工作流**: 引入 `--worktree` 和子代理隔离功能。 * **模型升级**: Sonnet 4.5 (1M) 被 Sonnet 4.6 (1M) 取代。 * **性能与稳定性**: 修复了 WASM 内存泄漏、启动性能及代理管理问题。 * **资源更新**: 文档中的架构图进行了 CDN 刷新（内容无实质变化）。 * *Impact*: Medium. 引入了重要的工作流增强（Worktree, 通知）和关键模型迁移，但主要是功能增强而非破坏性变更。 * *Action Items*: * 如果你在 Max 计划中使用 1M 上下文模型，请切换至 Sonnet 4.6。 * 尝试使用新的 `Notification` hook 配置桌面通知，以便在长时间任务完成后接收提醒。 * 探索 `--worktree` 标志以在隔离的 git 工作树中进行操作。 * 针对企业安全审计，利用新增的 `ConfigChange` hook。 * 更新插件以支持默认 `settings.json` 配置。 7. **Refine for Conciseness and Insight**: * Make sure to mention the specific commands for notifications as a nice-to-know. * Highlight the memory fix for long sessions as a "quality of life" improvement for devs. 8. **Final Polish (Markdown)**: (Proceed to generate output).

1. **Analyze the Request:** * **Role:** World-class programmer with deep expertise in developer tools and documentation. * **Task:** Analyze a specific documentation change (model deprecations) as a single batch. * **Output Format:** Markdown, specific structure (Summary, Key Themes, Impact Level, Action Items). * **Language:** Chinese (requested in the prompt "请用中文回复"). * **Input Data:** A diff from `about-claude/model-deprecations.md`. 2. **Analyze the Diff:** * **File:** `about-claude/model-deprecations.md` * **Changes:** * Line 75: `claude-3-haiku-20240307` retirement date changed from `April 19, 2026` to `April 20, 2026`. * Line 87: Same change reflected in the "Deprecation history" table. * **Context:** A small adjustment to the retirement date of `claude-3-haiku-20240307`. 3. **Drafting the Content (Internal Monologue/Rough Draft):** * *Summary:* This change just moves the retirement date of the old Haiku model back by one day (from April 19 to April 20, 2026). It's a minor tweak. * *Key Themes:* Lifecycle management, date adjustments. Not much else. * *Impact:* Very Low. It's just one day. No functional changes, just a date correction or slight scheduling shift. * *Action Items:* If you have strict deadlines set for that specific day, update them. Otherwise, just be aware of the new date. The migration advice remains the same (move to 4.5). 4. **Translating and Refining into Chinese (targeting "World-class programmer" persona):** * **1. Overall Summary (总体摘要):** * *Draft:* 本次更新微调了 `claude-3-haiku-20240307` 模型的停用日期，从 2026 年 4 月 19 日延后一天至 4 月 20 日。 * *Refinement:* 保持简洁专业。强调这是一个微小的日程调整。 * **2. Key Themes (核心主题):** * *Draft:* * 模型生命周期管理：持续更新模型退役时间表。 * 迁移路径：替代方案保持不变。 * *Refinement:* * **模型生命周期微调**：对旧版 Haiku 模型的最终停用日期进行小幅修正。 * **3. Impact level (影响级别):** * *Level:* Low (低). * *Reasoning:* 日期仅推迟 1 天，不涉及 API 行为变更，迁移路径（推荐使用 `claude-haiku-4-5-20251001`）未变。 * **4. Action items for developers (开发者行动项):** * *Draft:* * 更新内部日历。 * 仍然需要迁移到新模型。 * *Refinement:* * **更新截止日期记录**：如果您已将 `claude-3-haiku-20240307` 的迁移截止日期（2026-04-19）标记在日历或监控系统中，请更新为 **2026 年 4 月 20 日**。 * **继续执行迁移计划**：虽然多出了一天缓冲期，但仍需按计划迁移至 `claude-haiku-4-5-20251001`。 5. **Final Review against Constraints:** * Markdown format? Yes. * Concise? Yes. * Chinese language? Yes. * Addressed the specific change? Yes. 6. **Final Output Generation** (similar to the provided good response).

**1. 分析需求：** * **角色：** 具备开发者工具和文档专业知识的世界级程序员。 * **任务：** 分析文档更改批次（10 个页面）。 * **输出格式：** Markdown。 * **语言：** 中文。 * **所需部分：** 1. 整体摘要（1-2 句话）。 2. 跨页面关键主题（要点）。 3. 影响级别（低/中/高/中断性）及推理。 4. 开发者行动项（要点，最多 5 条）。 **2. 分析 Diff（逐页分析）：** * **第 1 页：`about-claude/models/overview.md`** * **更改：** 从“可用模型”列表中移除了 `Claude Sonnet 3.7`（之前存在于表中）。更新了 `Claude Opus 4` 列（从 3.7 部分继承？不，它只是清理了表格结构）。主要变化：添加了 `Claude Haiku 3 (deprecated)`（已弃用）到表格中。添加了关于 `Claude Haiku 3` 的警告框，说明其将于 2026 年 4 月 19 日停用。移除了关于 3.7 模型 128k 输出的脚注 4。 * **关键点：** `Claude Sonnet 3.7` 从概述表的“可用”部分移至隐含的已停用状态（在弃用页面中明确）。`Claude Haiku 3` 标记为已弃用，将于 2026 年 4 月 19 日停用。 * **第 2 页：`about-claude/models/migrating-to-claude-4.md`** * **更改：** 添加了从 Haiku 3 迁移到 Haiku 4.5 的代码块/说明。更新了速率限制说明。 * **关键点：** 增加了对从 Haiku 3 迁移至 Haiku 4.5 的支持。 * **第 3 页：`about-claude/model-deprecations.md`** * **更改：** * 将 `claude-3-7-sonnet-20250219` 状态从“Deprecated”（已弃用）更新为“Retired”（已停用）。 * 将 `claude-3-5-haiku-20241022` 状态从“Deprecated”（已弃用）更新为“Retired”（已停用）。 * 将 `claude-3-haiku-20240307` 状态从“Active”（活跃）更新为“Deprecated”（已弃用）。弃用日期：2026 年 2 月 19 日。停用日期：2026 年 4 月 19 日。 * 添加了历史记录部分，标记了 2026-02-19 的 Haiku 3 弃用通知。 * 注意到 Haiku 3.5 和 Sonnet 3.7 已停用。 * **关键点：** Haiku 3 现在已正式弃用（计划于 2026 年 4 月停用）。Haiku 3.5 和 Sonnet 3.7 现在已停用（死亡）。 * **第 4 页：`api/messages.md`**（及第 5、6 页 —— 批量 API 和计数 Token API 中存在相同的更改） * **更改：** * 在 `caller` 联合类型中，将 `CodeExecution20260120` 重命名为 `ServerToolCaller20260120`。 * 为工具（bash, code_execution, memory, text_editor, web_search, web_fetch）添加了 `code_execution_20260120` 到 `allowed_callers` 中。 * 在请求参数中添加了顶层的 `cache_control: optional CacheControlEphemeral`。 * 移除了 `speed: optional "standard" or "fast"` 参数。 * **关键点：** * **新增功能：** 顶层（请求级别）缓存控制，支持“自动”缓存。 * **弃用/移除：** `speed` 参数已被移除。 * **内部更新：** 工具调用者类型重构 (`ServerToolCaller20260120`)，`allowed_callers` 中添加了对 `code_execution_20260120` 的支持。 * **第 5 页：`api/messages-count-tokens.md`** * **更改：** 与 `api/messages.md` 相同（顶层缓存控制，移除 speed，工具调用者更新）。 * **关键点：** 同上。 * **第 6 页：`api/creating-message-batches.md`** * **更改：** 与 `api/messages.md` 相同（顶层缓存控制，移除 speed，工具调用者更新）。 * **关键点：** 同上。 * **第 7 页：`build-with-claude/overview.md`** * **更改：** 更新了 Azure AI (`azureAi`) 的可用性标签。许多功能（Adaptive thinking, Citations, Effort, Extended thinking, PDF support, Search results, Code execution, Memory, Web fetch, Web search, Bash, Text editor）从 `azureAi`（暗示 GA）变为 `azureAiBeta`。 * **关键点：** Claude on Azure AI 上的许多功能现处于 Beta 状态（或文档反映了这一点）。 * **第 8 页：`build-with-claude/prompt-caching.md`** * **更改：** * 更新了“自动缓存”的介绍和代码示例。 * 展示了在请求体顶层使用 `cache_control`，而不是在系统块内部。 * 更新了示例代码（Python, JS, Java），以展示顶层 `cache_control` 的更简单用法。 * 更新了逻辑：添加顶层字段将自动应用到最后一个可缓存块。 * 提及“支持的模型”包括 Haiku 3.5（已弃用）。 * **关键点：** 引入/文档化了“自动缓存”（顶层 `cache_control`）功能，简化了实现。 * **第 9 页：`build-with-claude/claude-on-amazon-bedrock.md`** * **更改：** * Sonnet 3.7：工具提示“Deprecated...” -> “Retired...”。 * Haiku 3.5：工具提示“Deprecated...” -> “Retired...”。 * Haiku 3：工具提示添加“Deprecated... Retiring...”。 * **关键点：** 反映了模型的停用/弃用状态。 * **第 10 页：`build-with-claude/claude-on-vertex-ai.md`** * **更改：** 与 Bedrock 页面相同。 * **关键点：** 反映了模型的停用/弃用状态。 **3. 综合发现：** * **主题 1：模型生命周期管理。** Haiku 3 和 Haiku 3.5 已弃用/停用。Sonnet 3.7 已停用。Haiku 3 现在处于弃用路径，计划于 2026 年 4 月停用。 * **主题 2：提示缓存改进。** 通过在请求级别添加 `cache_control`，引入了“自动缓存”的更简单实现。这简化了多轮对话场景。 * **主题 3：API 清理与内部更改。** 从 Messages/Batch/Count-Tokens API 中移除了 `speed` 参数。工具调用者类型更新 (`ServerToolCaller20260120`) 和允许的调用者列表。 * **主题 4：平台可用性更新。** Azure AI 上的许多功能标记为 Beta。 **4. 起草回复（迭代完善）：** * **整体摘要：** 这次更新主要涵盖了模型生命周期（Haiku 3 弃用，Sonnet 3.7/Haiku 3.5 停用），引入简化的“自动提示缓存”功能，移除 `speed` API 参数，以及更新 Azure AI 平台的功能可用性状态。 * **关键主题：** * **模型弃用/停用：** Claude Haiku 3 现已弃用（计划于 2026 年 4 月停用）。Claude Haiku 3.5 和 Sonnet 3.7 现已正式停用。 * **提示缓存简化：** 引入顶层 `cache_control` 参数，自动将缓存断点应用于最后一个可缓存块，极大地简化了缓存实现。 * **API 变更：** 从 Messages API 参数中移除了 `speed` (standard/fast)；更新了工具调用者架构以支持 `code_execution_20260120`。 * **平台状态更新：** Azure AI 上的多项功能（如 Citations, Extended Thinking, Tools）更新为 Beta 状态。 * **影响级别：** **中到高**。 * *理由：* * **停用：** 高影响。依赖 Haiku 3.5 或 Sonnet 3.7 的用户将面临破坏性变更。 * **API 移除 (`speed`)：** 中等影响。如果他们的代码使用 `speed`，将会中断（验证错误）。 * **Haiku 3 弃用：** 高影响（最终）。需要迁移至 Haiku 4.5。 * **自动缓存：** 低影响（可选）。这是改进/简化，而非强制性的中断，除非他们之前依赖特定的内部行为（此处不太可能）。 * *评估：* 停用和 `speed` 参数移除将其推至“中到高”范围。“高”更稳妥，因为停用*现在*生效（Haiku 3.5/Sonnet 3.7），而 Haiku 3 已进入倒计时。 * **行动项：** * **立即：** 如果您正在使用 `claude-3-5-haiku` 或 `claude-3-7-sonnet`，请迁移至 `claude-haiku-4-5-20251001` 或 `claude-sonnet-4-5-20250929`，因为这些模型已停用。 * **计划：** 准备将 `claude-3-haiku` 迁移至 `claude-haiku-4-5-20251001`；其将于 2026 年 4 月停用。 * **代码更新：** 从您的 API 请求中移除 `speed` 参数，因为它已不再受支持。 * **优化：** 利用新的顶层 `cache_control` 字段简化多轮对话的提示缓存实现。 * **审查：** 如果您依赖这些功能的稳定状态，请检查 Azure AI 的功能可用性。 **5. 最终润色（中文）：** * 摘要：本次更新主要涉及模型生命周期管理（Haiku 3弃用、Sonnet 3.7及Haiku 3.5停用）、引入简化的“自动提示缓存”功能、移除`speed` API参数以及更新Azure AI平台的功能可用性状态。 * 主题：模型停用与弃用, 提示缓存简化, API 参数变更, 平台状态更新. * 影响：高（停用具有破坏性，API 移除会导致破坏）。 * 行动项：迁移已停用模型，移除 speed 参数，规划 Haiku 3 迁移，利用新缓存功能。 **6. 根据约束条件进行审查：** * 10 个页面？是的。 * 简明/有洞察力？是的。 * Markdown？是的。 * 中文？是的。 * 最多 5 个行动项？是的。 （起草时的自我纠正）：确保强调移除 `speed` 具有破坏性。如果开发者发送 `"speed": "fast"`，如果 API 严格，可能会报错或忽略。Diff 显示它已从架构中移除，因此很可能会报错。 最终检查“主题”： 1. 模型生命周期：Haiku 3 已弃用（2026 年 4 月停用）。Haiku 3.5 和 Sonnet 3.7 已停用。 2. API 机制：自动提示缓存（顶层字段）。 3. API 弃用：移除了 `speed` 参数。 4. 工具/架构更新：`ServerToolCaller20260120`，`code_execution_20260120` 允许的调用者。 5. 平台：Azure AI Beta 状态。 看起来不错。

1. **Analyze the Request**: * **Role**: World-class programmer with expertise in dev tools/docs. * **Task**: Analyze a batch of documentation changes (single page: `plugins.md`). * **Output Format**: Markdown, concise, insightful. * **Language**: Chinese (as requested in the system prompt: "请用中文回复"). * **Specifics**: 1. Overall Summary (1-2 sentences). 2. Key Themes (bullets). 3. Impact Level (Low/Medium/High/Breaking) with reasoning. 4. Action Items (bullets, max 5). 2. **Analyze the Diff (`plugins.md`)**: * *Context*: The documentation describes how to create Claude Code plugins, specifically focusing on "skills" and file structure. * *Changes Observed*: * Terminology shift from "command" to "skill" in text (e.g., "try your new command" -> "try your new skill"). * File path change: `my-first-plugin/commands/hello.md` changed to `my-first-plugin/skills/hello/SKILL.md`. * Directory name change: `commands/` changed to `skills/`. * Heading change: `# Hello Command` -> `# Hello Skill`. * Refinement in summary text: "Try your commands with /command-name" changed to "Try your skills with /plugin-name:skill-name". 3. **Synthesize Key Themes**: * **Terminology Standardization**: Moving from "commands" to "skills". This is a branding/API consistency update. * **File/Directory Structure Reorganization**: The physical layout of plugins is changing. Commands are now nested inside a `skills/` directory, and individual skill definitions seem to be encapsulated in their own subdirectories with a `SKILL.md` file, rather than just flat files in a `commands/` folder. 4. **Determine Impact Level**: * *Type*: Breaking Change (High Impact). * *Reasoning*: The directory structure changed (`commands/` vs `skills/`) and the file naming convention (`hello.md` vs `hello/SKILL.md`). Existing plugins built following the old docs will likely break or not be recognized by the system if the codebase enforces these specific paths. * *Correction*: Wait, looking at the diff, it's strictly documentation. If the underlying tool changed to support this new structure, it's a Breaking Change for developers who have already implemented plugins based on the old docs. If the tool supports both but docs are just updating to best practice, it's Medium. However, usually, path changes in docs imply a path change in the implementation. Let's assume High/Medium-High because it affects how developers write code/organize files. Let's stick with **High** because file structure changes usually invalidate existing code/projects. 5. **Draft Action Items**: * Developers need to rename directories (`commands` -> `skills`). * Developers need to restructure files (move flat files into subdirectories named `SKILL.md`). * Update mental models/tutorials to use "skills" instead of "commands". * Update tests or scripts that might look for the old file paths. 6. **Translate and Format Output (Chinese)**: * *Overall Summary*: 文档更新了插件系统的术语和文件结构，将 "commands" 重命名为 "skills"，并采用了新的目录层级（即每个技能拥有独立的 `SKILL.md` 文件）。 * *Key Themes*: * **术语更新**: 统一使用 "skill" 替代 "command" 来描述插件功能。 * **目录结构重构**: 插件文件结构从扁平的 `commands/` 目录改为嵌套的 `skills/<skill-name>/SKILL.md` 结构。 * **命名规范优化**: 强化了命名空间概念，技能文件统一命名为 `SKILL.md`。 * *Impact Level*: **High (高影响)**. *Reasoning*: 这涉及物理文件路径和目录结构的改变。现有基于旧文档构建的插件如果不更新结构，可能会导致工具无法识别或加载失败。 * *Action Items*: * 将插件目录下的 `commands` 文件夹重命名为 `skills`。 * 重构文件结构：将原本位于 `commands/` 下的 `.md` 文件移动到 `skills/<skill-name>/` 目录下，并重命名为 `SKILL.md`。 * 检查并更新代码中任何对旧文件路径（如 `commands/hello.md`）的引用。 * 更新内部文档或教程，统一使用 "skill" 这一术语。 7. **Review against Constraints**: * Single batch analysis? Yes. * Markdown format? Yes. * Chinese? Yes. * Concise? Yes. 8. **Final Polish**: Ensure the tone is professional ("world-class programmer"). * *Self-Correction during drafting*: The action item about code paths is important. If a user had scripts that watched the command file, those need updates. * *Refining the "High" impact*: If the tool simply ignores the old way, it's high effort but maybe not "breaking" in a runtime crash sense, but definitely "breaking" for the dev workflow. "High" is appropriate. * *Refining the Summary*: Ensure it mentions both the terminology change *and* the structural change. * *Output Generation*...