@jesonliu/lark-claudecode-bridge 0.10.0 → 0.13.0

package/dist/session/plugin-command.js

@@ -0,0 +1,110 @@
+// /plugin 飞书端插件管理命令：spawn SDK bundled CLI（plugin-manager）执行安装/启停/市场操作。
+// 权限分级：list 对所有成员开放；变更类（install/uninstall/enable/disable/marketplace）仅 admin。
+// 长操作（安装含 git clone）立即 ack、完成后经 deps.send 异步推送结果——不阻塞 gateway 事件链。
+// managed 模式双目录：list 合并自管目录 + 本机 ~/.claude；变更操作按插件所在目录定向执行，
+// install 默认装 ~/.claude（与本机 claude CLI 共用一份），--dir=managed 装 bridge 自管目录
+import { runPluginCli } from '../executor/plugin-manager.js';
+import { invalidatePluginCache, listInstalledPlugins } from '../executor/plugin-discovery.js';
+const USAGE = [
+    '**插件管理**（仅管理员可变更）',
+    '/plugin list — 已安装插件清单（managed 模式含本机 ~/.claude）',
+    '/plugin install <name[@marketplace]> [--dir=managed] — 安装插件（默认装本机 ~/.claude）',
+    '/plugin uninstall <name> — 卸载插件',
+    '/plugin enable|disable <name> — 启用/停用插件',
+    '/plugin marketplace add <git地址|路径> — 添加插件市场',
+    '/plugin marketplace list — 查看插件市场',
+    '/plugin marketplace update [name] — 更新插件市场',
+    '/plugin marketplace remove <name> — 移除插件市场',
+    '',
+    '💡 插件装好后下一条消息自动加载（无须重启，两处目录的插件都会加载）；/plugins 查看当前会话实际加载的插件',
+].join('\n');
+/** 变更类子命令（admin only）；list 与用法提示对全部成员开放 */
+const ADMIN_SUBS = new Set(['install', 'uninstall', 'enable', 'disable', 'marketplace']);
+/**
+ * 处理 /plugin 子命令，返回立即回复文本。install/uninstall/marketplace 为长操作：
+ * 先回 ack，后台执行完毕（成功/失败/超时）经 deps.send 推送结果。
+ */
+export async function handlePluginCommand(args, deps) {
+    const [sub, ...rest] = args;
+    if (!sub)
+        return USAGE;
+    if (sub === 'help')
+        return USAGE;
+    if (ADMIN_SUBS.has(sub) && !deps.isAdmin) {
+        return '⛔ 插件变更操作仅管理员可用（查看清单可用 /plugin list）';
+    }
+    const bridgeDir = deps.claudeConfigDir;
+    const userDir = deps.userClaudeDir && deps.userClaudeDir !== deps.claudeConfigDir
+        ? deps.userClaudeDir
+        : deps.claudeConfigDir;
+    const dual = bridgeDir !== userDir; // managed 模式：变更类需按插件所在目录定向
+    const invalidateAll = () => { invalidatePluginCache(bridgeDir); if (dual)
+        invalidatePluginCache(userDir); };
+    // --dir=managed：install/marketplace 的目标目录选择（装自管目录；缺省装 ~/.claude）
+    const wantManagedDir = rest.some((s) => s === '--dir=managed' || s === '--dir=bridge');
+    const target = rest.filter((s) => s && !s.startsWith('-') && !s.startsWith('--dir='));
+    const installDir = wantManagedDir ? bridgeDir : userDir;
+    if (sub === 'list') {
+        const rows = pluginListRows(bridgeDir, dual ? userDir : null);
+        return rows
+            ? `**已安装插件**${dual ? '（[bridge]=托管目录 [user]=本机 ~/.claude）' : ''}\n\`\`\`\n${rows}\n\`\`\``
+            : '尚无已安装插件（/plugin install <name[@marketplace]> 安装）';
+    }
+    if (sub === 'marketplace' && target[0] === 'list') {
+        // 市场清单仍走 CLI（repo 缓存目录结构复杂，本地解析收益低）；dual 时提示两处各自的市场
+        const r = await runPluginCli(['marketplace', 'list'], { claudeConfigDir: installDir });
+        if (!r.ok)
+            return `查询失败：${r.text}`;
+        const head = dual ? `（目标目录：${installDir === bridgeDir ? 'bridge 托管' : '本机 ~/.claude'}，--dir=managed 可切换）\n` : '';
+        return `**插件市场**${head ? `\n${head}` : ''}\n\`\`\`\n${r.text}\n\`\`\``;
+    }
+    const requiresTarget = sub !== 'marketplace' || target[0] !== 'list';
+    const name = target.join(' ');
+    if (requiresTarget && !name)
+        return `参数缺失：/plugin ${args.join(' ')} <…>。\n\n${USAGE}`;
+    // 目标目录解析：enable/disable/uninstall 按插件实际所在目录执行（两处都有则都执行）；
+    // install/marketplace 用 installDir（--dir=managed 或缺省 ~/.claude）
+    const cliArgs = [sub, ...target]; // target 已剔除 --dir* 标志；runPluginCli 自行补 plugin 前缀与 -y
+    const dirs = (sub === 'install' || sub === 'marketplace')
+        ? [installDir]
+        : locatePluginDirs(name, bridgeDir, dual ? userDir : null);
+    const label = args.join(' ');
+    void (async () => {
+        const results = [];
+        for (const dir of dirs) {
+            const r = await runPluginCli(cliArgs, { claudeConfigDir: dir });
+            results.push(r.ok
+                ? `✅ ${dual ? `[${dir === bridgeDir ? 'bridge' : 'user'}] ` : ''}完成：\`\`\`\n${r.text}\n\`\`\``
+                : `❌ ${dual ? `[${dir === bridgeDir ? 'bridge' : 'user'}] ` : ''}失败：${r.text}`);
+        }
+        invalidateAll();
+        await deps.send((results.length ? results.join('\n') : '❌ 未找到该插件（两处目录均无安装记录）')
+            + '\n下一条消息起自动加载；/plugins 可查看实际加载清单');
+    })().catch((e) => deps.send(`❌ 插件操作异常（\`/plugin ${label}\`）：${e instanceof Error ? e.message : String(e)}`));
+    return `⏳ 正在执行 \`/plugin ${label}\`（可能需要拉取仓库，稍候推送结果）`;
+}
+/** 合并渲染两处目录的已装插件清单；无任何插件返回 null。sourceTag 仅 dual 模式使用 */
+function pluginListRows(bridgeDir, userDir) {
+    const fmt = (list) => list.map((p) => `${p.enabled ? '✅' : '⬜'} ${p.key}${p.version ? `  v${p.version}` : ''}${p.enabled ? '' : '  （未启用）'}`);
+    const bridgeList = listInstalledPlugins(bridgeDir);
+    if (!userDir) {
+        const rows = fmt(bridgeList);
+        return rows.length ? rows.join('\n') : null;
+    }
+    const rows = [
+        ...bridgeList.map((p) => `[bridge] ${fmt([p])[0]}`),
+        ...listInstalledPlugins(userDir).map((p) => `[user]   ${fmt([p])[0]}`),
+    ];
+    return rows.length ? rows.join('\n') : null;
+}
+/** 按插件名（name 或 name@marketplace）定位所在目录；两处都装了则返回两处（都执行） */
+function locatePluginDirs(name, bridgeDir, userDir) {
+    const inDir = (dir) => listInstalledPlugins(dir).some((p) => p.key === name || p.name === name);
+    const dirs = [];
+    if (inDir(bridgeDir))
+        dirs.push(bridgeDir);
+    if (userDir && inDir(userDir))
+        dirs.push(userDir);
+    return dirs;
+}
+//# sourceMappingURL=plugin-command.js.map

package/dist/session/plugin-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-command.js","sourceRoot":"","sources":["../../src/session/plugin-command.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,8EAA8E;AAC9E,mEAAmE;AACnE,4DAA4D;AAC5D,yEAAyE;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAY9F,MAAM,KAAK,GAAG;IACZ,mBAAmB;IACnB,iDAAiD;IACjD,8EAA8E;IAC9E,iCAAiC;IACjC,yCAAyC;IACzC,6CAA6C;IAC7C,mCAAmC;IACnC,4CAA4C;IAC5C,4CAA4C;IAC5C,EAAE;IACF,4DAA4D;CAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,2CAA2C;AAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAc,EAAE,IAAuB;IAC/E,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,eAAe;QAC/E,CAAC,CAAC,IAAI,CAAC,aAAa;QACpB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IACzB,MAAM,IAAI,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,2BAA2B;IAC/D,MAAM,aAAa,GAAG,GAAG,EAAE,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI;QAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,iEAAiE;IACjE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,eAAe,IAAI,CAAC,KAAK,cAAc,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtF,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAExD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,OAAO,IAAI;YACT,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,UAAU;YAC1F,CAAC,CAAC,kDAAkD,CAAC;IACzD,CAAC;IACD,IAAI,GAAG,KAAK,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAClD,oDAAoD;QACpD,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,OAAO,WAAW,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,UAAU,CAAC;IACzE,CAAC;IACD,MAAM,cAAc,GAAG,GAAG,KAAK,aAAa,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IACrE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,cAAc,IAAI,CAAC,IAAI;QAAE,OAAO,gBAAgB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC;IAEtF,yDAAyD;IACzD,gEAAgE;IAChE,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,sDAAsD;IACxF,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,aAAa,CAAC;QACvD,CAAC,CAAC,CAAC,UAAU,CAAC;QACd,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBACf,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,UAAU;gBAC9F,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,aAAa,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;cAC1E,iCAAiC,CAAC,CAAC;IACzC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,KAAK,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7G,OAAO,oBAAoB,KAAK,qBAAqB,CAAC;AACxD,CAAC;AAED,yDAAyD;AACzD,SAAS,cAAc,CAAC,SAAiB,EAAE,OAAsB;IAC/D,MAAM,GAAG,GAAG,CAAC,IAA6C,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5E,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IACzG,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG;QACX,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;IACF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,0DAA0D;AAC1D,SAAS,gBAAgB,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAsB;IAC/E,MAAM,KAAK,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,IAAI,CACpE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CACzC,CAAC;IACF,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,SAAS,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/types.d.ts

@@ -44,6 +44,58 @@ export interface PermissionsConfig {
     allowTools?: string[];
     dangerousCommands?: RegExp[];
 }
+/** Web 配置页服务器（lcb start / lcb ui 内嵌，node:http 零依赖）：enabled/host/port 均为启动时读取，改动需重启 */
+export interface ServerConfig {
+    enabled?: boolean;
+    host?: string;
+    port?: number;
+}
+export type ClaudeAuthMode = 'inherit' | 'managed';
+/**
+ * 多厂商认证档案（Web 配置页「Claude 认证」管理，0.13 起）。档案仅是配置库：
+ * 当前生效配置始终是 ClaudeConfig 顶层四字段（写入 settings.json 的就是它），
+ * 「设为当前」= 把档案字段拷贝到顶层（互斥凭证同步清理），与 cc-switch 同款切换语义。
+ */
+export interface ClaudeProfile {
+    /** 档案名（显示用，如「官方」「中转站A」「GLM」） */
+    name: string;
+    /** 与 apiKey 二选一 */
+    authToken?: string;
+    /** 与 authToken 二选一 */
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    /** 候选模型集（fable/opus/sonnet/haiku 等各存一条，页面点选即切换当前模型）；model 仍为「设为当前」时的默认模型 */
+    models?: string[];
+}
+/**
+ * Claude 认证与模型配置。inherit = 共享本机 ~/.claude（0.4 起默认行为，登录态/settings 全继承）；
+ * managed = bridge 自管目录（~/.lark-claudecode-bridge/claude/），authToken/apiKey/baseUrl/model
+ * 写入该目录 settings.json 的 env 块——完全摆脱对本机 claude login 的依赖
+ */
+export interface ClaudeConfig {
+    mode?: ClaudeAuthMode;
+    /** ANTHROPIC_AUTH_TOKEN（Bearer，中转站常用）；与 apiKey 二选一 */
+    authToken?: string;
+    /** ANTHROPIC_API_KEY（x-api-key）；与 authToken 二选一 */
+    apiKey?: string;
+    /** ANTHROPIC_BASE_URL（第三方中转端点；官方 API 留空） */
+    baseUrl?: string;
+    /** 写 settings.json 顶层 model + env.ANTHROPIC_MODEL */
+    model?: string;
+    /** 多厂商档案库（不直接生效；Web 页「设为当前」拷贝到顶层） */
+    profiles?: ClaudeProfile[];
+}
+/** 飞书斜杠命令注册定义（同步到开放平台 app_slash_commands；command 不含 / 前缀） */
+export interface SlashCommandDef {
+    command: string;
+    description: string;
+    icon?: string;
+}
+/** 斜杠命令同步配置：extra 为用户自定义透传命令（内置命令集见 commands.SLASH_COMMAND_META，始终参与同步） */
+export interface SlashCommandsConfig {
+    extra?: SlashCommandDef[];
+}
 export interface BridgeConfig {
     /** 多飞书应用（多机器人）：每 app 一条独立 WS 长连接 + 独立会话池（sessions.<appId>.json）。
      *  全部 app 共享本机 ~/.claude：模型设置/登录态/user MCP/skills/插件统一继承，仅会话池隔离 */
@@ -59,6 +111,12 @@ export interface BridgeConfig {
     };
     /** 权限白名单；缺省用 permission-gate 的内置默认（读工具 + Bash + 危险命令表） */
     permissions?: PermissionsConfig;
+    /** Web 配置页服务器；缺省 enabled=true / 127.0.0.1:17317（随 lcb start 常驻） */
+    server?: ServerConfig;
+    /** Claude 认证模式；缺省 inherit（共享 ~/.claude） */
+    claude?: ClaudeConfig;
+    /** 飞书斜杠命令同步；缺省仅内置命令集 */
+    slashCommands?: SlashCommandsConfig;
 }
 export interface IncomingMessage {
     chatId: string;
@@ -66,6 +124,17 @@ export interface IncomingMessage {
     userId: string;
     text: string;
     messageId: string;
+    /** image 消息 / post 内嵌图片的 image_key（gateway 下载后把本地路径注记拼进 text，下游不再消费此字段） */
+    imageKeys?: string[];
+}
+/** parseIncomingMessage 对「明确发给机器人但不支持的消息类型」的拒绝信息（p2p 场景上层回提示；群聊保持静默 null） */
+export interface RejectedMessage {
+    rejected: {
+        kind: 'unsupported-type';
+        chatId: string;
+        chatType: 'p2p' | 'group';
+        messageType: string;
+    };
 }
 /** 卡片回调决策：allow/deny/allow-session 为写工具确认卡；plan-* 为计划确认卡（feedback = 按意见修改时的用户输入） */
 export type CardDecision = 'allow' | 'deny' | 'allow-session' | 'plan-approve' | 'plan-revise' | 'plan-reject';

package/dist/util/open-browser.d.ts

@@ -0,0 +1 @@
+export declare function openBrowser(url: string): void;

package/dist/util/open-browser.js

@@ -0,0 +1,20 @@
+// 跨平台开浏览器（best-effort：失败静默，用户可手动复制 URL）
+import { spawn } from 'node:child_process';
+export function openBrowser(url) {
+    try {
+        if (process.platform === 'win32') {
+            // cmd /c start：Windows 默认浏览器；空标题占位防 URL 被当成标题
+            spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+        }
+        else if (process.platform === 'darwin') {
+            spawn('open', [url], { detached: true, stdio: 'ignore' }).unref();
+        }
+        else {
+            spawn('xdg-open', [url], { detached: true, stdio: 'ignore' }).unref();
+        }
+    }
+    catch {
+        // 开不了浏览器不影响功能：URL 已打印在终端
+    }
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/util/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../src/util/open-browser.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,8CAA8C;YAC9C,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACzG,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACzC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACxE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;AACH,CAAC"}

package/dist/util/server-url.d.ts

@@ -0,0 +1,3 @@
+import type { BridgeConfig } from '../types.js';
+/** 配置页 URL（host/port 回退默认值）；server.enabled=false 时返回 null（无页面可指） */
+export declare function serverUrl(config: BridgeConfig): string | null;

package/dist/util/server-url.js

@@ -0,0 +1,10 @@
+/** 配置页 URL（host/port 回退默认值）；server.enabled=false 时返回 null（无页面可指） */
+export function serverUrl(config) {
+    const s = config.server;
+    if (s?.enabled === false)
+        return null;
+    const host = s?.host ?? '127.0.0.1';
+    const port = s?.port ?? 17317;
+    return `http://${host}:${port}`;
+}
+//# sourceMappingURL=server-url.js.map

package/dist/util/server-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-url.js","sourceRoot":"","sources":["../../src/util/server-url.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,WAAW,CAAC;IACpC,MAAM,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC;IAC9B,OAAO,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.6.0";
+export declare const VERSION: string;

package/dist/version.js

@@ -1,3 +1,7 @@
-// 版本号单一来源：package.json / lcb version / smoke 测试均以此为准
-export const VERSION = '0.6.0';
+// 版本号唯一来源：package.json（运行时读取，避免双份声明漂移——历史上 0.7.0~0.10.0 曾连续漏改）
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
+export const VERSION = pkg.version;
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACnE,CAAC;AAEzB,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/dist/web/config-api.d.ts

@@ -0,0 +1,50 @@
+import type { BridgeConfig, FeishuAppConfig } from '../types.js';
+/** secret 字段的脱敏回显形状（真实值永不离开本机进程） */
+export interface SecretHint {
+    secretSet: boolean;
+    secretHint?: string;
+}
+export declare function maskSecret(value: string | undefined): SecretHint;
+/** 客户端提交的 secret 字段是否应视为「未修改」（空串/缺省/仍是脱敏对象都算） */
+export declare function isUnchangedSecret(v: unknown): boolean;
+/**
+ * secret 回填：客户端 doc 中的 secret 字段（apps[].app_secret、claude.auth_token/api_key）
+ * 未修改时回填磁盘现值。非 secret 字段不动；其余 secret 位置（未来新增）按同模式扩展。
+ */
+export declare function applySecrets(newDoc: Record<string, unknown>, oldDoc: Record<string, unknown>): Record<string, unknown>;
+/** GET /api/config 响应构建：深拷贝 doc 并把 secret 字段替换为脱敏提示 */
+export declare function docForClient(doc: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Host header 校验（防 DNS rebinding）：host 部分（去端口）必须是回环名或配置的 host。
+ * 端口不校验（localhost:port 与 127.0.0.1:port 等价放行，用户从哪个名字进来无从假设）。
+ */
+export declare function isAllowedHost(hostHeader: string | undefined, cfgHost: string): boolean;
+/** Origin header 校验（存在才查；同源 fetch 一定带且 host 合法，跨站请求携带外域 Origin） */
+export declare function isAllowedOrigin(originHeader: string | undefined, cfgHost: string, cfgPort: number): boolean;
+/** PUT 前后比较，列出需重启的段落（其余段落经热重载器下一条消息生效） */
+export declare function computeRestartRequired(before: BridgeConfig, after: BridgeConfig): string[];
+/** apps 启动态摘要（GET /api/status 用；lcb ui 独立进程无法得知，标 unknown） */
+export declare function appStatusSummary(apps: FeishuAppConfig[], started?: Array<{
+    name: string;
+    started: boolean;
+}>): Array<{
+    name: string;
+    appId: string;
+    started: boolean | 'unknown';
+}>;
+/**
+ * GET /api/config 显示层权限默认回填：permissions 键缺失（undefined/null，多见于老版本升级配置）时
+ * 回显运行时默认，让用户「打开页面就能看到/编辑默认值」；键存在但为空数组 = 用户有意清空，原样返回。
+ * PUT 整段替换语义下「回显 → 保存 → 固化写盘」为预期行为（老配置保存会把该段固化为默认并重写，
+ * 丢段内手写注释；bootstrap 出身的配置磁盘已有相同默认，走「值未变跳过重写」不受影响）。
+ */
+export declare function applyPermissionDisplayDefaults(doc: Record<string, unknown>): Record<string, unknown>;
+/** 当前生效 Claude 配置摘要（GET /api/status 展示用）：settings.json 内容 → 凭证脱敏。inherit/managed 均适用 */
+export interface ClaudeCurrentSummary {
+    baseUrl?: string;
+    model?: string;
+    authToken: SecretHint;
+    apiKey: SecretHint;
+}
+/** 纯函数：解析 settings.json（顶层 model + env 块 ANTHROPIC_*），凭证过 maskSecret，明文永不离开本机 */
+export declare function claudeSettingsSummary(settings: unknown): ClaudeCurrentSummary;

package/dist/web/config-api.js

@@ -0,0 +1,184 @@
+import { sameApps } from '../config.js';
+import { DEFAULT_ALLOW_TOOLS_LIST, DEFAULT_DANGEROUS_COMMAND_SOURCES } from '../executor/permission-gate.js';
+export function maskSecret(value) {
+    if (!value)
+        return { secretSet: false };
+    return { secretSet: true, secretHint: `••••${value.slice(-4)}` };
+}
+/** 客户端提交的 secret 字段是否应视为「未修改」（空串/缺省/仍是脱敏对象都算） */
+export function isUnchangedSecret(v) {
+    if (v === undefined || v === null)
+        return true;
+    if (typeof v === 'object')
+        return true; // 仍是 GET 回显的 {secretSet...} 对象
+    if (typeof v === 'string')
+        return v.trim() === '';
+    return true;
+}
+/**
+ * secret 回填：客户端 doc 中的 secret 字段（apps[].app_secret、claude.auth_token/api_key）
+ * 未修改时回填磁盘现值。非 secret 字段不动；其余 secret 位置（未来新增）按同模式扩展。
+ */
+export function applySecrets(newDoc, oldDoc) {
+    const doc = { ...newDoc };
+    const newApps = Array.isArray(doc.apps) ? doc.apps : [];
+    const oldApps = Array.isArray(oldDoc.apps) ? oldDoc.apps : [];
+    // 按 app_id 对齐回填（而非索引）：页面可能增删/重排应用，索引对齐会把别的应用 secret 错配
+    const oldSecretById = new Map(oldApps.map((a) => [String(a?.app_id ?? ''), a?.app_secret]));
+    doc.apps = newApps.map((app) => (isUnchangedSecret(app?.app_secret)
+        ? { ...app, app_secret: oldSecretById.get(String(app?.app_id ?? '')) } // 新应用查不到 → undefined，loadConfig 拦截
+        : app));
+    if (doc.claude && typeof doc.claude === 'object' && !Array.isArray(doc.claude)) {
+        const newClaude = { ...doc.claude };
+        const oldClaude = oldDoc.claude && typeof oldDoc.claude === 'object' && !Array.isArray(oldDoc.claude)
+            ? oldDoc.claude
+            : {};
+        for (const key of ['auth_token', 'api_key']) {
+            if (isUnchangedSecret(newClaude[key]))
+                newClaude[key] = oldClaude[key];
+        }
+        // 多厂商档案（0.13）：按 name 对齐回填未修改的凭证（同 apps 按 app_id 对齐的考虑）
+        if (Array.isArray(newClaude.profiles)) {
+            const oldByName = new Map((Array.isArray(oldClaude.profiles) ? oldClaude.profiles : [])
+                .map((p) => [String(p?.name ?? ''), p]));
+            newClaude.profiles = newClaude.profiles.map((p) => {
+                const old = oldByName.get(String(p?.name ?? ''));
+                if (!old)
+                    return p; // 新档案：提交值即最终值（无凭证无内容会被 normalizeClaude 剔除）
+                const merged = { ...p };
+                for (const key of ['auth_token', 'api_key']) {
+                    if (isUnchangedSecret(merged[key]))
+                        merged[key] = old[key];
+                }
+                return merged;
+            });
+        }
+        doc.claude = newClaude;
+    }
+    return doc;
+}
+/** GET /api/config 响应构建：深拷贝 doc 并把 secret 字段替换为脱敏提示 */
+export function docForClient(doc) {
+    const out = JSON.parse(JSON.stringify(doc ?? {}));
+    if (Array.isArray(out.apps)) {
+        out.apps = out.apps.map((app) => ({
+            ...app,
+            app_secret: maskSecret(typeof app?.app_secret === 'string' ? app.app_secret : undefined),
+        }));
+    }
+    if (out.claude && typeof out.claude === 'object') {
+        const c = { ...out.claude };
+        for (const key of ['auth_token', 'api_key']) {
+            c[key] = maskSecret(typeof c[key] === 'string' ? c[key] : undefined);
+        }
+        if (Array.isArray(c.profiles)) {
+            c.profiles = c.profiles.map((p) => ({
+                ...p,
+                auth_token: maskSecret(typeof p?.auth_token === 'string' ? p.auth_token : undefined),
+                api_key: maskSecret(typeof p?.api_key === 'string' ? p.api_key : undefined),
+            }));
+        }
+        out.claude = c;
+    }
+    return out;
+}
+/**
+ * Host header 校验（防 DNS rebinding）：host 部分（去端口）必须是回环名或配置的 host。
+ * 端口不校验（localhost:port 与 127.0.0.1:port 等价放行，用户从哪个名字进来无从假设）。
+ */
+export function isAllowedHost(hostHeader, cfgHost) {
+    if (!hostHeader)
+        return false;
+    let hostPart = hostHeader;
+    const bracket = hostPart.match(/^\[([^\]]+)\]/); // 规范 IPv6 host：[::1]:8080
+    if (bracket) {
+        hostPart = bracket[1];
+    }
+    else {
+        // 仅单一冒号视为 host:port（裸 IPv6 多冒号整体保留；多冒号场景只可能命中 '::1' 白名单）
+        const last = hostPart.lastIndexOf(':');
+        if (last !== -1 && hostPart.indexOf(':') === last)
+            hostPart = hostPart.slice(0, last);
+    }
+    return hostPart === '127.0.0.1' || hostPart === 'localhost' || hostPart === '::1' || hostPart === cfgHost;
+}
+/** Origin header 校验（存在才查；同源 fetch 一定带且 host 合法，跨站请求携带外域 Origin） */
+export function isAllowedOrigin(originHeader, cfgHost, cfgPort) {
+    if (!originHeader)
+        return true; // 非 CORS 场景（curl / 同源部分实现）无 Origin，放行给 Host 校验兜底
+    try {
+        const u = new URL(originHeader);
+        return u.origin === `http://${cfgHost}:${cfgPort}`
+            || u.origin === `http://127.0.0.1:${cfgPort}`
+            || u.origin === `http://localhost:${cfgPort}`;
+    }
+    catch {
+        return false;
+    }
+}
+/** PUT 前后比较，列出需重启的段落（其余段落经热重载器下一条消息生效） */
+export function computeRestartRequired(before, after) {
+    const sections = [];
+    if (!sameApps(before.apps, after.apps))
+        sections.push('apps');
+    if (before.concurrency !== after.concurrency)
+        sections.push('concurrency');
+    if (JSON.stringify(before.claude ?? {}) !== JSON.stringify(after.claude ?? {}))
+        sections.push('claude');
+    if (JSON.stringify(before.server ?? {}) !== JSON.stringify(after.server ?? {}))
+        sections.push('server');
+    return sections;
+}
+/** apps 启动态摘要（GET /api/status 用；lcb ui 独立进程无法得知，标 unknown） */
+export function appStatusSummary(apps, started) {
+    return apps.map((a) => ({
+        name: a.name,
+        appId: a.appId,
+        started: started?.find((s) => s.name === a.name)?.started ?? 'unknown',
+    }));
+}
+/**
+ * GET /api/config 显示层权限默认回填：permissions 键缺失（undefined/null，多见于老版本升级配置）时
+ * 回显运行时默认，让用户「打开页面就能看到/编辑默认值」；键存在但为空数组 = 用户有意清空，原样返回。
+ * PUT 整段替换语义下「回显 → 保存 → 固化写盘」为预期行为（老配置保存会把该段固化为默认并重写，
+ * 丢段内手写注释；bootstrap 出身的配置磁盘已有相同默认，走「值未变跳过重写」不受影响）。
+ */
+export function applyPermissionDisplayDefaults(doc) {
+    const p = doc.permissions;
+    if (p === undefined || p === null) {
+        return { ...doc, permissions: { allow_tools: [...DEFAULT_ALLOW_TOOLS_LIST], dangerous_commands: [...DEFAULT_DANGEROUS_COMMAND_SOURCES] } };
+    }
+    if (typeof p !== 'object' || Array.isArray(p))
+        return doc; // 脏形状：loadConfig/parseConfigText 会拦，GET 原样透出
+    const np = { ...p };
+    let changed = false;
+    if (np.allow_tools === undefined || np.allow_tools === null) {
+        np.allow_tools = [...DEFAULT_ALLOW_TOOLS_LIST];
+        changed = true;
+    }
+    if (np.dangerous_commands === undefined || np.dangerous_commands === null) {
+        np.dangerous_commands = [...DEFAULT_DANGEROUS_COMMAND_SOURCES];
+        changed = true;
+    }
+    return changed ? { ...doc, permissions: np } : doc;
+}
+/** 纯函数：解析 settings.json（顶层 model + env 块 ANTHROPIC_*），凭证过 maskSecret，明文永不离开本机 */
+export function claudeSettingsSummary(settings) {
+    if (!settings || typeof settings !== 'object' || Array.isArray(settings)) {
+        return { authToken: maskSecret(undefined), apiKey: maskSecret(undefined) };
+    }
+    const doc = settings;
+    const env = doc.env && typeof doc.env === 'object' && !Array.isArray(doc.env)
+        ? doc.env
+        : {};
+    const str = (v) => (typeof v === 'string' && v.trim() ? v : undefined);
+    const baseUrl = str(env.ANTHROPIC_BASE_URL);
+    const model = str(env.ANTHROPIC_MODEL) ?? str(doc.model);
+    return {
+        ...(baseUrl ? { baseUrl } : {}),
+        ...(model ? { model } : {}),
+        authToken: maskSecret(str(env.ANTHROPIC_AUTH_TOKEN)),
+        apiKey: maskSecret(str(env.ANTHROPIC_API_KEY)),
+    };
+}
+//# sourceMappingURL=config-api.js.map

package/dist/web/config-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-api.js","sourceRoot":"","sources":["../../src/web/config-api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAK7G,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACxC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnE,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,iBAAiB,CAAC,CAAU;IAC1C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,+BAA+B;IACvE,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B,EAAE,MAA+B;IAC3F,MAAM,GAAG,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,IAAuC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,IAAuC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,uDAAuD;IACvD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5F,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAC9B,iBAAiB,CAAC,GAAG,EAAE,UAAU,CAAC;QAChC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,mCAAmC;QAC1G,CAAC,CAAC,GAAG,CACR,CAAC,CAAC;IACH,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,MAAM,SAAS,GAAG,EAAE,GAAI,GAAG,CAAC,MAAkC,EAAE,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YACnG,CAAC,CAAE,MAAM,CAAC,MAAkC;YAC5C,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAU,EAAE,CAAC;YACrD,IAAI,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,uDAAuD;QACvD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAA0C,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5F,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAC1C,CAAC;YACF,SAAS,CAAC,QAAQ,GAAI,SAAS,CAAC,QAA2C,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACpF,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjD,IAAI,CAAC,GAAG;oBAAE,OAAO,CAAC,CAAC,CAAC,2CAA2C;gBAC/D,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAU,EAAE,CAAC;oBACrD,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC7D,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,GAA4B;IACvD,MAAM,GAAG,GAA4B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,GAAI,GAAG,CAAC,IAAuC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG,GAAG;YACN,UAAU,EAAE,UAAU,CAAC,OAAO,GAAG,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;SACzF,CAAC,CAAC,CAAC;IACN,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,EAAE,GAAI,GAAG,CAAC,MAAkC,EAAE,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,CAAU,EAAE,CAAC;YACrD,CAAC,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,CAAC,CAAC,QAAQ,GAAI,CAAC,CAAC,QAA2C,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtE,GAAG,CAAC;gBACJ,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;aAC5E,CAAC,CAAC,CAAC;QACN,CAAC;QACD,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAA8B,EAAE,OAAe;IAC3E,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,QAAQ,GAAG,UAAU,CAAC;IAC1B,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,0BAA0B;IAC3E,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,yDAAyD;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;YAAE,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,OAAO,CAAC;AAC5G,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,YAAgC,EAAE,OAAe,EAAE,OAAe;IAChG,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC,CAAC,iDAAiD;IACjF,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU,OAAO,IAAI,OAAO,EAAE;eAC7C,CAAC,CAAC,MAAM,KAAK,oBAAoB,OAAO,EAAE;eAC1C,CAAC,CAAC,MAAM,KAAK,oBAAoB,OAAO,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,sBAAsB,CAAC,MAAoB,EAAE,KAAmB;IAC9E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,IAAuB,EAAE,OAAmD;IAC3G,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,IAAI,SAAS;KACvE,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,GAA4B;IACzE,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,wBAAwB,CAAC,EAAE,kBAAkB,EAAE,CAAC,GAAG,iCAAiC,CAAC,EAAE,EAAE,CAAC;IAC7I,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,6CAA6C;IACxG,MAAM,EAAE,GAAG,EAAE,GAAI,CAA6B,EAAE,CAAC;IACjD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,EAAE,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAAC,EAAE,CAAC,WAAW,GAAG,CAAC,GAAG,wBAAwB,CAAC,CAAC;QAAC,OAAO,GAAG,IAAI,CAAC;IAAC,CAAC;IAChI,IAAI,EAAE,CAAC,kBAAkB,KAAK,SAAS,IAAI,EAAE,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAAC,EAAE,CAAC,kBAAkB,GAAG,CAAC,GAAG,iCAAiC,CAAC,CAAC;QAAC,OAAO,GAAG,IAAI,CAAC;IAAC,CAAC;IAC9J,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC;AAUD,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,QAAiB;IACrD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;IAC7E,CAAC;IACD,MAAM,GAAG,GAAG,QAAmC,CAAC;IAChD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAC3E,CAAC,CAAC,GAAG,CAAC,GAA8B;QACpC,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,GAAG,GAAG,CAAC,CAAU,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/web/lifecycle.d.ts

@@ -0,0 +1,52 @@
+/** 桥接器进程启动成功后自写 PID 文件（页面据此探活/跨进程停止） */
+export declare function writePidFile(pidPath?: string): void;
+/** 优雅关闭时自清 PID 文件；文件已被其它进程覆写（重启竞态）时不误删 */
+export declare function clearPidFile(pidPath?: string): void;
+export interface BridgeStatus {
+    running: boolean;
+    pid: number | null;
+}
+/** 探活桥接器；PID 文件指向已消亡进程（崩溃/被硬杀未及清理）时顺手清掉陈旧文件 */
+export declare function bridgeStatus(pidPath?: string): BridgeStatus;
+/**
+ * 解析 lcb CLI 入口（发布包 dist/bin/lcb.js；模块位置相对定位，tsx 源码模式下该路径不存在）。
+ * 源码运行时返回 error——页面按钮禁用并提示手动启停
+ */
+export declare function resolveLcbEntry(): {
+    ok: true;
+    entry: string;
+} | {
+    ok: false;
+    error: string;
+};
+/** 后台拉起桥接器：detached 守护进程，stdio 落 bridge.log，父进程退出不影响其存活 */
+export declare function spawnBridgeDetached(): {
+    ok: true;
+    pid: number;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * 停止指定 PID 的桥接器。Windows 上 SIGTERM 等效 TerminateProcess（不走进程内优雅关闭
+ * handler）；会话/配对状态均逐消息落盘，硬终止风险可控。同进程内（embedded）停止走
+ * server.ts 注入的 selfStop 优雅路径，不经本函数
+ */
+export declare function stopBridgeByPid(pid: number): boolean;
+/** 重启桥接器：spawn detached helper 由其等待旧进程退出后拉起新进程（跨平台统一路径） */
+export declare function restartBridgeWithHelper(oldPid: number): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * lcb start 启动早期调用：探活并终止 pid 文件登记的旧实例，轮询等待真正退出。
+ * 旧实例占着 Web 配置页端口会让本进程配置页静默失联（浏览器仍打到旧进程）。
+ * Windows 上 SIGTERM=硬杀仍为异步，端口释放有延迟，故轮询（300ms 节奏同 RESTART_HELPER）。
+ * 纯逻辑不打日志（由调用方输出），便于测试
+ */
+export declare function stopExistingBridgeAndWait(timeoutMs?: number, pidPath?: string): Promise<{
+    stopped: boolean;
+    pid: number | null;
+}>;