@jspg-ai/coding-bb 0.0.1 → 0.0.2-beta.23

package/cbb/lib/install/opencode.js

@@ -0,0 +1,31 @@
+/**
+ * opencode 适配器
+ *
+ * 将编码规范分发到 .opencode/ 目录（opencode 项目级配置域）。
+ *
+ * 与 Claude Code / Qoder 的映射差异：
+ * - rules：opencode 无原生 rules 目录，部署到 .opencode/rules/ 并由安装流程
+ *   将 glob 注册进项目根 opencode.json 的 instructions 字段（官方支持的加载方式）
+ * - skills：.opencode/skills/<name>/SKILL.md，结构与 Claude 同构
+ * - commands：命令名 = 文件名（嵌套目录无命名空间，且 init.md 等会撞内置 /init），
+ *   因此扁平化为 opsx-<name>.md（/opsx-propose）；worktree 管理命令同理扁平化为
+ *   cbb-<name>.md（/cbb-worktree-init），部署副本中的 /opsx: 与 /cbb: 引用同步改写
+ * - hooks：opencode 无 UserPromptSubmit 等价事件，版本检查 hook 不安装（settingsFile 留空即跳过）
+ */
+
+module.exports = {
+  name: 'opencode',
+  displayName: 'opencode',
+  rulesDir: '.opencode/rules',
+  skillsDir: '.opencode/skills',
+  commandsDir: '.opencode/commands',
+  // 部署时给命令文件名加此前缀（规避内置命令名冲突）
+  commandPrefix: 'opsx-',
+  // worktree 管理命令（非 openspec 上游）落在同一扁平目录，用 cbb- 前缀区分
+  worktreeCommandsDir: '.opencode/commands',
+  worktreeCommandPrefix: 'cbb-',
+  // 部署副本中将该引用串改写为 opencode 的命令风格（配合 commandPrefix）
+  contentRewrites: [['/opsx:', '/opsx-'], ['/cbb:', '/cbb-']],
+  // rules 加载登记：注入项目根 opencode.json 的 instructions（glob，相对项目根）
+  instructionsPattern: '.opencode/rules/*.md',
+};

package/cbb/lib/install/qoder.js

@@ -13,6 +13,8 @@ module.exports = {
   rulesDir: '.qoder/rules',
   skillsDir: '.qoder/skills',
   commandsDir: '.qoder/commands/opsx',
+  // worktree 管理命令（非 openspec 上游）：独立命名空间 /cbb:worktree-*
+  worktreeCommandsDir: '.qoder/commands/cbb',
   // 用户级 settings，写入全局生效，不污染项目目录
   settingsFile: path.join(os.homedir(), '.qoder', 'settings.json'),
   settingsFileIsUserLevel: true,

package/cbb/lib/install/workspaces.js

@@ -15,7 +15,7 @@ const path = require('path');
 const { execSync } = require('child_process');
 
 const DEFAULT_CONFIG = 'config/workspaces.json';
-const SAMPLE_CONFIG  = 'config/config.sample.json';
+const SAMPLE_CONFIG  = 'config/workspace-config.sample.json';
 
 /**
  * 归一化 git remote URL：提取 "namespace/repo" 形式（去掉 .git 后缀）。
@@ -102,39 +102,40 @@ function loadWorkspaces(configPath = DEFAULT_CONFIG) {
 }
 
 /**
- * 校验业务工作空间 CONFIG.json 的格式是否合法。
+ * 校验业务工作空间 workspace-config.json 的格式是否合法。
  *
  * 校验项：
  *  - 文件存在且为合法 JSON
  *  - 含 apps 数组且非空
  *  - 每个 app 对象必须含 name / repo / side 三个字段
  *  - name、repo 为非空字符串；side 必须为 'front' 或 'back'
+ *  - desc 为可选字段；一旦出现必须是非空字符串（应用职责描述）
  *
- * @param {string} configPath CONFIG.json 的绝对路径
+ * @param {string} configPath workspace-config.json 的绝对路径
  * @returns {{ valid: boolean, message?: string, config?: object }}
  */
 function validateWorkspaceConfig(configPath) {
   if (!fs.existsSync(configPath)) {
-    return { valid: false, message: `CONFIG.json 不存在：${configPath}` };
+    return { valid: false, message: `workspace-config.json 不存在：${configPath}` };
   }
 
   let raw;
   try {
     raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
   } catch (e) {
-    return { valid: false, message: `CONFIG.json 不是合法 JSON：${e.message}` };
+    return { valid: false, message: `workspace-config.json 不是合法 JSON：${e.message}` };
   }
 
   if (!raw || typeof raw !== 'object') {
-    return { valid: false, message: 'CONFIG.json 内容应为 JSON 对象' };
+    return { valid: false, message: 'workspace-config.json 内容应为 JSON 对象' };
   }
 
   if (!Array.isArray(raw.apps)) {
-    return { valid: false, message: 'CONFIG.json 缺少 apps 数组' };
+    return { valid: false, message: 'workspace-config.json 缺少 apps 数组' };
   }
 
   if (raw.apps.length === 0) {
-    return { valid: false, message: 'CONFIG.json 中 apps 数组为空，请至少配置一个关联应用' };
+    return { valid: false, message: 'workspace-config.json 中 apps 数组为空，请至少配置一个关联应用' };
   }
 
   const VALID_SIDES = ['front', 'back'];
@@ -143,19 +144,22 @@ function validateWorkspaceConfig(configPath) {
     const label = `第 ${i + 1} 项`;
 
     if (!app || typeof app !== 'object') {
-      return { valid: false, message: `CONFIG.json ${label}不是对象` };
+      return { valid: false, message: `workspace-config.json ${label}不是对象` };
     }
     if (typeof app.name !== 'string' || !app.name.trim()) {
-      return { valid: false, message: `CONFIG.json ${label}缺少 name（应用名）` };
+      return { valid: false, message: `workspace-config.json ${label}缺少 name（应用名）` };
     }
     if (typeof app.repo !== 'string' || !app.repo.trim()) {
-      return { valid: false, message: `CONFIG.json "${app.name}" 缺少 repo（Git 仓库地址）` };
+      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 repo（Git 仓库地址）` };
     }
     if (typeof app.side !== 'string' || !app.side.trim()) {
-      return { valid: false, message: `CONFIG.json "${app.name}" 缺少 side（仓库类型，可选值：front / back）` };
+      return { valid: false, message: `workspace-config.json "${app.name}" 缺少 side（仓库类型，可选值：front / back）` };
     }
     if (!VALID_SIDES.includes(app.side.trim())) {
-      return { valid: false, message: `CONFIG.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back）` };
+      return { valid: false, message: `workspace-config.json "${app.name}" 的 side 字段值无效："${app.side}"（可选值：front / back）` };
+    }
+    if (app.desc !== undefined && (typeof app.desc !== 'string' || !app.desc.trim())) {
+      return { valid: false, message: `workspace-config.json "${app.name}" 的 desc 字段应为非空字符串（该应用的职责描述），不需要可整条删除` };
     }
   }
 
@@ -219,6 +223,39 @@ function extractRepoBasename(url) {
   return parts.length > 0 ? parts[parts.length - 1] : '';
 }
 
+/**
+ * 判断 repo 是否为样例占位地址（RFC 2606 保留域名）。
+ * 样例 workspace-config.json 的 repo 用 example.com 等占位，clone 必然失败；
+ * setup 据此逐条跳过空跑并给出明确编辑提示。
+ * 支持 SSH（git@host:path）与 URL（ssh://、https://、git://）两种形式的 host 提取。
+ *
+ * 注意：不含 `.localhost`——本地 Git 服务（`git@localhost:<ns>/<repo>.git`）是真实可用地址，
+ * 误判会导致正常应用的代码被跳过。
+ */
+const SAMPLE_HOST_RE = /(?:^|\.)(?:example\.(?:com|org|net)|test|invalid)$/i;
+
+function getRepoHost(repo) {
+  if (typeof repo !== 'string') return '';
+  let s = repo.trim().replace(/^[a-z]+:\/\//i, '');
+  const at = s.lastIndexOf('@');
+  if (at >= 0) s = s.slice(at + 1);
+  const m = s.match(/^[^:/]+/);
+  return m ? m[0].toLowerCase() : '';
+}
+
+function isSampleRepo(repo) {
+  const host = getRepoHost(repo);
+  return !!host && SAMPLE_HOST_RE.test(host);
+}
+
+/** 从 apps 数组中挑出占位条目，返回 [{ name, repo }]（非数组输入返回 []） */
+function findSampleApps(apps) {
+  if (!Array.isArray(apps)) return [];
+  return apps
+    .filter(a => a && typeof a === 'object' && isSampleRepo(a.repo))
+    .map(a => ({ name: a.name, repo: a.repo }));
+}
+
 module.exports = {
   DEFAULT_CONFIG,
   SAMPLE_CONFIG,
@@ -229,4 +266,7 @@ module.exports = {
   readGitRemotes,
   detectRepo,
   extractRepoBasename,
+  getRepoHost,
+  isSampleRepo,
+  findSampleApps,
 };

package/cbb/lib/openspec/index.js

@@ -5,7 +5,7 @@
  *
  * 负责从 GitHub (Fission-AI/OpenSpec) 拉取官方 workflow 模板,
  * 渲染并部署到本项目的 openspec/{commands,skills} 目录。
- * 提供 `cbb update --upstream-openspec` 选项。
+ * 提供 `cbbm update --upstream-openspec` 选项。
  *
  * 升级范围严格限定:只有 WORKFLOWS 白名单中的 commands/*.md 和
  * skills/<workflow>/SKILL.md 会被覆盖写入。config/openspec/（schemas + config.yaml）、
@@ -75,9 +75,9 @@ function assertSafeDestination(destPath, op) {
   for (const prefix of PROTECTED_PATH_PREFIXES) {
     if (abs === prefix || abs.startsWith(prefix + path.sep)) {
       throw new Error(
-        `[cbb update --upstream-openspec] ${op} 试图写入受保护路径: ${abs}\n` +
+        `[cbbm update --upstream-openspec] ${op} 试图写入受保护路径: ${abs}\n` +
         `命中前缀: ${prefix}\n` +
-        `该路径属于项目自有扩展位,绝对禁止被 cbb update --upstream-openspec 覆盖。\n` +
+        `该路径属于项目自有扩展位,绝对禁止被 cbbm update --upstream-openspec 覆盖。\n` +
         `详见 AGENTS.md「原生内容保护与扩展位」一节。`
       );
     }

package/cbb/lib/superpowers/index.js

@@ -4,7 +4,7 @@
  * Superpowers Skills 管理模块
  *
  * 负责从 GitHub (obra/superpowers) 下载 skills 并部署到本项目。
- * 提供 cbb update --upstream-superpowers 选项，以及 init 时的自动部署能力。
+ * 提供 cbbm update --upstream-superpowers 选项，以及 init 时的自动部署能力。
  */
 
 const fs = require('fs');

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

@@ -10,12 +10,16 @@
  */
 
 const fs = require('fs');
+const os = require('os');
 const path = require('path');
 
 // 共享版本工具（readInstalledVersion / fetchLatest / compareVersions / 常量）
 const versionUtil = require('./version');
 
-const CACHE_FILE = path.join('.cbb', '.update-check-cache.json');
+// 缓存提升到用户级：registry 最新版本号是全局属性（npm 全局包只有一个版本），
+// 团队多 workspace / 多 worktree 沙箱共享一份，每日真实请求一次；
+// 「本项目是否落后」仍按项目清单版本在本地判定。
+const CACHE_FILE = path.join(os.homedir(), '.cbb', '.update-check-cache.json');
 const CACHE_TTL = 24 * 60 * 60 * 1000;
 
 function getProjectDir() {
@@ -48,20 +52,18 @@ function readInstalledVersion(projectDir, adapterName) {
   }
 }
 
-function readCache(projectDir) {
-  const cachePath = path.join(projectDir, CACHE_FILE);
-  if (!fs.existsSync(cachePath)) return null;
+function readCache() {
+  if (!fs.existsSync(CACHE_FILE)) return null;
   try {
-    return JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+    return JSON.parse(fs.readFileSync(CACHE_FILE, 'utf-8'));
   } catch (_) {
     return null;
   }
 }
 
-function writeCache(projectDir, data) {
-  const cachePath = path.join(projectDir, CACHE_FILE);
-  fs.mkdirSync(path.dirname(cachePath), { recursive: true });
-  fs.writeFileSync(cachePath, JSON.stringify(data) + '\n');
+function writeCache(data) {
+  fs.mkdirSync(path.dirname(CACHE_FILE), { recursive: true });
+  fs.writeFileSync(CACHE_FILE, JSON.stringify(data) + '\n');
 }
 
 /** 读取 hook 传入的 stdin（session_id）；TTY 或异常返回空对象 */
@@ -104,7 +106,7 @@ async function main() {
   const isPrerelease = versionUtil.detectIsPrerelease(installed);
   const tag = isPrerelease ? 'beta' : 'latest';
   const now = Date.now();
-  let cache = readCache(projectDir) || {};
+  let cache = readCache() || {};
 
   // 决定最新版本：命中每日缓存且 tag 一致则复用，否则请求 registry
   let latest = cache.latest;
@@ -116,7 +118,7 @@ async function main() {
       return; // 网络失败静默
     }
     cache = { ...cache, lastCheck: now, latest, tag };
-    writeCache(projectDir, cache);
+    writeCache(cache);
   }
 
   if (!latest || versionUtil.compareVersions(latest, installed) <= 0) return; // 已是最新
@@ -125,8 +127,8 @@ async function main() {
 
   // Hook 调用（有 sessionId）：以 additionalContext 注入，由 AI 助手提醒用户
   if (sessionId) {
-    // 按适配器分别去重，同一会话同一适配器只提示一次
-    const notifiedKey = adapterName || '_default';
+    // 按「项目+适配器」分别去重，同一会话同一项目同一适配器只提示一次
+    const notifiedKey = `${projectDir}::${adapterName || '_default'}`;
     if (!cache.notifiedSessions) cache.notifiedSessions = {};
     if (cache.notifiedSessions[notifiedKey] === sessionId) return; // 本会话本适配器已提示过
     process.stdout.write(Buffer.from(JSON.stringify({
@@ -136,7 +138,7 @@ async function main() {
       },
     }) + '\n', 'utf8'));
     cache.notifiedSessions[notifiedKey] = sessionId;
-    writeCache(projectDir, cache);
+    writeCache(cache);
     return;
   }
 

package/cbb/lib/utils/gitignore.js

@@ -17,7 +17,8 @@ const GITIGNORE_RULES = [
   { add: '.claude', accept: ['.claude', '.claude/'] },
   { add: '.qoder', accept: ['.qoder', '.qoder/'] },
   { add: '.cbb/', accept: ['.cbb/'] },
-  { add: '.code/', accept: ['.code/', '.code'] },
+  { add: '.codespace/', accept: ['.codespace/', '.codespace'] },
+  { add: '.opencode', accept: ['.opencode', '.opencode/'] },
 ];
 
 /** 将 .gitignore 文本拆为行数组。 */

package/cbb/lib/utils/output.js

@@ -48,9 +48,94 @@ function section(icon, title) {
   console.log(c('gray', '─'.repeat(48)));
 }
 
-/** 以"label + value"两列对齐的方式输出一条字段记录 */
-function field(label, value, valueColor) {
-  console.log(`  ${c('gray', (label + ':').padEnd(8, ' '))} ${valueColor ? c(valueColor, value) : value}`);
+/** 视觉宽度：CJK / 全角字符按 2 列计，其余按 1 列（终端对齐用） */
+function visualWidth(text) {
+  let w = 0;
+  for (const ch of String(text)) {
+    const cp = ch.codePointAt(0);
+    const wide =
+      (cp >= 0x1100 && cp <= 0x115f) ||
+      cp === 0x2329 || cp === 0x232a ||
+      (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) ||
+      (cp >= 0xac00 && cp <= 0xd7a3) ||
+      (cp >= 0xf900 && cp <= 0xfaff) ||
+      (cp >= 0xfe30 && cp <= 0xfe6f) ||
+      (cp >= 0xff00 && cp <= 0xff60) ||
+      (cp >= 0xffe0 && cp <= 0xffe6);
+    w += wide ? 2 : 1;
+  }
+  return w;
+}
+
+/** 按视觉宽度右补空格（中文标签对齐用） */
+function padVisual(text, width) {
+  return text + ' '.repeat(Math.max(0, width - visualWidth(text)));
+}
+
+// 实时进度行的 spinner 帧（TTY 下循环播放，表示进程仍活着）
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+
+/**
+ * 长耗时步骤的单行实时进度：显示「正在做什么 + 已耗时」，避免看起来像卡死。
+ * TTY：spinner 原地刷新（\r + 清行）；非 TTY：内容变化时换行输出（CI 日志友好）。
+ * 结束时必须调用 done() 清掉本行，再由调用方补一条最终 step()。
+ * @param {string} label 步骤标签（与 step 同宽，如「应用」）
+ * @param {{stream?:NodeJS.WriteStream,indent?:number,labelWidth?:number,intervalMs?:number}} [opts]
+ * @returns {{update(text:string):void, done():void}}
+ */
+function progress(label, opts = {}) {
+  const { stream = process.stdout, indent = 2, labelWidth = 10, intervalMs = 80 } = opts;
+  const tty = stream.isTTY === true;
+  const startedAt = Date.now();
+  let frame = 0;
+  let text = '';
+  let timer = null;
+
+  const head = icon => ' '.repeat(indent) + c('cyan', icon) + ' ' + c('gray', padVisual(label, labelWidth));
+  const elapsed = () => Math.round((Date.now() - startedAt) / 1000);
+
+  const render = () => {
+    const sec = elapsed();
+    const value = sec > 0 ? `${text} ${c('gray', sec + 's')}` : text;
+    stream.write(`\r\x1b[2K${head(SPINNER_FRAMES[frame++ % SPINNER_FRAMES.length])} ${value}`);
+  };
+
+  return {
+    update(next) {
+      if (next === text) return;
+      text = next;
+      if (tty) {
+        render();
+        if (!timer) {
+          timer = setInterval(render, intervalMs);
+          if (timer.unref) timer.unref();
+        }
+      } else {
+        stream.write(`${head('·')} ${text}\n`);
+      }
+    },
+    done() {
+      if (timer) {
+        clearInterval(timer);
+        timer = null;
+      }
+      if (tty) stream.write('\r\x1b[2K');
+      text = '';
+    },
+  };
+}
+
+/**
+ * 缩进步进行：`  ✓ 标签    值`
+ * @param {string} icon 图标（✓ / ! / ✗ / ⏳ / ▸ …）
+ * @param {string} label 标签（中文；按视觉宽度对齐到 labelWidth）
+ * @param {string} [value] 值文本
+ * @param {{iconColor?:string,labelColor?:string,valueColor?:string,indent?:number,labelWidth?:number}} [opts]
+ */
+function step(icon, label, value = '', opts = {}) {
+  const { iconColor = 'green', labelColor = 'gray', valueColor = null, indent = 2, labelWidth = 10 } = opts;
+  const head = ' '.repeat(indent) + c(iconColor, icon) + ' ' + c(labelColor, padVisual(label, labelWidth));
+  console.log(value ? `${head} ${valueColor ? c(valueColor, value) : value}` : head);
 }
 
 module.exports = {
@@ -60,5 +145,8 @@ module.exports = {
   LOG_STYLES,
   log,
   section,
-  field,
+  visualWidth,
+  padVisual,
+  progress,
+  step,
 };

package/cbb/lib/utils/version.js

@@ -12,7 +12,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const http = require('http');
+const https = require('https');
 
 const PKG_NAME = '@jspg-ai/coding-bb';
 const REGISTRY = 'https://registry.npmjs.org';
@@ -41,7 +41,7 @@ function readInstalledVersion(projectDir) {
 function fetchLatest(tag) {
   return new Promise((resolve, reject) => {
     const url = `${REGISTRY}/${encodeURIComponent(PKG_NAME).replace('%2F', '/')}`;
-    const req = http.get(url, { timeout: REQUEST_TIMEOUT }, res => {
+    const req = https.get(url, { timeout: REQUEST_TIMEOUT }, res => {
       if (res.statusCode !== 200) { res.resume(); reject(new Error(`status ${res.statusCode}`)); return; }
       let body = '';
       res.setEncoding('utf-8');
@@ -94,34 +94,6 @@ function detectIsPrerelease(version) {
   return typeof version === 'string' && version.includes('-');
 }
 
-/**
- * 反查指定版本所属的 dist-tag：从 registry 获取全量 tag 映射，
- * 找到指向该版本的 tag 名称（如 zjc / beta / latest）。
- *  - 不依赖版本号格式，兼容任意 prerelease 命名
- *  - 网络失败 / 找不到 / 多个 tag 指向同一版本（选第一个）→ 返回 null，由调用方降级
- */
-function findTagForVersion(version) {
-  return new Promise((resolve, reject) => {
-    const url = `${REGISTRY}/${encodeURIComponent(PKG_NAME).replace('%2F', '/')}`;
-    const req = http.get(url, { timeout: REQUEST_TIMEOUT }, res => {
-      if (res.statusCode !== 200) { res.resume(); reject(new Error(`status ${res.statusCode}`)); return; }
-      let body = '';
-      res.setEncoding('utf-8');
-      res.on('data', chunk => { body += chunk; });
-      res.on('end', () => {
-        try {
-          const distTags = JSON.parse(body)['dist-tags'] || {};
-          // 找到指向目标版本的 tag（取第一个，避免重复）
-          const found = Object.keys(distTags).find(k => distTags[k] === version);
-          resolve(found || null);
-        } catch (err) { reject(err); }
-      });
-    });
-    req.on('timeout', () => req.destroy(new Error('timeout')));
-    req.on('error', reject);
-  });
-}
-
 module.exports = {
   PKG_NAME,
   REGISTRY,
@@ -131,5 +103,4 @@ module.exports = {
   fetchLatest,
   compareVersions,
   detectIsPrerelease,
-  findTagForVersion,
 };

package/cbb/lib/wiki/cli.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 
 /**
- * cbb wiki 子命令 — Wiki 查询与管理。
+ * cbbm wiki 子命令 — Wiki 查询与管理。
  *
  * 用法:
- *   cbb wiki get <pageId> [--expand=...] [--full]
- *   cbb wiki children <pageId> [--limit=50] [--start=0]
- *   cbb wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]
- *   cbb wiki spaces [--limit=100] [--type=global]
- *   cbb wiki comments <pageId> [--limit=50]
- *   cbb wiki user [--current] [--account-id=<id>] [--username=<name>]
- *   cbb wiki versions <pageId> [--limit=20]
- *   cbb wiki attachments <pageId> list [--limit=50]
- *   cbb wiki attachments <pageId> upload --file=<path> [--comment="..."]
- *   cbb wiki attachments <pageId> delete --attachment-id=<id>
- *   cbb wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]
+ *   cbbm wiki get <pageId> [--expand=...] [--full]
+ *   cbbm wiki children <pageId> [--limit=50] [--start=0]
+ *   cbbm wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]
+ *   cbbm wiki spaces [--limit=100] [--type=global]
+ *   cbbm wiki comments <pageId> [--limit=50]
+ *   cbbm wiki user [--current] [--account-id=<id>] [--username=<name>]
+ *   cbbm wiki versions <pageId> [--limit=20]
+ *   cbbm wiki attachments <pageId> list [--limit=50]
+ *   cbbm wiki attachments <pageId> upload --file=<path> [--comment="..."]
+ *   cbbm wiki attachments <pageId> delete --attachment-id=<id>
+ *   cbbm wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]
  */
 
 const fs = require('fs');
@@ -79,7 +79,7 @@ function parseArgs(argv) {
 }
 
 function showHelp() {
-  out(`cbb wiki — Wiki 操作（查询 + 发布 + 管理）
+  out(`cbbm wiki — Wiki 操作（查询 + 发布 + 管理）
 
 参数格式：
   本工具同时支持两种写法，请按习惯任选其一：
@@ -104,9 +104,9 @@ function showHelp() {
   comment <pageId> --body-file=<path>                   创建评论
 
 示例：
-  cbb wiki create --parent-id 123456 --title "方案" --file design.md
-  cbb wiki get 123456 --full
-  cbb wiki search 'type=page AND title~"freight"'
+  cbbm wiki create --parent-id 123456 --title "方案" --file design.md
+  cbbm wiki get 123456 --full
+  cbbm wiki search 'type=page AND title~"freight"'
 
 认证：环境变量 CBB_WIKI_EMAIL + CBB_WIKI_TOKEN，或 ~/.cbb/wiki-config.json
       令牌获取: https://wiki.amh-group.com/plugins/tokens/view.action`);
@@ -115,7 +115,7 @@ function showHelp() {
 // ── 子命令实现 ────────────────────────────────────────
 
 async function cmdGet({ pos, opts }) {
-  if (!pos[0]) { err('用法: cbb wiki get <pageId> [--expand=...] [--full]'); process.exit(1); }
+  if (!pos[0]) { err('用法: cbbm wiki get <pageId> [--expand=...] [--full]'); process.exit(1); }
   const result = await api.getPage(pos[0], { includeBody: opts.full });
   if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
 
@@ -141,7 +141,7 @@ async function cmdGet({ pos, opts }) {
 }
 
 async function cmdChildren({ pos, opts }) {
-  if (!pos[0]) { err('用法: cbb wiki children <pageId> [--limit=50] [--start=0]'); process.exit(1); }
+  if (!pos[0]) { err('用法: cbbm wiki children <pageId> [--limit=50] [--start=0]'); process.exit(1); }
   const result = await api.getChildren(pos[0], { limit: Number(opts.limit) || 50, start: Number(opts.start) || 0 });
   if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
 
@@ -162,7 +162,7 @@ async function cmdChildren({ pos, opts }) {
 }
 
 async function cmdSearch({ pos, opts }) {
-  if (!pos[0]) { err('用法: cbb wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]'); process.exit(1); }
+  if (!pos[0]) { err('用法: cbbm wiki search "<cql>" [--limit=20] [--excerpt=highlight] [--order=lastmodified desc]'); process.exit(1); }
   const result = await api.search(pos[0], {
     limit: Number(opts.limit) || 20,
     excerpt: opts.excerpt,
@@ -204,7 +204,7 @@ async function cmdSpaces({ opts }) {
 }
 
 async function cmdComments({ pos, opts }) {
-  if (!pos[0]) { err('用法: cbb wiki comments <pageId> [--limit=50]'); process.exit(1); }
+  if (!pos[0]) { err('用法: cbbm wiki comments <pageId> [--limit=50]'); process.exit(1); }
   const result = await api.getComments(pos[0], { limit: Number(opts.limit) || 50 });
   if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
 
@@ -246,7 +246,7 @@ async function cmdUser({ opts }) {
 }
 
 async function cmdVersions({ pos, opts }) {
-  if (!pos[0]) { err('用法: cbb wiki versions <pageId> [--limit=20]'); process.exit(1); }
+  if (!pos[0]) { err('用法: cbbm wiki versions <pageId> [--limit=20]'); process.exit(1); }
   const result = await api.getVersions(pos[0], { limit: Number(opts.limit) || 20 });
   if (!result.success) { err(`获取失败: ${result.error}`); process.exit(1); }
 
@@ -267,7 +267,7 @@ async function cmdVersions({ pos, opts }) {
 }
 
 async function cmdAttachments({ pos, opts }) {
-  if (!pos[0] || !pos[1]) { err('用法: cbb wiki attachments <pageId> <list|upload|delete> [选项]'); process.exit(1); }
+  if (!pos[0] || !pos[1]) { err('用法: cbbm wiki attachments <pageId> <list|upload|delete> [选项]'); process.exit(1); }
   const pageId = pos[0];
   const action = pos[1];
 
@@ -320,7 +320,7 @@ async function cmdAttachments({ pos, opts }) {
 
 async function cmdComment({ pos, opts }) {
   if (!pos[0] || !opts['body-file']) {
-    err('用法: cbb wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]');
+    err('用法: cbbm wiki comment <pageId> --body-file=<path> [--parent=<parentCommentId>]');
     process.exit(1);
   }
   const body = fs.readFileSync(opts['body-file'], 'utf8');
@@ -347,7 +347,7 @@ function readAndConvert(filePath) {
 
 async function cmdCreate({ pos, opts }) {
   if (!opts['parent-id'] || !opts.title || !opts.file) {
-    err('用法: cbb wiki create --parent-id <id> --title "..." --file <md>');
+    err('用法: cbbm wiki create --parent-id <id> --title "..." --file <md>');
     process.exit(1);
   }
   const xhtml = readAndConvert(opts.file);
@@ -369,7 +369,7 @@ async function cmdCreate({ pos, opts }) {
 
 async function cmdUpdate({ pos, opts }) {
   if (!opts['page-id'] || !opts.file) {
-    err('用法: cbb wiki update --page-id <id> --file <md>');
+    err('用法: cbbm wiki update --page-id <id> --file <md>');
     process.exit(1);
   }
   const xhtml = readAndConvert(opts.file);