mn-ws 0.1.0 → 0.2.0

package/dist/runtime/cli.js

@@ -0,0 +1,410 @@
+// 通用 CLI 运行器：解析 argv → 匹配 action → 校验 → 执行 → 渲染。
+//
+// 改造前这里是一个 400 行的 switch，每条命令要在 BOOL_FLAGS / helpText / case /
+// renderXxx 四处重复登记。现在命令表、help 文本、参数校验全部由 action 声明派生，
+// 新增命令只需在所属模块的 actions 里加一条。
+import { readFileSync } from 'node:fs';
+import { APP_NAME, DEFAULT_PORT, STORE_ENV, storePathFromEnv, } from '../core/paths.js';
+import { toErrorPayload, exitCodeOf, badInput } from '../core/errors/index.js';
+import { ACTIONS } from './registry.js';
+import { cliPathsOf, argSpecsOf, flagSpecsOf, booleanFlagNames, applySpec, } from './spec.js';
+import { commandEntry, helpEntries, renderHelp, printCommandHelp, } from './help.js';
+const VERSION = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+// ---- 平台命令：不属于任何功能域，不参与 action 表 ----
+// 用与 action 相同的形状声明，好让参数解析与 help 生成保持同一套逻辑。
+const BUILTINS = [
+    {
+        id: 'serve',
+        cli: ['serve'],
+        summary: '启动桥接与 Web 面板（默认 :7777；--port N 改面板端口；--no-open 不开浏览器；--apps 指定白名单）',
+        flags: {
+            port: { type: 'number', default: DEFAULT_PORT },
+            url: { type: 'string', hint: 'server 半的 ws:// 地址' },
+            token: { type: 'string', hint: '注册门禁（静态门禁或设备令牌）' },
+            apps: { type: 'string', hint: '白名单：逗号分隔的应用名' },
+            ports: { type: 'string', hint: '白名单：逗号分隔的本地端口' },
+            'app-map': { type: 'string', hint: '显式基址，如 nx-kv=http://127.0.0.1:7999' },
+            'device-name': { type: 'string', hint: '桥的显示名' },
+            'log-level': { type: 'string', hint: 'debug | info | warn | error' },
+            'no-open': { type: 'boolean' },
+        },
+        run: (ctx) => cmdServe(ctx),
+    },
+    {
+        id: 'doctor',
+        cli: ['doctor'],
+        summary: '环境自检：端口占用 / 鉴权 / 应用可达性 / server 连通性',
+        flags: {
+            url: { type: 'string', hint: 'server 半的 ws:// 地址' },
+            token: { type: 'string', hint: '注册门禁' },
+            'no-open': { type: 'boolean' },
+        },
+        run: (ctx) => cmdDoctor(ctx),
+    },
+    {
+        id: 'help',
+        cli: ['help'],
+        summary: '显示帮助（可跟模块名或命令组，如 mn-ws help home）',
+        args: [{ name: 'topic', required: false }],
+        // 走标准 action 形态：--json 时 emit 会序列化返回的条目，
+        // 于是 `help --json` 输出的是可解析的命令表而非帮助文本
+        run: (ctx) => helpEntries(ctx.topic, ALL_COMMANDS.map(commandEntry)),
+        render: (entries, ctx) => renderHelp(entries, ctx?.topic),
+    },
+    // render 让 `nx-nx version` 输出裸版本号（脚本里可 `V=$(nx-nx version)`），
+    // 而 `--json` 仍走序列化，保持机器可读
+    {
+        id: 'version',
+        cli: ['version'],
+        summary: '显示版本',
+        run: () => VERSION,
+        render: (v) => v,
+    },
+];
+export const ALL_COMMANDS = [
+    ...BUILTINS,
+    ...ACTIONS,
+];
+// 全局 flag 先摘掉：它们可以出现在 argv 任意位置，不属于任何 action 的声明。
+function splitGlobals(argv) {
+    const rest = [];
+    let json = false;
+    let store;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--json') {
+            json = true;
+            continue;
+        }
+        if (a === '--store') {
+            store = argv[++i];
+            continue;
+        }
+        if (a.startsWith('--store=')) {
+            store = a.slice('--store='.length);
+            continue;
+        }
+        rest.push(a);
+    }
+    return { rest, json, store };
+}
+// 匹配命令：把声明路径与 argv 前缀逐 token 比较，选最长匹配。
+//
+// 逐 token 比较（而非只取「开头连续的非 flag token」）是必需的——有些命令路径
+// 本身就含 flag，例如 `skill install --list` 是「列出内置包」而非「安装」。
+// 最长优先则让 ['skill','central','add'] 压过 ['skill','central']，子命令与别名因此共存。
+export function resolveCommand(argv) {
+    let best = null;
+    let bestLen = -1;
+    for (const cmd of ALL_COMMANDS) {
+        for (const path of cliPathsOf(cmd)) {
+            if (path.length > argv.length || path.length <= bestLen)
+                continue;
+            if (path.every((seg, i) => seg === argv[i])) {
+                best = { cmd, path };
+                bestLen = path.length;
+            }
+        }
+    }
+    return best ? { ...best, rest: argv.slice(bestLen) } : null;
+}
+// 解析剩余 token。布尔 flag 不吞下一个 token —— 否则 `skill install --force demo`
+// 会把 force 解析成字符串 'demo'，而 demo 本该是位置参数。
+function parseRest(rest, cmd) {
+    const bools = booleanFlagNames(cmd);
+    const positionals = [];
+    const flags = {};
+    for (let i = 0; i < rest.length; i++) {
+        const a = rest[i];
+        if (!a.startsWith('--')) {
+            positionals.push(a);
+            continue;
+        }
+        const eq = a.indexOf('=');
+        if (eq > 2) {
+            setFlag(flags, a.slice(2, eq), a.slice(eq + 1));
+            continue;
+        }
+        const key = a.slice(2);
+        const next = rest[i + 1];
+        if (!bools.has(key) && next !== undefined && !next.startsWith('--')) {
+            setFlag(flags, key, next);
+            i++;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    return { positionals, flags };
+}
+// 同名 flag 出现多次 → 收成数组（`--set a=1 --set b=2`）。
+// 不这么做的话后者会静默覆盖前者——`--set` / `--hidden` 这类可重复 flag 全靠它。
+function setFlag(flags, key, value) {
+    const prev = flags[key];
+    if (prev === undefined)
+        flags[key] = value;
+    else if (Array.isArray(prev))
+        prev.push(value);
+    else
+        flags[key] = [prev, value];
+}
+// 位置参数按声明顺序映射成具名输入；末尾声明 { rest: true } 的收集剩余全部
+function mapPositionals(positionals, cmd) {
+    const out = {};
+    let i = 0;
+    for (const spec of argSpecsOf(cmd)) {
+        if (spec.rest) {
+            out[spec.name] = positionals.slice(i);
+            i = positionals.length;
+            break;
+        }
+        if (positionals[i] !== undefined)
+            out[spec.name] = positionals[i];
+        i++;
+    }
+    if (i < positionals.length) {
+        throw badInput(`多余的参数: ${positionals.slice(i).join(' ')}（用法见 ${APP_NAME} help）`);
+    }
+    return out;
+}
+// 未知 flag 直接报错——`--fiile` 这类拼写错误应该立刻被指出来，而不是被静默忽略。
+//
+// 例外：声明了 openFlags 的 action 表示「可选项由数据驱动」（模板的 option
+// schema），声明期无法枚举。这类 action 放行未知 flag，由 action 自己在 run 里
+// 按 schema 取白名单——否则用户永远传不进模板选项。
+function assertKnownFlags(flags, cmd) {
+    if (cmd.openFlags)
+        return;
+    const known = new Set(flagSpecsOf(cmd).map((f) => f.name));
+    for (const k of Object.keys(flags)) {
+        if (!known.has(k))
+            throw badInput(`未知参数 --${k}（用法见 ${APP_NAME} help）`);
+    }
+}
+// ---- 输出 ----
+// render 拿到 (data, ctx)，可以是 async——有些渲染需要补一点上下文才能标注
+// （例如候选清单要标出哪一项是「当前」），而 `--json` 必须保持纯数据的旧形状。
+async function emit(cmd, data, json, ctx) {
+    // 无返回值的命令（help / serve 这类）不该打印任何东西：落进 JSON.stringify(undefined)
+    // 会打出字面量 "undefined"，让 `help --json` 的 stdout 不再是合法 JSON。
+    if (data === undefined && !cmd.render)
+        return;
+    if (json) {
+        if (data === undefined)
+            return;
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (cmd.render) {
+        const text = await cmd.render(data, ctx);
+        if (text !== undefined && text !== null && text !== '')
+            console.log(text);
+        return;
+    }
+    console.log(JSON.stringify(data, null, 2));
+}
+// 失败一律 exit 1；--json 下输出可解析的错误对象。
+// 注意 error 保持字符串（历史契约），code 是新增字段——agent 可据此分支，
+// 老消费方按字符串匹配「用法:」「未设置」「不存在」仍然可用。
+function fail(err, json) {
+    const p = toErrorPayload(err);
+    if (json) {
+        const payload = { ok: false, error: p.message, code: p.code };
+        if (p.details !== undefined)
+            payload.details = p.details;
+        console.log(JSON.stringify(payload, null, 2));
+    }
+    else {
+        console.error('错误: ' + p.message);
+    }
+    process.exitCode = exitCodeOf(p.code);
+}
+/**
+ * 起桥 + 起面板。
+ *
+ * 这是 mn-ws client 半的**常态运行形态**：一条命令既把本机 nx 服务桥出去，
+ * 又把管理面板开在本机。两者在同一个进程里 —— 面板上的「启停桥 / 改白名单」
+ * 操作的就是这条正在跑的桥。
+ *
+ * 面板端口**运行时可选**（--port），且与 server 半的 7777 是两回事：
+ * 面板只在本机监听，server 半在公网机上，两边不冲突。
+ */
+async function cmdServe(ctx) {
+    const { startServer } = await import('./server.js');
+    const { openBrowser } = await import('../core/open.js');
+    const { autoOpenEnabled, resolvePortConflict, describeOccupant } = await import('../core/serve-port.js');
+    const { getController } = await import('../core/controller.js');
+    const host = '127.0.0.1';
+    const desiredPort = Number(ctx.port || DEFAULT_PORT);
+    // --no-open 与 NX_SERVE_NO_OPEN 都看这里：后者是所有 nx-xx 项目共享的开关
+    const canOpen = autoOpenEnabled(ctx['no-open'] === true);
+    // ── 桥 ──
+    const controller = getController(ctx);
+    // 复用 CLI 已存的登录态：有有效设备令牌就直接进入登录态（面板不用再登一遍）
+    const adopted = controller.session.adoptFromAccountStore();
+    const started = controller.start();
+    if (started.started) {
+        console.log(`桥: 已连接 ${controller.cfg.url}（白名单: ${started.apps.join(', ') || '空'}）`);
+    }
+    else {
+        console.log(`桥: 未启动 —— ${started.reason || '未知原因'}`);
+    }
+    if (adopted) {
+        const who = controller.session.snapshot();
+        console.log(`登录: 复用 CLI 登录态（${who.nickname || who.email || who.userId || '已登录'}）`);
+    }
+    else {
+        console.log('登录: 尚未登录 —— 面板会显示登录页（也可先跑 mn-ws auth login）');
+    }
+    let server;
+    try {
+        server = await startServer({ port: desiredPort, host, controller });
+    }
+    catch (err) {
+        if (!err || err.code !== 'EADDRINUSE')
+            throw err;
+        // 端口被占：先问一句「上面跑的是不是我」。
+        const decision = await resolvePortConflict(desiredPort, APP_NAME, host);
+        if (decision.action === 'reuse') {
+            // 自己的面板已经在跑：不重复启动，直接把浏览器指过去。
+            const addr = `http://${host}:${desiredPort}`;
+            console.log(APP_NAME + ' 已在运行：' + addr);
+            console.log('直接打开浏览器（不重复启动）；如需重启请先停掉旧实例');
+            if (canOpen)
+                openBrowser(addr);
+            return;
+        }
+        // 别人占的：顺延到下一个空闲端口，再起自己的面板。
+        console.log(`端口 ${desiredPort} 已被占用（占用者: ${describeOccupant(decision.occupant)}），改用 ${decision.port}`);
+        server = await startServer({ port: decision.port, host, controller });
+    }
+    const bound = server.address();
+    const actualPort = typeof bound === 'object' && bound ? bound.port : desiredPort;
+    const addr = `http://${host}:${actualPort}`;
+    // 面板端口要告诉会话管理器：OIDC 回调落在面板自己的 /callback 上
+    controller.panelPort = actualPort;
+    console.log(APP_NAME + ' v' + VERSION);
+    console.log(`面板:   ${addr}`);
+    console.log(`存储:   ${storePathFromEnv()}`);
+    console.log('CLI:    ' + APP_NAME + ' help（每个按钮都有对应命令，agent 可加 --json）');
+    console.log('按 Ctrl+C 停止');
+    if (canOpen)
+        openBrowser(addr);
+    const shutdown = () => {
+        console.log('\n正在停止...');
+        controller.stop();
+        server.close(() => process.exit(0));
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+/** 环境自检：端口 / 鉴权 / 应用可达性 / server 连通性。 */
+async function cmdDoctor(ctx) {
+    const { getController } = await import('../core/controller.js');
+    const { loadClientConfig } = await import('../core/config.js');
+    const { isPortFree, scanApps } = await import('mn-ws-server/apps');
+    const cfg = loadClientConfig(ctx);
+    const controller = getController(ctx);
+    console.log(`mn-ws doctor  v${VERSION}`);
+    console.log('');
+    console.log('端口');
+    const port = Number(ctx.port || cfg.webPort);
+    const free = await isPortFree(port, '127.0.0.1');
+    console.log(free.free ? `  面板 :${port}  空闲` : `  面板 :${port}  已被占用`);
+    console.log('');
+    console.log('鉴权');
+    const sess = controller.session.snapshot();
+    if (sess.loggedIn) {
+        console.log(`  ✓ 统一登录（${sess.via === 'cli' ? '复用 CLI 登录态' : '面板登录'}）：${sess.nickname || sess.email || sess.userId}`);
+    }
+    else if (cfg.token) {
+        console.log('  ✓ 静态门禁 token（共享密钥，等价全量访问）');
+    }
+    else {
+        console.log('  ! 未登录：无注册令牌，桥会连不上');
+    }
+    console.log('');
+    console.log('可桥接的应用');
+    const { apps } = controller.resolveApps();
+    if (!Object.keys(apps).length) {
+        console.log('  ! 白名单为空 —— 一个都不桥（用 --apps 指定）');
+    }
+    else {
+        const list = await scanApps({ host: '127.0.0.1', apps: Object.keys(apps), overrides: cfg.appOverrides });
+        for (const a of list) {
+            console.log(`  ${a.app.padEnd(10)} ${String(a.port ?? '—').padEnd(7)} ${a.alive ? '✓ 在监听' : '✗ 未运行'}  ${a.base || ''}`);
+        }
+    }
+    console.log('');
+    console.log('server 连通性');
+    try {
+        const res = await fetch(`${cfg.serverHttp.replace(/\/+$/, '')}/health`);
+        const j = (await res.json());
+        console.log(`  ✓ ${cfg.serverHttp}/health → ${j.service || 'ok'} · 桥接数 ${j.bridges ?? 0}`);
+    }
+    catch (e) {
+        console.log(`  ✗ ${cfg.serverHttp}/health → ${e.message}`);
+    }
+}
+// ---- 主入口 ----
+export async function runCli(argv) {
+    const { rest, json, store } = splitGlobals(argv);
+    if (store)
+        process.env[STORE_ENV] = store;
+    const hit = resolveCommand(rest);
+    // 无参数、无全局 flag → **启动**（起桥 + 起面板）。
+    //
+    // 为什么不是「显示帮助」：`mn-ws` 这个命令存在的意义就是「把它跑起来」。
+    // 想看帮助就 `mn-ws help` —— 显式一点，别让「敲个名字」有两种意思。
+    if (!hit) {
+        if (!rest.length) {
+            await cmdServe({});
+            return;
+        }
+        // 裸命令 + flag（`mn-ws --apps nx-kv`）→ 等同 `mn-ws serve --apps nx-kv`。
+        //
+        // 为什么单独认这一种：serve 的 flag 全是**运行时选择**（端口、白名单、
+        // server 地址），用户不想先敲一遍 `serve` 再摆 flag。
+        if (rest[0].startsWith('--')) {
+            const serve = ALL_COMMANDS.find((c) => c.id === 'serve');
+            if (serve) {
+                const { positionals, flags } = parseRest(rest, serve);
+                const input = { ...mapPositionals(positionals, serve), ...flags };
+                const ctx = applySpec(serve, input);
+                await serve.run?.(ctx, { transport: 'cli' });
+                return;
+            }
+        }
+        console.error(`未知命令: ${rest.join(' ')}`);
+        console.error('运行 ' + APP_NAME + ' help 查看用法');
+        process.exitCode = 1;
+        return;
+    }
+    const { cmd, rest: tail } = hit;
+    try {
+        if (tail.includes('--help')) {
+            printCommandHelp(cmd);
+            return;
+        }
+        const { positionals, flags } = parseRest(tail, cmd);
+        assertKnownFlags(flags, cmd);
+        const input = { ...mapPositionals(positionals, cmd), ...flags };
+        const ctx = applySpec(cmd, input);
+        const data = await cmd.run?.(ctx, { transport: 'cli' });
+        await emit(cmd, data, json, ctx);
+    }
+    catch (err) {
+        fail(err, json);
+    }
+}
+// ---- 直接运行本文件时进入 CLI ----
+// dev：`node --import tsx src/runtime/cli.ts ...`（改码即跑，无需构建）；
+// prod：bin 调用 runCli，argv[1] 是 bin → 此处不重复执行；被 import 时不触发。
+import { pathToFileURL } from 'node:url';
+if (process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url) {
+    runCli(process.argv.slice(2)).catch((err) => {
+        console.error(err && err.stack ? err.stack : String(err));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/runtime/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/runtime/cli.ts"],"names":[],"mappings":"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"}

package/dist/runtime/help.d.ts

@@ -0,0 +1,29 @@
+import type { ActionShape } from './types/action.js';
+export interface CommandEntry {
+    id: string;
+    module: string;
+    command: string;
+    usage: string;
+    http: {
+        method: string;
+        path: string;
+    } | null;
+    summary?: string;
+}
+export declare function commandEntry(c: {
+    id: string;
+    module?: string;
+    cli?: ActionShape['cli'];
+    http?: readonly [string, string] | null;
+    summary?: string;
+}): CommandEntry;
+export declare function helpEntries(topic: unknown, all: CommandEntry[]): CommandEntry[];
+export declare function renderHelp(entries: CommandEntry[], topic?: unknown): string;
+export declare function printCommandHelp(cmd: {
+    id: string;
+    module?: string;
+    cli?: ActionShape['cli'];
+    http?: readonly [string, string] | null;
+    summary?: string;
+}): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/runtime/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/runtime/help.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,YAAY,CAUf;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAqB/E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CA2B3E;AAID,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAYP"}

package/dist/runtime/help.js

@@ -0,0 +1,89 @@
+// help 文本与命令条目的派生。从 cli.ts 拆出以控制单文件行数。
+//
+// 全部由命令表生成——help 因此不可能与实际注册的命令脱节。
+import { readFileSync } from 'node:fs';
+import { APP_NAME, STORE_ENV, storePathFromEnv } from '../core/paths.js';
+import { cliPathsOf, usageOf } from './spec.js';
+const VERSION = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+// 命令表的一行。`routes` 与 `help` 共用它，因此两张表必然同源同长——
+// 面板底部的「CLI 等价」提示用的也是这个形状（经 bootstrap 下发）。
+export function commandEntry(c) {
+    const [first] = cliPathsOf(c);
+    return {
+        id: c.id,
+        module: c.module || 'platform',
+        command: APP_NAME + ' ' + (first || []).join(' '),
+        http: c.http ? { method: c.http[0], path: c.http[1] } : null,
+        usage: usageOf(c),
+        summary: c.summary,
+    };
+}
+// 解析帮助主题。既接受模块 id（template），也接受命令组（template）——
+// 用户脑子里想的是「相关的东西」，不会去记内部模块名。
+// 这条路径不能报错退出：`nx-nx help <随便什么>` 失败会让最需要帮助的人卡住。
+export function helpEntries(topic, all) {
+    if (!topic)
+        return all;
+    const t = String(topic);
+    const byModule = all.filter((e) => e.module === t);
+    if (byModule.length)
+        return byModule;
+    const byRoot = all.filter((e) => e.command.split(' ')[1] === t);
+    if (byRoot.length)
+        return byRoot;
+    // 命令本身的 id 也认（如 `nx-nx help template.create`）
+    const byId = all.filter((e) => e.id === t);
+    if (byId.length)
+        return byId;
+    // 命令组名由已注册的命令表现推，不写死——模块增删时提示自动跟上。
+    const roots = all.map((e) => e.command.slice(APP_NAME.length + 1).split(/\s+/)[0]);
+    const groups = [...new Set(roots.filter((r) => roots.filter((x) => x === r).length > 1))]
+        .slice(0, 4)
+        .join(' / ');
+    const topics = [...new Set(all.map((e) => e.module))].join(', ');
+    throw new Error(`未知帮助主题: ${t}（可用模块: ${topics}；或命令组如 ${groups}）`);
+}
+export function renderHelp(entries, topic) {
+    const lines = [];
+    if (!topic) {
+        lines.push(`${APP_NAME} v${VERSION}`);
+        lines.push('CLI 与 Web 面板共享同一 action 声明。');
+        lines.push(`存储: ${storePathFromEnv()}    （环境变量 ${STORE_ENV} 或 --store 覆盖）`);
+        lines.push('');
+    }
+    const groups = new Map();
+    for (const e of entries) {
+        const list = groups.get(e.module) || [];
+        list.push(e);
+        groups.set(e.module, list);
+    }
+    for (const [mod, list] of groups) {
+        lines.push(mod + ':');
+        const width = Math.max(...list.map((e) => e.usage.length));
+        for (const e of list)
+            lines.push('  ' + e.usage.padEnd(width + 2) + e.summary);
+        lines.push('');
+    }
+    lines.push('通用:');
+    lines.push('  --json    机器可读输出（agent 模式）');
+    lines.push('  --store   本次运行覆盖存储路径');
+    return lines.join('\n');
+}
+// `nx-nx <命令> --help`：只打印这一条，而不是整个模块——
+// 之前这里传的是 cmd.cli[0]，对别名 action（cli 是数组的数组）会拼出 "bundled,list"。
+export function printCommandHelp(cmd) {
+    const lines = [usageOf(cmd)];
+    if (cmd.summary)
+        lines.push('    ' + cmd.summary);
+    lines.push('');
+    const aliases = cliPathsOf(cmd)
+        .slice(1)
+        .map((p) => APP_NAME + ' ' + p.join(' '));
+    if (aliases.length)
+        lines.push('别名: ' + aliases.join('  ·  '));
+    if (cmd.http)
+        lines.push('对应路由: ' + cmd.http[0] + ' ' + cmd.http[1]);
+    lines.push('所属模块: ' + (cmd.module || 'platform'));
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=help.js.map

package/dist/runtime/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/runtime/help.ts"],"names":[],"mappings":"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"}