@jesonliu/lark-claudecode-bridge 0.3.0

package/dist/session/channel.js

@@ -0,0 +1,44 @@
+/** 通道键：chatId 与 userId 拼接，同 chat + 同 user 视为同一会话通道 */
+export function channelKey(chatId, userId) {
+    return `${chatId}:${userId}`;
+}
+/**
+ * 异步信号量：限制同时在跑的 Claude 任务数。
+ * acquire() 返回一个 release 函数，调用后唤醒最早排队者（FIFO）。
+ *
+ * - 许可转移式 release：有等待者时不减 active，直接把许可转移给队首等待者，
+ *   消除「release 先减、waiter 恢复后加」的 microtask 窗口内被新 acquire 插队超发。
+ * - 每个 release 带 once 保护：重复调用为 no-op，防止 active 递减为负。
+ */
+export class Semaphore {
+    n;
+    active = 0;
+    waiters = [];
+    constructor(n) {
+        this.n = n;
+    }
+    async acquire() {
+        if (this.active < this.n) {
+            this.active++;
+        }
+        else {
+            // 排队等待；许可由 release() 原地转移（active 保持），唤醒后不再自增
+            await new Promise((resolve) => this.waiters.push(resolve));
+        }
+        return this.makeRelease();
+    }
+    makeRelease() {
+        let released = false;
+        return () => {
+            if (released)
+                return; // 重复释放为 no-op
+            released = true;
+            const next = this.waiters.shift();
+            if (next)
+                next(); // 许可直接转移给队首等待者，active 不变
+            else
+                this.active--;
+        };
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/session/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/session/channel.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAc;IACvD,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IAIA,CAAC;IAHb,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAsB,EAAE,CAAC;IAExC,YAAoB,CAAS;iBAAT,CAAC;IAAW,CAAC;IAEjC,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAEO,WAAW;QACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO,CAAC,cAAc;YACpC,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC,CAAC,yBAAyB;;gBACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC;CACF"}

package/dist/session/commands.d.ts

@@ -0,0 +1,24 @@
+import type { BridgeConfig } from '../types.js';
+import type { SessionStore } from './session-store.js';
+export interface CommandContext {
+    channelKey: string;
+    store: SessionStore;
+    config: BridgeConfig;
+    /** 本机器人显示名：多机器人同群/多会话时 /status 需要辨认对谁说话 */
+    appName: string;
+    /** member 不能 /ws use 切换工作区（spec 权限分级） */
+    isAdmin: boolean;
+    currentWorkspace(): string;
+    stopCurrentTask(): boolean;
+}
+export interface CommandResult {
+    handled: boolean;
+    reply?: string;
+    taskText?: string;
+}
+/**
+ * 斜杠命令处理。非 / 开头的文本返回 { handled: false, taskText } 交给任务链路。
+ * 会话编号约定：列表按时间正序展示（1 = 最早归档）；
+ * 内部存储为新→旧（sessions[0] 为当前），故编号 n 对应内部下标 length - n。
+ */
+export declare function handleCommand(text: string, ctx: CommandContext): Promise<CommandResult>;

package/dist/session/commands.js

@@ -0,0 +1,87 @@
+const HELP = `**可用命令**
+/new — 开启新会话
+/resume — 列出历史会话
+/resume <编号> — 恢复指定会话
+/stop — 停止当前任务
+/status — 查看当前状态
+/ws list — 列出工作区
+/ws use <名字> — 切换工作区
+/help — 帮助`;
+/**
+ * 斜杠命令处理。非 / 开头的文本返回 { handled: false, taskText } 交给任务链路。
+ * 会话编号约定：列表按时间正序展示（1 = 最早归档）；
+ * 内部存储为新→旧（sessions[0] 为当前），故编号 n 对应内部下标 length - n。
+ */
+export async function handleCommand(text, ctx) {
+    if (!text.startsWith('/'))
+        return { handled: false, taskText: text };
+    const [name, ...args] = text.slice(1).trim().split(/\s+/);
+    const { store, channelKey: key } = ctx;
+    switch (name) {
+        case 'help':
+            return { handled: true, reply: HELP };
+        case 'new': {
+            const ws = ctx.currentWorkspace();
+            const st = store.getChannelState(key);
+            // 显式清空历史（保留工作区归属），会话指针重置为空
+            store.setChannelState(key, { workspaceName: st?.workspaceName ?? ws, sessions: [] });
+            return { handled: true, reply: `✅ 已开启新会话（工作区：${ws}）` };
+        }
+        case 'resume': {
+            const sessions = store.listSessions(key);
+            if (args.length === 0) {
+                if (sessions.length === 0)
+                    return { handled: true, reply: '暂无历史会话' };
+                // 按时间正序展示：最早的排最前
+                const chrono = [...sessions].reverse();
+                const list = chrono
+                    .map((s, i) => `${i + 1}. ${s.summary || '(无摘要)'} <font color='grey'>${s.updatedAt.slice(0, 16)}</font>`)
+                    .join('\n');
+                return { handled: true, reply: `**历史会话**（回复 /resume 编号 恢复）\n${list}` };
+            }
+            const n = Number(args[0]);
+            if (!Number.isInteger(n) || n < 1 || n > sessions.length) {
+                return { handled: true, reply: `编号无效，范围 1-${sessions.length}` };
+            }
+            const target = sessions[sessions.length - n]; // 编号 n → 时间正序第 n 个
+            const st = store.getChannelState(key);
+            if (st) {
+                // 恢复 = 将选中会话移到头部（当前）
+                st.sessions = [target, ...st.sessions.filter((s) => s.sessionId !== target.sessionId)];
+                store.setChannelState(key, st);
+            }
+            return { handled: true, reply: `↩️ 已恢复会话：${target.summary || target.sessionId}` };
+        }
+        case 'stop':
+            return { handled: true, reply: ctx.stopCurrentTask() ? '🛑 已发送停止信号' : '当前没有运行中的任务' };
+        case 'status': {
+            const st = store.getChannelState(key);
+            return {
+                handled: true,
+                reply: `机器人：**${ctx.appName}**\n工作区：**${st?.workspaceName ?? ctx.currentWorkspace()}**\n历史会话：${store.listSessions(key).length} 个`,
+            };
+        }
+        case 'ws': {
+            const sub = args[0];
+            if (sub === 'list') {
+                const list = ctx.config.workspaces.map((w) => `- **${w.name}** \`${w.path}\``).join('\n');
+                return { handled: true, reply: `**工作区列表**\n${list}` };
+            }
+            if (sub === 'use') {
+                if (!ctx.isAdmin)
+                    return { handled: true, reply: '⛔ 切换工作区仅管理员可用' };
+                const target = ctx.config.workspaces.find((w) => w.name === args[1]);
+                if (!target)
+                    return { handled: true, reply: `工作区 "${args[1] ?? ''}" 不存在，/ws list 查看` };
+                const st = store.getChannelState(key);
+                // 切换工作区保留历史会话记录
+                store.setChannelState(key, { workspaceName: target.name, sessions: st?.sessions ?? [] });
+                return { handled: true, reply: `✅ 已切换工作区：**${target.name}**（${target.path}）` };
+            }
+            return { handled: true, reply: '用法：/ws list | /ws use <名字>' };
+        }
+        default:
+            return { handled: true, reply: `未知命令 /${name}，/help 查看帮助` };
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/session/commands.js.map

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

package/dist/session/session-store.d.ts

@@ -0,0 +1,42 @@
+export interface SessionMeta {
+    sessionId: string;
+    summary: string;
+    updatedAt: string;
+}
+/** 通道状态：sessions[0] 为当前会话，其余按新→旧排列 */
+export interface ChannelState {
+    workspaceName: string;
+    sessions: SessionMeta[];
+}
+/**
+ * 通道会话存储：JSON 文件持久化，每个 channelKey 一份 ChannelState。
+ * 约定：sessions 数组按新→旧排列，sessions[0] 即当前会话；
+ * /resume 列表展示时按时间正序编号（1 = 最早归档），恢复后移回数组头部。
+ */
+export declare class SessionStore {
+    private path;
+    private data;
+    private constructor();
+    static load(path: string): SessionStore;
+    private save;
+    getChannelState(key: string): ChannelState | undefined;
+    setChannelState(key: string, state: ChannelState): void;
+    /** 归档会话并置为当前（头插，去重；summary 截断到 60 字） */
+    archiveSession(key: string, sessionId: string, summary: string): void;
+    /**
+     * 开启新会话：channel 不存在时以 defaultWorkspace 初始化；
+     * 已存在时保持工作区与历史不变（历史由 /new 命令显式清空）。
+     */
+    newSession(key: string, defaultWorkspace: string): void;
+    listSessions(key: string): SessionMeta[];
+}
+/**
+ * 一次性迁移：旧单应用的 sessions.json → sessions.<appId>.json。
+ * 归一化保证旧 feishu 应用恒为 apps[0]，与「旧数据属于原单应用」语义吻合；
+ * channelKey 格式未变，纯文件改名即完成迁移（历史会话立即可 /resume）。
+ * - 旧文件不存在 → 'noop'
+ * - 旧文件存在且目标分片不存在 → 改名 → 'migrated'
+ * - 两者都存在 → 旧文件改名 .bak 保全（不覆盖新分片）；.bak 已存在则完全不动 → 'conflict-kept'
+ * 只应在 startBridge 装配前调用一次（单进程无竞态）。
+ */
+export declare function migrateLegacySessions(configDir: string, firstAppId: string): 'noop' | 'migrated' | 'conflict-kept';

package/dist/session/session-store.js

@@ -0,0 +1,85 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, renameSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * 通道会话存储：JSON 文件持久化，每个 channelKey 一份 ChannelState。
+ * 约定：sessions 数组按新→旧排列，sessions[0] 即当前会话；
+ * /resume 列表展示时按时间正序编号（1 = 最早归档），恢复后移回数组头部。
+ */
+export class SessionStore {
+    path;
+    data = {};
+    constructor(path) {
+        this.path = path;
+        if (existsSync(path)) {
+            try {
+                this.data = JSON.parse(readFileSync(path, 'utf8'));
+            }
+            catch {
+                this.data = {};
+            }
+        }
+    }
+    static load(path) {
+        return new SessionStore(path);
+    }
+    save() {
+        mkdirSync(dirname(this.path), { recursive: true });
+        writeFileSync(this.path, JSON.stringify(this.data, null, 2), 'utf8');
+    }
+    getChannelState(key) {
+        return this.data[key];
+    }
+    setChannelState(key, state) {
+        this.data[key] = state;
+        this.save();
+    }
+    /** 归档会话并置为当前（头插，去重；summary 截断到 60 字） */
+    archiveSession(key, sessionId, summary) {
+        const st = this.data[key] ?? { workspaceName: '', sessions: [] };
+        const rest = st.sessions.filter((s) => s.sessionId !== sessionId);
+        st.sessions = [{ sessionId, summary: summary.slice(0, 60), updatedAt: new Date().toISOString() }, ...rest];
+        this.data[key] = st;
+        this.save();
+    }
+    /**
+     * 开启新会话：channel 不存在时以 defaultWorkspace 初始化；
+     * 已存在时保持工作区与历史不变（历史由 /new 命令显式清空）。
+     */
+    newSession(key, defaultWorkspace) {
+        if (!this.data[key]) {
+            this.setChannelState(key, { workspaceName: defaultWorkspace, sessions: [] });
+        }
+    }
+    listSessions(key) {
+        return this.data[key]?.sessions ?? [];
+    }
+}
+/**
+ * 一次性迁移：旧单应用的 sessions.json → sessions.<appId>.json。
+ * 归一化保证旧 feishu 应用恒为 apps[0]，与「旧数据属于原单应用」语义吻合；
+ * channelKey 格式未变，纯文件改名即完成迁移（历史会话立即可 /resume）。
+ * - 旧文件不存在 → 'noop'
+ * - 旧文件存在且目标分片不存在 → 改名 → 'migrated'
+ * - 两者都存在 → 旧文件改名 .bak 保全（不覆盖新分片）；.bak 已存在则完全不动 → 'conflict-kept'
+ * 只应在 startBridge 装配前调用一次（单进程无竞态）。
+ */
+export function migrateLegacySessions(configDir, firstAppId) {
+    const legacyPath = join(configDir, 'sessions.json');
+    if (!existsSync(legacyPath))
+        return 'noop';
+    const shardedPath = join(configDir, `sessions.${firstAppId}.json`);
+    if (!existsSync(shardedPath)) {
+        renameSync(legacyPath, shardedPath);
+        return 'migrated';
+    }
+    const bakPath = join(configDir, 'sessions.json.bak');
+    if (!existsSync(bakPath)) {
+        renameSync(legacyPath, bakPath);
+        console.warn(`[迁移] sessions.json 与 sessions.${firstAppId}.json 并存，旧文件已保全为 sessions.json.bak（请人工确认归属）`);
+    }
+    else {
+        console.warn('[迁移] sessions.json / 分片文件 / .bak 三者并存，保持原状不动（请人工处理）');
+    }
+    return 'conflict-kept';
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

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

package/dist/session/triggers.d.ts

@@ -0,0 +1,12 @@
+import type { TriggerRule } from '../types.js';
+/**
+ * 命中触发词则返回改写后的 prompt，未命中返回 null（走原链路）。
+ *
+ * 匹配语义：
+ * - 斜杠形态（match 以 / 开头）：消息首 token 精确相等才命中（/produce 命中，/produced 不命中）；
+ *   本地命令（RESERVED）最高优先级直接放行；斜杠消息未命中任何规则也返回 null——
+ *   保持 handleCommand 的「未知命令」防呆 UX，不被关键词规则误捞。
+ * - 关键词形态（match 不带 /）：整条消息包含该关键词即命中，按数组顺序首个生效。
+ * 占位符：{text}=原始全文，{args}=去掉首 token 的剩余参数（斜杠形态）/ 全文（关键词形态）。
+ */
+export declare function rewriteByTrigger(text: string, rules: TriggerRule[] | undefined): string | null;

package/dist/session/triggers.js

@@ -0,0 +1,34 @@
+// bridge 本地命令首 token（去 / 后比对）：触发词不得劫持本地命令——/stop 永远是停止任务
+const RESERVED_COMMANDS = new Set(['help', 'new', 'resume', 'stop', 'status', 'ws']);
+function applyRewrite(template, text, args) {
+    return template.replaceAll('{text}', text).replaceAll('{args}', args);
+}
+/**
+ * 命中触发词则返回改写后的 prompt，未命中返回 null（走原链路）。
+ *
+ * 匹配语义：
+ * - 斜杠形态（match 以 / 开头）：消息首 token 精确相等才命中（/produce 命中，/produced 不命中）；
+ *   本地命令（RESERVED）最高优先级直接放行；斜杠消息未命中任何规则也返回 null——
+ *   保持 handleCommand 的「未知命令」防呆 UX，不被关键词规则误捞。
+ * - 关键词形态（match 不带 /）：整条消息包含该关键词即命中，按数组顺序首个生效。
+ * 占位符：{text}=原始全文，{args}=去掉首 token 的剩余参数（斜杠形态）/ 全文（关键词形态）。
+ */
+export function rewriteByTrigger(text, rules) {
+    const t = text.trim();
+    if (!t || !rules?.length)
+        return null;
+    const firstToken = t.split(/\s+/)[0] ?? '';
+    if (firstToken.startsWith('/')) {
+        if (RESERVED_COMMANDS.has(firstToken.slice(1).toLowerCase()))
+            return null;
+        const rule = rules.find((r) => r.match.startsWith('/') && r.match === firstToken);
+        if (!rule)
+            return null;
+        return applyRewrite(rule.rewrite, t, t.slice(firstToken.length).trim());
+    }
+    const rule = rules.find((r) => !r.match.startsWith('/') && t.includes(r.match));
+    if (!rule)
+        return null;
+    return applyRewrite(rule.rewrite, t, t);
+}
+//# sourceMappingURL=triggers.js.map

package/dist/session/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/session/triggers.ts"],"names":[],"mappings":"AAIA,yDAAyD;AACzD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AAErF,SAAS,YAAY,CAAC,QAAgB,EAAE,IAAY,EAAE,IAAY;IAChE,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAgC;IAC7E,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC"}

package/dist/transcript/transcript-writer.d.ts

@@ -0,0 +1,85 @@
+export type TranscriptEvent = {
+    v: 1;
+    ts: string;
+    kind: 'user';
+    app: string;
+    chatId: string;
+    userId: string;
+    workspace?: string;
+    sessionId?: string;
+    text: string;
+} | {
+    v: 1;
+    ts: string;
+    kind: 'assistant';
+    app: string;
+    chatId: string;
+    userId: string;
+    sessionId?: string;
+    text: string;
+} | {
+    v: 1;
+    ts: string;
+    kind: 'tool';
+    app: string;
+    chatId: string;
+    userId: string;
+    sessionId?: string;
+    phase: 'start' | 'result';
+    tool: string;
+    summary: string;
+    ok: boolean;
+} | {
+    v: 1;
+    ts: string;
+    kind: 'result';
+    app: string;
+    chatId: string;
+    userId: string;
+    workspace?: string;
+    sessionId: string;
+    subtype: 'success' | 'stopped' | 'error';
+    text: string;
+    producedFiles?: string[];
+    turns?: number;
+};
+/** 落盘记录器 DI 接口：wiring 层依赖此抽象，测试可注入 mock */
+export interface TranscriptRecorder {
+    user(ev: TranscriptEvent & {
+        kind: 'user';
+    }): void;
+    assistant(ev: TranscriptEvent & {
+        kind: 'assistant';
+    }): void;
+    tool(ev: TranscriptEvent & {
+        kind: 'tool';
+    }): void;
+    result(ev: TranscriptEvent & {
+        kind: 'result';
+    }): void;
+}
+/** 本地时区日期（避免 toISOString 的 UTC 偏移导致跨天分文件错位） */
+export declare function localDate(d?: Date): string;
+export declare class TranscriptWriter implements TranscriptRecorder {
+    private baseDir;
+    /** 已确认存在的会话目录缓存：避免每行一次 existsSync/mkdirSync syscall */
+    private madeDirs;
+    /** 告警节流：同一分钟内最多告警一次（失败风暴不刷屏） */
+    private lastWarnMin;
+    constructor(baseDir: string);
+    user(ev: TranscriptEvent & {
+        kind: 'user';
+    }): void;
+    assistant(ev: TranscriptEvent & {
+        kind: 'assistant';
+    }): void;
+    tool(ev: TranscriptEvent & {
+        kind: 'tool';
+    }): void;
+    result(ev: TranscriptEvent & {
+        kind: 'result';
+    }): void;
+    private append;
+}
+/** 清理过期落盘：递归删除 baseDir 下 mtime 早于 retentionDays 的 .jsonl，返回删除文件数 */
+export declare function sweepTranscripts(baseDir: string, retentionDays: number): number;

package/dist/transcript/transcript-writer.js

@@ -0,0 +1,64 @@
+// 对话内容落盘：用户消息 / Claude 回复 / 工具调用 / 最终结果 全文持久化为 JSONL。
+// 布局 <CONFIG_DIR>/transcripts/<appId>/<chatId>/<本地日期>.jsonl，按天分文件即天然轮转。
+// 为后续「对话挖掘写 Notion」打底（v:1 版本号为挖掘管道的格式演化留空间）。
+// 设计约束：任何写失败只节流告警，绝不向调用方抛出、绝不阻断任务主流程。
+import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+/** 本地时区日期（避免 toISOString 的 UTC 偏移导致跨天分文件错位） */
+export function localDate(d = new Date()) {
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${d.getFullYear()}-${m}-${day}`;
+}
+export class TranscriptWriter {
+    baseDir;
+    /** 已确认存在的会话目录缓存：避免每行一次 existsSync/mkdirSync syscall */
+    madeDirs = new Set();
+    /** 告警节流：同一分钟内最多告警一次（失败风暴不刷屏） */
+    lastWarnMin = 0;
+    constructor(baseDir) {
+        this.baseDir = baseDir;
+    }
+    user(ev) { this.append(ev); }
+    assistant(ev) { this.append(ev); }
+    tool(ev) { this.append(ev); }
+    result(ev) { this.append(ev); }
+    append(ev) {
+        try {
+            const dir = join(this.baseDir, ev.chatId);
+            if (!this.madeDirs.has(dir)) {
+                mkdirSync(dir, { recursive: true });
+                this.madeDirs.add(dir);
+            }
+            appendFileSync(join(dir, `${localDate()}.jsonl`), JSON.stringify(ev) + '\n', 'utf8');
+        }
+        catch (e) {
+            const min = Math.floor(Date.now() / 60_000);
+            if (min !== this.lastWarnMin) {
+                this.lastWarnMin = min;
+                console.warn('[transcripts] 对话落盘失败（不影响任务执行）：', e instanceof Error ? e.message : e);
+            }
+        }
+    }
+}
+/** 清理过期落盘：递归删除 baseDir 下 mtime 早于 retentionDays 的 .jsonl，返回删除文件数 */
+export function sweepTranscripts(baseDir, retentionDays) {
+    if (!existsSync(baseDir))
+        return 0;
+    const cutoff = Date.now() - retentionDays * 86_400_000;
+    let removed = 0;
+    const walk = (dir) => {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const p = join(dir, entry.name);
+            if (entry.isDirectory())
+                walk(p);
+            else if (entry.name.endsWith('.jsonl') && statSync(p).mtimeMs < cutoff) {
+                unlinkSync(p);
+                removed++;
+            }
+        }
+    };
+    walk(baseDir);
+    return removed;
+}
+//# sourceMappingURL=transcript-writer.js.map

package/dist/transcript/transcript-writer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,105 @@
+/** 触发词规则：match 命中后把消息改写为 rewrite 再入队（{text}=原文全文，{args}=去首 token 的剩余参数） */
+export interface TriggerRule {
+    match: string;
+    rewrite: string;
+}
+/** 显式加载的本地插件（path 指含 .claude-plugin/plugin.json 的插件目录） */
+export interface PluginRef {
+    name: string;
+    path: string;
+}
+export interface FeishuAppConfig {
+    /** 显示名（日志前缀 / /status / lcb app list），缺省 = appId */
+    name: string;
+    appId: string;
+    appSecret: string;
+    domain?: 'feishu' | 'lark';
+    /** 该 app 的默认工作区（须在 workspaces 列表内），缺省回退 defaults.workspace */
+    defaultWorkspace?: string;
+    /** 该 app 的并发上限（1-100），缺省用全局 concurrency */
+    concurrency?: number;
+    /** 可选人格补充，直通 SDK options.appendSystemPrompt */
+    appendSystemPrompt?: string;
+    /** Claude Code 数据目录（会话存储/用户设置/插件，每个机器人一套）：
+     *  apps 里新配置的 app 缺省 <CONFIG_DIR>/claude/<appId>；旧 feishu 迁移的 app 沿用系统默认 ~/.claude（保存量会话 resume） */
+    claudeConfigDir?: string;
+    /** per-app 环境变量（如 ANTHROPIC_BASE_URL/ANTHROPIC_MODEL 凭证差异化），合并进 Claude Code 子进程环境 */
+    env?: Record<string, string>;
+    /** 触发词映射：按数组顺序首个命中生效；不配置 = 行为零变化。match 以 / 开头=首 token 精确匹配，否则=关键词包含 */
+    triggers?: TriggerRule[];
+    /** 显式加载的本地插件目录列表（SDK 单次 query 不会展开斜杠命令，技能须经改写指令触发；插件目录须含 .claude-plugin/plugin.json） */
+    plugins?: PluginRef[];
+}
+export interface Workspace {
+    name: string;
+    path: string;
+}
+export interface BridgeConfig {
+    /** 多飞书应用（多机器人）：每 app 一条独立 WS 长连接 + 独立会话池 + 独立 Claude Code 实例 */
+    apps: FeishuAppConfig[];
+    workspaces: Workspace[];
+    defaults: {
+        workspace: string;
+    };
+    concurrency: number;
+    /** 对话落盘清理策略；缺省/0 = 永久保留 */
+    transcripts?: {
+        retentionDays?: number;
+    };
+}
+export interface IncomingMessage {
+    chatId: string;
+    chatType: 'p2p' | 'group';
+    userId: string;
+    text: string;
+    messageId: string;
+}
+export interface CardActionValue {
+    requestId: string;
+    decision: 'allow' | 'deny' | 'allow-session';
+}
+export interface CardActionEvent {
+    value: CardActionValue;
+    operatorId: string;
+    openMessageId: string;
+}
+/**
+ * card.action.trigger 回调的返回体：非空时由 gateway 透传给飞书。
+ * toast 为客户端弹窗提示；card 为回调响应内联新卡片，飞书收到响应后同步替换
+ * 被点击的卡片（3 秒内响应有效）——仅发起人有效点击路径使用，
+ * !pending 等分支严禁携带（此时卡片可能已是结果卡，带卡会把结果卡换回带按钮状态，
+ * 等同剥夺发起人操作权，参照 I2 教训）。
+ */
+export interface CardActionResponse {
+    toast?: {
+        type: 'info' | 'success' | 'error' | 'warning';
+        content: string;
+    };
+    card?: {
+        type: 'raw';
+        data: unknown;
+    };
+}
+export interface GatewayHandlers {
+    onMessage(msg: IncomingMessage): Promise<void>;
+    onCardAction(action: CardActionEvent): Promise<CardActionResponse | void>;
+}
+export interface ConfirmationRequest {
+    requestId: string;
+    toolName: string;
+    summary: string;
+    diff?: string;
+    workspaceName: string;
+}
+export type PermissionDecision = 'allow' | 'deny' | 'allow-session';
+export interface ProgressEvent {
+    kind: 'text' | 'tool-start' | 'tool-result' | 'status';
+    content: string;
+    ok?: boolean;
+}
+export interface TaskOutcome {
+    sessionId: string;
+    finalText: string;
+    producedFiles: string[];
+    turns: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.2.0";

package/dist/version.js

@@ -0,0 +1,3 @@
+// 版本号单一来源：package.json / lcb version / smoke 测试均以此为准
+export const VERSION = '0.2.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}