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

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-cn/rules/)
+ *          WorkBuddy (.workbuddy/rules/)、TraeWork/TraeCode 中国版 (.trae/rules/，用户级 hook 在 ~/.trae-cn)
  *
  * 使用方式：
  *   npm install -g @jspg-ai/coding-bb  # 首次使用

package/cbb/lib/install/trae.js

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

package/cbb/lib/utils/gitignore.js

@@ -22,10 +22,10 @@ const GITIGNORE_RULES = [
   // .codebuddy：beta.15 及以前写入的旧目录，不再新增（add: null），但卸载/清理时仍移除其行
   { add: null, accept: ['.codebuddy', '.codebuddy/'] },
   { add: '.workbuddy', accept: ['.workbuddy', '.workbuddy/'] },
-  // .trae：beta.18 及以前（国际版）写入的旧目录，不再新增（add: null，目录可能为用户自建、不清理），
-  // 但卸载时仍移除其 gitignore 行
-  { add: null, accept: ['.trae', '.trae/'] },
-  { add: '.trae-cn', accept: ['.trae-cn', '.trae-cn/'] },
+  // .trae-cn：beta.19 误把中国版项目级目录当成 .trae-cn（实为用户级目录），beta.20 起不再新增，
+  // 但卸载/清理时仍移除其 gitignore 行
+  { add: null, accept: ['.trae-cn', '.trae-cn/'] },
+  { add: '.trae', accept: ['.trae', '.trae/'] },
 ];
 
 /** 将 .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-cn/` | 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.19",
+  "version": "0.0.3-beta.20",
   "description": "整合业界热门且高价值的工具、框架与技能，为 AI CODING AGENT 提供统一的行为准则与工作流，辅助开发者将需求高效落地为符合规范的代码",
   "main": "cbb/lib/install/init.js",
   "bin": {