Skip to content

Releases: jnMetaCode/superpowers-zh

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

05 May 15:07

Choose a tag to compare

修复 #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 默认拒绝,提示加 --forcecd 到项目目录。
  • 计数显示叠加(#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 的卸载和安装功能。