@sfmc-bds/cli 0.2.0-beta.8 → 0.2.0

package/README.md

@@ -5,18 +5,17 @@ SFMC 管理 CLI：REPL、服务启停、模块安装、行为包 build/deploy。
 ## 安装
 
 ```bash
-npm install -g @sfmc-bds/cli
-# 或
-npx @sfmc-bds/cli status
+pnpm add -g @sfmc-bds/cli
+pnpm dlx @sfmc-bds/cli status
 ```
 
 服主推荐：
 
 ```bash
-npm install -g @sfmc-bds/sfmc
+pnpm add -g @sfmc-bds/sfmc
 ```
 
-仅 CLI（不含后端服务）仍可用 `npm install -g @sfmc-bds/cli`，完整平台请装聚合包。
+仅 CLI（不含后端服务）可用 `pnpm add -g @sfmc-bds/cli`，完整平台请装聚合包。
 
 ## 依赖
 

package/dist/bds-runtime-version.d.ts

@@ -0,0 +1,3 @@
+/** 仅接受 BDS 启动阶段版本行，避免普通游戏日志被误当作版本。 */
+export declare function recordBdsVersion(root: string, line: string, pid: number, startedAt: number): void;
+//# sourceMappingURL=bds-runtime-version.d.ts.map

package/dist/bds-runtime-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bds-runtime-version.d.ts","sourceRoot":"","sources":["../src/bds-runtime-version.ts"],"names":[],"mappings":"AAGA,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CASjG"}

package/dist/bds-runtime-version.js

@@ -0,0 +1,15 @@
+import { stateDir, writeJson } from "@sfmc-bds/sdk/node/config";
+import path from "node:path";
+function recordBdsVersion(root, line, pid, startedAt) {
+  if (!pid || Date.now() - startedAt > 6e4) return;
+  const match = /^(?:\[(?!Scripting\b)[^\]\r\n]*\]\s*)?Version:\s*(\d+\.\d+\.\d+(?:\.\d+)?)(?:\s|$)/.exec(line.trim());
+  if (!match) return;
+  try {
+    writeJson(path.join(stateDir(root), "bds-runtime-version.json"), { pid, startedAt, version: match[1] });
+  } catch {
+  }
+}
+export {
+  recordBdsVersion
+};
+//# sourceMappingURL=bds-runtime-version.js.map

package/dist/bds-runtime-version.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/bds-runtime-version.ts"],
+  "sourcesContent": ["import { stateDir, writeJson } from \"@sfmc-bds/sdk/node/config\";\nimport path from \"node:path\";\n\n/** \u4EC5\u63A5\u53D7 BDS \u542F\u52A8\u9636\u6BB5\u7248\u672C\u884C\uFF0C\u907F\u514D\u666E\u901A\u6E38\u620F\u65E5\u5FD7\u88AB\u8BEF\u5F53\u4F5C\u7248\u672C\u3002 */\nexport function recordBdsVersion(root: string, line: string, pid: number, startedAt: number): void {\n  if (!pid || Date.now() - startedAt > 60_000) return;\n  const match = /^(?:\\[(?!Scripting\\b)[^\\]\\r\\n]*\\]\\s*)?Version:\\s*(\\d+\\.\\d+\\.\\d+(?:\\.\\d+)?)(?:\\s|$)/.exec(line.trim());\n  if (!match) return;\n  try {\n    writeJson(path.join(stateDir(root), \"bds-runtime-version.json\"), { pid, startedAt, version: match[1] });\n  } catch {\n    /* \u7248\u672C\u91C7\u96C6\u5931\u8D25\u4E0D\u5F71\u54CD\u670D\u52A1\u8FDB\u7A0B\u3002 */\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,UAAU,iBAAiB;AACpC,OAAO,UAAU;AAGV,SAAS,iBAAiB,MAAc,MAAc,KAAa,WAAyB;AACjG,MAAI,CAAC,OAAO,KAAK,IAAI,IAAI,YAAY,IAAQ;AAC7C,QAAM,QAAQ,qFAAqF,KAAK,KAAK,KAAK,CAAC;AACnH,MAAI,CAAC,MAAO;AACZ,MAAI;AACF,cAAU,KAAK,KAAK,SAAS,IAAI,GAAG,0BAA0B,GAAG,EAAE,KAAK,WAAW,SAAS,MAAM,CAAC,EAAE,CAAC;AAAA,EACxG,QAAQ;AAAA,EAER;AACF;",
+  "names": []
+}

package/dist/command-surface.js

@@ -94,8 +94,8 @@ const TOP_DESC = {
   init: "help.init",
   update: "help.update",
   locale: "help.locale",
-  remote: "help.remote.status",
   debug: "help.debug.status",
+  ui: "help.ui",
   install: "help.module.install",
   uninstall: "help.module.uninstall",
   search: "help.module.search",
@@ -151,7 +151,7 @@ function moduleChildNodes(mode) {
   });
 }
 function packsChildNodes(mode) {
-  const noArg = /* @__PURE__ */ new Set(["list", "doctor", "path", "sources"]);
+  const noArg = /* @__PURE__ */ new Set(["list", "path", "sources"]);
   return listVisiblePacksSubs(mode).map((sub) => ({
     label: sub,
     token: sub,
@@ -230,8 +230,8 @@ const COMMAND_SPECS = [
   { id: "init", name: "init", channel: "both", needsTty: true },
   { id: "update", name: "update", channel: "both" },
   { id: "locale", name: "locale", channel: "both" },
-  { id: "remote", name: "remote", channel: "both" },
   { id: "debug", name: "debug", channel: "both", accent: "dev" },
+  { id: "ui", name: "ui", channel: "both", accent: "dev" },
   /** 顶层扁平短命令 → module.*（少写一层 module） */
   { id: "install", name: "install", channel: "both" },
   { id: "uninstall", name: "uninstall", channel: "both", aliases: ["remove"] },

package/dist/command-surface.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/command-surface.ts"],
-  "sourcesContent": ["/**\n * command-surface.ts \u2014 sfmc CLI \u547D\u4EE4\u901A\u9053\u6CE8\u518C\u8868\uFF08\u5355\u4E00\u6743\u5A01\uFF09\n *\n * channel:\n *   - both: argv\uFF08`sfmc <cmd>`\uFF09\u4E0E REPL \u5747\u53EF\u7528\uFF08\u9ED8\u8BA4\uFF09\n *   - repl: \u4EC5 REPL\uFF1Bargv \u62D2\u7EDD\uFF08\u5982 send / quit\uFF09\n *\n * accent: \"dev\" \u4EC5\u5F71\u54CD\u5E2E\u52A9/\u8865\u5168\u84DD\u8272\u6837\u5F0F\uFF0C\u4E0D\u53C2\u4E0E canRun\uFF08OCP/DRY\uFF09\u3002\n * \u4E1A\u52A1\u5B9E\u73B0\u4E0D\u5728\u672C\u6587\u4EF6 / \u9762\u677F\u5185\uFF1A\u5206\u53D1\u5230 commands\u3001module-commands\u3001world-packs \u7B49\u3002\n */\nimport { stdin } from \"node:process\";\n\nexport type CommandChannel = \"repl\" | \"both\";\nexport type CommandMode = \"argv\" | \"repl\";\nexport type CommandAccent = \"dev\";\n\nexport type CommandSpec = {\n  /** \u7A33\u5B9A id\uFF0C\u5982 \"module.install\" / \"send\" / \"debug\" */\n  id: string;\n  /** \u9876\u5C42\u547D\u4EE4\u540D\uFF08module \u5B50\u547D\u4EE4\u7528 \"module\"\uFF1B\u9876\u5C42\u522B\u540D\u89C1 TOP_LEVEL_ALIASES\uFF09 */\n  name: string;\n  /** \u5B50\u547D\u4EE4\uFF08\u4EC5 module/packs \u7B49\uFF09 */\n  sub?: string;\n  channel: CommandChannel;\n  needsTty?: boolean;\n  /** \u5E2E\u52A9\u67D3\u8272\uFF1B\u4E0D\u53C2\u4E0E canRun */\n  accent?: CommandAccent;\n  /** \u5B50\u547D\u4EE4\u540C\u4E49\u522B\u540D\uFF08\u5982 uninstall \u2192 remove\uFF09\uFF0C\u4E0D\u662F\u9876\u5C42\u522B\u540D */\n  aliases?: string[];\n};\n\nexport type CanRunContext = {\n  mode: CommandMode;\n  isTty: boolean;\n};\n\nexport type CanRunFailReason = \"replOnly\" | \"needTty\";\n\nexport type CanRunResult = { ok: true } | { ok: false; reason: CanRunFailReason };\n\n/** \u9876\u5C42\u547D\u4EE4\u522B\u540D \u2192 \u89C4\u8303 name\uFF08DRY\uFF1A\u52FF\u5728\u5404 sub spec \u91CD\u590D\u5199 mod/addon\uFF09 */\nexport const TOP_LEVEL_ALIASES: Readonly<Record<string, string>> = {\n  mod: \"module\",\n  addon: \"packs\",\n  log: \"logs\",\n  lang: \"locale\",\n  h: \"help\",\n  \"?\": \"help\",\n  exit: \"quit\",\n  q: \"quit\",\n  i: \"install\",\n  remove: \"uninstall\",\n};\n\n/**\n * \u9876\u5C42\u6241\u5E73\u77ED\u547D\u4EE4 \u2192 module \u5B50\u547D\u4EE4\uFF08argv / REPL \u5171\u7528\uFF0C\u907F\u514D\u5728 switch \u91CC\u6563\u843D\u6620\u5C04\uFF09\n * \u4E0D\u542B enable/disable\uFF08\u4E0E packs \u51B2\u7A81\uFF0C\u4ECD\u8D70 /module \u6216 /packs\uFF09\n *\n * \u4E0E packs \u5B50\u547D\u4EE4\u5BF9\u9F50\uFF1A`packs i` \u2192 `packs install`\uFF08mapPacksSubAlias\uFF09\uFF1B\n * module \u9876\u5C42\u540C\u6837\u652F\u6301 `i` \u2192 `install`\uFF08\u89C1 TOP_LEVEL_ALIASES \u4E0E\u672C\u8868\uFF09\u3002\n */\nexport const MODULE_TOP_SHORTHAND: Readonly<Record<string, string>> = {\n  i: \"install\",\n  install: \"install\",\n  uninstall: \"uninstall\",\n  search: \"search\",\n  verify: \"verify\",\n};\n\nexport function resolveModuleTopShorthand(cmd: string | undefined): string | undefined {\n  if (!cmd) return undefined;\n  const name = resolveTopLevelName(cmd);\n  if (!name) return undefined;\n  return MODULE_TOP_SHORTHAND[name];\n}\n\nexport function resolveTopLevelName(cmd: string | undefined): string | undefined {\n  if (!cmd) return undefined;\n  return TOP_LEVEL_ALIASES[cmd] ?? cmd;\n}\n\nfunction channelAllows(channel: CommandChannel, mode: CommandMode): boolean {\n  if (channel === \"both\") return true;\n  return mode === \"repl\";\n}\n\n/** \u5224\u5B9A\u5F53\u524D\u6A21\u5F0F\u4E0B\u80FD\u5426\u6267\u884C\u8BE5\u547D\u4EE4\uFF08accent \u4E0D\u53C2\u4E0E\uFF09\u3002 */\nexport function canRunCommand(spec: CommandSpec, ctx: CanRunContext): CanRunResult {\n  if (!channelAllows(spec.channel, ctx.mode)) {\n    return { ok: false, reason: \"replOnly\" };\n  }\n  if (spec.needsTty && !ctx.isTty) {\n    return { ok: false, reason: \"needTty\" };\n  }\n  return { ok: true };\n}\n\n/** \u5F53\u524D\u6A21\u5F0F\u53EF\u89C1\u547D\u4EE4\uFF08help / Tab\uFF09\u3002 */\nexport function listVisibleCommands(mode: CommandMode): CommandSpec[] {\n  return COMMAND_SPECS.filter((s) => channelAllows(s.channel, mode));\n}\n\n/** \u9876\u5C42\u547D\u4EE4\u540D\uFF08\u542B\u522B\u540D\uFF09\uFF0C\u4F9B REPL COMMANDS / \u8865\u5168\u3002 */\nexport function listVisibleTopLevelNames(mode: CommandMode): string[] {\n  const canonical = new Set<string>();\n  for (const s of listVisibleCommands(mode)) {\n    canonical.add(s.name);\n  }\n  const out = new Set<string>(canonical);\n  for (const [alias, name] of Object.entries(TOP_LEVEL_ALIASES)) {\n    if (canonical.has(name)) out.add(alias);\n  }\n  return [...out];\n}\n\n/** \u67E5\u627E\u9876\u5C42\u547D\u4EE4\uFF08\u65E0 sub\uFF09\u7684\u4EFB\u610F\u4E00\u6761\u540C\u540D spec\uFF08\u7528\u4E8E channel \u95E8\u7981\uFF09\u3002 */\nexport function findTopLevelSpec(cmd: string | undefined): CommandSpec | undefined {\n  const name = resolveTopLevelName(cmd);\n  if (!name) return undefined;\n  /* \u4F18\u5148\u65E0 sub \u7684\u9876\u5C42\u6761\u76EE\uFF1B\u5426\u5219\u53D6\u8BE5 name \u4E0B\u4EFB\u610F\u53EF\u89C1 spec \u4EE3\u8868\u901A\u9053\uFF08module/packs\uFF09 */\n  const top = COMMAND_SPECS.find((s) => !s.sub && s.name === name);\n  if (top) return top;\n  return COMMAND_SPECS.find((s) => s.name === name);\n}\n\n/** \u67E5\u627E module \u5B50\u547D\u4EE4 spec\u3002 */\nexport function findModuleSubSpec(sub: string | undefined): CommandSpec | undefined {\n  if (!sub) return undefined;\n  return COMMAND_SPECS.find(\n    (s) => s.name === \"module\" && (s.sub === sub || (s.aliases ?? []).includes(sub))\n  );\n}\n\n/** \u67E5\u627E packs \u5B50\u547D\u4EE4 spec\u3002 */\nexport function findPacksSubSpec(sub: string | undefined): CommandSpec | undefined {\n  if (!sub) return undefined;\n  return COMMAND_SPECS.find(\n    (s) => s.name === \"packs\" && (s.sub === sub || (s.aliases ?? []).includes(sub))\n  );\n}\n\n/** \u5F53\u524D mode \u4E0B\u53EF\u89C1\u7684 module \u5B50\u547D\u4EE4\u540D\uFF08\u89C4\u8303\u540D\uFF0C\u4E0D\u542B remove \u522B\u540D\uFF09\u3002 */\nexport function listVisibleModuleSubs(mode: CommandMode): string[] {\n  return listVisibleCommands(mode)\n    .filter((s) => s.name === \"module\" && s.sub)\n    .map((s) => s.sub!);\n}\n\n/** \u5F53\u524D mode \u4E0B\u53EF\u89C1\u7684 packs \u5B50\u547D\u4EE4\u540D\u3002 */\nexport function listVisiblePacksSubs(mode: CommandMode): string[] {\n  return listVisibleCommands(mode)\n    .filter((s) => s.name === \"packs\" && s.sub)\n    .map((s) => s.sub!);\n}\n\n/** REPL \u5FEB\u901F\u8865\u5168\uFF1A\u5C42\u7EA7\u8282\u70B9\uFF08\u4E3B\u9762\u677F \u2192 \u53F3\u4FA7\u5B50\u9762\u677F\uFF09 */\nexport type PaletteNode = {\n  /** \u9762\u677F\u5185\u663E\u793A\u7684\u6807\u7B7E */\n  label: string;\n  /** \u8FFD\u52A0\u5230\u547D\u4EE4\u884C\u7684 token\uFF08\u6839\u8282\u70B9\u542B\u6216\u4E0D\u542B\u524D\u5BFC\u903B\u8F91\u7531\u7EC4\u88C5\u8D1F\u8D23\uFF09 */\n  token: string;\n  /** i18n \u63CF\u8FF0\u952E */\n  descKey?: string;\n  accent?: CommandAccent;\n  /** \u56FA\u5B9A\u4E0B\u4E00\u53C2\u9009\u9879\uFF1B\u56DE\u8F66\u540E\u5728\u53F3\u4FA7\u5C55\u5F00 */\n  children?: PaletteNode[];\n  /** \u65E0 children \u65F6\u4ECD\u9700\u81EA\u7531\u8F93\u5165\uFF08\u56DE\u8F66\u540E\u586B\u5165\u7A7A\u683C\u7EE7\u7EED\u6253\u5B57\uFF09 */\n  freeArgs?: boolean;\n};\n\nconst NO_ARG_TOP = new Set([\"status\", \"help\", \"version\", \"quit\", \"init\", \"logs\"]);\n\nconst TOP_DESC: Record<string, string> = {\n  status: \"help.status\",\n  logs: \"help.logs\",\n  start: \"help.start\",\n  stop: \"help.stop\",\n  restart: \"help.restart\",\n  send: \"help.send\",\n  help: \"help.help\",\n  version: \"help.version\",\n  quit: \"help.quit\",\n  init: \"help.init\",\n  update: \"help.update\",\n  locale: \"help.locale\",\n  remote: \"help.remote.status\",\n  debug: \"help.debug.status\",\n  install: \"help.module.install\",\n  uninstall: \"help.module.uninstall\",\n  search: \"help.module.search\",\n  verify: \"help.module.verify\",\n};\n\nconst MODULE_DESC: Record<string, string> = {\n  list: \"help.module.list\",\n  info: \"help.module.info\",\n  build: \"help.module.build\",\n  reload: \"help.module.reload\",\n  search: \"help.module.search\",\n  install: \"help.module.install\",\n  uninstall: \"help.module.uninstall\",\n  verify: \"help.module.verify\",\n  enable: \"help.module.toggle\",\n  disable: \"help.module.toggle\",\n};\n\nconst PACKS_DESC: Record<string, string> = {\n  list: \"help.packs.list\",\n  search: \"help.packs.search\",\n  enable: \"help.packs.enable\",\n  disable: \"help.packs.disable\",\n  doctor: \"help.packs.doctor\",\n  path: \"help.packs.path\",\n  install: \"help.addon\",\n  scan: \"help.addon\",\n  uninstall: \"help.addon\",\n  bind: \"help.addon\",\n  unbind: \"help.addon\",\n  sources: \"help.addon\",\n  check: \"help.addon\",\n  update: \"help.addon\",\n  bump: \"help.addon\",\n};\n\nfunction serviceArgNodes(): PaletteNode[] {\n  return [\n    { label: \"-all\", token: \"-all\" },\n    ...([\"bds\", \"db\", \"qq\", \"llbot\"] as const).map((n) => ({ label: n, token: n })),\n  ];\n}\n\nfunction moduleChildNodes(mode: CommandMode): PaletteNode[] {\n  const noArg = new Set([\"list\", \"build\"]);\n  return listVisibleModuleSubs(mode).map((sub) => {\n    const spec = findModuleSubSpec(sub);\n    const node: PaletteNode = {\n      label: sub,\n      token: sub,\n      descKey: MODULE_DESC[sub] ?? \"help.module.list\",\n      freeArgs: !noArg.has(sub),\n    };\n    if (spec?.accent) node.accent = spec.accent;\n    return node;\n  });\n}\n\nfunction packsChildNodes(mode: CommandMode): PaletteNode[] {\n  const noArg = new Set([\"list\", \"doctor\", \"path\", \"sources\"]);\n  return listVisiblePacksSubs(mode).map((sub) => ({\n    label: sub,\n    token: sub,\n    descKey: PACKS_DESC[sub] ?? \"help.addon\",\n    freeArgs: !noArg.has(sub),\n  }));\n}\n\n/** \u5C42\u7EA7\u547D\u4EE4\u6811\uFF08REPL \u9762\u677F\u4E3B\u5217\uFF09 */\nexport function listPaletteRoots(mode: CommandMode = \"repl\"): PaletteNode[] {\n  const specs = listVisibleCommands(mode);\n  const out: PaletteNode[] = [];\n  const seen = new Set<string>();\n  /** \u9762\u677F\u4E0D\u5C55\u793A\u9876\u5C42\u77ED\u547D\u4EE4\uFF0C\u7EDF\u4E00\u8D70 /module <sub>\uFF08argv \u77ED\u547D\u4EE4\u4ECD\u53EF\u7528\uFF09 */\n  const skipTopShorthand = new Set(Object.keys(MODULE_TOP_SHORTHAND));\n\n  for (const s of specs) {\n    if (s.sub) continue;\n    if (s.name === \"module\" || s.name === \"packs\") continue;\n    if (skipTopShorthand.has(s.name)) continue;\n    if (seen.has(s.name)) continue;\n    seen.add(s.name);\n\n    const node: PaletteNode = {\n      label: `/${s.name}`,\n      token: s.name,\n      descKey: TOP_DESC[s.name] ?? \"help.help\",\n    };\n    if (s.accent) node.accent = s.accent;\n\n    if (s.name === \"start\" || s.name === \"stop\" || s.name === \"restart\") {\n      node.children = serviceArgNodes();\n    } else if (s.name === \"send\") {\n      node.children = ([\"bds\", \"db\", \"qq\", \"llbot\"] as const).map((n) => ({\n        label: n,\n        token: n,\n        freeArgs: true,\n      }));\n    } else if (!NO_ARG_TOP.has(s.name)) {\n      node.freeArgs = true;\n    }\n\n    out.push(node);\n  }\n\n  const moduleSubs = moduleChildNodes(mode);\n  if (moduleSubs.length > 0) {\n    out.push({\n      label: \"/module\",\n      token: \"module\",\n      descKey: \"help.module.list\",\n      children: moduleSubs,\n    });\n  }\n\n  const packsSubs = packsChildNodes(mode);\n  if (packsSubs.length > 0) {\n    out.push({\n      label: \"/packs\",\n      token: \"packs\",\n      descKey: \"help.addon\",\n      children: packsSubs,\n    });\n  }\n\n  return out;\n}\n\nexport function isDevAccent(spec: CommandSpec | undefined): boolean {\n  return spec?.accent === \"dev\";\n}\n\n/** sub \u662F\u5426\u4E3A\u5F00\u53D1\u8005\u6837\u5F0F\u547D\u4EE4\uFF08\u84DD\u6807\uFF09\u3002 */\nexport function isDevAccentModuleSub(sub: string | undefined): boolean {\n  return isDevAccent(findModuleSubSpec(sub));\n}\n\n/** stdin TTY \u63A2\u6D4B\uFF08\u4F9B main/repl \u5171\u7528\uFF09\u3002 */\nexport function isCliTty(): boolean {\n  return Boolean(stdin.isTTY);\n}\n\n/**\n * \u547D\u4EE4\u6CE8\u518C\u8868 \u2014\u2014 \u65B0\u589E\u547D\u4EE4\u53EA\u52A0\u6B64\u5904\uFF08OCP\uFF09\u3002\n * channel:\n *   - both: argv + REPL\uFF08\u9ED8\u8BA4\uFF1B\u9762\u677F\u53EA\u8C03\u5EA6\u65E2\u6709 dispatcher\uFF09\n *   - repl: \u4EC5 REPL\uFF08\u5982 send / quit\uFF09\n */\nexport const COMMAND_SPECS: readonly CommandSpec[] = [\n  /* \u2500\u2500\u2500 both\uFF1A\u670D\u52A1 / \u6A21\u5757 / \u8D44\u6E90\u5305 / \u914D\u7F6E \u2500\u2500\u2500 */\n  { id: \"status\", name: \"status\", channel: \"both\" },\n  { id: \"start\", name: \"start\", channel: \"both\" },\n  { id: \"stop\", name: \"stop\", channel: \"both\" },\n  { id: \"restart\", name: \"restart\", channel: \"both\" },\n  { id: \"logs\", name: \"logs\", channel: \"repl\" },\n  { id: \"help\", name: \"help\", channel: \"both\" },\n  { id: \"version\", name: \"version\", channel: \"both\" },\n  { id: \"init\", name: \"init\", channel: \"both\", needsTty: true },\n  { id: \"update\", name: \"update\", channel: \"both\" },\n  { id: \"locale\", name: \"locale\", channel: \"both\" },\n  { id: \"remote\", name: \"remote\", channel: \"both\" },\n  { id: \"debug\", name: \"debug\", channel: \"both\", accent: \"dev\" },\n\n  /** \u9876\u5C42\u6241\u5E73\u77ED\u547D\u4EE4 \u2192 module.*\uFF08\u5C11\u5199\u4E00\u5C42 module\uFF09 */\n  { id: \"install\", name: \"install\", channel: \"both\" },\n  { id: \"uninstall\", name: \"uninstall\", channel: \"both\", aliases: [\"remove\"] },\n  { id: \"search\", name: \"search\", channel: \"both\" },\n  { id: \"verify\", name: \"verify\", channel: \"both\" },\n\n  { id: \"module.list\", name: \"module\", sub: \"list\", channel: \"both\" },\n  { id: \"module.info\", name: \"module\", sub: \"info\", channel: \"both\" },\n  { id: \"module.build\", name: \"module\", sub: \"build\", channel: \"both\", accent: \"dev\" },\n  { id: \"module.reload\", name: \"module\", sub: \"reload\", channel: \"both\", accent: \"dev\" },\n  { id: \"module.install\", name: \"module\", sub: \"install\", channel: \"both\" },\n  {\n    id: \"module.uninstall\",\n    name: \"module\",\n    sub: \"uninstall\",\n    channel: \"both\",\n    aliases: [\"remove\"],\n  },\n  { id: \"module.search\", name: \"module\", sub: \"search\", channel: \"both\" },\n  { id: \"module.verify\", name: \"module\", sub: \"verify\", channel: \"both\" },\n  { id: \"module.enable\", name: \"module\", sub: \"enable\", channel: \"both\" },\n  { id: \"module.disable\", name: \"module\", sub: \"disable\", channel: \"both\" },\n\n  { id: \"packs.list\", name: \"packs\", sub: \"list\", channel: \"both\" },\n  { id: \"packs.search\", name: \"packs\", sub: \"search\", channel: \"both\" },\n  { id: \"packs.enable\", name: \"packs\", sub: \"enable\", channel: \"both\" },\n  { id: \"packs.disable\", name: \"packs\", sub: \"disable\", channel: \"both\" },\n  { id: \"packs.doctor\", name: \"packs\", sub: \"doctor\", channel: \"both\" },\n  { id: \"packs.path\", name: \"packs\", sub: \"path\", channel: \"both\" },\n  { id: \"packs.install\", name: \"packs\", sub: \"install\", channel: \"both\" },\n  { id: \"packs.scan\", name: \"packs\", sub: \"scan\", channel: \"both\" },\n  { id: \"packs.uninstall\", name: \"packs\", sub: \"uninstall\", channel: \"both\" },\n  { id: \"packs.bind\", name: \"packs\", sub: \"bind\", channel: \"both\" },\n  { id: \"packs.unbind\", name: \"packs\", sub: \"unbind\", channel: \"both\" },\n  { id: \"packs.sources\", name: \"packs\", sub: \"sources\", channel: \"both\" },\n  { id: \"packs.check\", name: \"packs\", sub: \"check\", channel: \"both\" },\n  { id: \"packs.update\", name: \"packs\", sub: \"update\", channel: \"both\" },\n  { id: \"packs.bump\", name: \"packs\", sub: \"bump\", channel: \"both\" },\n\n  /* \u2500\u2500\u2500 repl-only \u2500\u2500\u2500 */\n  { id: \"send\", name: \"send\", channel: \"repl\" },\n  { id: \"quit\", name: \"quit\", channel: \"repl\" },\n];\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * command-surface.ts \u2014 sfmc CLI \u547D\u4EE4\u901A\u9053\u6CE8\u518C\u8868\uFF08\u5355\u4E00\u6743\u5A01\uFF09\n *\n * channel:\n *   - both: argv\uFF08`sfmc <cmd>`\uFF09\u4E0E REPL \u5747\u53EF\u7528\uFF08\u9ED8\u8BA4\uFF09\n *   - repl: \u4EC5 REPL\uFF1Bargv \u62D2\u7EDD\uFF08\u5982 send / quit\uFF09\n *\n * accent: \"dev\" \u4EC5\u5F71\u54CD\u5E2E\u52A9/\u8865\u5168\u84DD\u8272\u6837\u5F0F\uFF0C\u4E0D\u53C2\u4E0E canRun\uFF08OCP/DRY\uFF09\u3002\n * \u4E1A\u52A1\u5B9E\u73B0\u4E0D\u5728\u672C\u6587\u4EF6 / \u9762\u677F\u5185\uFF1A\u5206\u53D1\u5230 commands\u3001module-commands\u3001world-packs \u7B49\u3002\n */\nimport { stdin } from \"node:process\";\n\nexport type CommandChannel = \"repl\" | \"both\";\nexport type CommandMode = \"argv\" | \"repl\";\nexport type CommandAccent = \"dev\";\n\nexport type CommandSpec = {\n  /** \u7A33\u5B9A id\uFF0C\u5982 \"module.install\" / \"send\" / \"debug\" */\n  id: string;\n  /** \u9876\u5C42\u547D\u4EE4\u540D\uFF08module \u5B50\u547D\u4EE4\u7528 \"module\"\uFF1B\u9876\u5C42\u522B\u540D\u89C1 TOP_LEVEL_ALIASES\uFF09 */\n  name: string;\n  /** \u5B50\u547D\u4EE4\uFF08\u4EC5 module/packs \u7B49\uFF09 */\n  sub?: string;\n  channel: CommandChannel;\n  needsTty?: boolean;\n  /** \u5E2E\u52A9\u67D3\u8272\uFF1B\u4E0D\u53C2\u4E0E canRun */\n  accent?: CommandAccent;\n  /** \u5B50\u547D\u4EE4\u540C\u4E49\u522B\u540D\uFF08\u5982 uninstall \u2192 remove\uFF09\uFF0C\u4E0D\u662F\u9876\u5C42\u522B\u540D */\n  aliases?: string[];\n};\n\nexport type CanRunContext = {\n  mode: CommandMode;\n  isTty: boolean;\n};\n\nexport type CanRunFailReason = \"replOnly\" | \"needTty\";\n\nexport type CanRunResult = { ok: true } | { ok: false; reason: CanRunFailReason };\n\n/** \u9876\u5C42\u547D\u4EE4\u522B\u540D \u2192 \u89C4\u8303 name\uFF08DRY\uFF1A\u52FF\u5728\u5404 sub spec \u91CD\u590D\u5199 mod/addon\uFF09 */\nexport const TOP_LEVEL_ALIASES: Readonly<Record<string, string>> = {\n  mod: \"module\",\n  addon: \"packs\",\n  log: \"logs\",\n  lang: \"locale\",\n  h: \"help\",\n  \"?\": \"help\",\n  exit: \"quit\",\n  q: \"quit\",\n  i: \"install\",\n  remove: \"uninstall\",\n};\n\n/**\n * \u9876\u5C42\u6241\u5E73\u77ED\u547D\u4EE4 \u2192 module \u5B50\u547D\u4EE4\uFF08argv / REPL \u5171\u7528\uFF0C\u907F\u514D\u5728 switch \u91CC\u6563\u843D\u6620\u5C04\uFF09\n * \u4E0D\u542B enable/disable\uFF08\u4E0E packs \u51B2\u7A81\uFF0C\u4ECD\u8D70 /module \u6216 /packs\uFF09\n *\n * \u4E0E packs \u5B50\u547D\u4EE4\u5BF9\u9F50\uFF1A`packs i` \u2192 `packs install`\uFF08mapPacksSubAlias\uFF09\uFF1B\n * module \u9876\u5C42\u540C\u6837\u652F\u6301 `i` \u2192 `install`\uFF08\u89C1 TOP_LEVEL_ALIASES \u4E0E\u672C\u8868\uFF09\u3002\n */\nexport const MODULE_TOP_SHORTHAND: Readonly<Record<string, string>> = {\n  i: \"install\",\n  install: \"install\",\n  uninstall: \"uninstall\",\n  search: \"search\",\n  verify: \"verify\",\n};\n\nexport function resolveModuleTopShorthand(cmd: string | undefined): string | undefined {\n  if (!cmd) return undefined;\n  const name = resolveTopLevelName(cmd);\n  if (!name) return undefined;\n  return MODULE_TOP_SHORTHAND[name];\n}\n\nexport function resolveTopLevelName(cmd: string | undefined): string | undefined {\n  if (!cmd) return undefined;\n  return TOP_LEVEL_ALIASES[cmd] ?? cmd;\n}\n\nfunction channelAllows(channel: CommandChannel, mode: CommandMode): boolean {\n  if (channel === \"both\") return true;\n  return mode === \"repl\";\n}\n\n/** \u5224\u5B9A\u5F53\u524D\u6A21\u5F0F\u4E0B\u80FD\u5426\u6267\u884C\u8BE5\u547D\u4EE4\uFF08accent \u4E0D\u53C2\u4E0E\uFF09\u3002 */\nexport function canRunCommand(spec: CommandSpec, ctx: CanRunContext): CanRunResult {\n  if (!channelAllows(spec.channel, ctx.mode)) {\n    return { ok: false, reason: \"replOnly\" };\n  }\n  if (spec.needsTty && !ctx.isTty) {\n    return { ok: false, reason: \"needTty\" };\n  }\n  return { ok: true };\n}\n\n/** \u5F53\u524D\u6A21\u5F0F\u53EF\u89C1\u547D\u4EE4\uFF08help / Tab\uFF09\u3002 */\nexport function listVisibleCommands(mode: CommandMode): CommandSpec[] {\n  return COMMAND_SPECS.filter((s) => channelAllows(s.channel, mode));\n}\n\n/** \u9876\u5C42\u547D\u4EE4\u540D\uFF08\u542B\u522B\u540D\uFF09\uFF0C\u4F9B REPL COMMANDS / \u8865\u5168\u3002 */\nexport function listVisibleTopLevelNames(mode: CommandMode): string[] {\n  const canonical = new Set<string>();\n  for (const s of listVisibleCommands(mode)) {\n    canonical.add(s.name);\n  }\n  const out = new Set<string>(canonical);\n  for (const [alias, name] of Object.entries(TOP_LEVEL_ALIASES)) {\n    if (canonical.has(name)) out.add(alias);\n  }\n  return [...out];\n}\n\n/** \u67E5\u627E\u9876\u5C42\u547D\u4EE4\uFF08\u65E0 sub\uFF09\u7684\u4EFB\u610F\u4E00\u6761\u540C\u540D spec\uFF08\u7528\u4E8E channel \u95E8\u7981\uFF09\u3002 */\nexport function findTopLevelSpec(cmd: string | undefined): CommandSpec | undefined {\n  const name = resolveTopLevelName(cmd);\n  if (!name) return undefined;\n  /* \u4F18\u5148\u65E0 sub \u7684\u9876\u5C42\u6761\u76EE\uFF1B\u5426\u5219\u53D6\u8BE5 name \u4E0B\u4EFB\u610F\u53EF\u89C1 spec \u4EE3\u8868\u901A\u9053\uFF08module/packs\uFF09 */\n  const top = COMMAND_SPECS.find((s) => !s.sub && s.name === name);\n  if (top) return top;\n  return COMMAND_SPECS.find((s) => s.name === name);\n}\n\n/** \u67E5\u627E module \u5B50\u547D\u4EE4 spec\u3002 */\nexport function findModuleSubSpec(sub: string | undefined): CommandSpec | undefined {\n  if (!sub) return undefined;\n  return COMMAND_SPECS.find(\n    (s) => s.name === \"module\" && (s.sub === sub || (s.aliases ?? []).includes(sub))\n  );\n}\n\n/** \u67E5\u627E packs \u5B50\u547D\u4EE4 spec\u3002 */\nexport function findPacksSubSpec(sub: string | undefined): CommandSpec | undefined {\n  if (!sub) return undefined;\n  return COMMAND_SPECS.find(\n    (s) => s.name === \"packs\" && (s.sub === sub || (s.aliases ?? []).includes(sub))\n  );\n}\n\n/** \u5F53\u524D mode \u4E0B\u53EF\u89C1\u7684 module \u5B50\u547D\u4EE4\u540D\uFF08\u89C4\u8303\u540D\uFF0C\u4E0D\u542B remove \u522B\u540D\uFF09\u3002 */\nexport function listVisibleModuleSubs(mode: CommandMode): string[] {\n  return listVisibleCommands(mode)\n    .filter((s) => s.name === \"module\" && s.sub)\n    .map((s) => s.sub!);\n}\n\n/** \u5F53\u524D mode \u4E0B\u53EF\u89C1\u7684 packs \u5B50\u547D\u4EE4\u540D\u3002 */\nexport function listVisiblePacksSubs(mode: CommandMode): string[] {\n  return listVisibleCommands(mode)\n    .filter((s) => s.name === \"packs\" && s.sub)\n    .map((s) => s.sub!);\n}\n\n/** REPL \u5FEB\u901F\u8865\u5168\uFF1A\u5C42\u7EA7\u8282\u70B9\uFF08\u4E3B\u9762\u677F \u2192 \u53F3\u4FA7\u5B50\u9762\u677F\uFF09 */\nexport type PaletteNode = {\n  /** \u9762\u677F\u5185\u663E\u793A\u7684\u6807\u7B7E */\n  label: string;\n  /** \u8FFD\u52A0\u5230\u547D\u4EE4\u884C\u7684 token\uFF08\u6839\u8282\u70B9\u542B\u6216\u4E0D\u542B\u524D\u5BFC\u903B\u8F91\u7531\u7EC4\u88C5\u8D1F\u8D23\uFF09 */\n  token: string;\n  /** i18n \u63CF\u8FF0\u952E */\n  descKey?: string;\n  accent?: CommandAccent;\n  /** \u56FA\u5B9A\u4E0B\u4E00\u53C2\u9009\u9879\uFF1B\u56DE\u8F66\u540E\u5728\u53F3\u4FA7\u5C55\u5F00 */\n  children?: PaletteNode[];\n  /** \u65E0 children \u65F6\u4ECD\u9700\u81EA\u7531\u8F93\u5165\uFF08\u56DE\u8F66\u540E\u586B\u5165\u7A7A\u683C\u7EE7\u7EED\u6253\u5B57\uFF09 */\n  freeArgs?: boolean;\n};\n\nconst NO_ARG_TOP = new Set([\"status\", \"help\", \"version\", \"quit\", \"init\", \"logs\"]);\n\nconst TOP_DESC: Record<string, string> = {\n  status: \"help.status\",\n  logs: \"help.logs\",\n  start: \"help.start\",\n  stop: \"help.stop\",\n  restart: \"help.restart\",\n  send: \"help.send\",\n  help: \"help.help\",\n  version: \"help.version\",\n  quit: \"help.quit\",\n  init: \"help.init\",\n  update: \"help.update\",\n  locale: \"help.locale\",\n  debug: \"help.debug.status\",\n  ui: \"help.ui\",\n  install: \"help.module.install\",\n  uninstall: \"help.module.uninstall\",\n  search: \"help.module.search\",\n  verify: \"help.module.verify\",\n};\n\nconst MODULE_DESC: Record<string, string> = {\n  list: \"help.module.list\",\n  info: \"help.module.info\",\n  build: \"help.module.build\",\n  reload: \"help.module.reload\",\n  search: \"help.module.search\",\n  install: \"help.module.install\",\n  uninstall: \"help.module.uninstall\",\n  verify: \"help.module.verify\",\n  enable: \"help.module.toggle\",\n  disable: \"help.module.toggle\",\n};\n\nconst PACKS_DESC: Record<string, string> = {\n  list: \"help.packs.list\",\n  search: \"help.packs.search\",\n  enable: \"help.packs.enable\",\n  disable: \"help.packs.disable\",\n  doctor: \"help.packs.doctor\",\n  path: \"help.packs.path\",\n  install: \"help.addon\",\n  scan: \"help.addon\",\n  uninstall: \"help.addon\",\n  bind: \"help.addon\",\n  unbind: \"help.addon\",\n  sources: \"help.addon\",\n  check: \"help.addon\",\n  update: \"help.addon\",\n  bump: \"help.addon\",\n};\n\nfunction serviceArgNodes(): PaletteNode[] {\n  return [\n    { label: \"-all\", token: \"-all\" },\n    ...([\"bds\", \"db\", \"qq\", \"llbot\"] as const).map((n) => ({ label: n, token: n })),\n  ];\n}\n\nfunction moduleChildNodes(mode: CommandMode): PaletteNode[] {\n  const noArg = new Set([\"list\", \"build\"]);\n  return listVisibleModuleSubs(mode).map((sub) => {\n    const spec = findModuleSubSpec(sub);\n    const node: PaletteNode = {\n      label: sub,\n      token: sub,\n      descKey: MODULE_DESC[sub] ?? \"help.module.list\",\n      freeArgs: !noArg.has(sub),\n    };\n    if (spec?.accent) node.accent = spec.accent;\n    return node;\n  });\n}\n\nfunction packsChildNodes(mode: CommandMode): PaletteNode[] {\n  const noArg = new Set([\"list\", \"path\", \"sources\"]);\n  return listVisiblePacksSubs(mode).map((sub) => ({\n    label: sub,\n    token: sub,\n    descKey: PACKS_DESC[sub] ?? \"help.addon\",\n    freeArgs: !noArg.has(sub),\n  }));\n}\n\n/** \u5C42\u7EA7\u547D\u4EE4\u6811\uFF08REPL \u9762\u677F\u4E3B\u5217\uFF09 */\nexport function listPaletteRoots(mode: CommandMode = \"repl\"): PaletteNode[] {\n  const specs = listVisibleCommands(mode);\n  const out: PaletteNode[] = [];\n  const seen = new Set<string>();\n  /** \u9762\u677F\u4E0D\u5C55\u793A\u9876\u5C42\u77ED\u547D\u4EE4\uFF0C\u7EDF\u4E00\u8D70 /module <sub>\uFF08argv \u77ED\u547D\u4EE4\u4ECD\u53EF\u7528\uFF09 */\n  const skipTopShorthand = new Set(Object.keys(MODULE_TOP_SHORTHAND));\n\n  for (const s of specs) {\n    if (s.sub) continue;\n    if (s.name === \"module\" || s.name === \"packs\") continue;\n    if (skipTopShorthand.has(s.name)) continue;\n    if (seen.has(s.name)) continue;\n    seen.add(s.name);\n\n    const node: PaletteNode = {\n      label: `/${s.name}`,\n      token: s.name,\n      descKey: TOP_DESC[s.name] ?? \"help.help\",\n    };\n    if (s.accent) node.accent = s.accent;\n\n    if (s.name === \"start\" || s.name === \"stop\" || s.name === \"restart\") {\n      node.children = serviceArgNodes();\n    } else if (s.name === \"send\") {\n      node.children = ([\"bds\", \"db\", \"qq\", \"llbot\"] as const).map((n) => ({\n        label: n,\n        token: n,\n        freeArgs: true,\n      }));\n    } else if (!NO_ARG_TOP.has(s.name)) {\n      node.freeArgs = true;\n    }\n\n    out.push(node);\n  }\n\n  const moduleSubs = moduleChildNodes(mode);\n  if (moduleSubs.length > 0) {\n    out.push({\n      label: \"/module\",\n      token: \"module\",\n      descKey: \"help.module.list\",\n      children: moduleSubs,\n    });\n  }\n\n  const packsSubs = packsChildNodes(mode);\n  if (packsSubs.length > 0) {\n    out.push({\n      label: \"/packs\",\n      token: \"packs\",\n      descKey: \"help.addon\",\n      children: packsSubs,\n    });\n  }\n\n  return out;\n}\n\nexport function isDevAccent(spec: CommandSpec | undefined): boolean {\n  return spec?.accent === \"dev\";\n}\n\n/** sub \u662F\u5426\u4E3A\u5F00\u53D1\u8005\u6837\u5F0F\u547D\u4EE4\uFF08\u84DD\u6807\uFF09\u3002 */\nexport function isDevAccentModuleSub(sub: string | undefined): boolean {\n  return isDevAccent(findModuleSubSpec(sub));\n}\n\n/** stdin TTY \u63A2\u6D4B\uFF08\u4F9B main/repl \u5171\u7528\uFF09\u3002 */\nexport function isCliTty(): boolean {\n  return Boolean(stdin.isTTY);\n}\n\n/**\n * \u547D\u4EE4\u6CE8\u518C\u8868 \u2014\u2014 \u65B0\u589E\u547D\u4EE4\u53EA\u52A0\u6B64\u5904\uFF08OCP\uFF09\u3002\n * channel:\n *   - both: argv + REPL\uFF08\u9ED8\u8BA4\uFF1B\u9762\u677F\u53EA\u8C03\u5EA6\u65E2\u6709 dispatcher\uFF09\n *   - repl: \u4EC5 REPL\uFF08\u5982 send / quit\uFF09\n */\nexport const COMMAND_SPECS: readonly CommandSpec[] = [\n  /* \u2500\u2500\u2500 both\uFF1A\u670D\u52A1 / \u6A21\u5757 / \u8D44\u6E90\u5305 / \u914D\u7F6E \u2500\u2500\u2500 */\n  { id: \"status\", name: \"status\", channel: \"both\" },\n  { id: \"start\", name: \"start\", channel: \"both\" },\n  { id: \"stop\", name: \"stop\", channel: \"both\" },\n  { id: \"restart\", name: \"restart\", channel: \"both\" },\n  { id: \"logs\", name: \"logs\", channel: \"repl\" },\n  { id: \"help\", name: \"help\", channel: \"both\" },\n  { id: \"version\", name: \"version\", channel: \"both\" },\n  { id: \"init\", name: \"init\", channel: \"both\", needsTty: true },\n  { id: \"update\", name: \"update\", channel: \"both\" },\n  { id: \"locale\", name: \"locale\", channel: \"both\" },\n  { id: \"debug\", name: \"debug\", channel: \"both\", accent: \"dev\" },\n  { id: \"ui\", name: \"ui\", channel: \"both\", accent: \"dev\" },\n\n  /** \u9876\u5C42\u6241\u5E73\u77ED\u547D\u4EE4 \u2192 module.*\uFF08\u5C11\u5199\u4E00\u5C42 module\uFF09 */\n  { id: \"install\", name: \"install\", channel: \"both\" },\n  { id: \"uninstall\", name: \"uninstall\", channel: \"both\", aliases: [\"remove\"] },\n  { id: \"search\", name: \"search\", channel: \"both\" },\n  { id: \"verify\", name: \"verify\", channel: \"both\" },\n\n  { id: \"module.list\", name: \"module\", sub: \"list\", channel: \"both\" },\n  { id: \"module.info\", name: \"module\", sub: \"info\", channel: \"both\" },\n  { id: \"module.build\", name: \"module\", sub: \"build\", channel: \"both\", accent: \"dev\" },\n  { id: \"module.reload\", name: \"module\", sub: \"reload\", channel: \"both\", accent: \"dev\" },\n  { id: \"module.install\", name: \"module\", sub: \"install\", channel: \"both\" },\n  {\n    id: \"module.uninstall\",\n    name: \"module\",\n    sub: \"uninstall\",\n    channel: \"both\",\n    aliases: [\"remove\"],\n  },\n  { id: \"module.search\", name: \"module\", sub: \"search\", channel: \"both\" },\n  { id: \"module.verify\", name: \"module\", sub: \"verify\", channel: \"both\" },\n  { id: \"module.enable\", name: \"module\", sub: \"enable\", channel: \"both\" },\n  { id: \"module.disable\", name: \"module\", sub: \"disable\", channel: \"both\" },\n\n  { id: \"packs.list\", name: \"packs\", sub: \"list\", channel: \"both\" },\n  { id: \"packs.search\", name: \"packs\", sub: \"search\", channel: \"both\" },\n  { id: \"packs.enable\", name: \"packs\", sub: \"enable\", channel: \"both\" },\n  { id: \"packs.disable\", name: \"packs\", sub: \"disable\", channel: \"both\" },\n  { id: \"packs.doctor\", name: \"packs\", sub: \"doctor\", channel: \"both\" },\n  { id: \"packs.path\", name: \"packs\", sub: \"path\", channel: \"both\" },\n  { id: \"packs.install\", name: \"packs\", sub: \"install\", channel: \"both\" },\n  { id: \"packs.scan\", name: \"packs\", sub: \"scan\", channel: \"both\" },\n  { id: \"packs.uninstall\", name: \"packs\", sub: \"uninstall\", channel: \"both\" },\n  { id: \"packs.bind\", name: \"packs\", sub: \"bind\", channel: \"both\" },\n  { id: \"packs.unbind\", name: \"packs\", sub: \"unbind\", channel: \"both\" },\n  { id: \"packs.sources\", name: \"packs\", sub: \"sources\", channel: \"both\" },\n  { id: \"packs.check\", name: \"packs\", sub: \"check\", channel: \"both\" },\n  { id: \"packs.update\", name: \"packs\", sub: \"update\", channel: \"both\" },\n  { id: \"packs.bump\", name: \"packs\", sub: \"bump\", channel: \"both\" },\n\n  /* \u2500\u2500\u2500 repl-only \u2500\u2500\u2500 */\n  { id: \"send\", name: \"send\", channel: \"repl\" },\n  { id: \"quit\", name: \"quit\", channel: \"repl\" },\n];\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/commands.d.ts

@@ -1,18 +1,71 @@
+/**
+ * commands.ts — CLI 核心运维命令实现
+ *
+ * 提供命令行与 REPL 共享的系统级运维指令：
+ * - `status`：查询全部服务（BDS、db-server、qq-bridge、LLBot）运行状态、PID、运行时长与所有权
+ * - `start` / `stop` / `restart`：按依赖顺序或单个控制服务启停
+ * - `startAll` / `stopAll`：批量编排控制所有后台服务
+ * - `logs`：检索并实时追踪指定服务的最近日志流
+ * - `update`：触发 BDS 核心版本更新检查与热升级
+ */
 import { type ServiceName } from "./services.js";
+/**
+ * 查询并格式化展示所有后台服务的当前运行状态矩阵。
+ *
+ * @returns 格式化后的状态摘要文本表格。
+ */
 export declare function cmdStatus(): Promise<string>;
+/**
+ * 检索并格式化指定服务的最近历史日志行（支持 `-n <行数>` 及 `-f` 实时追踪）。
+ *
+ * @param args 参数列表。
+ * @param onFollow 可选的跟随模式回调。
+ * @returns 格式化后的日志输出文本。
+ */
 export declare function cmdLogs(args: string[], onFollow?: (serviceName: ServiceName) => void): string;
+/**
+ * 启动指定的单项后台服务（bds / db / qq / llbot）。
+ *
+ * @param raw 目标服务名称字符串。
+ * @returns 启动结果描述文本。
+ */
 export declare function cmdStart(raw: string): Promise<string>;
+/**
+ * 停止指定的单项后台服务（支持对外部非托管实例执行精准清理）。
+ *
+ * @param raw 目标服务名称字符串。
+ * @returns 停止操作结果文本。
+ */
 export declare function cmdStop(raw: string): Promise<string>;
 export declare function cmdSend(raw: string, message: string): Promise<string>;
+/**
+ * 重启指定的单项后台服务（遵循 stop → start 严谨时序）。
+ *
+ * @param raw 目标服务名称字符串。
+ * @returns 重启操作结果文本。
+ */
 export declare function cmdRestart(raw: string): Promise<string>;
+/**
+ * 按服务拓扑依赖次序批量启动所有已启用的后台服务。
+ *
+ * @returns 批量启动结果统计报告文本。
+ */
 export declare function cmdStartAll(): Promise<string>;
+/**
+ * 批量停止所有当前处于运行态的后台服务。
+ *
+ * @returns 批量停止确认文本。
+ */
 export declare function cmdStopAll(): Promise<string>;
 /**
- * BDS 更新：子进程始终 --no-start，由 sfmc 监督器接管启停与日志。
- * （updater 内 detached 自启会导致 REPL 丢 PID / 无 stdout）
+ * 触发 BDS 核心版本更新检查与热升级流程。
+ *
+ * 进程管理与编排约束：
+ * - updater 子进程始终附加 `--no-start` 参数，避免由于进程脱离导致 REPL 丢失 PID 跟踪及标准输出
+ * - 若更新前 BDS 处于运行状态，且未显式指定 `--no-start`，在更新落盘部署完成后由监督器重新唤起 BDS
  *
- * 不停服预操作：真正需要更新时由 updater 停服；已是最新则不影响正在跑的 BDS。
- * 更新成功后若未指定 --no-start，再由监督器 `start bds`（接管 PID + 日志管道）。
+ * @param args 传递给更新器的命令行参数。
+ * @returns 更新执行结果摘要文本。
  */
 export declare function cmdUpdate(args?: string[]): Promise<string>;
 //# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AA4BtG,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAmBjD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,CA+C7F;AAKD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0B3D;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC1D;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB3E;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc7D;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAInD;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAIlD;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA2EpE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,OAAO,EAAuD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AA+CtG;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAYjD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,CA+C7F;AAkBD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuC3D;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgE1D;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB3E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB7D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CA8BnD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFpE"}

package/dist/commands.js

@@ -1,11 +1,18 @@
-import { killBedrockServerByImage, probeBdsStatus, clearBdsPidFile } from "@sfmc-bds/bds-tools/process-probe";
-import { pushLog as pushUnifiedLog } from "./logs.js";
+import { clearBdsPidFile, killBedrockServerByImage, probeBdsStatus } from "@sfmc-bds/bds-tools/process-probe";
+import { stripTaskbarOsc } from "@sfmc-bds/bds-tools/taskbar";
+import { didUpdateDeploy } from "@sfmc-bds/bds-tools/update-result";
+import {
+  DEFAULT_QQ_CONFIG,
+  loadEnsuredConfig,
+  qqRuntimeStatusPath
+} from "@sfmc-bds/sdk/node/config";
+import fs from "node:fs";
 import { t } from "./i18n/index.js";
+import { pushLog as pushUnifiedLog } from "./logs.js";
+import { findNodeServicePids, killNodeServiceByScript } from "./node-service-probe.js";
 import { spawnService } from "./runtime.js";
-import { ROOT, SERVICE_NAMES, queryServicesRuntime, services } from "./services.js";
+import { queryServicesRuntime, ROOT, SERVICE_NAMES, services } from "./services.js";
 import { c, DIVIDER, highlightLogLine, padRight } from "./theme.js";
-import { stripTaskbarOsc } from "@sfmc-bds/bds-tools/taskbar";
-import { didUpdateDeploy } from "@sfmc-bds/bds-tools/update-result";
 function parseService(raw) {
   const s = raw.toLowerCase();
   if (SERVICE_NAMES.includes(s)) return s;
@@ -19,7 +26,27 @@ function statusLine(name, running, pid, uptime, ownership) {
   else if (running && ownership === "external") owner = c.yellow(t("svc.owner.external"));
   const pidStr = pid ? c.dim(String(pid)) : c.dim("\u2014");
   const upStr = uptime !== "\u2014" ? c.dim(uptime) : c.dim("\u2014");
-  return `  ${dot} ${c.bold(padRight(name, 9))} ${padRight(state, 8)} ${padRight(owner, 6)} ${padRight(pidStr, 8)} ${upStr}`;
+  return `  ${dot} ${c.bold(padRight(name, 14))} ${padRight(state, 8)} ${padRight(owner, 6)} ${padRight(pidStr, 8)} ${upStr}`;
+}
+function qqBridgeStatusFooter() {
+  const qqCfg = loadEnsuredConfig(ROOT, "qq_config.json", "qq_config", { ...DEFAULT_QQ_CONFIG });
+  const backend = qqCfg.qq_backend === "llbot" ? "llbot" : "official";
+  const enabled = qqCfg.qq_enabled !== false;
+  if (backend === "llbot") {
+    const group = qqCfg.llbot?.group_id || "\u2014";
+    const pathHint = qqCfg.llbot?.path ? String(qqCfg.llbot.path) : "\u2014";
+    return `
+${c.dim(t("svc.qq.footer.llbot", { enabled: enabled ? "on" : "off", group, path: pathHint }))}
+`;
+  }
+  const appId = String(qqCfg.official?.app_id ?? "").trim();
+  const appIdHint = appId ? appId.length > 8 ? `${appId.slice(0, 4)}\u2026${appId.slice(-4)}` : appId : "\u2014";
+  const openid = String(qqCfg.official?.group_openid ?? "").trim() || "\u2014";
+  const sandbox = qqCfg.official?.sandbox ? "sandbox" : "prod";
+  const creds = appId && String(qqCfg.official?.app_secret ?? "").trim() ? "ok" : "missing";
+  return `
+${c.dim(t("svc.qq.footer.official", { enabled: enabled ? "on" : "off", appId: appIdHint, openid, sandbox, creds }))}
+`;
 }
 async function cmdStatus() {
   const rows = await queryServicesRuntime();
@@ -29,10 +56,10 @@ async function cmdStatus() {
   const ownerH = t("svc.col.owner");
   const pidH = t("svc.col.pid");
   const upH = t("svc.col.uptime");
-  const header = `  ${padRight(nameH, 11)}${padRight(statusH, 8)}${padRight(ownerH, 6)}${padRight(pidH, 8)}${upH}`;
+  const header = `  ${padRight(nameH, 16)}${padRight(statusH, 8)}${padRight(ownerH, 6)}${padRight(pidH, 8)}${upH}`;
   return `
 ${c.bold(t("svc.header"))}
-` + c.dim(header) + "\n" + DIVIDER + "\n" + lines.join("\n") + "\n";
+` + c.dim(header) + "\n" + DIVIDER + "\n" + lines.join("\n") + qqBridgeStatusFooter();
 }
 function cmdLogs(args, onFollow) {
   let n = 20;
@@ -72,6 +99,16 @@ ${c.bold(t("svc.logs.header", { title: svcObj.title, count: lines.length }))}`;
 }
 const STARTING = /* @__PURE__ */ new Set();
 const STOPPING = /* @__PURE__ */ new Set();
+function isNodeSvc(name) {
+  return name === "db" || name === "qq";
+}
+function clearQqRuntimeFile() {
+  try {
+    const file = qqRuntimeStatusPath(ROOT);
+    if (fs.existsSync(file)) fs.unlinkSync(file);
+  } catch {
+  }
+}
 async function cmdStart(raw) {
   const svc = parseService(raw);
   if (!svc) return c.red(t("svc.unknown", { name: raw, list: SERVICE_NAMES.join(", ") }));
@@ -87,11 +124,23 @@ async function cmdStart(raw) {
       );
     }
   }
+  if (isNodeSvc(svc)) {
+    const external = await findNodeServicePids(svc);
+    if (external.length > 0) {
+      return c.yellow(t("svc.alreadyRunning", { title: svcObj.title, pid: String(external.join(",")) }));
+    }
+  }
   if (svcObj.running) return c.yellow(t("svc.alreadyRunning", { title: svcObj.title, pid: svcObj.pid }));
   if (STARTING.has(svc)) return c.dim(t("svc.alreadyStarting", { title: svcObj.title }));
   STARTING.add(svc);
   try {
-    await svcObj.start();
+    const outcome = await svcObj.start();
+    if (outcome.status === "skipped") {
+      return c.yellow(t("svc.skipped", { title: svcObj.title, reason: outcome.reason }));
+    }
+    if (outcome.status === "already") {
+      return c.yellow(t("svc.alreadyRunning", { title: svcObj.title, pid: svcObj.pid }));
+    }
     return c.green(t("svc.started", { title: svcObj.title }));
   } catch (e) {
     return c.red(t("svc.startFailed", { title: svcObj.title, message: e.message }));
@@ -123,7 +172,33 @@ async function cmdStop(raw) {
       }
     }
   }
-  if (!svcObj.running) return c.yellow(t("svc.alreadyStopped", { title: svcObj.title }));
+  if (isNodeSvc(svc)) {
+    if (STOPPING.has(svc)) return c.dim(t("svc.alreadyStopping", { title: svcObj.title }));
+    STOPPING.add(svc);
+    try {
+      const managed = svcObj.running;
+      if (managed) {
+        await svcObj.stop();
+      }
+      const killed = await killNodeServiceByScript(svc);
+      if (svc === "qq") clearQqRuntimeFile();
+      if (!managed && killed.length === 0) {
+        return c.yellow(t("svc.alreadyStopped", { title: svcObj.title }));
+      }
+      if (!managed && killed.length > 0) {
+        return c.dim(t("svc.stoppedExternal", { title: svcObj.title }));
+      }
+      return c.dim(t("svc.stoppedMsg", { title: svcObj.title }));
+    } catch (e) {
+      return c.red(t("svc.stopFailed", { title: svcObj.title, message: e.message }));
+    } finally {
+      STOPPING.delete(svc);
+    }
+  }
+  if (!svcObj.running) {
+    if (svc === "tunnel") await svcObj.stop();
+    return c.yellow(t("svc.alreadyStopped", { title: svcObj.title }));
+  }
   if (STOPPING.has(svc)) return c.dim(t("svc.alreadyStopping", { title: svcObj.title }));
   STOPPING.add(svc);
   try {
@@ -138,6 +213,7 @@ async function cmdStop(raw) {
 async function cmdSend(raw, message) {
   const svc = parseService(raw);
   if (!svc) return c.red(t("svc.unknown", { name: raw, list: SERVICE_NAMES.join(", ") }));
+  if (svc === "tunnel") return c.yellow(t("svc.stdinUnavailable", { title: services[svc].title }));
   if (!message) return c.yellow(t("svc.send.usage"));
   const svcObj = services[svc];
   await queryServicesRuntime();
@@ -162,13 +238,21 @@ async function cmdSend(raw, message) {
 async function cmdRestart(raw) {
   const svc = parseService(raw);
   if (!svc) return c.red(t("svc.unknown", { name: raw, list: SERVICE_NAMES.join(", ") }));
-  if (svc === "bds") {
-    await cmdStop("bds");
-    return cmdStart("bds");
+  if (svc === "bds" || isNodeSvc(svc)) {
+    const stopMsg = await cmdStop(svc);
+    const startMsg = await cmdStart(svc);
+    if (/失败|failed/i.test(stopMsg) && !/已停止|stopped|already/i.test(stopMsg)) {
+      return stopMsg;
+    }
+    if (/失败|failed/i.test(startMsg)) return startMsg;
+    return c.green(t("svc.restarted", { title: services[svc].title }));
   }
   const svcObj = services[svc];
   try {
-    await svcObj.restart();
+    const outcome = await svcObj.restart();
+    if (outcome.status === "skipped") {
+      return c.yellow(t("svc.skipped", { title: svcObj.title, reason: outcome.reason }));
+    }
     return c.green(t("svc.restarted", { title: svcObj.title }));
   } catch (e) {
     return c.red(t("svc.restartFailed", { title: svcObj.title, message: e.message }));
@@ -176,8 +260,34 @@ async function cmdRestart(raw) {
 }
 async function cmdStartAll() {
   const { startAll } = await import("./services.js");
-  await startAll();
-  return c.green(t("svc.allStarted"));
+  const result = await startAll();
+  const parts = [];
+  if (result.started.length > 0) {
+    parts.push(c.green(t("svc.startAll.started", { list: result.started.join(", ") })));
+  }
+  if (result.skipped.length > 0) {
+    parts.push(
+      c.dim(
+        t("svc.startAll.skipped", {
+          list: result.skipped.map((s) => `${s.name}(${s.reason})`).join("; ")
+        })
+      )
+    );
+  }
+  if (result.failed.length > 0) {
+    parts.push(
+      c.red(
+        t("svc.startAll.failed", {
+          list: result.failed.map((s) => `${s.name}: ${s.reason}`).join("; ")
+        })
+      )
+    );
+  }
+  if (parts.length === 0) return c.dim(t("svc.startAll.empty"));
+  if (result.failed.length === 0 && result.skipped.length === 0) {
+    return c.green(t("svc.allStarted"));
+  }
+  return parts.join("\n");
 }
 async function cmdStopAll() {
   const { stopAll } = await import("./services.js");
@@ -189,65 +299,71 @@ async function cmdUpdate(args = []) {
   const checkOnly = args.includes("--check-only");
   const spawnArgs = userNoStart ? [...args] : [...args, "--no-start"];
   const bds = services.bds;
-  const bdsProbe = await probeBdsStatus({
-    managedPid: bds.pid,
-    hasStdin: Boolean(bds.proc?.stdin),
-    rootDir: ROOT
-  });
-  const bdsWasRunning = bdsProbe.state !== "stopped";
-  const result = await new Promise((resolve) => {
-    const proc = spawnService("update", spawnArgs, {
-      cwd: ROOT,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    let out = "";
-    const pushChunk = (raw, level) => {
-      const s = stripTaskbarOsc(raw);
-      out += s;
-      for (const line of s.split(/\r?\n/).map((l) => l.trimEnd()).filter((l) => l.length > 0)) {
-        pushUnifiedLog(line, "update", level);
-      }
-    };
-    proc.stdout?.on("data", (d) => pushChunk(d.toString(), "info"));
-    proc.stderr?.on("data", (d) => pushChunk(d.toString(), "error"));
-    proc.on("exit", (code) => {
-      if (code === 0) {
-        pushUnifiedLog(t("svc.updateComplete"), "system", "success");
-        resolve({ code: 0, out: (out ? out + "\n" : "") + t("svc.updateComplete") });
-      } else {
-        resolve({ code, out: out || t("svc.updateExited", { code: String(code) }) });
-      }
-    });
-    proc.on("error", (e) => {
-      pushUnifiedLog(t("svc.updateError", { message: e.message }), "system", "error");
-      resolve({ code: 1, out: t("svc.updateError", { message: e.message }) });
-    });
-  });
-  const didDeploy = didUpdateDeploy(result.out);
-  if (result.code === 0 && didDeploy && !userNoStart && !checkOnly) {
-    const afterProbe = await probeBdsStatus({
+  bds.beginUpdate();
+  try {
+    const bdsProbe = await probeBdsStatus({
       managedPid: bds.pid,
       hasStdin: Boolean(bds.proc?.stdin),
       rootDir: ROOT
     });
-    if (afterProbe.state !== "stopped") {
-      return result.out;
-    }
-    try {
-      pushUnifiedLog(t("svc.updateStartBds"), "system", "info");
-      await bds.start();
-      return result.out + "\n" + c.green(t("svc.bdsStarted"));
-    } catch (e) {
-      return result.out + "\n" + c.red(t("svc.bdsStartFailed", { message: e.message }));
+    const bdsWasRunning = bdsProbe.state !== "stopped";
+    const result = await new Promise((resolve) => {
+      const proc = spawnService("update", spawnArgs, {
+        cwd: ROOT,
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      let out = "";
+      const pushChunk = (raw, level) => {
+        const s = stripTaskbarOsc(raw);
+        out += s;
+        for (const line of s.split(/\r?\n/).map((l) => l.trimEnd()).filter((l) => l.length > 0)) {
+          pushUnifiedLog(line, "update", level);
+        }
+      };
+      proc.stdout?.on("data", (d) => pushChunk(d.toString(), "info"));
+      proc.stderr?.on("data", (d) => pushChunk(d.toString(), "error"));
+      proc.on("exit", (code) => {
+        if (code === 0) {
+          pushUnifiedLog(t("svc.updateComplete"), "system", "success");
+          resolve({ code: 0, out: (out ? out + "\n" : "") + t("svc.updateComplete") });
+        } else {
+          resolve({ code, out: out || t("svc.updateExited", { code: String(code) }) });
+        }
+      });
+      proc.on("error", (e) => {
+        pushUnifiedLog(t("svc.updateError", { message: e.message }), "system", "error");
+        resolve({ code: 1, out: t("svc.updateError", { message: e.message }) });
+      });
+    });
+    const didDeploy = didUpdateDeploy(result.out);
+    if (result.code === 0 && didDeploy && !userNoStart && !checkOnly) {
+      const afterProbe = await probeBdsStatus({
+        managedPid: bds.pid,
+        hasStdin: Boolean(bds.proc?.stdin),
+        rootDir: ROOT
+      });
+      if (afterProbe.state !== "stopped") {
+        return result.out;
+      }
+      try {
+        pushUnifiedLog(t("svc.updateStartBds"), "system", "info");
+        bds.endUpdate();
+        await bds.start();
+        return result.out + "\n" + c.green(t("svc.bdsStarted"));
+      } catch (e) {
+        return result.out + "\n" + c.red(t("svc.bdsStartFailed", { message: e.message }));
+      }
     }
-  }
-  if (result.code === 0 && didDeploy && userNoStart && bdsWasRunning) {
-    const afterProbe = await probeBdsStatus({ rootDir: ROOT });
-    if (afterProbe.state === "stopped") {
-      return result.out + "\n" + c.yellow(t("svc.bdsStoppedForUpdate"));
+    if (result.code === 0 && didDeploy && userNoStart && bdsWasRunning) {
+      const afterProbe = await probeBdsStatus({ rootDir: ROOT });
+      if (afterProbe.state === "stopped") {
+        return result.out + "\n" + c.yellow(t("svc.bdsStoppedForUpdate"));
+      }
     }
+    return result.out;
+  } finally {
+    bds.endUpdate();
   }
-  return result.out;
 }
 export {
   cmdLogs,