@jesonliu/lark-claudecode-bridge 0.10.0 → 0.13.0

package/dist/web/lifecycle.js

@@ -0,0 +1,167 @@
+// 桥接器进程生命周期：PID 文件探活 / 后台拉起 / 跨进程停止 / 旧进程退出后重启。
+// 消费方：Web 配置页 /api/bridge/* 端点（页面按钮启停）；startBridge 写/清 PID（src/index.ts）。
+// 路径参数可注入（默认 CONFIG_DIR），便于测试用临时目录
+import { closeSync, existsSync, openSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CONFIG_DIR } from '../config.js';
+const PID_PATH = join(CONFIG_DIR, 'bridge.pid');
+const LOG_PATH = join(CONFIG_DIR, 'bridge.log');
+/** 后台运行日志超 5MB 先截断，避免常驻进程日志无限增长 */
+const LOG_TRUNCATE_BYTES = 5 * 1024 * 1024;
+/** 桥接器进程启动成功后自写 PID 文件（页面据此探活/跨进程停止） */
+export function writePidFile(pidPath = PID_PATH) {
+    writeFileSync(pidPath, String(process.pid), 'utf8');
+}
+/** 优雅关闭时自清 PID 文件；文件已被其它进程覆写（重启竞态）时不误删 */
+export function clearPidFile(pidPath = PID_PATH) {
+    try {
+        if (readPidFile(pidPath) === process.pid)
+            rmSync(pidPath, { force: true });
+    }
+    catch { /* 文件不存在等：无事 */ }
+}
+function readPidFile(pidPath) {
+    try {
+        const n = Number.parseInt(readFileSync(pidPath, 'utf8').trim(), 10);
+        return Number.isInteger(n) && n > 0 ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 进程是否存活：signal 0 仅探测不发送；EPERM = 存在但属他人，仍视为存活 */
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'EPERM';
+    }
+}
+/** 探活桥接器；PID 文件指向已消亡进程（崩溃/被硬杀未及清理）时顺手清掉陈旧文件 */
+export function bridgeStatus(pidPath = PID_PATH) {
+    const pid = readPidFile(pidPath);
+    if (pid === null)
+        return { running: false, pid: null };
+    if (isPidAlive(pid))
+        return { running: true, pid };
+    try {
+        rmSync(pidPath, { force: true });
+    }
+    catch { /* 并发清理竞态：忽略 */ }
+    return { running: false, pid: null };
+}
+/**
+ * 解析 lcb CLI 入口（发布包 dist/bin/lcb.js；模块位置相对定位，tsx 源码模式下该路径不存在）。
+ * 源码运行时返回 error——页面按钮禁用并提示手动启停
+ */
+export function resolveLcbEntry() {
+    // dist/web/lifecycle.js → ../bin/lcb.js = dist/bin/lcb.js；tsx 源码模式下对应 src/bin/lcb.js
+    // （实际是 lcb.ts，node 跑不了）→ 不存在即返回 error，页面按钮禁用提示手动启停
+    const entry = fileURLToPath(new URL('../bin/lcb.js', import.meta.url));
+    if (!existsSync(entry)) {
+        return { ok: false, error: '未找到 dist/bin/lcb.js：源码（tsx）运行模式不支持由页面启停桥接器，请手动运行 lcb start' };
+    }
+    return { ok: true, entry };
+}
+/** 打开后台日志 fd（append；超 5MB 先截断） */
+function openLogFd() {
+    try {
+        if (existsSync(LOG_PATH) && statSync(LOG_PATH).size > LOG_TRUNCATE_BYTES)
+            rmSync(LOG_PATH, { force: true });
+    }
+    catch { /* 截断失败继续 append */ }
+    return openSync(LOG_PATH, 'a');
+}
+/** 后台拉起桥接器：detached 守护进程，stdio 落 bridge.log，父进程退出不影响其存活 */
+export function spawnBridgeDetached() {
+    const r = resolveLcbEntry();
+    if (!r.ok)
+        return r;
+    const fd = openLogFd();
+    const child = spawn(process.execPath, [r.entry, 'start'], {
+        detached: true,
+        stdio: ['ignore', fd, fd],
+        windowsHide: true,
+    });
+    child.unref();
+    closeSync(fd); // 父进程关闭自有 fd 副本（子进程已继承）
+    return { ok: true, pid: child.pid ?? -1 };
+}
+/**
+ * 停止指定 PID 的桥接器。Windows 上 SIGTERM 等效 TerminateProcess（不走进程内优雅关闭
+ * handler）；会话/配对状态均逐消息落盘，硬终止风险可控。同进程内（embedded）停止走
+ * server.ts 注入的 selfStop 优雅路径，不经本函数
+ */
+export function stopBridgeByPid(pid) {
+    try {
+        process.kill(pid, 'SIGTERM');
+        return true;
+    }
+    catch {
+        return false; // 已退出或无权限
+    }
+}
+/**
+ * 内嵌重启 helper（CJS，node -e 执行）：轮询旧进程退出 → 拉起新桥接器 → 自退。
+ * 不能「先拉新再杀旧」：新进程的 Web 配置页会因端口仍被旧进程占用而启动失败，
+ * 导致重启后页面失联。超时 30s 放弃（保留旧进程运行态，页面可重试）
+ */
+const RESTART_HELPER = `
+const { spawn } = require('node:child_process');
+const { openSync, closeSync, existsSync, statSync, rmSync } = require('node:fs');
+const [oldPid, entry, logPath] = process.argv.slice(1);
+const t0 = Date.now();
+(function wait() {
+  try { process.kill(+oldPid, 0); } catch {
+    try {
+      if (existsSync(logPath) && statSync(logPath).size > 5*1024*1024) rmSync(logPath, { force: true });
+      const fd = openSync(logPath, 'a');
+      const child = spawn(process.execPath, [entry, 'start'], { detached: true, stdio: ['ignore', fd, fd], windowsHide: true });
+      child.unref();
+      closeSync(fd);
+    } catch (e) { try { console.error('restart helper failed:', e); } catch {} }
+    process.exit(0);
+  }
+  if (Date.now() - t0 > 30000) process.exit(1);
+  setTimeout(wait, 300);
+})();
+`;
+/** 重启桥接器：spawn detached helper 由其等待旧进程退出后拉起新进程（跨平台统一路径） */
+export function restartBridgeWithHelper(oldPid) {
+    const r = resolveLcbEntry();
+    if (!r.ok)
+        return r;
+    const helper = spawn(process.execPath, ['-e', RESTART_HELPER, String(oldPid), r.entry, LOG_PATH], {
+        detached: true,
+        stdio: 'ignore',
+        windowsHide: true,
+    });
+    helper.unref();
+    return { ok: true };
+}
+/**
+ * lcb start 启动早期调用：探活并终止 pid 文件登记的旧实例，轮询等待真正退出。
+ * 旧实例占着 Web 配置页端口会让本进程配置页静默失联（浏览器仍打到旧进程）。
+ * Windows 上 SIGTERM=硬杀仍为异步，端口释放有延迟，故轮询（300ms 节奏同 RESTART_HELPER）。
+ * 纯逻辑不打日志（由调用方输出），便于测试
+ */
+export async function stopExistingBridgeAndWait(timeoutMs = 10_000, pidPath = PID_PATH) {
+    const st = bridgeStatus(pidPath); // 指向已消亡进程时顺手清理陈旧文件
+    if (!st.running || st.pid === null || st.pid === process.pid)
+        return { stopped: false, pid: null };
+    const pid = st.pid;
+    if (!stopBridgeByPid(pid))
+        return { stopped: false, pid }; // 无权限等：交给调用方提示
+    const t0 = Date.now();
+    while (isPidAlive(pid)) {
+        if (Date.now() - t0 > timeoutMs)
+            return { stopped: false, pid };
+        await new Promise((r) => setTimeout(r, 300));
+    }
+    return { stopped: true, pid };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/web/lifecycle.js.map

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

package/dist/web/model-list.d.ts

@@ -0,0 +1,36 @@
+export type ModelCredType = 'auth_token' | 'api_key';
+export interface ModelFetchParams {
+    baseUrl: string;
+    credType: ModelCredType;
+    credential: string;
+}
+export declare const DEFAULT_MODEL_BASE = "https://api.anthropic.com";
+/** body 明文凭证优先；空/缺省回落磁盘 claude 段（带 profile_name 时回落该档案）；两处皆无 → error（联合类型便于路由层直接 400） */
+export declare function resolveModelFetchParams(body: {
+    base_url?: unknown;
+    auth_token?: unknown;
+    api_key?: unknown;
+    profile_name?: unknown;
+}, disk: {
+    baseUrl?: string;
+    authToken?: string;
+    apiKey?: string;
+    profiles?: Array<{
+        name: string;
+        authToken?: string;
+        apiKey?: string;
+        baseUrl?: string;
+    }>;
+} | undefined): ModelFetchParams | {
+    error: string;
+};
+/** GET 模型列表的 URL+请求头：双发认证头（OpenAI 风格认 Bearer、Anthropic 风格认 x-api-key），
+ *  anthropic-version 对非 Anthropic 网关是未知头、按惯例忽略，无害 */
+export declare function buildModelListRequest(p: ModelFetchParams): {
+    url: string;
+    headers: Record<string, string>;
+};
+/** 宽容解析多形状模型列表：{data:[{id}]}（OpenAI/Anthropic 通用）/ {data:["id"]} / {models:[...]} / {result:[...]} */
+export declare function parseModelList(payload: unknown): string[];
+/** 实际拉取：全局 fetch（Node≥20 自带），AbortController 超时；非 2xx 抛带状态码+截断 body 的 Error */
+export declare function fetchModelList(p: ModelFetchParams, fetchFn?: typeof fetch, timeoutMs?: number): Promise<string[]>;

package/dist/web/model-list.js

@@ -0,0 +1,101 @@
+// 模型列表拉取（Web 配置页「拉取模型」按钮）。厂商无关：模型可能来自 Anthropic 官方、
+// OpenAI 风格中转站或任意兼容网关，故 URL 拼接兼容带/不带 /v1 的 base、认证头双发、
+// 响应形状宽容解析。纯函数与 fetch 分离（fetchFn 可注入，测试免网络）。
+export const DEFAULT_MODEL_BASE = 'https://api.anthropic.com';
+/** body 明文凭证优先；空/缺省回落磁盘 claude 段（带 profile_name 时回落该档案）；两处皆无 → error（联合类型便于路由层直接 400） */
+export function resolveModelFetchParams(body, disk) {
+    const pick = (v) => (typeof v === 'string' && v.trim() ? v.trim() : undefined);
+    // 档案编辑抽屉场景：body.profile_name 指定档案，磁盘回落取该档案（而非顶层）的凭证与 base_url
+    const pname = pick(body.profile_name);
+    const prof = pname ? disk?.profiles?.find((p) => p.name === pname) : undefined;
+    let baseUrl = pick(body.base_url);
+    if (!baseUrl)
+        baseUrl = (pname ? prof?.baseUrl : undefined) ?? disk?.baseUrl ?? DEFAULT_MODEL_BASE;
+    const bToken = pick(body.auth_token);
+    const bKey = pick(body.api_key);
+    // pname 命中档案时严格用档案凭证（档案选了哪种类型就按哪种，顶层不混入）；否则回落顶层
+    const dToken = (pname && prof ? prof.authToken : disk?.authToken)?.trim() || undefined;
+    const dKey = (pname && prof ? prof.apiKey : disk?.apiKey)?.trim() || undefined;
+    // 优先级：body 明文（用户刚输入、尚未保存，按其选择的类型）> 磁盘（档案/顶层，token 型先于 key 型）
+    if (bToken)
+        return { baseUrl, credType: 'auth_token', credential: bToken };
+    if (bKey)
+        return { baseUrl, credType: 'api_key', credential: bKey };
+    if (dToken)
+        return { baseUrl, credType: 'auth_token', credential: dToken };
+    if (dKey)
+        return { baseUrl, credType: 'api_key', credential: dKey };
+    return {
+        error: '未找到可用凭证：请在表单填入 Auth Token / API Key 后重试（无须先保存），或保存 managed 模式凭证。'
+            + 'inherit 模式使用本机 ~/.claude 登录，页面无法代取其凭证。',
+    };
+}
+/** GET 模型列表的 URL+请求头：双发认证头（OpenAI 风格认 Bearer、Anthropic 风格认 x-api-key），
+ *  anthropic-version 对非 Anthropic 网关是未知头、按惯例忽略，无害 */
+export function buildModelListRequest(p) {
+    const base = p.baseUrl.replace(/\/+$/, ''); // 剥尾部斜杠
+    const url = /\/v\d+$/.test(base) ? `${base}/models` : `${base}/v1/models`;
+    return {
+        url,
+        headers: {
+            Accept: 'application/json',
+            'anthropic-version': '2023-06-01',
+            Authorization: `Bearer ${p.credential}`,
+            'x-api-key': p.credential,
+        },
+    };
+}
+/** 宽容解析多形状模型列表：{data:[{id}]}（OpenAI/Anthropic 通用）/ {data:["id"]} / {models:[...]} / {result:[...]} */
+export function parseModelList(payload) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+        throw new Error('无法识别的响应格式（期望 JSON 对象含 data/models 数组）');
+    }
+    const candidates = payload.data
+        ?? payload.models
+        ?? payload.result;
+    if (!Array.isArray(candidates)) {
+        throw new Error('无法识别的响应格式（期望 data/models 数组）');
+    }
+    const ids = new Set();
+    for (const item of candidates) {
+        const id = typeof item === 'string' ? item
+            : (item && typeof item === 'object' && typeof item.id === 'string')
+                ? item.id
+                : undefined;
+        if (id?.trim())
+            ids.add(id.trim());
+    }
+    return [...ids].sort();
+}
+/** 实际拉取：全局 fetch（Node≥20 自带），AbortController 超时；非 2xx 抛带状态码+截断 body 的 Error */
+export async function fetchModelList(p, fetchFn = fetch, timeoutMs = 15000) {
+    const { url, headers } = buildModelListRequest(p);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let res;
+    try {
+        res = await fetchFn(url, { method: 'GET', headers, signal: controller.signal });
+    }
+    catch (e) {
+        throw new Error(`模型列表请求失败：${e instanceof Error ? e.message : String(e)}（请检查 BASE_URL 可达性；也可直接手动填写模型名）`);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const text = await res.text().catch(() => '');
+    if (!res.ok) {
+        throw new Error(`模型列表拉取失败：HTTP ${res.status} ${text.slice(0, 200)}（也可直接手动填写模型名）`);
+    }
+    let payload;
+    try {
+        payload = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`响应不是合法 JSON（前 200 字符：${text.slice(0, 200) || '(空)'}）；也可直接手动填写模型名`);
+    }
+    const models = parseModelList(payload);
+    if (!models.length)
+        throw new Error('响应中没有模型条目；也可直接手动填写模型名');
+    return models;
+}
+//# sourceMappingURL=model-list.js.map

package/dist/web/model-list.js.map

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

package/dist/web/server.d.ts

@@ -0,0 +1,22 @@
+import type { ServerConfig } from '../types.js';
+export interface WebServerOptions {
+    /** server 段配置；缺省用默认（firstRun 无配置文件场景） */
+    server?: ServerConfig;
+    configPath?: string;
+    /** true = lcb start 内嵌（页面顶栏标识 + status.apps 显示启动态） */
+    embedded?: boolean;
+    /** 启动后自动开浏览器 */
+    autoOpen?: boolean;
+    appsStarted?: Array<{
+        name: string;
+        started: boolean;
+    }>;
+    /** embedded 模式下页面停止/重启自身进程的优雅关闭回调（lcb start 注入 shutdown） */
+    selfStop?: () => void;
+}
+export interface WebServerHandle {
+    url: string;
+    port: number;
+    close(): void;
+}
+export declare function startWebServer(opts?: WebServerOptions): Promise<WebServerHandle | null>;