diff --git a/.gitignore b/.gitignore index b967682..4b52338 100644 --- a/.gitignore +++ b/.gitignore @@ -12,3 +12,6 @@ npm-debug.log* # lychee 本地缓存 .lycheecache + +# Claude Code 本地 worktree +.claude/ diff --git a/CHANGELOG.en.md b/CHANGELOG.en.md index cfcf010..bf0872c 100644 --- a/CHANGELOG.en.md +++ b/CHANGELOG.en.md @@ -4,6 +4,32 @@ > See `git log` for full commit history. This file records user-facing major updates. +## September 2026 · Full Refresh Against Current Official Docs + +Nearly six months since the last verification — several tools were renamed, retired, or changed config formats. Every item was re-checked against official docs / source / release notes, in both languages. + +### ⚠️ Major Changes +- **Windsurf → Devin Desktop** (renamed 2026-06, now under Cognition): page largely rewritten (Devin Local, Code/Plan/Ask modes, `.devin/rules/`) +- **Gemini CLI**: stopped serving individual / free users on 2026-06-18; enterprise and paid API keys still work, individuals move to Antigravity CLI; context corrected to 1M +- **Trae**: international edition removed Claude in 2025-09; IDE renamed TraeCode +- **Aider**: added maintenance-status note (last release 2026-02, no native MCP) + +### 🔧 Fixes for Copy-Paste Errors +- All retired model IDs replaced (`claude-sonnet-4-20250514`, `deepseek-chat`, `gpt-5.4`, etc.) +- Codex: `codex exec` rejects `--ask-for-approval`; profiles are now separate `.config.toml` files; `mcp-server` → `app-server` +- Claude Code: skills must be `/SKILL.md` folders; `.claude/rules/` uses `paths:`; only exit-2 hooks block +- Cursor: rules must be `.mdc`; Notepads removed; Composer panel → Agent +- Copilot: MCP config lives in `.vscode/mcp.json`; chatModes → `.github/agents/` +- Kiro: steering `inclusion:` with four modes; new hooks format +- OpenClaw: config keys, `models set` syntax, Node version +- shellward: MCP / SDK usage synced to latest + +### 🔄 Other +- Cheatsheet capability matrix refreshed (most tools now support Hooks / Subagents / MCP) +- Each tool guide gets a compact "New in H2 2026" list +- Resource star counts and renamed / archived repos updated +- CI: fixed the persistently failing Link Check (book/src symlink false positives, etc.) + ## Late April 2026 · OpenAI Codex CLI Guide Added ### 🆕 New Tool: Codex CLI (now 10 tools total) diff --git a/CHANGELOG.md b/CHANGELOG.md index a0c50a1..4d2dc16 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,32 @@ > 完整提交历史见 `git log`。本文档记录面向用户的重要更新。 +## 2026-09 · 全面刷新:10 款工具按最新官方文档核实 + +距上次核实已近半年,多款工具发生了改名、停服、配置格式变更。本次逐项对照官方文档 / 源码 / release notes 更新,中英同步。 + +### ⚠️ 重大变化 +- **Windsurf → Devin Desktop**(2026-06 改名,Cognition 旗下):页面基本重写(Devin Local、Code/Plan/Ask 模式、`.devin/rules/`) +- **Gemini CLI**:2026-06-18 起个人 / 免费用户停服,企业版与付费 API Key 仍可用,个人转 Antigravity CLI;上下文更正为 1M +- **Trae**:国际版 2025-09 已下架 Claude,IDE 改名 TraeCode +- **Aider**:补充维护状态说明(最后发版 2026-02,无原生 MCP) + +### 🔧 照抄会报错的修复 +- 退役模型 ID 全部替换(`claude-sonnet-4-20250514`、`deepseek-chat`、`gpt-5.4` 等) +- Codex:`codex exec` 不接受 `--ask-for-approval`;profile 改为独立 `.config.toml`;`mcp-server` → `app-server` +- Claude Code:skill 必须是 `/SKILL.md` 目录;`.claude/rules/` 用 `paths:`;只有 exit 2 的 hook 会阻断 +- Cursor:规则文件必须是 `.mdc`;Notepads 已移除;Composer 面板 → Agent +- Copilot:MCP 配置改为 `.vscode/mcp.json`;chatModes → `.github/agents/` +- Kiro:steering `inclusion:` 四种模式;hooks 新格式 +- OpenClaw:配置键、`models set` 语法、Node 版本 +- shellward:MCP / SDK 用法同步最新版 + +### 🔄 其他 +- 速查表能力矩阵整体更新(多数工具已支持 Hook / Subagent / MCP) +- 各工具新增「2026 下半年新增」简表 +- 资源页星数、改名 / 归档仓库更新 +- CI:修复 Link Check 连续失败(book/src 软链接误报等) + ## 2026-04(下半月) · 新增 OpenAI Codex CLI 教程 ### 🆕 新增工具:Codex CLI(10 款工具齐了) diff --git a/README.en.md b/README.en.md index 05b4536..201d0e6 100644 --- a/README.en.md +++ b/README.en.md @@ -141,7 +141,7 @@ This project covers "how to use the 10 tools well." Want to go deeper? See **[Fu ## 🆕 Changelog -See **[CHANGELOG](CHANGELOG.en.md)** for important updates. Latest major update: **2026-04** added cheatsheet, 31 deep pitfalls, end-to-end scenario scripts, persona-based learning paths, and 20+ external learning resources. +See **[CHANGELOG](CHANGELOG.en.md)** for important updates. Latest major update: **2026-09** all 10 tools re-verified against current official docs (Windsurf → Devin Desktop, Gemini CLI individual tier retired, retired model IDs replaced, and more). --- diff --git a/README.md b/README.md index 3aa54bf..b8158b5 100644 --- a/README.md +++ b/README.md @@ -182,7 +182,7 @@ AI 视频线: ## 🆕 更新日志 -查看 **[CHANGELOG](CHANGELOG.md)** 了解项目重要更新。最近一次重大更新:**2026-04** 新增速查表、31 个深度陷阱合集、端到端实战脚本、画像推荐路径、20+ 外部学习资源。 +查看 **[CHANGELOG](CHANGELOG.md)** 了解项目重要更新。最近一次重大更新:**2026-09** 10 款工具按最新官方文档全面核实(Windsurf → Devin Desktop、Gemini CLI 个人版停服、退役模型 ID 替换等)。 ---