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

package/cbb/lib/install/init.js

@@ -5,7 +5,7 @@
  *
  * 将AI 编码规范与工作流套件安装到目标项目中。
  * 支持工具：Claude Code (.claude/rules/)、Qoder (.qoder/rules/)、opencode (.opencode/rules/)、
- *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode (.trae/rules/)
+ *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode 中国版 (.trae-cn/rules/)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用

package/cbb/lib/install/trae.js

@@ -1,16 +1,20 @@
 /**
- * TraeWork / TraeCode 适配器
+ * TraeWork / TraeCode 适配器（中国版）
  *
- * 字节 TraeWork 桌面工作台与 TraeCode IDE 共用项目级配置目录 `.trae/`，
- * 故一个适配器同时覆盖两者。
+ * 字节 TraeWork 桌面工作台与 TraeCode IDE 的中国版共用项目级配置目录
+ * `.trae-cn/`（与国际版 `.trae/` 区分），故一个适配器同时覆盖两者。
+ * 我司及团队主要使用中国版，beta.19 起不再支持国际版目录分发。
  *
  * 与 Claude Code / Qoder 的映射差异：
- * - rules：`.trae/rules/*.md`（扁平文件、支持子目录，最多 3 层），frontmatter 用
+ * - rules：`.trae-cn/rules/*.md`（扁平文件、支持子目录，最多 3 层），frontmatter 用
  *   `alwaysApply: true`（Qoder 的 `trigger: always_on` 需改写，见 ruleRewrites）
- * - skills：`.trae/skills/<name>/SKILL.md`，结构与 Claude 同构
- * - commands：`.trae/commands/`，支持目录嵌套（最多 3 层），与 Claude 同风格
+ * - skills：`.trae-cn/skills/<name>/SKILL.md`，结构与 Claude 同构
+ * - commands：`.trae-cn/commands/`，支持目录嵌套（最多 3 层），与 Claude 同风格
  * - hooks：`~/.trae-cn/hooks.json`，格式与 Claude 相近但需顶层 `version: 1`
  *   （由 settingsManager 的 hookDialect 处理），事件名/输出字段一致
+ *
+ * 注意：不设 legacyDirs —— 项目级 `.trae/` 可能是用户自建的国际版配置，
+ * cbb 不做目录删除；仅 .gitignore 遗留行在卸载时清理。
  */
 
 const path = require('path');
@@ -18,13 +22,13 @@ const os = require('os');
 
 module.exports = {
   name: 'trae',
-  displayName: 'TraeWork（TraeCode）',
-  rulesDir: '.trae/rules',
-  skillsDir: '.trae/skills',
-  commandsDir: '.trae/commands/opsx',
+  displayName: 'TraeWork（TraeCode·中国版）',
+  rulesDir: '.trae-cn/rules',
+  skillsDir: '.trae-cn/skills',
+  commandsDir: '.trae-cn/commands/opsx',
   // 规则 frontmatter 改写：Qoder 风格 → Trae 风格
   ruleRewrites: [['trigger: always_on', 'alwaysApply: true']],
-  // 用户级 hooks 配置（Trae 用 hooks.json，国内版目录为 ~/.trae-cn/）
+  // 用户级 hooks 配置（Trae 中国版用 hooks.json，目录为 ~/.trae-cn/）
   settingsFile: path.join(os.homedir(), '.trae-cn', 'hooks.json'),
   settingsFileIsUserLevel: true,
   hookEvents: ['UserPromptSubmit'],

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

@@ -25,6 +25,7 @@ const CACHE_TTL = 24 * 60 * 60 * 1000;
 function getProjectDir() {
   return process.env.WORKBUDDY_PROJECT_DIR
     || process.env.CODEBUDDY_PROJECT_DIR
+    || process.env.TRAE_CN_PROJECT_DIR
     || process.env.TRAE_PROJECT_DIR
     || process.env.QODER_PROJECT_DIR
     || process.env.CLAUDE_PROJECT_DIR
@@ -34,9 +35,10 @@ function getProjectDir() {
 /** 通过环境变量检测当前调用方对应的适配器名称 */
 function detectAdapterName() {
   // 兼容变量（CLAUDE_PROJECT_DIR）由 Trae / WorkBuddy 一并注入，故优先判定各自专属变量；
-  // CODEBUDDY_PROJECT_DIR 为 WorkBuddy 沿用的历史变量名，一并识别为 workbuddy
+  // CODEBUDDY_PROJECT_DIR 为 WorkBuddy 沿用的历史变量名，一并识别为 workbuddy；
+  // TRAE_CN_PROJECT_DIR / TRAE_PROJECT_DIR 为中国版 Trae 的变量名（不同版本注入不一），均识别为 trae
   if (process.env.WORKBUDDY_PROJECT_DIR || process.env.CODEBUDDY_PROJECT_DIR) return 'workbuddy';
-  if (process.env.TRAE_PROJECT_DIR) return 'trae';
+  if (process.env.TRAE_CN_PROJECT_DIR || process.env.TRAE_PROJECT_DIR) return 'trae';
   if (process.env.QODER_PROJECT_DIR) return 'qoder';
   if (process.env.CLAUDE_PROJECT_DIR) return 'claude-code';
   return null;

package/cbb/lib/utils/gitignore.js

@@ -22,7 +22,10 @@ const GITIGNORE_RULES = [
   // .codebuddy：beta.15 及以前写入的旧目录，不再新增（add: null），但卸载/清理时仍移除其行
   { add: null, accept: ['.codebuddy', '.codebuddy/'] },
   { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
-  { add: '.trae', accept: ['.trae', '.trae/'] },
+  // .trae：beta.18 及以前（国际版）写入的旧目录，不再新增（add: null，目录可能为用户自建、不清理），
+  // 但卸载时仍移除其 gitignore 行
+  { add: null, accept: ['.trae', '.trae/'] },
+  { add: '.trae-cn', accept: ['.trae-cn', '.trae-cn/'] },
 ];
 
 /** 将 .gitignore 文本拆为行数组。 */

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/` `.workbuddy/` `.trae/` | AI 工具适配目录：编码规范规则、OpenSpec 命令、worktree 管理技能（skill 形态） | 由 cbb 按 setup 时选择的工具安装；已 gitignore，不提交，勿手动改 |
+| `.claude/` `.qoder/` `.opencode/` `.workbuddy/` `.trae-cn/` | 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.18",
+  "version": "0.0.3-beta.19",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {