@jspg-ai/coding-bb 0.0.3-beta.16 → 0.0.3-beta.18

package/cbb/lib/install/init.js

@@ -5,7 +5,7 @@
  *
  * 将AI 编码规范与工作流套件安装到目标项目中。
  * 支持工具：Claude Code (.claude/rules/)、Qoder (.qoder/rules/)、opencode (.opencode/rules/)、
- *          WorkBuddy/CodeBuddy (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
+ *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用
@@ -56,7 +56,7 @@ const LAST_TOOLS_FILE = path.join(MANIFEST_DIR, '.last-tools');
 // 适配器（数组顺序 = 工具选择面板的显示顺序）
 const adapters = [
   require('./opencode'),
-  require('./codebuddy'),
+  require('./workbuddy'),
   require('./trae'),
   require('./qoder'),
   require('./claude-code'),
@@ -94,6 +94,17 @@ function hookOpts(adapter) {
   return adapter.hookDialect ? { dialect: adapter.hookDialect } : {};
 }
 
+// 工具历史名迁移：beta.16 及以前为 'codebuddy'（CodeBuddy 目录模型），
+// beta.17 起统一为 'workbuddy'。存量 .last-tools / 清单里的旧名读取时归一，
+// 下次安装由 saveLastTools 以新名落盘。
+const LEGACY_TOOL_NAMES = { codebuddy: 'workbuddy' };
+
+/** 工具名集合归一（旧名 → 新名）；null 透传 */
+function normalizeToolSet(set) {
+  if (!set) return set;
+  return new Set([...set].map(t => LEGACY_TOOL_NAMES[t] || t));
+}
+
 /**
  * 迁移清理：移除本包写在旧用户级 settings 里的 hook（如 WorkBuddy 适配修正：
  * ~/.codebuddy/settings.json → ~/.workbuddy/settings.json）。
@@ -107,7 +118,7 @@ function cleanLegacySettings(adapter) {
 // 清单驱动的文件清理决策（保护用户文档 CLAUDE.md / AGENTS.md 等）
 const { pathsToDelete, protectedKeptPaths } = require('./cleanup');
 
-// 规则 frontmatter 改写（Trae/CodeBuddy 需 alwaysApply: true）
+// 规则 frontmatter 改写（Trae/WorkBuddy 需 alwaysApply: true）
 const { applyRuleRewrites } = require('./rule-rewrite');
 
 // .gitignore 条目决策（纯函数：检测/写入/卸载移除）
@@ -208,7 +219,7 @@ function readLastTools() {
   if (!fs.existsSync(filePath)) return null;
   try {
     const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    return new Set(data.tools || []);
+    return normalizeToolSet(new Set(data.tools || []));
   } catch (_) {
     return null;
   }
@@ -995,12 +1006,15 @@ async function init(targetDir, options = {}) {
   // 选择优先级：调用方预设（cbb setup）> .last-tools（非交互沿用）> 交互选择；无记录才回退全选
   const isNonInteractive = yes || !process.stdin.isTTY;
   let selectedAdapters;
+  let fromRecord = false; // 选择来自预设或 .last-tools 记录（需落盘归一化后的新工具名）
   if (presetAdapters && presetAdapters.length > 0) {
     selectedAdapters = presetAdapters;
+    fromRecord = true;
   } else if (isNonInteractive) {
     const lastTools = readLastTools();
     const reused = lastTools ? adapters.filter(a => lastTools.has(a.name)) : [];
     selectedAdapters = reused.length > 0 ? reused : adapters;
+    fromRecord = reused.length > 0;
     if (yes && process.stdin.isTTY) {
       log(reused.length > 0
         ? `--yes 非交互模式，沿用上次工具选择：${reused.map(a => a.displayName).join('、')}`
@@ -1009,8 +1023,9 @@ async function init(targetDir, options = {}) {
   } else {
     selectedAdapters = await selectTools(isUpgrade);
   }
-  // 业务空间根记录本次选择，供 cbb update 等非交互场景沿用
-  if (isWorkspaceRoot && presetAdapters && presetAdapters.length > 0) {
+  // 业务空间根记录本次选择，供 cbb update 等非交互场景沿用；
+  // 沿用旧记录时同样落盘，使历史工具名（codebuddy → workbuddy）归一化自愈
+  if (isWorkspaceRoot && fromRecord) {
     saveLastTools(selectedAdapters);
   }
 
@@ -1281,7 +1296,7 @@ function decideUpgradeIfInstalled(targetDir, selectedAdapters) {
   const pkg = require(path.join(SHARED_STANDARDS_DIR, 'package.json'));
   const decision = setupDecision.decideSetupAction({
     sameVersion: version.compareVersions(installed, pkg.version) === 0,
-    lastTools: setupDecision.readLastToolsFrom(targetDir),
+    lastTools: normalizeToolSet(setupDecision.readLastToolsFrom(targetDir)),
     selectedNames: (selectedAdapters || []).map(a => a.name),
   });
 

package/cbb/lib/install/rule-rewrite.js

@@ -7,7 +7,7 @@
  * `trigger: always_on`。各工具对"始终生效"的字段名不同：
  *  - Qoder：trigger: always_on（源格式）
  *  - Claude Code / opencode：无该字段，靠各自机制加载
- *  - WorkBuddy/CodeBuddy、Trae：alwaysApply: true
+ *  - WorkBuddy、Trae：alwaysApply: true
  *
  * 适配器通过 ruleRewrites（[[from, to], ...]）声明改写规则，部署时套用；
  * 无 ruleRewrites 的适配器原样返回。

package/cbb/lib/install/{codebuddy.js → workbuddy.js}

@@ -1,9 +1,10 @@
 /**
- * WorkBuddy / CodeBuddy 适配器
+ * WorkBuddy 适配器
  *
- * 腾讯 WorkBuddy 桌面工作台的项目级配置目录为 `.workbuddy/`（实测：skill 只有
- * 放在 `.workbuddy/skills/` 才生效；旧版假设「与 CodeBuddy 共用 .codebuddy/」不成立）。
- * 0.0.3-beta.16 起目录与用户级 settings 全部切到 `.workbuddy`，`.codebuddy` 作为
+ * 腾讯 WorkBuddy 桌面工作台的项目级配置目录为 `.workbuddy/`（业务空间实测：
+ * skill 只有放在 `.workbuddy/skills/` 才生效；旧版假设「与 CodeBuddy 共用
+ * .codebuddy/」不成立）。0.0.3-beta.16 起目录与用户级 settings 切到
+ * `.workbuddy`；0.0.3-beta.17 起不再支持 CodeBuddy，`.codebuddy` 仅作为
  * legacy 由安装流程迁移清理（legacyDirs / legacySettingsFile）。
  *
  * 与 Claude Code / Qoder 的映射差异：
@@ -18,18 +19,18 @@ const path = require('path');
 const os = require('os');
 
 module.exports = {
-  name: 'codebuddy',
-  displayName: 'WorkBuddy（CodeBuddy）',
+  name: 'workbuddy',
+  displayName: 'WorkBuddy',
   rulesDir: '.workbuddy/rules',
   skillsDir: '.workbuddy/skills',
   commandsDir: '.workbuddy/commands/opsx',
-  // 规则 frontmatter 改写：Qoder 风格 → CodeBuddy 风格
+  // 规则 frontmatter 改写：Qoder 风格 → WorkBuddy 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
   // 用户级 settings，写入全局生效，不污染项目目录
   settingsFile: path.join(os.homedir(), '.workbuddy', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],
-  // 旧版目录/文件（beta.15 及以前写入 .codebuddy）：安装时迁移清理
+  // 旧版（beta.15 及以前按 CodeBuddy 装的 .codebuddy）：安装时迁移清理
   legacyDirs: ['.codebuddy'],
   legacySettingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
 };

package/cbb/lib/utils/check-update.js

@@ -23,7 +23,8 @@ const CACHE_FILE = path.join(os.homedir(), '.cbb', '.update-check-cache.json');
 const CACHE_TTL = 24 * 60 * 60 * 1000;
 
 function getProjectDir() {
-  return process.env.CODEBUDDY_PROJECT_DIR
+  return process.env.WORKBUDDY_PROJECT_DIR
+    || process.env.CODEBUDDY_PROJECT_DIR
     || process.env.TRAE_PROJECT_DIR
     || process.env.QODER_PROJECT_DIR
     || process.env.CLAUDE_PROJECT_DIR
@@ -32,8 +33,9 @@ function getProjectDir() {
 
 /** 通过环境变量检测当前调用方对应的适配器名称 */
 function detectAdapterName() {
-  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / CodeBuddy 一并注入，故优先判定各自专属变量
-  if (process.env.CODEBUDDY_PROJECT_DIR) return 'codebuddy';
+  // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / WorkBuddy 一并注入，故优先判定各自专属变量；
+  // CODEBUDDY_PROJECT_DIR 为 WorkBuddy 沿用的历史变量名，一并识别为 workbuddy
+  if (process.env.WORKBUDDY_PROJECT_DIR || process.env.CODEBUDDY_PROJECT_DIR) return 'workbuddy';
   if (process.env.TRAE_PROJECT_DIR) return 'trae';
   if (process.env.QODER_PROJECT_DIR) return 'qoder';
   if (process.env.CLAUDE_PROJECT_DIR) return 'claude-code';

package/cbb/lib/utils/gitignore.js

@@ -19,7 +19,8 @@ const GITIGNORE_RULES = [
   { add: '.cbb/', accept: ['.cbb/'] },
   { add: '.codespace/', accept: ['.codespace/', '.codespace'] },
   { add: '.opencode', accept: ['.opencode', '.opencode/'] },
-  { add: '.codebuddy', accept: ['.codebuddy', '.codebuddy/'] },
+  // .codebuddy：beta.15 及以前写入的旧目录，不再新增（add: null），但卸载/清理时仍移除其行
+  { add: null, accept: ['.codebuddy', '.codebuddy/'] },
   { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
   { add: '.trae', accept: ['.trae', '.trae/'] },
 ];
@@ -32,12 +33,12 @@ function toLines(content) {
 /**
  * 给定 .gitignore 内容，返回需要新增的条目。
  * 已含任一可接受形式（带/不带尾斜杠）的目录会被跳过；全部已存在时返回空数组。
- * 返回的是写入形式（.claude / .qoder 无尾斜杠，.cbb/ 带尾斜杠）。
+ * 返回的是写入形式（.claude / .qoder 无尾斜杠，.cbb/ 带尾斜杠；add 为 null 的纯遗留规则不新增）。
  */
 function entriesToAdd(content) {
   const lines = toLines(content).map(l => l.trim());
   return GITIGNORE_RULES
-    .filter(r => !r.accept.some(a => lines.includes(a)))
+    .filter(r => r.add && !r.accept.some(a => lines.includes(a)))
     .map(r => r.add);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jspg-ai/coding-bb",
-  "version": "0.0.3-beta.16",
+  "version": "0.0.3-beta.18",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {