From 78457e5bc322ae468d10a33af2aac1c70dca9c32 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?AI=E4=B8=8D=E6=AD=A2=E8=AF=AD?= <12096460+jnMetaCode@users.noreply.github.com> Date: Fri, 7 Aug 2026 21:59:56 +0800 Subject: [PATCH] =?UTF-8?q?chore(release):=20v1.7.3=20=E2=80=94=E2=80=94?= =?UTF-8?q?=20=E4=B8=8A=E6=B8=B8=E7=BA=AF=E4=BB=A3=E7=A0=81=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=E5=90=8C=E6=AD=A5=20+=20=E5=B7=A5=E5=85=B7=E8=AE=A1?= =?UTF-8?q?=E6=95=B0=E4=B8=80=E8=87=B4=E6=80=A7=E6=A3=80=E6=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 版本号：7 份声明文件 1.7.2 -> 1.7.3（只动 "version" 行，未重排 JSON，已 diff 确认）。 内容见 RELEASE-NOTES.zh.md v1.7.3 条目： - 同步上游 Windows SessionStart hook 分发修复与 find-polluter.sh 三处路径 bug - audit 新增 Category 5 工具计数一致性检查（+24 项，已验证会拦漂移） - 修 bash 3.2 下 CJK 报错信息乱码（3 处） - .gitignore 补新工具安装产物；官网计数 20 -> 22 - 简繁 README 亮点更新至 v1.7.3，补上 Windows 修复一条 发版前门禁 - scripts/audit.sh: 153 pass / 0 fail（3 warn 为上游漂移，见 #19） - scripts/verify-release.sh: 82 pass / 0 fail - npm publish --dry-run: 1.7.3 / 106 文件 / 457.6 kB --- .claude-plugin/marketplace.json | 2 +- .claude-plugin/plugin.json | 2 +- .codex-plugin/plugin.json | 2 +- .cursor-plugin/plugin.json | 2 +- .kimi-plugin/plugin.json | 2 +- README.md | 3 ++- README.zh-Hant.md | 3 ++- RELEASE-NOTES.zh.md | 44 +++++++++++++++++++++++++++++++++ gemini-extension.json | 2 +- package.json | 2 +- 10 files changed, 55 insertions(+), 9 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index cb7478d..8754944 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,7 +9,7 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", - "version": "1.7.2", + "version": "1.7.3", "source": "./", "author": { "name": "jnMetaCode", diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 166c254..2b6ac71 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", - "version": "1.7.2", + "version": "1.7.3", "author": { "name": "jnMetaCode", "url": "https://github.com/jnMetaCode" diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index b7d004d..9ba4224 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.2", + "version": "1.7.3", "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。", "author": { "name": "jnMetaCode", diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 297f927..2f7863c 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "name": "superpowers-zh", "displayName": "Superpowers 中文版", "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具", - "version": "1.7.2", + "version": "1.7.3", "author": { "name": "jnMetaCode", "url": "https://github.com/jnMetaCode" diff --git a/.kimi-plugin/plugin.json b/.kimi-plugin/plugin.json index 6eadee6..6a15091 100644 --- a/.kimi-plugin/plugin.json +++ b/.kimi-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.2", + "version": "1.7.3", "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。", "author": { "name": "jnMetaCode", diff --git a/README.md b/README.md index 013077d..21633c7 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,8 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) > > 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers) -> 🆕 **v1.7.2 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)） +> 🆕 **v1.7.3 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)） +> - 🪟 **Windows bootstrap 修复** —— SessionStart hook 改经 Git Bash 分发（同步上游），hook 不加载 skill 就是死重 > - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展（工具数 20 → 22）—— 按 rules 常驻开销做了专门设计，索引仅 4.5 KB > - 🔧 检测落空时会扫 PATH 给出**可直接复制的 `--tool` 命令**，不再只报「未检测到」 > - 📦 README 补上 **Plugin Marketplace 安装方式**（`claude plugin marketplace add`，升级只需一条命令） diff --git a/README.zh-Hant.md b/README.zh-Hant.md index 6160d8a..56cd212 100644 --- a/README.zh-Hant.md +++ b/README.zh-Hant.md @@ -16,7 +16,8 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) > 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)：180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費 -> 🆕 **v1.7.2 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)） +> 🆕 **v1.7.3 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)） +> - 🪟 **Windows bootstrap 修復** —— SessionStart hook 改經 Git Bash 分發（同步上游），hook 不載入 skill 就是死重 > - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛（工具數 20 → 22）—— 針對 rules 常駐開銷做了專門設計，索引僅 4.5 KB > - 🔧 偵測落空時會掃 PATH 給出**可直接複製的 `--tool` 命令**，不再只報「未偵測到」 > - 📦 README 補上 **Plugin Marketplace 安裝方式**（`claude plugin marketplace add`，升級只需一條命令） diff --git a/RELEASE-NOTES.zh.md b/RELEASE-NOTES.zh.md index f30554f..15ecd4c 100644 --- a/RELEASE-NOTES.zh.md +++ b/RELEASE-NOTES.zh.md @@ -6,6 +6,50 @@ --- +## v1.7.3 (2026-08-07) + +### 🐛 同步上游两处纯代码修复（对齐 v6.1.1 → v6.2.0 时挑出） + +两个文件在我们这边都与上游 v6.1.1 **字节一致**（从未汉化改动），因此可直接取上游版 —— 无需翻译、无需 eval。 + +- **`hooks/hooks.json` 加 `"shell": "bash"`**（上游 `5151e7a`）：SessionStart hook 在 Windows 上原先不经 Git Bash 分发。我们的 hooks.json 与上游除这一行外完全相同。这条直接改善 Windows 用户的 bootstrap 可靠性 —— **bootstrap 不加载，skill 就是死重**。 +- **`skills/systematic-debugging/find-polluter.sh`**（上游 `6015d37`、`c8921b5`）：修三个真 bug，已逐个实测新旧版对比： + - pattern 带 `./` 前缀时匹配不到（`find .` 输出 `./` 前缀路径）：旧 1 个 → 新 2 个 + - `-path` 的 `**/` 无法匹配零层目录，`src/**/*.test.ts` 漏掉 `src/top.test.ts`：旧 1 个 → 新 2 个 + - 完全无匹配时计数为 1 而非 0（`echo` 空串仍算一行）：旧 1 → 新 0 + +### 🧪 新增工具计数一致性检查（audit Category 5，+24 项） + +加一款工具要同步简繁 README（各 6 处）、`package.json`、`CLAUDE.md`、`site/build.mjs`（三语言 15 处）、3 份 plugin manifest —— v1.7.2 全靠人工 grep 才没漏。现在从 installer 的 `TARGETS` 推导期望值并逐处断言，另加两条结构性检查：README 工具表行数必须等于宣称数、Category 2 实际测试的工具数必须等于宣称数（**宣称了就必须测**）。 + +已验证会拦：把标题改成 23 款、删掉一行工具表，两种漂移都被抓到。 + +口径写进注释：`TARGETS` 是「安装目标」共 21 个；Copilot CLI 与 CC 共用 `.claude/skills`（别名映射过去）不占独立条目，但文案里作为独立产品单独计数，所以「文案数 = TARGETS 数 + 1 = 22」。 + +### 🐛 修 bash 3.2 下 CJK 报错信息乱码 + +macOS 自带 bash 3.2.57 解析标识符时不识别多字节字符，`$file「` 会把「的首字节 `0xE3` 吞进变量名，导致变量展开为空且字符被截断。报错信息变成「计数不一致: ����= ��应为 22」—— **只在检查失败时才暴露，写检查的人看不到**。 + +复现：`bash -c 'f=README.md; echo "文件: $f「标签」结束"'` → `文件: ��标签」结束` + +修法是给紧跟 CJK 标点的变量加花括号。全仓扫描 `$var` 紧跟非 ASCII 字节的模式，命中 3 处（audit.sh 2 处、verify-release.sh 1 处 —— 后者因为检测项一直全通过，从没暴露过）。 + +### 🧹 其他 + +- `.gitignore` 补上 `.cline/`、`.clinerules/`、`.kilocode/` —— 与 `.trae/`、`.qoder/` 一致，避免在本仓库内自测安装器留下未跟踪文件。 +- 官网 `site/build.mjs` 工具计数 20 → 22，三语言 FAQ 枚举补入 Cline、Kilo Code（v1.7.2 发了但站点没跟）。 + +### ✅ 验证 + +- `scripts/audit.sh`：**153 pass / 0 fail**（3 项 warn 为上游漂移，见 #19） +- `scripts/verify-release.sh`：**82 pass / 0 fail** +- SessionStart hook 冒烟：退出码 0，输出正确的 SessionStart JSON +- npm 包端到端：pack → 从 tarball 安装 → 真实跑安装器 → 卸载零残留 + +> ⚠️ audit 的上游漂移 warn 从 2 条变 3 条（新增 `using-git-worktrees`），且 `executing-plans` / `finishing-a-development-branch` 的上游 H 值有变化 —— 这是本次 `git fetch upstream` 把对比基准从旧快照更新到 **v6.2.0** 导致的，不是代码改动引起。 + +--- + ## v1.7.2 (2026-08-07) ### 🆕 新增 Cline 与 Kilo Code 适配（工具数 20 → 22，关 #112、#88） diff --git a/gemini-extension.json b/gemini-extension.json index eabaad1..8425dae 100644 --- a/gemini-extension.json +++ b/gemini-extension.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论", - "version": "1.7.2", + "version": "1.7.3", "contextFileName": "GEMINI.md" } diff --git a/package.json b/package.json index b2082cc..3d0d114 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "version": "1.7.2", + "version": "1.7.3", "engines": { "node": ">=20.0.0" },