更新日志

本文件保留上游版本信息的时间顺序，但用中文补充阅读说明，方便中文用户快速判断“这个仓库最近同步了什么”。

中文版同步 — 2026-08-06

上游审阅

核对上游范围：b9a973b → 4f3fa85
上游补齐 v2.1.220-r2 accuracy review 的后续工程修复：EPUB 改为 CI-only、文档切换到本地 mmdc、修正 Ruff 实际扫描范围、删除 Kroki 遗留依赖，并修复 Hook 分类与多语言链接

中文 fork 处理

将仍在使用的 Kroki/httpx EPUB 渲染器改为本地 mmdc，保留中文封面、元数据、章节结构、图片嵌入和根目录入口
EPUB 从 pre-commit 移到 GitHub Actions；主 CI、自动化测试与标签发布统一安装 mmdc，以 --lang zh 构建根目录中文版本，并在 Mermaid 失败时严格失败
不复制上游已无对应源码的多语言构建矩阵，也不重新引入 ja/vi/uk/zh 目录
删除 httpx、tenacity，统一 Ruff v0.15.10+，修正 tests pattern、Bandit 配置路径与 B113 抑制
取消 Ruff、Bandit、mypy 与 Markdown lint 的 continue-on-error；新增显式 .markdownlint.json，让失败检查不再被 workflow 静默吞掉
按 action 官方兼容说明升级 codecov-action@v5 与 setup-python@v7，消除旧 Node runner action
更新脚本文档、Hooks 分类说明和本地化回归护栏，不改变 Claude Code 中文全面上手指南 默认入口

中文版同步 — 2026-08-05

上游审阅

核对上游范围：343d6f0 → b9a973b
上游这轮是 Claude Code v2.1.220-r2 accuracy pass，不升级版本号，重点纠正命令、session、Memory、skills、MCP、hooks、checkpoints、plugins 和 settings 示例
关键修复包括 /fork / /subtask 角色、/fewer-permission-prompts、Hook stderr + exit 2、MCP type / ${DATABASE_URL}、skill 优先级和 canonical permissions.defaultMode

中文 fork 处理

审阅 258 个上游变更文件，只本土化影响中文主线和可执行性的改动；不复制英文根 README 或多语言 metadata
修复 command、skill、MCP JSON、Hook scripts、context tracker、plugin agents 与 config-examples.json
更新 01-10 教程、功能总表、速查卡、概念总览、资源索引和 Index
补充 auto memory、CLAUDE.md 200 行建议、AGENTS.md、checkpoint 100 个上限、MCP scopes、Output Styles、Status Line 与 community marketplace
扩展本地化校验，阻止旧命令、旧 session 语义、硬编码凭证、错误 Hook 退出码与无效 frontmatter 回归
修复 pre-commit 对非 commit Bash 命令误跑测试、SessionEnd 提前退出的问题，新增 Hook 回归测试并清零 ShellCheck 警告
将 Pages 的源码链接、绝对路径检查基准与反馈入口留在中文 fork，修复链接检查 timeout 类型与模板空链接，并修正 Ruff 扫描零文件的配置盲点；真实 format、lint、Bandit 与 mypy 检查均通过
不改变 Claude Code 中文全面上手指南 默认入口

中文版同步 — 2026-07-30

上游审阅

核对上游范围：97fc961 → 343d6f0
上游这轮重点：
教程覆盖更新到 Claude Code v2.1.220，其中 v2.1.219 再次反转 subagent 嵌套默认值：现在默认深度为 3，设为 1 才会禁用嵌套
Claude Opus 5（claude-opus-5、1M context、默认 effort high）成为默认 Opus 模型，Fast Mode 只覆盖 Opus 5 与 Opus 4.8
新增 /deep-research、/code-review、fork skills、frontmatter boolean、agent name 和 workspace trust 相关行为
hooks 新增 DirectoryAdded，总数从 30 增至 31
Auto Mode、dynamic workflows、sandbox、MCP 和 stream-json 增加新的资格、限制和排错入口
上游撤回此前合入的 Vexilo 社区资源

中文 fork 处理

将 v2.1.220 行为写入中文教程、功能总表、速查卡、概念总览、资源索引和 Index，不照搬英文上游 README
统一 subagent 默认深度、Opus 5、Fast Mode、Auto Mode、31 个 hooks 和 MCP 错误输出的中文口径
保留模型 ID、hook event、settings key、环境变量、CLI flag、frontmatter key 和 skill / agent 名称原文
将 Hooks 自测题和学习建议同步改为 31 个事件
复核 doc-generator 已使用正确名称；对仅更新英文页脚、来源和兼容模型的文件不做无意义机械改写
从当前资源索引移除 Vexilo，但保留旧同步日志作为真实历史
扩展本地化校验，锁定本轮关键行为并阻止旧事实回归
不改变 Claude Code 中文全面上手指南 默认入口
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-07-23

上游审阅

核对上游范围：8f04517 → 97fc961
上游这轮重点：
教程覆盖更新到 Claude Code v2.1.217，修正 subagent、Auto Mode、Memory、hooks、checkpoints、sandbox 与 CLI 行为
subagent 嵌套改为默认关闭；新增并发上限和显式嵌套深度环境变量
--enable-auto-mode 已是无效旧 flag，当前应使用 --permission-mode auto
config-examples.json 原有 11 组示例包含虚构 schema 和旧模型 ID，现已改成真实 settings.json key
brand-voice skill、CLAUDE.md 长度建议和 Sonnet 5 兼容说明完成一致性修正

中文 fork 处理

将 v2.1.217 的行为变化写入中文教程、功能总表、速查卡、概念总览、资源索引和 Index，不照搬英文上游 README
重写 JSON 配置示例：保留 key、hook event、permission rule 和模型 ID 原文，仅本土化说明值
清除“subagent 默认最多嵌套 5 层”和 --enable-auto-mode 仍可用等过时表述
补充 hook glob 范围、fork source、rewind link protection、Memory modified 字段、sandbox 与 telemetry 新入口
对齐 brand-voice frontmatter，统一 CLAUDE.md 长度建议，并加入 Vexilo 参考资源
扩展本地化校验，锁定本轮关键行为并阻止无效配置字段回归
上游其他语言目录继续只作参考，不改变 Claude Code 中文全面上手指南 默认入口
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-07-19

上游审阅

核对上游范围：a645ffe → 8f04517
上游这轮重点：
教程覆盖更新到 Claude Code v2.1.212，修正 Memory、session 分支、subagent、MCP、Auto Mode 和 accessibility 行为
CLAUDE.md 文件按范围拼接，不是严格覆盖链；import 最大深度为 4 hops
这批 session 行为后来由 v2.1.220-r2 accuracy pass 纠正为 /fork [prompt]、/subtask <task>、/branch [name] 三类边界
新增 subagent 输出扫描与 spawn 上限、WebSearch 上限、MCP 自动转后台阈值
Auto Mode provider opt-in 自 v2.1.207 起不再需要，并新增 claude auto-mode reset 与 screen reader mode

中文 fork 处理

将 v2.1.212 的行为变化写入中文教程、功能总表、速查卡、概念总览、资源索引和 Index，不照搬英文上游 README
删除“Memory 8 层覆盖”“/fork 是 /branch 的兼容别名”“云 provider 仍需 CLAUDE_CODE_ENABLE_AUTO_MODE=1”等过时说法
保留命令、路径、JSON key、环境变量、frontmatter 字段和 CLI flags 原文
不引入上游其他语言目录；示例页脚的元数据变化仅记录同步状态，不给中文示例添加无必要页脚
扩展本地化校验，锁定关键新行为并阻止旧内容回归
不改变 Claude Code 中文全面上手指南 默认入口
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-07-12

上游审阅

核对上游范围：0f3fe1d → a645ffe
上游这轮重点：
教程覆盖更新到 Claude Code v2.1.206，补充 Sonnet 5、manual permission mode 和 /dataviz
skills 支持 ${CLAUDE_PROJECT_DIR} 和一次调用叠加多个 skills
subagents 默认后台运行，Explore 模型与 extended thinking 改为继承 session
MCP 增加 roots/list 和未信任 workspace approval 规则
hooks、plugin marketplace、checkpoints、settings 与 CLI 增加新字段和行为

中文 fork 处理

将 v2.1.206 变化写入中文教程、功能总表、速查卡、资源索引和概念总览
修正上一轮 assessment 中的 5 轮 / 19 分 / 30 个 hook 事件等语义错误
将用户可见题面、选项、结果模板和主题建议改为中文主线；保留协议 key、命令、路径和环境变量原文
为每课 Q9 / Q10 补齐可匹配的中文回看章节，避免英文指针或不存在的标题
扩展本地化校验，覆盖课程结构、跨文档事实和关键版本内容
修复 EPUB 构建器重复查找已嵌入 Mermaid 图片造成的缺图误报，并新增回归测试
不引入上游英文根 README，不改变 Claude Code 中文全面上手指南 默认入口
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-07-11

上游审阅

核对上游范围：ce10c70 → 0f3fe1d
上游这轮重点：
改进 lesson-quiz skill，明确每个 lesson 用 10 道题、5 轮出题，并禁止题库缺失时临时编题
新增 quiz 结果报告模板
精简 self-assessment 主 skill，把 Deep Assessment 轮次、输出模板和按主题建议拆到 references/

中文 fork 处理

将 /lesson-quiz 主流程本土化为中文说明，保留 SKILL.md frontmatter key、CLI flags、路径和 slash command 名称原文
补齐中文题库中每个 lesson 的 Q9 / Q10，使固定 10 题流程有完整数据源
新增中文化的 results-template.md、deep-assessment-rounds.md、output-templates.md、topic-recommendations.md
在 self-assessment 中加入按需读取 reference 的说明，减少主说明上下文负担
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-07-02

上游审阅

核对上游范围：d4243d9 → ce10c70
上游这轮重点：
修复 Pages workflow，移除会在缺少 uv.lock 时出问题的 uv cache 配置

中文 fork 处理

同步 .github/workflows/pages.yml 的必要行为变化，删除 setup-uv 的 enable-cache / cache-dependency-glob 配置
保留中文 fork 的 Pages 发布后首页验证，继续检查线上页面包含 Claude Code 中文全面上手指南
不改教程正文，不引入上游英文根 README
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-30

上游审阅

核对上游范围：6b9ce64 → d4243d9
上游这轮重点：
同步 Claude Code v2.1.195，覆盖 v2.1.191 到 v2.1.195 的新增文档
MCP 启动时会提示仍需认证的 server，headersHelper 遇到 HTTP 401 / 403 会自动刷新动态认证头
hook matcher 支持逗号列表，并按更精确的工具名规则匹配
/plugin 会提示 unused plugins，并修复 plugin manifest name 与 marketplace entry name 不一致时的启用 / 禁用问题
/rewind 可以跨过 /clear 回到更早 checkpoint
autoMode.classifyAllShell 可让所有 shell 命令经过 Auto Mode 分类器，拒绝原因会显示在 /permissions 等位置
OpenTelemetry 增加 claude_code.assistant_response log event
! bash mode 支持 live file-path autocomplete
新增 CLAUDE_CODE_DISABLE_MOUSE_CLICKS

中文 fork 处理

将 MCP、hooks、plugins、checkpoints、advanced features 和 CLI 更新写入中文主线
保留 headersHelper、HTTP 401 / 403、matcher、"Write,Edit"、plugin.json、autoMode.classifyAllShell、claude_code.assistant_response、CLAUDE_CODE_DISABLE_MOUSE_CLICKS 等标识原文
同步总表、速查卡、资源索引和概念总览，确保入口文档也能看到 v2.1.195 新能力
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-26

上游审阅

核对上游范围：8143e37 → 6b9ce64
上游这轮重点：
同步 Claude Code v2.1.187，覆盖 v2.1.183 到 v2.1.187 的新增文档
/review <pr> 用于审查 GitHub PR，并复用 /code-review medium 的 review engine；本地 diff 仍用 /code-review
attribution.sessionUrl、respondToBashCommands、sandbox.credentials、sandbox.allowAppleEvents 等 settings 口径更新
claude mcp login <name> / logout <name> 支持在 CLI 里处理 MCP server 登录状态，--no-browser 支持 headless OAuth
Agent Teams 增加 --teammate-mode iterm2
Auto Mode 增加内置 intent-based protection，默认拦截一批破坏性命令
! bash 命令输出默认会自动发给 Claude 并触发回复
/config key=value 支持直接设置单个配置项
新增或强调 retry、presence、MCP idle timeout 相关环境变量

中文 fork 处理

将影响真实使用的 slash command、memory settings、subagents、MCP、advanced features 和 CLI 变化写入中文主线
保留 /review <pr>、/code-review medium、claude mcp login、--no-browser、--teammate-mode iterm2、respondToBashCommands、sandbox.credentials、CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 等标识原文
同步总表、速查卡、资源索引和概念总览，确保入口文档也能看到 v2.1.187 新能力
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-18

上游审阅

核对上游范围：ae656f6 → 8143e37
上游这轮重点：
同步 Claude Code v2.1.179，覆盖 v2.1.178 到 v2.1.179 的新增文档
/doctor 改为 flat tree 布局，并强化状态图标
/bug 必须填写描述后才能提交
嵌套 .claude/agents/、workflow 和 output-style 定义采用“最近目录优先”
permission rules 支持 Tool(param:value) 参数匹配
remote session plugin loading performance 提升
网站构建脚本改为 single-parse / cached source / shared nav skeleton
Pages workflow 增加 uv cache 和 vendor assets cache

中文 fork 处理

将 slash command、subagent 优先级、permission rule、plugin 和 CLI 的行为变化改写进中文主线文档
保留 /doctor、/bug、.claude/agents/、Tool(param:value)、Bash(...)、Read(...) 等可执行标识原文
同步 scripts/build_website.py 的性能优化和 Pages 缓存配置，但保留本仓库发布后中文首页验证步骤
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-16

上游审阅

核对上游范围：733c088 → ae656f6
上游这轮重点：
同步 Claude Code v2.1.176，覆盖 v2.1.172 到 v2.1.176 的新增文档
subagent 可继续 spawn 子 subagent，最多嵌套 5 层，并可通过 Agent(agent_type) 限制可 spawn 类型
hooks 新增 handler 级 if 条件，可用 permission-rule 语法按工具参数继续收窄匹配
/plugin marketplace 浏览界面新增搜索栏
新增或更新 enforceAvailableModels、wheelScrollAccelerationEnabled、footerLinksRegexes、language
VSCode Account & usage 视图新增 cache miss、long-context cost、subagents 以及 per-skill / per-agent / per-plugin / per-MCP 归因
上游新增 .gitissue.yml，并修正 scripts/check_links.py 对正则示例链接的误报

中文 fork 处理

将 subagent 嵌套、hook if、plugin 搜索、settings key 和 usage 归因拆分写入中文主线说明
保留 Agent(agent_type)、if、matcher、enforceAvailableModels、wheelScrollAccelerationEnabled、footerLinksRegexes、language 等可执行标识原文
本仓库不采用上游 .gitissue.yml traceability 流程，且当前没有 scripts/check_links.py；这两处上游配置已审阅但不引入
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-12

上游审阅

核对上游范围：fcdc088 → 733c088
上游这轮重点：
同步 Claude Code v2.1.170，覆盖 v2.1.161 到 v2.1.170 的新增文档
/cd <path> 可以在不打断 prompt cache 的情况下切换工作目录
--safe-mode / CLAUDE_CODE_SAFE_MODE=1 用于禁用 CLAUDE.md、plugins、skills、hooks、MCP 等自定义项，便于排查配置问题
fallbackModel 可配置最多三个 fallback models；--fallback-model 从 v2.1.166 起也适用于交互式 session
disableBundledSkills / CLAUDE_CODE_DISABLE_BUNDLED_SKILLS=1 可隐藏内置 skills、workflows 和 commands
/plugin list --enabled / --disabled 可按状态查看 installed plugins
Stop / SubagentStop hook 可返回 hookSpecificOutput.additionalContext 给 Claude 追加上下文并继续当前 turn
stdio MCP servers 会收到 CLAUDE_CODE_SESSION_ID，包括 --resume 恢复的 session
CLI 模型表新增 claude-fable-5

中文 fork 处理

将命令、配置、环境变量、hook 返回字段、MCP session 标识和模型标识改写进中文主线说明
保留 /cd、--safe-mode、CLAUDE_CODE_SAFE_MODE、fallbackModel、disableBundledSkills、CLAUDE_CODE_DISABLE_BUNDLED_SKILLS、hookSpecificOutput.additionalContext、CLAUDE_CODE_SESSION_ID、claude-fable-5 等可执行标识原文
上游 02-memory/README.md 仅刷新页脚和来源链接，本中文 fork 无需为此改写记忆正文
不引入上游英文根 README，不改变中文首页结构
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-03

上游审阅

核对上游范围：e30220c → fcdc088
上游这轮重点：
同步 Claude Code v2.1.160
claude plugin init <name> 可在 .claude/skills 中脚手架新 plugin；放在该目录的 plugin 会自动加载，不再需要 marketplace
Auto Mode 支持 Bedrock / Vertex / Foundry 上的 Opus 4.7 / 4.8，但需要显式设置 CLAUDE_CODE_ENABLE_AUTO_MODE=1
EnterWorktree 可以在 session 中切换 Claude 管理的 worktree；结束后的 worktree 保持 unlocked，方便 git worktree remove / prune 清理
acceptEdits 对 shell 启动文件和可执行构建配置写入仍会提示确认，避免把自动批准扩展到可能执行命令的配置
dynamic workflows 的触发关键词改为 ultracode，裸词 workflow 不再触发运行
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 在 v2.1.160 起为 no-op
上游修正 ja / uk / vi 翻译里的 settings 优先级描述

中文 fork 处理

将 plugin 初始化、Auto Mode 云厂商 opt-in、worktree 切换、安全提示和 workflow 触发变化写入中文主线文档
保留 claude plugin init <name>、CLAUDE_CODE_ENABLE_AUTO_MODE、EnterWorktree、acceptEdits、ultracode、git worktree remove、prune 等可执行标识原文
不引入上游英文根 README，也不新增 ja / uk / vi 目录；这些语言目录的修正已审阅，本仓库根目录中文文档已保持正确 settings 优先级
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-06-01

上游审阅

核对上游范围：c726139 → e30220c
上游这轮重点：
同步 Claude Code v2.1.156 与 Claude Opus 4.8
/model 默认行为改为“保存为后续 session 默认值”；选中后按 s 才只作用于当前 session
Opus 4.8 默认 effort 为 high；xhigh 支持 Opus 4.8 / 4.7，max 支持 Opus 4.8 / 4.7 / 4.6 和 Sonnet 4.6；Haiku 4.5 不支持 effort levels
Fast Mode 默认切到 Opus 4.8；CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 已弃用并在 2026-06-01 移除
/simplify 在 v2.1.154 后重新成为独立的清理型命令；/code-review 继续负责正确性缺陷审查
新增 /reload-skills、/workflows、dynamic workflows、skill disallowed-tools、SessionStart reloadSkills / sessionTitle
hooks 事件数更新为 30，新增 MessageDisplay；status-line 命令脚本会收到 COLUMNS 和 LINES
修正 settings 优先级链：managed policy -> .claude/settings.local.json -> .claude/settings.json -> ~/.claude/settings.json

中文 fork 处理

将影响真实操作的模型、命令、settings、skills、hooks 和 workflow 行为改写成中文说明
保留 /model、/effort、/reload-skills、/workflows、disallowed-tools、reloadSkills、sessionTitle、MessageDisplay、COLUMNS、LINES 等可执行标识原文
继续保持根目录 README.md 为中文入口，不引入上游英文 README 或额外多语言目录树
更新 README.md、UPSTREAM.md 和 CHANGELOG.md 的最近同步记录

中文版同步 — 2026-05-27

上游审阅

核对上游范围：46941a3 → c726139
上游这轮重点：
同步 Claude Code v2.1.150
内置 /simplify 改名为 /code-review，旧名不再作为 alias（别名）使用
/code-review 支持 effort 参数，例如 /code-review high，并可用 --comment 在 PR 里写行内评论
/usage 成本视图按 skills、subagents、plugins、MCP server 等类别拆分
claude agents 视图支持 Ctrl+T 固定后台 session
Markdown 渲染支持 GFM 任务清单复选框（- [ ] / - [x]）
新增托管设置：allowAllClaudeAiMcps
移除 Stop / SubagentStop background_tasks、session_crons 字段说明，因为它们未列入当前官方 hooks reference

中文 fork 处理

将本仓库示例 skill 目录从 03-skills/code-review/ 改名为 03-skills/code-review-specialist/，避免遮蔽新版内置 /code-review
更新 README、速查卡、功能总表、skills、hooks、MCP、CLI、advanced features 与概念总览中的中文说明
保留 /code-review、--comment、Ctrl+T、allowAllClaudeAiMcps、- [ ]、- [x] 等可执行标识原文
不引入上游 ja/、uk/、vi/、zh/ 等额外多语言目录改动，继续保持根目录中文主线结构
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-23

上游审阅

核对上游范围：7e369ee → 46941a3
上游这轮重点：
修正多语言 root-level README 的 logo 相对路径
同步 Claude Code v2.1.145
/extra-usage 主名称改为 /usage-credits，旧命令仍作为 alias（别名）保留
/model 默认只影响当前 session，选择模型后按 d 才写入后续 session 默认值
新增 bundled skills：/run、/verify、/run-skill-generator
Stop / SubagentStop hook 输入新增 background_tasks 和 session_crons
claude agents 新增 --json
修复 Bash 裸环境变量 allowlist 自动批准漏洞

中文 fork 处理

将会影响实际使用、安全边界和自动化脚本的变化改写成中文说明
保留所有 slash command、CLI flag、JSON key、环境变量和权限规则标识原文
补充根级 pyproject.toml 的 jinja2 依赖，确保固定的自动化测试命令无需额外 --with jinja2 也能覆盖网站构建测试
不引入上游 uk/、vi/、zh/ 等额外多语言目录改动，继续保持根目录中文主线结构
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-20（补充）

上游审阅

核对上游范围：30d5ad5 → 7e369ee
上游这轮重点：
修正 ja/、uk/、vi/、zh/ 多语言模块 README 的 logo 相对路径

中文 fork 处理

本中文 fork 的根目录中文主线与模块 README 路径原本正确，因此无需正文改动
不引入上游其他语言子目录改动，继续保持当前中文主线结构
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-20

上游审阅

核对上游范围：3557d79 → 30d5ad5
上游这轮重点：
同步 Claude Code v2.1.143
新增 /goal、/scroll-speed、Agent View、claude plugin details
hooks 增加 args、continueOnBlock、terminalSequence、Stop hook safety cap
MCP stdio server 自动带 CLAUDE_PROJECT_DIR
Fast Mode 默认切到 Opus 4.7，API key 会静默禁用 Remote Control / /schedule / claude.ai connectors

中文 fork 处理

将会影响自动化、安全边界和命令行为的变化改写成适合中文用户理解的说明
保留所有 CLI flags、JSON key、环境变量和命令名原样
更新 hooks 事件数和版本脚注，避免中文仓库继续引用旧口径
保持根目录中文默认入口，不引入上游英文 README 或其他语言目录改动
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-16

上游审阅

核对上游范围：553a319 → 3557d79
上游这轮重点：
新增 scripts/build_website.py
新增 scripts/vendor_assets.py
新增 scripts/website_templates/ 页面模板与样式
新增 scripts/tests/test_build_website.py
新增 .github/workflows/pages.yml

中文 fork 处理

将静态网站生成器、依赖、模板、测试和 GitHub Pages workflow 同步进中文仓库
用中文补充 scripts/README.md 的网站构建、预览和 Pages 部署说明
实际跑通网站构建测试、Markdown 渲染校验、本地化校验、交叉引用检查和整套脚本测试
保持根目录中文默认入口，不引入上游其他语言目录改动
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-12

上游审阅

核对上游范围：b3571e8 → 553a319
上游这轮重点：
新增 scripts/check_markdown_rendering.py
新增 scripts/tests/test_check_markdown_rendering.py
.pre-commit-config.yaml 增加 markdown-rendering 钩子
修正文档里 !`command` 相关 Markdown 渲染转义

中文 fork 处理

将新的 Markdown 渲染校验脚本、测试和 pre-commit 配置同步进中文仓库
实际运行渲染校验器，确认当前中文 README 集合通过检查
保持根目录中文默认入口，不引入上游其他语言目录改动
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-10

上游审阅

核对上游范围：d4b5cf5 → b3571e8
上游这轮重点：
同步 Claude Code v2.1.138
hooks 事件数更新到 29，并新增 Setup 事件、effort.level
新增 worktree.baseRef、autoMode.hard_deny、plan mode 无条件阻止写入
MCP 修复 /clear 后 server 丢失与 OAuth refresh token 并发刷新
plugin 支持空格调用，subagent 共享主 skill catalog，CLI 增补新的环境变量与 resume 权限模式修复

中文 fork 处理

将会影响自动化、安全边界和命令行为的变化改写成适合中文用户理解的说明
保留所有 CLI flags、JSON key、环境变量和命令名原样
同步 hooks 事件数、目录计数和版本脚注，避免中文仓库继续引用旧统计
保持根目录中文默认入口，不引入上游英文 README 或其他语言目录改动
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-07

上游审阅

核对上游范围：9701bb7 → d4b5cf5
上游这轮重点：
同步 Claude Code v2.1.131
新增 skillOverrides、plugin .zip / --plugin-url、disableRemoteControl
/mcp 增加工具数量显示和 0 tools 提示
gateway model discovery 改成显式 opt-in，需要 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
/context 不再把 ASCII 可视化写进对话上下文，Ctrl+R 默认搜索所有项目 prompts，--channels 支持 API key

中文 fork 处理

将新增命令、设置项和行为变化改写成适合中文用户理解的说明
保留所有 CLI flags、JSON key、环境变量和命令名原样
修正上次关于 gateway model discovery 的口径，避免误导用户只设置 ANTHROPIC_BASE_URL 就能自动发现模型
保持根目录中文默认入口，不引入上游英文 README 或其他语言目录改动
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-03

上游审阅

核对上游范围：f393805 → 9701bb7
上游这轮重点：
同步 Claude Code v2.1.126
新增 claude project purge、claude plugin prune、headless claude ultrareview
补充 MCP alwaysLoad、hooks updatedToolOutput 全工具适用范围、${CLAUDE_EFFORT} 等说明
修正 memory 题库中已停用的 # your rule 写法
修正 extended thinking 相关示例与题目，避免误写 /think

中文 fork 处理

将新增命令和配置说明改写为中文用户可理解、可复制的版本
保留所有 CLI flags、JSON key、环境变量和命令名原样
更新 lesson quiz 的出题规则：每轮即时反馈，并要求打乱选项顺序
不引入上游其他语言目录变化，继续保持根目录中文默认入口
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-05-01

上游审阅

核对上游范围：3221229 → f393805
上游这轮重点：
新增完整 ja/ 日文翻译目录
英文 README 去掉硬编码 star / fork 数字
日文目录配套补充 pre-commit 和 EPUB 构建支持

中文 fork 处理

不引入 ja/ 目录，继续保持根目录中文主线
中文首页没有使用上游硬编码 star / fork 指标，因此无需正文改动
不同步日文专项构建配置，避免为未维护目录增加无效检查
更新 README.md 和 UPSTREAM.md 的最近同步记录

中文版同步 — 2026-04-28

上游审阅

核对上游范围：a7a0ea2 → 3221229
上游这轮重点：
新增 SessionEnd 学习进度记录 hook
新增本地浏览器进度面板 local-progress/index.html
修正 agent 优先级为 CLI → Project → User
修正 lesson quiz 里几个过时题目
配置示例继续更新到 Opus 4.7 / Sonnet 4.6

中文 fork 处理

新增中文化的 06-hooks/session-end.sh
新增中文化的 local-progress/index.html
更新 hooks、subagents、CLI、advanced features 和 lesson quiz 相关说明
继续保留中文根目录主线，不采用上游英文 README 或多语言目录结构
保留本仓库自有 RELEASE_NOTES.md，不跟随上游删除该文件

中文版同步 — 2026-04-22

上游审阅

核对上游范围：9c224ff → cf92e8e
上游这轮重点：
同步 Claude Code v2.1.110 / v2.1.112
新增 /tui、/focus、/recap、/undo、/proactive、/ultrareview、/fewer-permission-prompts
09-advanced-features 补充 TUI、session recap、push notifications、Auto Mode 新访问方式
CLI / docs 切到 Opus 4.7，并引入 xhigh effort
plugins 文档新增 background monitors 说明

中文 fork 处理

把这轮新增能力同步到中文根目录主线文档
更新 README.md 和 UPSTREAM.md 的最近同步记录
保留中文默认入口，不采用上游英文 README 和多语言目录结构
增强本地化校验，拦截明显未翻译的英文标题和英文模板段落

中文版同步 — 2026-04-08

上游审阅

核对上游范围：0ca8c37 → 561c6cb
上游这轮重点：
发布 v2.3.0
新增 CLAUDE.md
新增 performance-optimizer subagent
新增 pre-tool-check.sh 与 dependency-check.sh
hooks shell 示例统一到 stdin JSON 协议，并补 Windows Git Bash 兼容性
文档更新覆盖 /ultraplan、MCP Apps、Agent Teams、Channels、cleanupPeriodDays 等主题
上游新增 zh/ / vi/ 多语言目录

中文 fork 处理

新增根目录 CLAUDE.md，写明本仓库的协作与校验约定
新增 04-subagents/performance-optimizer.md
新增 06-hooks/pre-tool-check.sh 与 06-hooks/dependency-check.sh
将 format-code.sh、log-bash.sh、security-scan.sh、validate-prompt.sh 同步到新版协议写法
更新 README.md 的最近同步说明，以及 01、02、03、04、05、06、08、09、10 模块的中文说明
未采用上游的多语言目录拆分与 README 星标 / fork 指标，继续保留当前中文主线仓库结构

中文版同步 — 2026-04-01

上游同步

同步上游范围：d41b335 → 0ca8c37
核心变化：
hooks 不再推荐旧的 auto-adapt-mode 动态学习方案
新增一次性权限种子脚本 09-advanced-features/setup-auto-mode-permissions.py
auto-mode 权限基线改为更保守的默认集合，并支持按需开启 edits、tests、git writes、packages、GitHub writes
上游 README 新增 Trending 徽章

中文 fork 处理

删除本仓库中的旧 06-hooks/auto-adapt-mode.py
在 06-hooks/README.md 和 09-advanced-features/README.md 中补上新的中文说明
在 README.md 中加入最近同步日期与更新内容说明
未直接照搬上游 Trending 徽章，以避免误导为当前中文 fork 的真实热度状态

v2.2.0 — 2026-03-26

文档

将全部教程和参考文档同步到 Claude Code v2.1.84
slash commands 更新为 55+ 个内建命令 + 5 个 bundled skills，并标记 3 个已废弃项
hooks 事件从 18 个扩展到 25 个，并新增 agent hook type
advanced features 新增 Auto Mode、Channels、Voice Dictation
SKILL.md frontmatter 新增 effort、shell
subagent 字段新增 initialPrompt、disallowedTools
MCP 新增 WebSocket transport、elicitation、2KB tool cap 等说明
plugins 新增 LSP、userConfig、${CLAUDE_PLUGIN_DATA} 相关支持
更新 CATALOG、QUICK_REFERENCE、LEARNING-ROADMAP、INDEX
README 改写为更像 landing page 的结构

问题修复

为 CI 补充缺失的 cSpell 词条和 README 章节
在 cSpell 词典中加入 Sandboxing

Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.1...v2.2.0

v2.1.1 — 2026-03-13

问题修复

删除导致链接检查失败的无效 marketplace 链接
在 cSpell 词典中补充 sandboxed 和 pycache

Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.1.0...v2.1.1

v2.1.0 — 2026-03-13

功能

新增自适应学习路径、自测和课后测验相关 skills
/self-assessment：对 10 个能力域做交互式自测并给出个性化学习路径
/lesson-quiz [lesson]：针对单个模块做交互式知识检查

问题修复

更新失效 URL、已废弃写法和过时引用
修复资源文档和自测 skill 里的坏链
将概念指南中的嵌套代码块改为波浪线 fence
增补 cSpell 词典缺失词条

文档

修正文档里的术语、URL 和一致性问题
完成缺失能力覆盖与参考文档补齐
在 MCP 章节加入 MCPorter 运行时说明
补充缺失命令、设置项和特性说明
新增风格指南
将自测和 lesson-quiz 引入 README 与路线图

新贡献者

@VikalpP 首次贡献

Full Changelog: https://github.com/luongnv89/claude-howto/compare/v2.0.0...v2.1.0

v2.0.0 — 2026-02-01

功能

将文档整体同步到 2026 年 2 月的 Claude Code 能力集
新增 Auto Memory
新增 Remote Control、Web Sessions、Desktop App
新增 Agent Teams（实验性）
新增 MCP OAuth 2.0、Tool Search、Claude.ai Connectors
新增 subagents 的 persistent memory 与 worktree isolation
新增 background subagents、task list、prompt suggestions
新增 sandboxing 与托管设置
新增 HTTP hooks 和 7 个新事件
新增 plugin settings、LSP、marketplace 相关说明
补充 checkpoints 的 summarize from checkpoint
补充 17 个新 slash commands
补充一批新 CLI flags 和环境变量

设计

重做 logo，改为更简洁的视觉设计

问题修复 / 纠正

更新模型名：Sonnet 4.5 → Sonnet 4.6，Opus 4.5 → Opus 4.6
修正 permission mode 名称
修正 hooks 事件名
修正 CLI 写法：claude-code --headless → claude -p
修正 checkpoint 命令示例
修正 session 管理命令
修正 plugin manifest：plugin.yaml → .claude-plugin/plugin.json
修正 MCP 配置路径
修正文档 URL，并删除虚构地址
移除多个虚构配置字段

Full Changelog: https://github.com/luongnv89/claude-howto/compare/20779db...v2.0.0