v1.3.0 — 跟上游 v5.1.0 对齐 + 修 marketplace.json drift

v1.3.0 (2026-05-10)

跟上游对齐 (v5.1.0)

• 同步上游 v5.1.0 的目录变更：上游主动删除了 commands/（3 个 deprecated stub）和 agents/code-reviewer.md（已上升进 requesting-code-review skill）。中文 fork 跟随删除以与上游意图对齐。详见上游 #1188 与 PR #1299。
• bin/superpowers-zh.js 移除安装时复制 agents/ 到 .claude/agents/ 的逻辑，保留 uninstall 时的清理逻辑（用于已装用户清理残留 code-reviewer.md，防止双 source of truth）。
• .github/workflows/ci.yml 删除 "Validate agents" 验证段（agents/ 已删，验证空目录无意义）。

补齐上游遗漏的根级文件

• CLAUDE.md —— 上游 contributor 指南（含 anti-slop-PR 规则）的中文翻译，末尾追加中文 fork 自己的 PR 流程说明。
• AGENTS.md —— 软链接 → CLAUDE.md（mode 120000，跟上游一致）。Codex CLI 等工具从 AGENTS.md 自动加载等同读取 CLAUDE.md。
  • Known limitation：npm pack 默认不跟随 symlink，因此 npm publish 出来的 tarball 不包含 AGENTS.md。这不影响实际使用：AGENTS.md 是 Codex CLI 在用户自己项目目录读的文件，不是从 superpowers-zh 安装包读的；通过 git clone 拿到仓库的贡献者会正确解析 symlink。
• RELEASE-NOTES.md —— 上游 release notes 原样保留（英文版，1180 行）。
• RELEASE-NOTES.zh.md —— 本文件，中文 fork 自身 release 记录。
• .codex-plugin/plugin.json —— Codex CLI plugin manifest（中文版本地化：name/description/displayName 改为中文版，URL 指向 jnMetaCode/superpowers-zh）。
• .version-bump.json —— 上游版本管理配置文件。
• scripts/bump-version.sh —— 上游版本同步脚本（含 --check 漂移检测、--audit 仓库审计）。中文版 npm version 钩子继续用 scripts/sync-plugin-version.js，bump-version.sh 作为补充工具引入。
• assets/app-icon.png + assets/superpowers-small.svg —— Codex marketplace 需要的图标资产。
• 4 个新增上游测试：tests/claude-code/test-requesting-code-review.sh、tests/claude-code/test-worktree-native-preference.sh、tests/opencode/test-bootstrap-caching.{mjs,sh}。

主动修复上游 v5.1.0 的疏忽

• .cursor-plugin/plugin.json 删除 dangling 的 "agents": "./agents/" 和 "commands": "./commands/" 两行。上游 v5.1.0 删了目录但忘了同步清理 manifest（git blame 显示这两行从 2026-02-13 加入后从未更新）。中文 fork 主动修掉（向上游开 issue 是后续动作）。

修中文版自己的老漂移（PR #23）

• .claude-plugin/marketplace.json 的 plugins[0].version 卡在 1.1.8 的老漂移修复（追上其他 4 个 manifest，1.3.0 release 时统一升到 1.3.0）。原因是中文版简化版 sync-plugin-version.js 之前只 match 顶层 "version": 字段，跳过嵌套位置；导致 Claude Code marketplace 用户看到的 plugin 版本一直停在 1.1.8，跟 npm 包真实版本不同步。
• scripts/sync-plugin-version.js 增强为支持嵌套字段路径（plugins.0.version）。TARGETS 改为对象数组 { path, field }，对齐上游 .version-bump.json 格式。仍使用 regex 替换而非 JSON re-stringify，保留原文件格式（缩进、行内/多行数组等不被破坏）。

不引入

• 上游 scripts/sync-to-codex-plugin.sh（推 OpenAI Codex marketplace 用，硬编码 prime-radiant-inc/openai-codex-plugins，中文版用不上）
• 配套测试 tests/codex-plugin-sync/test-sync-to-codex-plugin.sh

不动（中文版叠加层全部保留）

bin/ + npx 流程、docs/ 中文工具文档、4 个 chinese-* skill、mcp-builder、workflow-runner、README.md 主推 npx 路径、.codex/INSTALL.md、.opencode/INSTALL.md、.gemini/、scripts/sync-plugin-version.js —— 这些是符合"保持上游主流程不变 + 中文版叠加新增"原则的中文 fork 沉淀，全部保留。

v1.2.1 — --uninstall 子命令 + 主目录守护 + 数据安全卸载

修复 #17 报告的两个 bug，同时新增数据安全的卸载子命令。

升级

npx superpowers-zh@latest                   # 安装 / 升级
npx superpowers-zh@latest --uninstall       # 卸载（含误装清理）

新增

• --uninstall 子命令 — 一条命令清理当前目录下的 superpowers-zh 安装：删除装过的 skill 目录、独立 bootstrap 文件（.trae/rules/superpowers-zh.md、.antigravity/rules.md），并清理追加到 CLAUDE.md / HERMES.md / GEMINI.md / CONVENTIONS.md 里的 superpowers-zh 段，保留用户原有内容。
• --force 参数 — 在用户主目录强制安装（默认拒绝）。
• 哨兵注释机制 — 安装时把 bootstrap 内容用 <!-- superpowers-zh:begin/end --> 包裹，卸载按哨兵精确切除，杜绝段尾误判导致的数据丢失。

修复

• 主目录污染（#17） — 之前在 ~ 直接跑 npx superpowers-zh 会把所有工具的 skills 和 bootstrap 文件写进用户主目录。v1.2.1 默认拒绝，提示加 --force 或 cd 到项目目录。
• 计数显示叠加（#17） — 多工具安装时显示 "Trae: 101 个 skills"（实际源只有 20 个），原因是 countDirs(dest) 把目标目录已有的子目录也算进去了。改为始终显示源数量。
• .DS_Store 散播 — copyDirSync 会把源里的 macOS 元数据复制到所有用户目录，现已跳过。
• 段尾识别不可靠的数据丢失风险 — v1.2.0（pre-release，未发布到 npm，仅 git tag）的 cleanBootstrapSection 在 superpowers 段后只有 ## 二级标题时会误删整个文件。v1.2.1 引入哨兵 + 保守 fallback：识别不可靠时跳过文件并打印警告。

内部改进

• scripts/sync-plugin-version.js + npm version 钩子：bump 后自动同步 .claude-plugin/plugin.json 和 .cursor-plugin/plugin.json 的 version 字段，从此不会再漏。
• 两个 plugin manifest 一次性从 1.1.8 修到 1.2.1。

兼容性

• 装过 v1.1.x 的用户跑 --uninstall 没问题，会用末尾固定句子做兜底识别。
• 只有遇到极端编辑场景（superpowers 段被人工搬到文件开头且后面只有 ## 二级标题）才会触发"跳过 + 警告"，此时按提示手动编辑文件即可，不会丢数据。

文档

• README 加主目录警告 + 完整的「卸载 / 误装清理」小节
• docs/README.trae.md 加误装清理指引

已知后续工作

#19 tracking 上游 v5.0.6 / v5.1.0 的 skill 内容同步（brainstorming / writing-plans 移除 subagent review loop、worktree 重写、code-review 整合等），不影响 v1.2.1 的卸载和安装功能。