@insightsuen/dingdoc 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,6CAA6C;AAC7C,MAAM,QAAQ,GACZ,CAAC,GAAG,IAAe,EAAE,EAAE,CACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5D,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC;AACvB,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;AACxB,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC;AACxB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,IAAI,eAAe,EAAE,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3B,MAAM,mBAAmB,EAAE,CAAC;QAC5B,YAAY,GAAG,IAAI,CAAC;QACpB,eAAe,CAAC,IAAI,CAAC,CAAC;QAEtB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,iBAAiB,EAAE,CAAC;QAClD,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,iCAAiC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YAC3E,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;KAAM,CAAC;IACN,MAAM,CAAC,IAAI,CACT,wFAAwF;QACxF,yCAAyC;QACzC,uCAAuC,CACxC,CAAC;AACJ,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,CAAC;IAC1B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,mCAAmC;CACjD,CAAC,CAAC;AAEH,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE3C,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,26 @@
+export interface DocExportResult {
+    taskId: number;
+    success: boolean;
+    content?: string;
+    url?: string;
+    name?: string;
+    extension?: string;
+    format?: string;
+    dentryUuid?: string;
+}
+/**
+ * 初始化 DingTalk Stream 长连接。
+ * 服务启动时调用一次，用于接收文档导出完成事件（doc_content_export_result）。
+ */
+export declare function initDocStream(appKey: string, appSecret: string): void;
+/**
+ * 等待指定 taskId 的文档导出结果。
+ * 需在调用 QueryDocContent 接口后立即调用，以避免事件先于等待注册到达。
+ */
+export declare function waitForDocExport(taskId: number, timeoutMs?: number): Promise<DocExportResult>;
+export declare function isStreamReady(): boolean;
+/** 从缓存中获取文档内容（若有） */
+export declare function getCachedDocContent(nodeId: string): string | undefined;
+/** 将文档内容写入缓存 */
+export declare function cacheDocContent(nodeId: string, content: string): void;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAsDrE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,SAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGrE"}

package/dist/stream.js

@@ -0,0 +1,114 @@
+import { DWClient, EventAck } from "dingtalk-stream";
+import { logger } from "@insight-mcp/shared";
+const DOC_CONTENT_EXPORT_EVENT = "doc_content_export_result";
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** taskId → Promise resolver（等待中的请求） */
+const pending = new Map();
+/**
+ * 近期到达的导出事件缓存（TTL 60s）。
+ * 解决竞态：事件在 waitForDocExport 注册前到达时，先暂存到此，供后续查询。
+ */
+const recentEvents = new Map();
+const RECENT_EVENT_TTL_MS = 60_000;
+let streamClient = null;
+let streamReady = false;
+/**
+ * 已成功获取过内容的文档缓存（nodeId → Markdown 内容）。
+ * DingTalk 导出事件每个 taskId 只推送一次，进程重启后需重新获取。
+ */
+const docContentCache = new Map();
+/**
+ * 初始化 DingTalk Stream 长连接。
+ * 服务启动时调用一次，用于接收文档导出完成事件（doc_content_export_result）。
+ */
+export function initDocStream(appKey, appSecret) {
+    if (streamClient)
+        return;
+    streamClient = new DWClient({ clientId: appKey, clientSecret: appSecret });
+    streamClient.registerAllEventListener((msg) => {
+        // 调试：打印所有收到的事件类型
+        logger.info(`[Stream] 收到事件 type=${msg.type} topic=${msg.headers.topic} eventType=${msg.headers.eventType ?? "(none)"}`);
+        if (msg.headers.eventType === DOC_CONTENT_EXPORT_EVENT) {
+            try {
+                logger.info(`[Stream] 事件原始 data: ${msg.data}`);
+                const data = JSON.parse(msg.data);
+                const taskId = Number(data.taskId);
+                const normalized = { ...data, taskId };
+                logger.info(`[Stream] 文档导出事件解析完成，taskId=${taskId}（原始: ${String(data.taskId)}），success=${String(data.success)}，pending中的key列表: [${[...pending.keys()].join(", ")}]`);
+                // 成功获取内容时，按 nodeId 缓存，避免因 DingTalk 只推送一次事件而导致后续请求超时
+                if (normalized.success && normalized.content && normalized.dentryUuid) {
+                    cacheDocContent(normalized.dentryUuid, normalized.content);
+                }
+                const resolver = pending.get(taskId);
+                if (resolver) {
+                    // 有等待中的请求，直接分发（无论成功或失败都分发，由调用方决策）
+                    pending.delete(taskId);
+                    resolver(normalized);
+                }
+                else if (normalized.success) {
+                    // 仅缓存成功结果，供稍后的 waitForDocExport 查询（解决事件先于等待注册的竞态）
+                    // 失败结果不缓存，避免污染后续请求
+                    logger.info(`[Stream] taskId ${taskId} 暂存到近期事件缓存`);
+                    recentEvents.set(taskId, normalized);
+                    setTimeout(() => recentEvents.delete(taskId), RECENT_EVENT_TTL_MS);
+                }
+                else {
+                    logger.warn(`[Stream] taskId ${taskId} 导出失败且无等待请求，丢弃`);
+                }
+            }
+            catch (err) {
+                logger.error("解析文档导出事件失败", err);
+            }
+        }
+        return { status: EventAck.SUCCESS };
+    });
+    streamClient
+        .connect()
+        .then(() => {
+        streamReady = true;
+        logger.info("✓ 钉钉 Stream 连接已建立，开始监听文档导出事件");
+    })
+        .catch((err) => {
+        logger.error("钉钉 Stream 连接失败，get_document 工具将无法获取文档内容", err);
+    });
+}
+/**
+ * 等待指定 taskId 的文档导出结果。
+ * 需在调用 QueryDocContent 接口后立即调用，以避免事件先于等待注册到达。
+ */
+export function waitForDocExport(taskId, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    if (!streamClient) {
+        return Promise.reject(new Error("DingTalk Stream 客户端未初始化，无法接收文档导出结果。请检查服务启动日志。"));
+    }
+    // 先查近期事件缓存（解决竞态：事件在注册前已到达的情况）
+    const cached = recentEvents.get(taskId);
+    if (cached) {
+        logger.info(`[Stream] taskId ${taskId} 命中近期事件缓存，直接返回`);
+        recentEvents.delete(taskId);
+        return Promise.resolve(cached);
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            pending.delete(taskId);
+            reject(new Error(`文档导出超时（taskId: ${taskId}，等待 ${timeoutMs / 1000}s）。` +
+                `\n  可能原因：Stream 连接断开、导出服务繁忙，或文档不支持导出。`));
+        }, timeoutMs);
+        pending.set(taskId, (result) => {
+            clearTimeout(timer);
+            resolve(result);
+        });
+    });
+}
+export function isStreamReady() {
+    return streamReady;
+}
+/** 从缓存中获取文档内容（若有） */
+export function getCachedDocContent(nodeId) {
+    return docContentCache.get(nodeId);
+}
+/** 将文档内容写入缓存 */
+export function cacheDocContent(nodeId, content) {
+    docContentCache.set(nodeId, content);
+    logger.info(`[Cache] 文档内容已缓存，nodeId: ${nodeId}，长度: ${content.length} 字符`);
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA2B,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AAC7D,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAalC,wCAAwC;AACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6C,CAAC;AAErE;;;GAGG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;AACxD,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,IAAI,YAAY,GAAoB,IAAI,CAAC;AACzC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,SAAiB;IAC7D,IAAI,YAAY;QAAE,OAAO;IAEzB,YAAY,GAAG,IAAI,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;IAE3E,YAAY,CAAC,wBAAwB,CAAC,CAAC,GAAuB,EAAE,EAAE;QAChE,iBAAiB;QACjB,MAAM,CAAC,IAAI,CACT,sBAAsB,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,OAAO,CAAC,KAAK,cAAc,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,QAAQ,EAAE,CAC3G,CAAC;QAEF,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,wBAAwB,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAoB,CAAC;gBACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,MAAM,UAAU,GAAoB,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC;gBACxD,MAAM,CAAC,IAAI,CAAC,8BAA8B,MAAM,QAAQ,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEpK,oDAAoD;gBACpD,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;oBACtE,eAAe,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC7D,CAAC;gBAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,QAAQ,EAAE,CAAC;oBACb,kCAAkC;oBAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACvB,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACvB,CAAC;qBAAM,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC9B,kDAAkD;oBAClD,mBAAmB;oBACnB,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,YAAY,CAAC,CAAC;oBACnD,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBACrC,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,gBAAgB,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,YAAY;SACT,OAAO,EAAE;SACT,IAAI,CAAC,GAAG,EAAE;QACT,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC9C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,SAAS,GAAG,kBAAkB;IAE9B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,+CAA+C,CAChD,CACF,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,mBAAmB,MAAM,gBAAgB,CAAC,CAAC;QACvD,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACvB,MAAM,CACJ,IAAI,KAAK,CACP,kBAAkB,MAAM,OAAO,SAAS,GAAG,IAAI,KAAK;gBAClD,uCAAuC,CAC1C,CACF,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAe;IAC7D,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,2BAA2B,MAAM,QAAQ,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;AAC5E,CAAC"}

package/dist/tools/get-document.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@insight-mcp/shared";
+export declare function registerGetDocument(server: McpServer): void;
+//# sourceMappingURL=get-document.d.ts.map

package/dist/tools/get-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-document.d.ts","sourceRoot":"","sources":["../../src/tools/get-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAmFrD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+D3D"}

package/dist/tools/get-document.js

@@ -0,0 +1,117 @@
+import { toToolError, logger } from "@insight-mcp/shared";
+import { z } from "zod";
+import { dingtalkGet, DingTalkApiError } from "../client.js";
+import { waitForDocExport, isStreamReady, getCachedDocContent } from "../stream.js";
+import { fetchDocViaBrowser } from "../browser.js";
+import { isApiAvailable } from "../auth.js";
+/** 触发 browser fallback 的 DingTalk API 错误码 */
+const BROWSER_FALLBACK_CODES = new Set(["permissionDenied", "documentNotExist"]);
+const ALIDOC_URL_PATTERN = /alidocs\.dingtalk\.com\/i\/nodes\/([A-Za-z0-9_-]+)/;
+/** 从钉钉文档 URL 中提取 nodeId */
+function extractNodeId(url) {
+    return ALIDOC_URL_PATTERN.exec(url)?.[1] ?? null;
+}
+/**
+ * 触发一次文档导出并等待 Stream 事件。
+ *
+ * 钉钉有导出缓存机制：若文档未变更，API 返回相同 taskId 但不推送新的 Stream 事件。
+ * 调用方应在首次超时后再重试一次，重试会强制钉钉重新导出并推送事件。
+ */
+async function triggerAndWaitExport(nodeId, timeoutMs) {
+    logger.info(`正在触发文档导出，nodeId: ${nodeId}`);
+    const resp = await dingtalkGet(`/v2.0/doc/query/${nodeId}/contents`, { targetFormat: "markdown" });
+    const taskId = Number(resp.taskId);
+    logger.info(`文档导出任务已触发，taskId: ${taskId}，等待导出结果（最长 ${timeoutMs / 1000}s）...`);
+    const result = await waitForDocExport(taskId, timeoutMs);
+    if (!result.success) {
+        throw new Error(`文档导出失败（taskId: ${taskId}）`);
+    }
+    const content = result.content ?? "";
+    logger.info(`文档导出成功，taskId: ${taskId}，内容长度: ${content.length} 字符`);
+    return content;
+}
+/**
+ * 通过 API + Stream 获取文档 Markdown 内容。
+ * 首次超时后自动重试一次（钉钉缓存机制导致相同 taskId 可能不推送新事件）。
+ */
+async function fetchDocContent(nodeId) {
+    if (!isStreamReady()) {
+        throw new Error("DingTalk Stream 连接尚未建立，无法获取文档内容。" +
+            "\n  请等待服务启动完成后重试，或检查启动日志中是否有 Stream 连接错误。");
+    }
+    // 优先使用进程内缓存（DingTalk 每个 taskId 只推送一次 Stream 事件）
+    const cached = getCachedDocContent(nodeId);
+    if (cached) {
+        logger.info(`[Cache] 命中文档缓存，nodeId: ${nodeId}，直接返回`);
+        return cached;
+    }
+    try {
+        return await triggerAndWaitExport(nodeId, 20_000);
+    }
+    catch (err) {
+        // 权限错误直接上抛，由外层决定是否 fallback 到浏览器
+        if (err instanceof DingTalkApiError && BROWSER_FALLBACK_CODES.has(err.code)) {
+            throw err;
+        }
+        // 超时或其他错误重试一次
+        const reason = err instanceof Error ? err.message : String(err);
+        logger.warn(`首次导出失败，自动重试（nodeId: ${nodeId}，原因: ${reason}）...`);
+        return await triggerAndWaitExport(nodeId, 30_000);
+    }
+}
+export function registerGetDocument(server) {
+    server.tool("dingtalk_get_document", "读取钉钉知识库文档内容，返回 Markdown 格式。支持通过 nodeId 或文档 URL（https://alidocs.dingtalk.com/i/nodes/...）两种方式指定文档", {
+        nodeId: z.string().optional().describe("文档节点 ID（与 url 二选一）"),
+        url: z
+            .string()
+            .optional()
+            .describe("文档 URL，格式：https://alidocs.dingtalk.com/i/nodes/{nodeId}（与 nodeId 二选一）"),
+    }, async ({ nodeId, url }) => {
+        let resolvedNodeId;
+        if (nodeId) {
+            resolvedNodeId = nodeId;
+        }
+        else if (url) {
+            const extracted = extractNodeId(url);
+            if (!extracted) {
+                return toToolError(new Error("无法从 URL 中解析 nodeId，请确认格式为：https://alidocs.dingtalk.com/i/nodes/{nodeId}"));
+            }
+            resolvedNodeId = extracted;
+        }
+        else {
+            return toToolError(new Error("请提供 nodeId 或 url 参数（二选一）"));
+        }
+        // API 不可用时直接走浏览器
+        if (!isApiAvailable()) {
+            logger.info(`[Browser] API 不可用，使用浏览器读取文档（nodeId: ${resolvedNodeId}）`);
+            try {
+                const content = await fetchDocViaBrowser(resolvedNodeId);
+                return { content: [{ type: "text", text: content }] };
+            }
+            catch (err) {
+                return toToolError(err);
+            }
+        }
+        try {
+            const content = await fetchDocContent(resolvedNodeId);
+            return { content: [{ type: "text", text: content }] };
+        }
+        catch (err) {
+            // API 权限不足时 fallback 到浏览器
+            if (err instanceof DingTalkApiError && BROWSER_FALLBACK_CODES.has(err.code)) {
+                logger.warn(`[Fallback] API 返回 ${err.code}，切换浏览器访问（nodeId: ${resolvedNodeId}）`);
+                try {
+                    const content = await fetchDocViaBrowser(resolvedNodeId);
+                    return {
+                        content: [{ type: "text", text: `> ⚠️ API 无权访问此文档，以下内容通过浏览器读取。\n\n${content}` }],
+                    };
+                }
+                catch (browserErr) {
+                    return toToolError(new Error(`API 和浏览器均无法获取文档内容：\n  API: ${err.message}\n  浏览器: ${browserErr instanceof Error ? browserErr.message : String(browserErr)}`));
+                }
+            }
+            return toToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=get-document.js.map

package/dist/tools/get-document.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@insight-mcp/shared";
+export declare function registerDingdocTools(server: McpServer, apiAvailable: boolean): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAMrD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,IAAI,CAQnF"}

package/dist/tools/index.js

@@ -0,0 +1,15 @@
+import { logger } from "@insight-mcp/shared";
+import { registerListSpaces } from "./list-spaces.js";
+import { registerListNodes } from "./list-nodes.js";
+import { registerGetDocument } from "./get-document.js";
+export function registerDingdocTools(server, apiAvailable) {
+    if (apiAvailable) {
+        registerListSpaces(server);
+        registerListNodes(server);
+    }
+    else {
+        logger.info("仅浏览器模式：仅注册 dingtalk_get_document 工具（list_spaces / list_nodes 需要 API 凭证）");
+    }
+    registerGetDocument(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,YAAqB;IAC3E,IAAI,YAAY,EAAE,CAAC;QACjB,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC3B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACzF,CAAC;IACD,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/list-nodes.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@insight-mcp/shared";
+export declare function registerListNodes(server: McpServer): void;
+//# sourceMappingURL=list-nodes.d.ts.map

package/dist/tools/list-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-nodes.d.ts","sourceRoot":"","sources":["../../src/tools/list-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA4ErD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCzD"}

package/dist/tools/list-nodes.js

@@ -0,0 +1,73 @@
+import { toToolError } from "@insight-mcp/shared";
+import { z } from "zod";
+import { dingtalkGet } from "../client.js";
+async function fetchNodes(parentNodeId) {
+    const nodes = [];
+    let nextToken;
+    do {
+        const params = {
+            parentNodeId,
+            maxResults: 50,
+        };
+        if (nextToken)
+            params["nextToken"] = nextToken;
+        const resp = await dingtalkGet("/v2.0/wiki/nodes", params);
+        nodes.push(...(resp.nodes ?? []));
+        nextToken = resp.nextToken;
+    } while (nextToken);
+    return nodes;
+}
+async function fetchNodesRecursive(parentNodeId) {
+    const nodes = await fetchNodes(parentNodeId);
+    const results = [];
+    for (const node of nodes) {
+        const result = {
+            nodeId: node.nodeId,
+            name: node.name,
+            type: node.type,
+            category: node.category ?? null,
+            url: node.url ?? null,
+            hasChildren: node.hasChildren,
+        };
+        if (node.hasChildren && node.type === "FOLDER") {
+            result.children = await fetchNodesRecursive(node.nodeId);
+        }
+        results.push(result);
+    }
+    return results;
+}
+export function registerListNodes(server) {
+    server.tool("dingtalk_list_nodes", "列出钉钉知识库节点下的子节点。nodeId 可从 dingtalk_list_spaces 获取的 rootNodeId 开始。支持 recursive 递归展开整个目录树（节点数量多时耗时较长）", {
+        nodeId: z.string().describe("父节点 ID（dentryUuid），如知识库的 rootNodeId"),
+        recursive: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("是否递归展开所有子节点，默认 false"),
+    }, async ({ nodeId, recursive }) => {
+        try {
+            let result;
+            if (recursive) {
+                result = await fetchNodesRecursive(nodeId);
+            }
+            else {
+                const nodes = await fetchNodes(nodeId);
+                result = nodes.map((node) => ({
+                    nodeId: node.nodeId,
+                    name: node.name,
+                    type: node.type,
+                    category: node.category ?? null,
+                    url: node.url ?? null,
+                    hasChildren: node.hasChildren,
+                }));
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return toToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=list-nodes.js.map

package/dist/tools/list-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-nodes.js","sourceRoot":"","sources":["../../src/tools/list-nodes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA8B3C,KAAK,UAAU,UAAU,CAAC,YAAoB;IAC5C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,SAA6B,CAAC;IAElC,GAAG,CAAC;QACF,MAAM,MAAM,GAAoC;YAC9C,YAAY;YACZ,UAAU,EAAE,EAAE;SACf,CAAC;QACF,IAAI,SAAS;YAAE,MAAM,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;QAE/C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAoB,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAClC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,CAAC,QAAQ,SAAS,EAAE;IAEpB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,YAAoB;IACrD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAe;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/C,MAAM,CAAC,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,oGAAoG,EACpG;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAClE,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,sBAAsB,CAAC;KACpC,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,IAAI,MAAoB,CAAC;YAEzB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;gBACvC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;oBAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;oBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC,CAAC,CAAC;YACN,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/list-spaces.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@insight-mcp/shared";
+export declare function registerListSpaces(server: McpServer): void;
+//# sourceMappingURL=list-spaces.d.ts.map

package/dist/tools/list-spaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-spaces.d.ts","sourceRoot":"","sources":["../../src/tools/list-spaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkC1D"}

package/dist/tools/list-spaces.js

@@ -0,0 +1,31 @@
+import { toToolError } from "@insight-mcp/shared";
+import { dingtalkGet } from "../client.js";
+export function registerListSpaces(server) {
+    server.tool("dingtalk_list_spaces", "列出当前用户有权限的所有钉钉知识库空间，返回 spaceId、名称、rootNodeId 和访问链接", {}, async () => {
+        try {
+            const spaces = [];
+            let nextToken;
+            do {
+                const params = { maxResults: 30 };
+                if (nextToken)
+                    params["nextToken"] = nextToken;
+                const resp = await dingtalkGet("/v2.0/wiki/workspaces", params);
+                spaces.push(...(resp.workspaces ?? []));
+                nextToken = resp.nextToken;
+            } while (nextToken);
+            const result = spaces.map((s) => ({
+                spaceId: s.workspaceId,
+                name: s.name,
+                rootNodeId: s.rootNodeId,
+                url: s.url ?? null,
+            }));
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return toToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=list-spaces.js.map

package/dist/tools/list-spaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-spaces.js","sourceRoot":"","sources":["../../src/tools/list-spaces.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAc3C,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,oDAAoD,EACpD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAgB,EAAE,CAAC;YAC/B,IAAI,SAA6B,CAAC;YAElC,GAAG,CAAC;gBACF,MAAM,MAAM,GAAoC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;gBACnE,IAAI,SAAS;oBAAE,MAAM,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;gBAE/C,MAAM,IAAI,GAAG,MAAM,WAAW,CAAyB,uBAAuB,EAAE,MAAM,CAAC,CAAC;gBACxF,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,CAAC,QAAQ,SAAS,EAAE;YAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChC,OAAO,EAAE,CAAC,CAAC,WAAW;gBACtB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI;aACnB,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@insightsuen/dingdoc",
+  "version": "0.1.0",
+  "description": "MCP server for reading DingTalk knowledge base documents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "dingdoc-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "mcp",
+    "dingtalk",
+    "dingdoc",
+    "knowledge-base",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "prepublishOnly": "pnpm run build",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "dingtalk-stream": "^2.1.4",
+    "playwright": "^1.58.2",
+    "turndown": "^7.2.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/turndown": "^5.0.6",
+    "esbuild": "^0.25.0",
+    "typescript": "^5.7.2"
+  }
+}