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

package/cbb/lib/install/codebuddy.js

@@ -1,15 +1,17 @@
 /**
  * WorkBuddy / CodeBuddy 适配器
  *
- * 腾讯 WorkBuddy 桌面工作台与 CodeBuddy IDE / CLI 共用项目级配置目录 `.codebuddy/`，
- * 故一个适配器同时覆盖两者。
+ * 腾讯 WorkBuddy 桌面工作台的项目级配置目录为 `.workbuddy/`（实测：skill 只有
+ * 放在 `.workbuddy/skills/` 才生效；旧版假设「与 CodeBuddy 共用 .codebuddy/」不成立）。
+ * 0.0.3-beta.16 起目录与用户级 settings 全部切到 `.workbuddy`，`.codebuddy` 作为
+ * legacy 由安装流程迁移清理（legacyDirs / legacySettingsFile）。
  *
  * 与 Claude Code / Qoder 的映射差异：
- * - rules：`.codebuddy/rules/*.md`（扁平文件、递归加载），frontmatter 用
+ * - rules：`.workbuddy/rules/*.md`（扁平文件、递归加载），frontmatter 用
  *   `alwaysApply: true`（Qoder 的 `trigger: always_on` 需改写，见 ruleRewrites）
- * - skills：`.codebuddy/skills/<name>/SKILL.md`，结构与 Claude 同构
- * - commands：`.codebuddy/commands/`，支持目录嵌套（`/group:command`），与 Claude 同风格
- * - hooks：完全兼容 Claude Code Hooks 规范，settings 结构一致，直接复用 settingsManager
+ * - skills：`.workbuddy/skills/<name>/SKILL.md`，结构与 Claude 同构
+ * - commands：`.workbuddy/commands/`，支持目录嵌套（`/group:command`），与 Claude 同风格
+ * - hooks：兼容 Claude Code Hooks 规范，settings 结构一致，直接复用 settingsManager
  */
 
 const path = require('path');
@@ -18,13 +20,16 @@ const os = require('os');
 module.exports = {
   name: 'codebuddy',
   displayName: 'WorkBuddy（CodeBuddy）',
-  rulesDir: '.codebuddy/rules',
-  skillsDir: '.codebuddy/skills',
-  commandsDir: '.codebuddy/commands/opsx',
+  rulesDir: '.workbuddy/rules',
+  skillsDir: '.workbuddy/skills',
+  commandsDir: '.workbuddy/commands/opsx',
   // 规则 frontmatter 改写：Qoder 风格 → CodeBuddy 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
   // 用户级 settings，写入全局生效，不污染项目目录
-  settingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
+  settingsFile: path.join(os.homedir(), '.workbuddy', 'settings.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],
+  // 旧版目录/文件（beta.15 及以前写入 .codebuddy）：安装时迁移清理
+  legacyDirs: ['.codebuddy'],
+  legacySettingsFile: path.join(os.homedir(), '.codebuddy', 'settings.json'),
 };

package/cbb/lib/install/init.js

@@ -5,7 +5,7 @@
  *
  * 将AI 编码规范与工作流套件安装到目标项目中。
  * 支持工具：Claude Code (.claude/rules/)、Qoder (.qoder/rules/)、opencode (.opencode/rules/)、
- *          WorkBuddy/CodeBuddy (.codebuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
+ *          WorkBuddy/CodeBuddy (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用
@@ -94,6 +94,16 @@ function hookOpts(adapter) {
   return adapter.hookDialect ? { dialect: adapter.hookDialect } : {};
 }
 
+/**
+ * 迁移清理：移除本包写在旧用户级 settings 里的 hook（如 WorkBuddy 适配修正：
+ * ~/.codebuddy/settings.json → ~/.workbuddy/settings.json）。
+ * removeHooks 只删 _managedBy: cbb 标记的条目，文件清空则删除。返回 true 表示有改动。
+ */
+function cleanLegacySettings(adapter) {
+  if (!adapter.legacySettingsFile || !adapter.hookEvents) return false;
+  return settingsManager.removeHooks(adapter.legacySettingsFile, adapter.hookEvents, hookOpts(adapter));
+}
+
 // 清单驱动的文件清理决策（保护用户文档 CLAUDE.md / AGENTS.md 等）
 const { pathsToDelete, protectedKeptPaths } = require('./cleanup');
 
@@ -1153,6 +1163,10 @@ async function init(targetDir, options = {}) {
       if (settingsManager.removeLegacyHooks(settingsPath, hookOpts(adapter))) {
         log(`清理 ${adapter.displayName} 遗留的 SessionStart hook`, 'success');
       }
+      // 迁移：清理旧用户级 settings（如 ~/.codebuddy → ~/.workbuddy）
+      if (cleanLegacySettings(adapter)) {
+        log(`迁移清理旧用户级配置 ${adapter.legacySettingsFile}`, 'success');
+      }
       if (!adapter.settingsFileIsUserLevel) newPaths.add(adapter.settingsFile);
     });
     log(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join(', ')} (${hookAdapters[0].hookEvents.join(', ')})`, 'success');
@@ -1776,6 +1790,7 @@ async function setupUserLevelComponents(targetAdapters = adapters) {
     hookAdapters.forEach(adapter => {
       settingsManager.addHooks(adapter.settingsFile, command, adapter.hookEvents, hookOpts(adapter));
       settingsManager.removeLegacyHooks(adapter.settingsFile, hookOpts(adapter));
+      cleanLegacySettings(adapter);
     });
     summaryParts.push(`版本检查 hook → ${hookAdapters.map(a => a.displayName).join('、')}`);
   }
@@ -1894,6 +1909,9 @@ async function uninstallUserLevelComponents() {
     if (settingsManager.removeHooks(adapter.settingsFile, adapter.hookEvents, hookOpts(adapter))) {
       log(`${adapter.settingsFile}: 移除版本检查 hook，保留用户配置`, 'success');
     }
+    if (cleanLegacySettings(adapter)) {
+      log(`${adapter.legacySettingsFile}: 移除版本检查 hook（旧路径），保留用户配置`, 'success');
+    }
   });
 
   removePath(USER_MANIFEST_FILE);
@@ -1922,7 +1940,7 @@ async function uninstall() {
   // 是否同时卸载用户级组件（工具 skills + 版本检查 hook，作用于 ~/.claude 等用户目录）
   let removeUserLevel = false;
   if (fs.existsSync(USER_MANIFEST_FILE)) {
-    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.codebuddy、~/.trae-cn 的版本检查 hook）？(y/N): ');
+    const answerUser = await ask('是否同时卸载用户级组件（~/.claude、~/.qoder、~/.workbuddy、~/.trae-cn 的版本检查 hook）？(y/N): ');
     removeUserLevel = answerUser.toLowerCase() === 'y' || answerUser.toLowerCase() === 'yes';
   }
 

package/cbb/lib/install/setup-decision.js

@@ -6,7 +6,7 @@
  * 背景 bug（0.0.3-beta.15 修复）：旧版 decideUpgradeIfInstalled 只比较
  * 「已装版本 vs 当前包版本」，版本一致即 skip——导致「空间已是当前版本 +
  * 本次新选了工具（如 WorkBuddy）」被整体跳过，新工具的空间级目录
- * （.codebuddy/ 等）永不生成，.last-tools 也不更新。
+ * （.workbuddy/ 等）永不生成，.last-tools 也不更新。
  */
 
 const fs = require('fs');

package/cbb/lib/utils/gitignore.js

@@ -20,6 +20,7 @@ const GITIGNORE_RULES = [
   { add: '.codespace/', accept: ['.codespace/', '.codespace'] },
   { add: '.opencode', accept: ['.opencode', '.opencode/'] },
   { add: '.codebuddy', accept: ['.codebuddy', '.codebuddy/'] },
+  { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
   { add: '.trae', accept: ['.trae', '.trae/'] },
 ];
 

package/config/workspace-agents.sample.md

@@ -20,7 +20,7 @@
 | `.codespace/` | 各关联应用的基准代码（每个应用一个子目录） | `cbb setup` 与 worktree 流程自动 clone / fetch；**勿手动编辑**；已 gitignore，不提交 |
 | `.worktrees/` | 需求隔离开发区（每个需求一个 `worktree-<需求名>/` 目录） | worktree 命令自动创建 / 清理；不提交（首次执行 worktree 流程时自动加入 .gitignore） |
 | `openspec/` | OpenSpec 工作流配置（`config.yaml` + `schemas/`） | 由 cbb 安装；变更产物（`openspec/changes/` 等）worktree 模式在**需求工作树内**生成随需求分支提交，轻量模式直接在空间根生成提交 main |
-| `.claude/` `.qoder/` `.opencode/` `.codebuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
+| `.claude/` `.qoder/` `.opencode/` `.workbuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
 | `.cbb/` | cbb 安装清单与状态（`.managed-by-cbb`、`.last-tools`） | 由 cbb 管理；**勿手动编辑** |
 
 ## 典型流程

package/package.json

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