yuque-ai-mcp 2.7.4

package/dist/doc/copy-doc.js

@@ -0,0 +1,238 @@
+/**
+ * doc/copy-doc — 单文档跨知识库复制
+ *
+ * 两种模式：
+ * 1. Agent 传入 title/body/format/paths → 工具建目录+创建文档
+ * 2. Agent 传入 doc_id + source_book_id → 工具拉取源文档，返回原始内容给 Agent
+ *    Agent 清洗后再调模式1创建。解决大文档（>30KB）通过 mcporter CLI 传 body 不稳定的问题。
+ */
+import { apiGet, apiPost, apiPut, isErrorResult } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { ensureDirectoryPath } from "../common/toc-cache.js";
+import { appendSourceLink } from "../common/copy-common.js";
+export const docCopySingle = {
+    name: "yuque_copy_doc",
+    description: "Copy a single document to another repo. Mode 1: Agent provides cleaned content. Mode 2: tool fetches source for Agent to clean. 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            target_book_id: {
+                type: "string",
+                description: "Target repository ID or namespace (required)",
+            },
+            // ─── 模式 1：Agent 传入内容 ───
+            title: {
+                type: "string",
+                description: "Document title (required for mode 1: manual content)",
+            },
+            body: {
+                type: "string",
+                description: "Document body, cleaned by Agent (required for mode 1: manual content)",
+            },
+            format: {
+                type: "string",
+                description: "Content format: markdown / lake / html (required for mode 1)",
+            },
+            // ─── 模式 2：工具内部拉取 ───
+            doc_id: {
+                type: "number",
+                description: "Source document ID. When provided, tool fetches the doc and returns raw content (title/body/format) for Agent to clean and create via mode 1. Requires source_book_id.",
+            },
+            source_book_id: {
+                type: "string",
+                description: "Source repository ID or namespace (optional, defaults to doc's own repo when doc_id is provided)",
+            },
+            // ─── 公共参数 ───
+            paths: {
+                type: "string",
+                description: "JSON array of directory paths, e.g. '[\"Java/Spring\",\"Database/MySQL\"]'. 1-5 paths (required)",
+            },
+            source_url: {
+                type: "string",
+                description: "Source document URL, appended as footer link. In mode 2, auto-generated from doc slug if not provided.",
+            },
+            source_title: {
+                type: "string",
+                description: "Source document title for the footer link. In mode 2, uses source doc title if not provided.",
+            },
+            raw: {
+                type: "boolean",
+                description: "Return raw full JSON",
+            },
+        },
+        required: ["target_book_id", "paths"],
+    },
+    async handler(args) {
+        const targetBookId = args?.target_book_id;
+        const docId = args?.doc_id;
+        const sourceBookId = args?.source_book_id;
+        let title = args?.title;
+        let body = args?.body;
+        let format = args?.format;
+        let sourceUrl = args?.source_url;
+        let sourceTitle = args?.source_title;
+        const raw = args?.raw;
+        // 校验必填
+        const err = requiredString(targetBookId, "target_book_id");
+        if (err)
+            return err;
+        // ─── 模式 2：工具内部拉取源文档 ───
+        if (docId) {
+            // source_book_id 必填（语雀 API 无全局文档查询端点）
+            if (!sourceBookId) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "MISSING_SOURCE_BOOK_ID",
+                                message: "doc_id 模式下 source_book_id 为必填参数（语雀 API 无全局文档查询端点，无法自动推断所属知识库）",
+                                doc_id: docId,
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+            // 拉取源文档完整内容（markdown 格式）
+            const srcDoc = await apiGet(`/repos/${sourceBookId}/docs/${docId}`, {
+                raw: "1",
+            }, `Fetch source doc ${docId}`);
+            if (isErrorResult(srcDoc)) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "FETCH_DOC_FAILED",
+                                message: "拉取源文档内容失败",
+                                doc_id: docId,
+                                source_book_id: sourceBookId,
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+            const data = srcDoc.data;
+            if (!data) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "FETCH_DOC_FAILED",
+                                message: "源文档内容为空",
+                                doc_id: docId,
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+            title = data.title;
+            body = data.body;
+            format = "markdown"; // 语雀 API raw=1 返回 markdown
+            if (!sourceTitle)
+                sourceTitle = data.title;
+            if (!sourceUrl) {
+                sourceUrl = `https://www.yuque.com/${data.book?.namespace || sourceBookId}/${data.slug}`;
+            }
+            // 返回原始内容给 Agent，Agent 清洗后调手动模式创建
+            // 清理控制字符（JSON.stringify 不处理 \x00-\x1f，会导致解析失败）
+            const safeBody = body.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "");
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            mode: "fetch-only",
+                            source_doc_id: docId,
+                            source_book_id: sourceBookId,
+                            title,
+                            body: safeBody,
+                            format,
+                            source_url: sourceUrl,
+                            source_title: sourceTitle,
+                            hint: "Agent 清洗内容后，调用 yuque_copy_doc 手动模式（title/body/format/paths）创建文档",
+                        }, null, 2) }],
+            };
+        }
+        // 校验模式1必填
+        if (!docId) {
+            for (const [val, name] of [[title, "title"], [body, "body"], [format, "format"]]) {
+                const err2 = requiredString(val, name);
+                if (err2)
+                    return err2;
+            }
+        }
+        // 解析 paths
+        const pathsErr = requiredString(args?.paths, "paths");
+        if (pathsErr)
+            return pathsErr;
+        let paths;
+        try {
+            paths = JSON.parse(args?.paths);
+            if (!Array.isArray(paths) || paths.length === 0) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是非空 JSON 数组" }, null, 2) }],
+                    isError: true,
+                };
+            }
+            paths = paths.slice(0, 5);
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是有效的 JSON 数组" }, null, 2) }],
+                isError: true,
+            };
+        }
+        // 确保 title/body 已填充（编译期保证，运行时兜底）
+        if (!title || !body || !format) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "MISSING_CONTENT",
+                            message: docId ? "工具内部拉取失败，title/body 为空" : "manual 模式缺少 title/body/format 参数",
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        // 追尾源链接
+        if (sourceUrl) {
+            body = appendSourceLink(body, sourceUrl, sourceTitle || "原文档");
+        }
+        // 逐路径创建副本
+        const results = [];
+        for (const path of paths) {
+            try {
+                const dirUuid = await ensureDirectoryPath(targetBookId, path);
+                if (!dirUuid) {
+                    results.push({ path, error: "目录创建失败" });
+                    continue;
+                }
+                const payload = { title, body, format };
+                const data = await apiPost(`/repos/${targetBookId}/docs`, payload, `Copy doc to ${path}`);
+                if (isErrorResult(data)) {
+                    const errMsg = data.content?.[0]?.text || "Unknown error";
+                    results.push({ path, error: errMsg });
+                    continue;
+                }
+                const newDoc = data.data;
+                if (!newDoc?.id) {
+                    results.push({ path, error: "文档创建返回无 ID" });
+                    continue;
+                }
+                // 挂到目录节点下
+                await apiPut(`/repos/${targetBookId}/toc`, {
+                    action: "appendNode",
+                    action_mode: "child",
+                    type: "DOC",
+                    doc_ids: [newDoc.id],
+                    target_uuid: dirUuid,
+                }, `Append doc to TOC: ${path}`);
+                results.push({ path, doc_id: newDoc.id, slug: newDoc.slug });
+            }
+            catch (err) {
+                results.push({ path, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        const summary = {
+            mode: docId ? "auto-fetch" : "manual",
+            source_doc_id: docId || null,
+            source_book_id: sourceBookId || null,
+            title,
+            target_book_id: targetBookId,
+            paths,
+            results,
+            total: results.length,
+            success: results.filter((r) => r.doc_id).length,
+            failed: results.filter((r) => r.error).length,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(summary, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=copy-doc.js.map

package/dist/doc/copy-doc.js.map

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

package/dist/doc/create-doc.d.ts

@@ -0,0 +1,11 @@
+/**
+ * doc/create — 创建文档
+ *
+ * 端点：POST /api/v2/repos/:book_id/docs
+ * 职责：在指定知识库中创建新文档，可选挂载到 TOC 指定节点下
+ *
+ * ⚠️ 重要：appendNode 的 target_uuid 不传时从 payload 中去掉该字段，
+ * 不能传空字符串 ""，否则语雀 API 可能清空整个目录结构。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docCreate: McpTool;

package/dist/doc/create-doc.js

@@ -0,0 +1,82 @@
+/**
+ * doc/create — 创建文档
+ *
+ * 端点：POST /api/v2/repos/:book_id/docs
+ * 职责：在指定知识库中创建新文档，可选挂载到 TOC 指定节点下
+ *
+ * ⚠️ 重要：appendNode 的 target_uuid 不传时从 payload 中去掉该字段，
+ * 不能传空字符串 ""，否则语雀 API 可能清空整个目录结构。
+ */
+import { apiPost, apiPut } from "../common/api-client.js";
+import { check, requiredString } from "../common/validate.js";
+import { formatDoc, handleApiCall } from "../common/format.js";
+/** 创建文档后追加到 TOC */
+async function appendToToc(bookId, docId, parentUuid) {
+    try {
+        const payload = {
+            action: "appendNode",
+            action_mode: "child",
+            type: "DOC",
+            doc_ids: [docId],
+        };
+        // ⚠️ 不传 target_uuid 比传空字符串安全：空字符串可能被语雀解析为清空目录
+        if (parentUuid)
+            payload.target_uuid = parentUuid;
+        const res = await apiPut(`/repos/${bookId}/toc`, payload, "Append to TOC");
+        if (res && typeof res === "object" && "isError" in res) {
+            return `文档创建成功，但追加到目录失败。请手动在语雀网页端调整目录。`;
+        }
+        return null;
+    }
+    catch {
+        return "文档创建成功，但追加到目录时网络异常，请手动在语雀网页端调整目录。";
+    }
+}
+export const docCreate = {
+    name: "yuque_create_doc",
+    description: "Create a document in a repo. 传 parent_uuid 则挂到指定节点下，不传默认挂根目录。POST /repos/:id/docs. 详见 references/api/doc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
+            title: { type: "string", description: "Title, defaults to 'Untitled'" },
+            slug: { type: "string", description: "Document slug. Rule: kebab-case, lowercase, no special chars. Auto-generated if omitted." },
+            format: { type: "string", description: "Content format: markdown / html / lake, defaults to markdown" },
+            body: { type: "string", description: "Document body content (required)" },
+            public: { type: "number", description: "Visibility: 0=private, 1=public, 2=team-public, defaults to repo setting" },
+            parent_uuid: { type: "string", description: "TOC parent node UUID. 指定后新文档挂到该节点下。不传默认挂根目录。" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["book_id", "body"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = check(requiredString(args?.book_id, "book_id"), requiredString(args?.body, "body"));
+        if (__v)
+            return __v;
+        const raw = args?.raw;
+        const bookId = args?.book_id;
+        const title = args?.title ?? "无标题";
+        const slug = args?.slug;
+        const format = args?.format ?? "markdown";
+        const body = args?.body;
+        const isPublic = args?.public;
+        const parentUuid = args?.parent_uuid;
+        const payload = { title, body, format };
+        if (slug)
+            payload.slug = slug;
+        if (isPublic !== undefined)
+            payload.public = isPublic;
+        const data = await apiPost(`/repos/${bookId}/docs`, payload, "Create doc");
+        const docId = data?.data?.id;
+        const result = handleApiCall(data, formatDoc, raw);
+        const content = result.content ? [...result.content] : [];
+        if (docId) {
+            const tocWarning = await appendToToc(bookId, docId, parentUuid);
+            if (tocWarning)
+                content.push({ type: "text", text: tocWarning });
+        }
+        return result;
+    },
+};
+//# sourceMappingURL=create-doc.js.map

package/dist/doc/create-doc.js.map

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

package/dist/doc/delete-doc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * doc/delete — 删除文档
+ *
+ * 端点：DELETE /api/v2/repos/:book_id/docs/:id
+ * 职责：删除指定文档（移入回收站）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docDelete: McpTool;

package/dist/doc/delete-doc.js

@@ -0,0 +1,39 @@
+/**
+ * doc/delete — 删除文档
+ *
+ * 端点：DELETE /api/v2/repos/:book_id/docs/:id
+ * 职责：删除指定文档（移入回收站）
+ */
+import { confirmationParam, checkConfirmation } from "../common/errors.js";
+import { check, requiredString } from "../common/validate.js";
+import { apiDelete } from "../common/api-client.js";
+import { formatDoc, handleApiCall } from "../common/format.js";
+export const docDelete = {
+    name: "yuque_delete_doc",
+    description: "Delete a document (moves to recycle bin). ⚠️ Requires confirm='DELETE'. DELETE /repos/:id/docs/:id. 详见 references/api/doc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
+            id: { type: "string", description: "Document ID or slug (required)" },
+            confirm: confirmationParam.confirm,
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["book_id", "id", "confirm"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = check(requiredString(args?.book_id, "book_id"), requiredString(args?.id, "id"));
+        if (__v)
+            return __v;
+        const confirmed = checkConfirmation(args);
+        if (confirmed)
+            return confirmed;
+        const raw = args?.raw;
+        const bookId = args?.book_id;
+        const id = args?.id;
+        const data = await apiDelete(`/repos/${bookId}/docs/${id}`, "Delete doc");
+        return handleApiCall(data, formatDoc, raw);
+    },
+};
+//# sourceMappingURL=delete-doc.js.map

package/dist/doc/delete-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-doc.js","sourceRoot":"","sources":["../../src/doc/delete-doc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,kIAAkI;IAE/I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAChH,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACrE,OAAO,EAAE,iBAAiB,CAAC,OAAO;YAClC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC;KACvC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,KAAK,CACf,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EACxC,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAC/B,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAEhC,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QACvC,MAAM,EAAE,GAAG,IAAI,EAAE,EAAY,CAAC;QAE9B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,UAAU,MAAM,SAAS,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QAC1E,OAAO,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;CACF,CAAC"}

package/dist/doc/diff-doc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * doc/diff — 对比文档两个版本的内容差异
+ *
+ * 端点：GET /api/v2/doc_versions/:id（内部调用两次）
+ * 职责：拉取两个版本的 body，做逐行 diff，输出结构化变更报告
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docDiff: McpTool;

package/dist/doc/diff-doc.js

@@ -0,0 +1,190 @@
+/**
+ * doc/diff — 对比文档两个版本的内容差异
+ *
+ * 端点：GET /api/v2/doc_versions/:id（内部调用两次）
+ * 职责：拉取两个版本的 body，做逐行 diff，输出结构化变更报告
+ */
+import { apiGet, isErrorResult } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+function diffLines(oldText, newText) {
+    const oldLines = oldText.split("\n");
+    const newLines = newText.split("\n");
+    // LCS 表
+    const m = oldLines.length;
+    const n = newLines.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (oldLines[i - 1] === newLines[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // 回溯
+    const result = [];
+    let i = m, j = n;
+    const temp = [];
+    while (i > 0 || j > 0) {
+        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
+            temp.push({ type: "unchanged", line: oldLines[i - 1] });
+            i--;
+            j--;
+        }
+        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
+            temp.push({ type: "added", line: newLines[j - 1] });
+            j--;
+        }
+        else {
+            temp.push({ type: "removed", line: oldLines[i - 1] });
+            i--;
+        }
+    }
+    return temp.reverse();
+}
+// ─── 工具定义 ────────────────────────────────────────────────
+export const docDiff = {
+    name: "yuque_diff_doc_versions",
+    description: "Compare two document versions and show line-level diff (added/removed/unchanged). Computes diff locally. 详见 references/api/doc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            version_id_1: {
+                type: "number",
+                description: "First version ID (required, older version)",
+            },
+            version_id_2: {
+                type: "number",
+                description: "Second version ID (required, newer version)",
+            },
+            max_lines: {
+                type: "number",
+                description: "Max diff lines to show in preview (default 200, 0 = all)",
+            },
+            context_lines: {
+                type: "number",
+                description: "Unchanged context lines around changes (default 3, 0 = no context)",
+            },
+        },
+        required: ["version_id_1", "version_id_2"],
+    },
+    async handler(args) {
+        // @validate
+        const v1 = requiredString(args?.version_id_1?.toString(), "version_id_1");
+        if (v1)
+            return v1;
+        const v2 = requiredString(args?.version_id_2?.toString(), "version_id_2");
+        if (v2)
+            return v2;
+        const versionId1 = args?.version_id_1;
+        const versionId2 = args?.version_id_2;
+        const maxLines = args?.max_lines ?? 200;
+        const contextLines = args?.context_lines ?? 3;
+        // 拉取两个版本的 body
+        const [data1, data2] = await Promise.all([
+            apiGet(`/doc_versions/${versionId1}`, undefined, "Get version 1"),
+            apiGet(`/doc_versions/${versionId2}`, undefined, "Get version 2"),
+        ]);
+        if (isErrorResult(data1))
+            return data1;
+        if (isErrorResult(data2))
+            return data2;
+        const body1 = data1?.data?.body ?? "";
+        const body2 = data2?.data?.body ?? "";
+        const title1 = data1?.data?.title ?? "";
+        const title2 = data2?.data?.title ?? "";
+        const createdAt1 = data1?.data?.created_at ?? "";
+        const createdAt2 = data2?.data?.created_at ?? "";
+        if (!body1 && !body2) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ error: "两个版本都没有 body 内容" }, null, 2),
+                    }],
+                isError: true,
+            };
+        }
+        // 执行 diff
+        const diff = diffLines(body1, body2);
+        // 统计
+        const added = diff.filter(d => d.type === "added").length;
+        const removed = diff.filter(d => d.type === "removed").length;
+        const unchanged = diff.filter(d => d.type === "unchanged").length;
+        const totalChanges = added + removed;
+        const totalLines = diff.length;
+        const similarity = totalLines > 0
+            ? Math.round((unchanged / totalLines) * 10000) / 100
+            : 100;
+        // 生成带上下文的预览
+        let preview = "";
+        const lines = maxLines === 0 ? diff.length : Math.min(maxLines, diff.length);
+        if (contextLines === 0) {
+            // 无上下文：只显示变更行
+            const changed = diff.filter(d => d.type !== "unchanged");
+            preview = changed.slice(0, lines).map(d => {
+                const prefix = d.type === "added" ? "+" : "-";
+                return `${prefix} ${d.line}`;
+            }).join("\n");
+        }
+        else {
+            // 带上下文
+            const result = [];
+            let lastPrinted = -contextLines - 1;
+            for (let i = 0; i < diff.length && result.length < lines; i++) {
+                const d = diff[i];
+                if (!d)
+                    continue;
+                if (d.type !== "unchanged") {
+                    // 在变更前添加上下文
+                    const ctxStart = Math.max(i - contextLines, lastPrinted + 1, 0);
+                    for (let c = ctxStart; c < i; c++) {
+                        if (result.length >= lines)
+                            break;
+                        result.push(`  ${diff[c].line}`);
+                    }
+                    const prefix = d.type === "added" ? "+" : "-";
+                    result.push(`${prefix} ${d.line}`);
+                    lastPrinted = i;
+                }
+                else if (i - lastPrinted <= contextLines && i > lastPrinted) {
+                    // 变更后的上下文
+                    result.push(`  ${d.line}`);
+                    lastPrinted = i;
+                }
+            }
+            preview = result.join("\n");
+        }
+        const output = {
+            version_1: {
+                id: versionId1,
+                title: title1,
+                created_at: createdAt1,
+                lines: body1.split("\n").length,
+            },
+            version_2: {
+                id: versionId2,
+                title: title2,
+                created_at: createdAt2,
+                lines: body2.split("\n").length,
+            },
+            stats: {
+                total_lines: totalLines,
+                added_lines: added,
+                removed_lines: removed,
+                unchanged_lines: unchanged,
+                total_changes: totalChanges,
+                similarity_pct: similarity,
+            },
+            diff_preview: preview,
+            note: maxLines > 0 && totalChanges > maxLines
+                ? `预览截断：仅显示前 ${maxLines} 行差异（共 ${totalChanges} 行变更）`
+                : undefined,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=diff-doc.js.map

package/dist/doc/diff-doc.js.map

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

package/dist/doc/embed-url.d.ts

@@ -0,0 +1,10 @@
+/**
+ * doc/embed-url — 生成语雀文档嵌入阅读器 URL
+ *
+ * 端点：无（纯工具函数，基于语雀嵌入文档阅读器规范）
+ * 职责：根据文档 URL 或 doc_id + book 信息，生成嵌入模式 URL
+ *
+ * 参考：https://www.yuque.com/yuque/developer/embed
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docEmbedUrl: McpTool;