botmux 2.78.0 → 2.79.1

package/dist/im/lark/doc-comment.js

@@ -0,0 +1,376 @@
+/**
+ * 飞书云文档「评论」桥接 —— 把一个 docx 文档变成会话的输入/输出通道。
+ *
+ * 这一层封装四件事：
+ *   1. 把用户贴的文档链接 / token 解析成 { fileToken, fileType }（含 wiki 节点解析）
+ *   2. 订阅 / 退订文档事件（评论新增等靠此推送）
+ *   3. 读评论（取上下文 / 解析 @bot）
+ *   4. 回评论（bot 的回复落点 —— 注意飞书无「往已有评论追加回复」的公开 API，
+ *      只能新建一条全文评论，见 {@link createDocComment}）
+ *
+ * 身份：评论 / 订阅事件官方推荐 user_access_token（文档可见性跟着授权用户走）。
+ * 因此所有调用 **优先 user token**（裸 fetch + Bearer），失败再回退 tenant（SDK
+ * client.request，自动带 tenant_access_token）。和 client.ts 的资源下载同套路，
+ * 只是 app/user 的优先级反过来。
+ */
+import { getBotClient, getBot } from '../../bot-registry.js';
+import { resolveUserToken } from '../../utils/user-token.js';
+import { logger } from '../../utils/logger.js';
+import { UserTokenMissingError } from './client.js';
+import { larkHosts, normalizeBrand } from './lark-hosts.js';
+/**
+ * bot 回复的隐形哨兵：追加在 bot 发表的评论末尾（零宽字符，用户不可见）。
+ *
+ * 为什么需要：bot 用 **user_access_token** 发评论 → 评论作者 = 授权用户本人，
+ * 无法靠「作者是不是 bot」区分「bot 的回复」和「用户自己的评论」。若不区分，
+ * bot 发评论 → 触发 comment_add 事件 → 又喂给 bot → 死循环。
+ *
+ * 双保险：① 记录 bot 创建过的 reply_id（{@link isBotAuthoredReply}，同一 daemon
+ * 生命周期内权威）② 文本末尾哨兵（跨重启 / reply_id 拿不到时的兜底）。
+ */
+export const BOT_REPLY_SENTINEL = '​⁣​';
+/** 记录 / 查询 bot 自己创建的评论回复 id（防自触发死循环）。环形上限防泄漏。 */
+const botAuthoredReplyIds = [];
+const BOT_AUTHORED_MAX = 2000;
+export function markBotAuthoredReply(id) {
+    if (!id)
+        return;
+    botAuthoredReplyIds.push(id);
+    if (botAuthoredReplyIds.length > BOT_AUTHORED_MAX)
+        botAuthoredReplyIds.splice(0, botAuthoredReplyIds.length - BOT_AUTHORED_MAX);
+}
+export function isBotAuthoredReply(id) {
+    return !!id && botAuthoredReplyIds.includes(id);
+}
+export function hasBotSentinel(text) {
+    return !!text && text.includes(BOT_REPLY_SENTINEL);
+}
+// ─── URL / token 解析 ──────────────────────────────────────────────────────────
+const URL_TYPE_RE = /\/(docx|docs|wiki|sheets|base|bitable|file|slides|mindnote)\/([A-Za-z0-9]+)/;
+const RAW_TOKEN_RE = /^[A-Za-z0-9]{20,}$/;
+/** URL path 段的类型 → 飞书 file_type。 */
+function pathKindToFileType(kind) {
+    switch (kind) {
+        case 'docx': return 'docx';
+        case 'docs': return 'doc';
+        case 'sheets': return 'sheet';
+        case 'base':
+        case 'bitable': return 'bitable';
+        case 'slides': return 'slides';
+        case 'mindnote': return 'mindnote';
+        case 'file': return 'file';
+        default: return kind;
+    }
+}
+/**
+ * 把用户输入解析成 { kind, token }。支持完整飞书链接、`/docx/<token>` 片段、
+ * 或裸 token（裸 token 当 docx 处理）。`wiki` 类型需要再过一次节点解析（见
+ * {@link resolveDocFile}）。无法识别返回 null。
+ */
+export function parseDocRef(input) {
+    const s = input.trim();
+    const m = s.match(URL_TYPE_RE);
+    if (m)
+        return { kind: m[1], token: m[2] };
+    if (RAW_TOKEN_RE.test(s))
+        return { kind: 'docx', token: s };
+    return null;
+}
+/**
+ * 解析成可直接调评论 / 订阅 API 的 { fileToken, fileType }。wiki 节点先调
+ * get_node 换出底层 obj_token + obj_type；其余类型直接映射。
+ */
+export async function resolveDocFile(larkAppId, input) {
+    const ref = parseDocRef(input);
+    if (!ref)
+        throw new Error(`无法从「${input.slice(0, 40)}」识别出飞书文档链接或 token`);
+    if (ref.kind === 'wiki') {
+        const res = await driveApiCall(larkAppId, {
+            method: 'GET',
+            path: '/open-apis/wiki/v2/spaces/get_node',
+            params: { token: ref.token, obj_type: 'wiki' },
+        });
+        const node = res?.data?.node;
+        if (!node?.obj_token || !node?.obj_type) {
+            throw new Error(`wiki 节点 ${ref.token} 解析失败（缺 obj_token/obj_type）`);
+        }
+        return { fileToken: node.obj_token, fileType: node.obj_type };
+    }
+    return { fileToken: ref.token, fileType: pathKindToFileType(ref.kind) };
+}
+function buildQuery(params) {
+    if (!params)
+        return '';
+    const usp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            usp.set(k, String(v));
+    }
+    const q = usp.toString();
+    return q ? `?${q}` : '';
+}
+/**
+ * 调一个 drive/wiki OpenAPI。优先 user token（裸 fetch），拿不到 token 或遇
+ * 401/403 时回退 tenant（SDK client.request 自带 tenant_access_token + GET
+ * 空 body 守卫）。返回飞书统一响应体 `{ code, msg, data }`。
+ */
+async function driveApiCall(larkAppId, opts) {
+    const bot = getBot(larkAppId);
+    const brand = normalizeBrand(bot.config.brand);
+    // tenant（应用身份）：走 SDK client.request（带 token/缓存/GET 空 body 守卫）。
+    const callTenant = async () => {
+        const c = getBotClient(larkAppId);
+        return c.request({
+            method: opts.method,
+            url: opts.path,
+            params: opts.params,
+            ...(opts.data !== undefined ? { data: opts.data } : {}),
+        });
+    };
+    const callUser = async () => {
+        const userToken = await resolveUserToken(bot.config.larkAppId, bot.config.larkAppSecret, brand);
+        if (!userToken)
+            throw new UserTokenMissingError('该操作需要 User Token（请在话题中 /login 授权）。');
+        return fetchWithUserToken(brand, userToken, opts);
+    };
+    if (opts.userOnly)
+        return callUser();
+    // 发评论：优先应用身份（回复显示为 bot），bot 无访问权（抛错或 code!=0）时回退用户身份。
+    if (opts.preferTenant) {
+        try {
+            const res = await callTenant();
+            if (res?.code === 0)
+                return res;
+            logger.debug(`[doc-comment] tenant call code=${res?.code} (${opts.path})；回退 user 身份`);
+        }
+        catch (err) {
+            logger.debug(`[doc-comment] tenant call threw (${opts.path})；回退 user 身份：${err instanceof Error ? err.message : err}`);
+        }
+        return callUser();
+    }
+    // 默认：优先 user（有 token），401/403 回退 tenant。
+    const userToken = await resolveUserToken(bot.config.larkAppId, bot.config.larkAppSecret, brand);
+    if (userToken) {
+        try {
+            return await fetchWithUserToken(brand, userToken, opts);
+        }
+        catch (err) {
+            if (!(err instanceof UserTokenMissingError))
+                throw err;
+            logger.debug(`[doc-comment] user token rejected (${opts.path}); falling back to tenant`);
+        }
+    }
+    return callTenant();
+}
+async function fetchWithUserToken(brand, userToken, opts) {
+    const url = `${larkHosts(brand).openApi}${opts.path}${buildQuery(opts.params)}`;
+    const res = await fetch(url, {
+        method: opts.method,
+        headers: {
+            Authorization: `Bearer ${userToken}`,
+            ...(opts.data !== undefined ? { 'Content-Type': 'application/json' } : {}),
+        },
+        ...(opts.data !== undefined ? { body: JSON.stringify(opts.data) } : {}),
+    });
+    if (res.status === 401) {
+        throw new UserTokenMissingError('User Token 已失效（HTTP 401）。请在话题中 /login 重新授权。');
+    }
+    if (res.status === 403) {
+        // token 有效但无权访问该文档 —— 视作可回退（也许 tenant 有权）
+        throw new UserTokenMissingError(`User Token 无权访问该文档（HTTP 403）。`);
+    }
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok) {
+        throw new Error(`drive API ${opts.path} HTTP ${res.status}: ${body?.msg ?? ''}`);
+    }
+    return body;
+}
+function ensureOk(res, what) {
+    if (res?.code !== 0) {
+        throw new Error(`${what} 失败: ${res?.msg ?? 'unknown'} (code: ${res?.code})`);
+    }
+    return res.data;
+}
+// ─── 订阅 / 退订 ────────────────────────────────────────────────────────────────
+/** 订阅文档事件（评论新增等靠此推送）。幂等：重复订阅飞书返回成功。 */
+export async function subscribeDocFile(larkAppId, file) {
+    const res = await driveApiCall(larkAppId, {
+        method: 'POST',
+        path: `/open-apis/drive/v1/files/${encodeURIComponent(file.fileToken)}/subscribe`,
+        params: { file_type: file.fileType },
+    });
+    ensureOk(res, '订阅文档');
+    logger.info(`[doc-comment] subscribed file=${file.fileToken.slice(0, 12)} type=${file.fileType}`);
+}
+/** 退订文档事件。best-effort：失败只告警不抛。 */
+export async function unsubscribeDocFile(larkAppId, file) {
+    try {
+        // 飞书取消订阅是 DELETE .../delete_subscribe（不是 DELETE .../subscribe，后者 404）。
+        const res = await driveApiCall(larkAppId, {
+            method: 'DELETE',
+            path: `/open-apis/drive/v1/files/${encodeURIComponent(file.fileToken)}/delete_subscribe`,
+            params: { file_type: file.fileType },
+        });
+        ensureOk(res, '退订文档');
+        logger.info(`[doc-comment] unsubscribed file=${file.fileToken.slice(0, 12)}`);
+    }
+    catch (err) {
+        logger.warn(`[doc-comment] unsubscribe failed for ${file.fileToken.slice(0, 12)}: ${err instanceof Error ? err.message : err}`);
+    }
+}
+// ─── 读评论 ─────────────────────────────────────────────────────────────────────
+/** 拼接评论内容元素为纯文本。 */
+function elementsToText(elements) {
+    if (!Array.isArray(elements))
+        return '';
+    return elements.map((el) => el?.text_run?.text ?? '').join('');
+}
+/** 从评论内容元素提取 @ 到的 open_id。 */
+function elementsMentions(elements) {
+    if (!Array.isArray(elements))
+        return [];
+    return elements.map((el) => el?.person?.user_id).filter((x) => typeof x === 'string');
+}
+/**
+ * 读某条评论（含其下所有回复）。用于事件来后取 thread 上下文 + 判断是否 @bot。
+ * 拿不到返回 null。
+ */
+export async function getDocComment(larkAppId, file, commentId) {
+    try {
+        // 用 batch_query 而非 GET /comments/{id}——后者只认「全文评论」，对**局部/锚定
+        // 评论**(is_whole:false，真实用户在 UI 选中文字评论就是这种)返回 1069307 not exist。
+        // batch_query 两种都支持。
+        const res = await driveApiCall(larkAppId, {
+            method: 'POST',
+            path: `/open-apis/drive/v1/files/${encodeURIComponent(file.fileToken)}/comments/batch_query`,
+            params: { file_type: file.fileType, user_id_type: 'open_id' },
+            data: { comment_ids: [commentId] },
+        });
+        const data = ensureOk(res, '获取评论');
+        const raw = Array.isArray(data?.items) ? data.items[0] : undefined;
+        if (!raw)
+            return null;
+        return normalizeComment(raw);
+    }
+    catch (err) {
+        logger.warn(`[doc-comment] getDocComment ${commentId.slice(0, 12)} failed: ${err instanceof Error ? err.message : err}`);
+        return null;
+    }
+}
+function normalizeComment(raw) {
+    const replies = Array.isArray(raw?.reply_list?.replies) ? raw.reply_list.replies : [];
+    return {
+        commentId: raw?.comment_id ?? '',
+        isSolved: raw?.is_solved === true,
+        replies: replies.map((r) => ({
+            replyId: r?.reply_id ?? '',
+            userId: r?.user_id,
+            text: elementsToText(r?.content?.elements),
+            mentions: elementsMentions(r?.content?.elements),
+            createdAt: typeof r?.create_time === 'number' ? r.create_time : undefined,
+        })),
+    };
+}
+// ─── 回评论 ─────────────────────────────────────────────────────────────────────
+/**
+ * 往**已有评论 thread 里追加一条回复**（真正的嵌套回复，用户看到 bot 的回复
+ * 就挂在自己那条评论下面）。
+ *
+ * 端点 `POST .../comments/{comment_id}/replies` 是飞书 drive-v1 的公开 API
+ * （file.comment.reply.create）—— 我们装的 node-sdk 1.64.0 恰好没暴露 create，
+ * 但裸 endpoint 存在，故这里直接打。返回新回复的 reply_id（已登记防自触发）。
+ */
+export async function replyToDocComment(larkAppId, file, commentId, text, mentionOpenId) {
+    const elements = buildCommentElements(text, mentionOpenId);
+    let res;
+    try {
+        res = await driveApiCall(larkAppId, {
+            method: 'POST',
+            path: `/open-apis/drive/v1/files/${encodeURIComponent(file.fileToken)}/comments/${encodeURIComponent(commentId)}/replies`,
+            params: { file_type: file.fileType, user_id_type: 'open_id' },
+            data: { content: { elements } },
+            preferTenant: true, // 回复显示为 bot 本身（应用身份）；bot 无访问权时回退 user
+        });
+    }
+    catch (err) {
+        // 有的评论不允许被回复（飞书 1069302：全文评论 / 已解决 / 文档评论设置受限）。
+        // 退回新建一条全文评论，保证 bot 的答复总能落到文档（不嵌套但仍在评论区）。
+        if (isReplyNotAllowed(err)) {
+            logger.warn(`[doc-comment] comment=${commentId.slice(0, 12)} 不允许回复，退回新建全文评论`);
+            const c = await createDocComment(larkAppId, file, text, mentionOpenId);
+            return { replyId: c.replyId, commentId: c.commentId };
+        }
+        throw err;
+    }
+    // ensureOk 对 code!==0 抛错；同样要识别"不允许回复"并退回新建。
+    if (res?.code !== 0) {
+        if (isReplyNotAllowed(res)) {
+            logger.warn(`[doc-comment] comment=${commentId.slice(0, 12)} 不允许回复(code=${res?.code})，退回新建全文评论`);
+            const c = await createDocComment(larkAppId, file, text, mentionOpenId);
+            return { replyId: c.replyId, commentId: c.commentId };
+        }
+        throw new Error(`回复评论 失败: ${res?.msg ?? 'unknown'} (code: ${res?.code})`);
+    }
+    const replyId = res.data?.reply_id;
+    if (replyId)
+        markBotAuthoredReply(replyId);
+    logger.info(`[doc-comment] replied to comment=${commentId.slice(0, 12)} reply=${String(replyId ?? '').slice(0, 12)} on file=${file.fileToken.slice(0, 12)} (${text.length} chars)`);
+    return { replyId };
+}
+/** 构造评论内容元素：可选在开头 @ 某人（person 元素，user_id=open_id），末尾追加
+ *  隐形哨兵供事件侧自触发兜底识别。 */
+function buildCommentElements(text, mentionOpenId) {
+    const els = [];
+    if (mentionOpenId) {
+        els.push({ type: 'person', person: { user_id: mentionOpenId } });
+        els.push({ type: 'text_run', text_run: { text: ' ' } });
+    }
+    els.push({ type: 'text_run', text_run: { text: text + BOT_REPLY_SENTINEL } });
+    return els;
+}
+/** 识别飞书"该评论不允许回复"的错误（code 1069302 或消息含 does not allow replies）。 */
+function isReplyNotAllowed(errOrRes) {
+    const s = errOrRes instanceof Error ? errOrRes.message : JSON.stringify(errOrRes ?? '');
+    return s.includes('1069302') || /does not allow replies|不允许回复/.test(s);
+}
+/**
+ * 新建一条**全文评论**（独立的新评论，非嵌套）。用于没有可挂靠 comment_id 的
+ * 场景（如主动向文档发评论）。返回 comment_id。
+ */
+export async function createDocComment(larkAppId, file, text, mentionOpenId) {
+    const elements = buildCommentElements(text, mentionOpenId);
+    const res = await driveApiCall(larkAppId, {
+        method: 'POST',
+        path: `/open-apis/drive/v1/files/${encodeURIComponent(file.fileToken)}/comments`,
+        params: { file_type: file.fileType, user_id_type: 'open_id' },
+        data: { reply_list: { replies: [{ content: { elements } }] } },
+        preferTenant: true, // 评论显示为 bot 本身（应用身份）；bot 无访问权时回退 user
+    });
+    const data = ensureOk(res, '发表评论');
+    const commentId = data?.comment_id ?? '';
+    const replyId = data?.reply_list?.replies?.[0]?.reply_id;
+    if (replyId)
+        markBotAuthoredReply(replyId);
+    logger.info(`[doc-comment] created comment=${String(commentId).slice(0, 12)} reply=${String(replyId ?? '').slice(0, 12)} on file=${file.fileToken.slice(0, 12)} (${text.length} chars)`);
+    return { commentId, replyId };
+}
+/** 飞书文档评论内容长度上限的保守值，超长 bot 回复按此分块发多条评论。 */
+export const DOC_COMMENT_MAX_CHARS = 3000;
+/** 把长文本按 {@link DOC_COMMENT_MAX_CHARS} 切块（尽量按段落/换行边界）。 */
+export function chunkCommentText(text, max = DOC_COMMENT_MAX_CHARS) {
+    if (text.length <= max)
+        return [text];
+    const chunks = [];
+    let rest = text;
+    while (rest.length > max) {
+        let cut = rest.lastIndexOf('\n', max);
+        if (cut < max * 0.5)
+            cut = max; // 没有靠后的换行就硬切
+        chunks.push(rest.slice(0, cut));
+        rest = rest.slice(cut).replace(/^\n+/, '');
+    }
+    if (rest)
+        chunks.push(rest);
+    return chunks;
+}
+//# sourceMappingURL=doc-comment.js.map

package/dist/im/lark/doc-comment.js.map

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

package/dist/im/lark/event-dispatcher.d.ts

@@ -4,6 +4,7 @@
  * Extracted from daemon.ts for modularity.
  */
 import * as Lark from '@larksuiteoapi/node-sdk';
+import { type DocSubscription } from '../../services/doc-subs-store.js';
 import { type Brand } from './lark-hosts.js';
 /** Set the bot's open_id. Callers should also call writeBotInfoFile() to persist. */
 export declare function setBotOpenId(larkAppId: string, id: string): void;
@@ -128,6 +129,23 @@ export interface EventHandlers {
      *  — which in a 话题群 wraps each top-level message in a fresh topic.
      *  Best-effort fire-and-forget; the dispatcher proceeds either way. */
     onChatModeConverted?: (chatId: string, larkAppId: string) => void;
+    /** 文档评论入口（/subscribe-lark-doc）：一条命中订阅的文档评论被喂进其绑定
+     *  会话。daemon 负责定位会话、投递给 worker、记录该轮回评论的落点。 */
+    handleDocComment?: (ctx: DocCommentContext) => Promise<void>;
+}
+/** 一条已通过订阅 + 触发范围 + 自触发过滤的文档评论，交给 daemon 投递。 */
+export interface DocCommentContext {
+    larkAppId: string;
+    /** 命中的文档订阅（含 sessionAnchor / scope / chatId）。 */
+    sub: DocSubscription;
+    /** 触发评论的 comment_id。 */
+    commentId: string;
+    /** 触发的具体回复 id（作 turnId，回评论落点也按它走）；缺省退回 commentId。 */
+    replyId?: string;
+    /** 评论纯文本（喂给模型的用户消息）。 */
+    text: string;
+    /** 评论发表者 open_id。 */
+    authorOpenId?: string;
 }
 /**
  * Best-effort plain-text extraction from a Lark message for routing-level

package/dist/im/lark/event-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/im/lark/event-dispatcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event-dispatcher.d.ts","sourceRoot":"","sources":["../../../src/im/lark/event-dispatcher.ts"],"names":[],"mappings":"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"}

package/dist/im/lark/event-dispatcher.js

@@ -17,7 +17,9 @@ import { parseForceTopicInvocation } from '../../core/command-handler.js';
 import { shouldAutoStartOnNewTopic } from '../../core/auto-start.js';
 import { stripLeadingMentions } from './message-parser.js';
 import { recordObservedBots } from '../../services/observed-bots-store.js';
-import { BOTMUX_REQUIRED_SCOPES, buildScopeDeepLink } from '../../setup/verify-permissions.js';
+import { getDocSubscription, listAllDocSubscriptions } from '../../services/doc-subs-store.js';
+import { getDocComment, isBotAuthoredReply, hasBotSentinel } from './doc-comment.js';
+import { BOTMUX_REQUIRED_SCOPES, DOC_FEATURE_SCOPES, DOC_COMMENT_EVENT, buildScopeDeepLink } from '../../setup/verify-permissions.js';
 import { larkHosts, normalizeBrand, sdkDomain } from './lark-hosts.js';
 import { tryHandleGrantCommand } from './grant-command.js';
 import { tryHandleReplyModeCommand } from './reply-mode-command.js';
@@ -215,6 +217,33 @@ export async function checkRequiredScopes(larkAppId) {
             return;
         }
         const grantedScopes = new Set(scopesRaw.map(s => typeof s === 'string' ? s : s?.scope).filter(Boolean));
+        // 文档评论入口就绪自检：仅对「已订阅过文档」的 bot 生效（opt-in，不打扰其他 bot）。
+        // ① 校验文档 app 权限是否开通（可查 → 缺则 DM 深链）② 提醒去后台订阅评论事件
+        // drive.notice.comment_add_v1（飞书无 API 可查是否已订阅，只能提醒）——让「订阅
+        // 成功却收不到评论」这类配置漏项在重启自检时暴露。
+        try {
+            const docSubs = listAllDocSubscriptions(config.session.dataDir, larkAppId);
+            if (docSubs.length > 0) {
+                const missingDoc = DOC_FEATURE_SCOPES.filter(s => !grantedScopes.has(s.name));
+                if (missingDoc.length > 0) {
+                    const summary = missingDoc.map(s => `${s.name}(${s.desc})`).join('、');
+                    logger.error(`[${larkAppId}] 文档评论入口已在用（${docSubs.length} 个订阅）但缺 ${missingDoc.length} 项文档权限：${summary}。评论将收不到/回不了，请到权限管理开通后 botmux restart。`);
+                    const adminDoc = getAdminOpenId(bot);
+                    if (adminDoc) {
+                        const lines = missingDoc.map((s, i) => `${i + 1}. **${s.desc}** (\`${s.name}\`)\n   ${buildScopeDeepLink(bot.config.larkAppId, s.name, brand)}`).join('\n\n');
+                        await dmAdmin(larkAppId, adminDoc, `⚠️ 机器人 "${bot.botName ?? larkAppId}" 已订阅 ${docSubs.length} 个飞书文档（/subscribe-lark-doc），但缺少文档评论所需权限：\n\n${lines}\n\n` +
+                            `另外请确认开发者后台「事件订阅」里已添加 **\`${DOC_COMMENT_EVENT}\`**（云文档新增评论）事件——该事件无法被自动检测，缺它则评论永远收不到。\n\n开通 + 订阅事件后执行 \`botmux restart\`。`, `missing doc-feature scopes: ${missingDoc.map(s => s.name).join(',')}`);
+                    }
+                }
+                else {
+                    // 权限齐了——事件订阅查不了，仅 info 记一条提醒（不 DM 免重启刷屏）。
+                    logger.info(`[${larkAppId}] doc-comment 权限齐全（${docSubs.length} 订阅）；请确保后台已订阅事件 ${DOC_COMMENT_EVENT}（无法自动检测）`);
+                }
+            }
+        }
+        catch (err) {
+            logger.debug(`[${larkAppId}] doc-feature readiness check errored: ${err?.message ?? err}`);
+        }
         // Diff against the canonical list. Critical-missing is the main signal;
         // non-critical is mentioned only when something critical is also missing,
         // so deployments don't get nagged about purely optional scopes like
@@ -970,6 +999,100 @@ export async function decideRouting(larkAppId, message) {
     const { scope, anchor } = await decideRoutingWithSource(larkAppId, message);
     return { scope, anchor };
 }
+/** 从评论事件 payload 里挖出 { fileToken, fileType, commentId, replyId,
+ *  noticeType, isMentioned, operatorOpenId }。
+ *
+ *  真机实测 drive.notice.comment_add_v1 的 event 体形如
+ *  `{ comment_id, is_mentioned, notice_meta, reply_id }` —— **file_token 不在顶层，
+ *  藏在 notice_meta 里**（notice_meta 可能是对象或 JSON 字符串）。故这里展开
+ *  notice_meta 并多路径兜底；file_type 拿不到无妨（后续用订阅表里的）。 */
+function parseCommentEvent(data) {
+    const d = data?.event ?? data ?? {};
+    let meta = d.notice_meta ?? d.noticeMeta;
+    if (typeof meta === 'string') {
+        try {
+            meta = JSON.parse(meta);
+        }
+        catch { /* 保留原字符串 */ }
+    }
+    const m = (meta && typeof meta === 'object') ? meta : {};
+    const pick = (k) => d[k] ?? m[k] ?? m[k.replace(/_([a-z])/g, (_, c) => c.toUpperCase())];
+    return {
+        fileToken: pick('file_token') ?? pick('token') ?? pick('obj_token'),
+        fileType: pick('file_type') ?? pick('obj_type'),
+        commentId: pick('comment_id'),
+        replyId: pick('reply_id'),
+        noticeType: pick('notice_type'),
+        isMentioned: d.is_mentioned === true || m.is_mentioned === true,
+        operatorOpenId: d.operator_id?.open_id ?? d.user_id?.open_id ?? m.operator_id?.open_id,
+        meta,
+    };
+}
+/** 评论事件入口：去重 ACK-safe 包装 + 订阅匹配 + 自触发/触发范围过滤后转 daemon。 */
+function handleCommentEventAckSafe(data, larkAppId, handlers) {
+    const parsed = parseCommentEvent(data);
+    const eventKey = `drive.comment_add:${larkAppId}:${eventIdForKey(data) ?? `${parsed.fileToken ?? '?'}:${parsed.replyId ?? parsed.commentId ?? '?'}`}`;
+    scheduleAckSafeEvent(eventKey, async () => {
+        try {
+            await processCommentEvent(parsed, larkAppId, handlers);
+        }
+        catch (err) {
+            logger.error(`Error handling doc-comment event: ${err}`);
+        }
+    }, 'doc-comment event');
+}
+async function processCommentEvent(parsed, larkAppId, handlers) {
+    if (!handlers.handleDocComment)
+        return;
+    const { fileToken, commentId } = parsed;
+    if (!fileToken || !commentId) {
+        logger.info(`[doc-comment] event dropped: missing fileToken/commentId (fileToken=${fileToken ?? '?'} commentId=${commentId ?? '?'}) — payload 字段路径可能与解析不符`);
+        return;
+    }
+    // 1) 必须是已订阅的文档（per-文档订阅 → 主键命中才处理）
+    const sub = getDocSubscription(config.session.dataDir, larkAppId, fileToken);
+    if (!sub) {
+        logger.info(`[doc-comment] event dropped: file_token=${fileToken.slice(0, 12)} 不在订阅表（已订阅的可 /subscribe-lark-doc list 查；注意 wiki 链接会解析成底层 obj_token）`);
+        return;
+    }
+    // 2) 拉评论 thread 取权威正文 / 作者 / @ 列表（事件 payload 不保证带全），
+    //    同时用最新一条回复作为"触发回复"。
+    const comment = await getDocComment(larkAppId, { fileToken, fileType: sub.fileType }, commentId);
+    if (!comment || comment.replies.length === 0) {
+        logger.info(`[doc-comment] event dropped: 取不到评论内容 comment=${commentId.slice(0, 12)}（replies=${comment ? comment.replies.length : 'null'}）`);
+        return;
+    }
+    const trigger = parsed.replyId
+        ? comment.replies.find(r => r.replyId === parsed.replyId) ?? comment.replies[comment.replies.length - 1]
+        : comment.replies[comment.replies.length - 1];
+    // 3) 自触发过滤（防死循环）：bot 的回复可能以应用身份（作者=bot open_id）或回退
+    //    用户身份（作者=授权用户，无法靠作者区分）发出。三重保险：①作者==本 bot
+    //    ②reply_id 在 bot 创建集合 ③文本含隐形哨兵。任一命中即跳过。
+    const selfBotOpenId = getBot(larkAppId).botOpenId;
+    if ((selfBotOpenId && trigger.userId === selfBotOpenId) || isBotAuthoredReply(trigger.replyId) || hasBotSentinel(trigger.text))
+        return;
+    // 4) 触发范围：mention-only 要求评论 @ 到本 bot。优先用事件自带的 is_mentioned
+    //    （飞书已判好），拿不到再回退按评论正文里的 @person 列表比对 bot open_id。
+    if (sub.commentTriggerMode === 'mention-only') {
+        const mentioned = parsed.isMentioned === true || (!!selfBotOpenId && trigger.mentions.includes(selfBotOpenId));
+        if (!mentioned) {
+            logger.info(`[doc-comment] event dropped: mention-only 但未 @ 本 bot (comment=${commentId.slice(0, 12)})`);
+            return;
+        }
+    }
+    const text = trigger.text.trim();
+    if (!text)
+        return;
+    logger.info(`[doc-comment] dispatch file=${fileToken.slice(0, 12)} comment=${commentId.slice(0, 12)} mode=${sub.commentTriggerMode} → session anchor=${sub.sessionAnchor.slice(0, 12)}`);
+    await handlers.handleDocComment({
+        larkAppId,
+        sub,
+        commentId,
+        replyId: trigger.replyId || commentId,
+        text,
+        authorOpenId: trigger.userId,
+    });
+}
 /**
  * Create and start the Lark WSClient with event dispatching.
  * Returns the WSClient instance for lifecycle management.
@@ -997,6 +1120,11 @@ export function startLarkEventDispatcher(larkAppId, larkAppSecret, handlers, bra
                 }
             }, 'bot-added event');
         },
+        // 文档评论入口（/subscribe-lark-doc）。飞书评论事件命名在 v1/v2 间有差异，
+        // 两个候选名都注册（同一处理器）——真机一锤定音后可删冗余。需在开发者后台
+        // 订阅对应事件。注意：评论事件是 per-文档 推送（订阅时按 file_token 注册）。
+        'drive.file.comment_add_v1': (data) => handleCommentEventAckSafe(data, larkAppId, handlers),
+        'drive.notice.comment_add_v1': (data) => handleCommentEventAckSafe(data, larkAppId, handlers),
         'card.action.trigger': (data) => handleCardActionAckSafe(data, larkAppId, handlers),
         'im.message.receive_v1': (data) => {
             const messageIdForKey = data?.message?.message_id;
@@ -1370,6 +1498,32 @@ export function startLarkEventDispatcher(larkAppId, larkAppSecret, handlers, bra
             }, 'message event');
         },
     });
+    // 诊断：包一层 invoke，记录长连接收到的**每一个**事件类型（含未注册的）。
+    // 排查云文档评论事件是否真送达 / 实际事件名用——comment 类一律连 payload 关键字段
+    // 一起打。日常其它事件只在 DEBUG 下打，避免刷屏。
+    // 仅当 dispatcher 真有 invoke 方法时才包（单测里 Lark.EventDispatcher 是 mock，
+    // register() 返回的对象没有 invoke → 不包，避免 undefined.bind 抛错）。
+    const __origInvoke = typeof eventDispatcher.invoke === 'function'
+        ? eventDispatcher.invoke.bind(eventDispatcher)
+        : undefined;
+    if (__origInvoke) {
+        eventDispatcher.invoke = (data) => {
+            try {
+                const et = data?.header?.event_type ?? data?.event_type ?? data?.type ?? 'unknown';
+                const isCommentish = typeof et === 'string' && et.includes('comment');
+                if (isCommentish) {
+                    const ev = data?.event ?? data;
+                    const p = parseCommentEvent(data);
+                    logger.info(`[ws-event] ${larkAppId} event_type=${et} → parsed fileToken=${p.fileToken ?? '?'} commentId=${p.commentId ?? '?'} replyId=${p.replyId ?? '?'} isMentioned=${p.isMentioned} | notice_meta=${JSON.stringify(ev?.notice_meta ?? ev?.noticeMeta ?? null)}`);
+                }
+                else if (process.env.DEBUG) {
+                    logger.info(`[ws-event] ${larkAppId} event_type=${et}`);
+                }
+            }
+            catch { /* 诊断不阻断分发 */ }
+            return __origInvoke(data);
+        };
+    }
     // Start WSClient
     const wsClient = new Lark.WSClient({
         appId: larkAppId,