yuque-ai-mcp 2.7.4

package/dist/repo/export-repo.js

@@ -0,0 +1,243 @@
+/**
+ * doc/export-repo — 批量导出知识库全部文档为 Markdown
+ *
+ * 流程：
+ *   1. 获取 TOC 目录树 → 构建目录结构
+ *   2. 分页获取全部文档列表
+ *   3. 逐个获取文档详情（body + body_html）
+ *   4. 解析 body_html 中的图片/附件 → 尝试下载 → 成功替换为本地路径，失败保留原链接
+ *   5. 按 TOC 目录结构创建文件夹，文件以标题命名
+ *   6. 生成 INDEX.md（目录树 + 文档列表）+ GRAPH.md（文档间引用关系）
+ *   7. 输出导出报告
+ */
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { apiGet, isErrorResult } from "../common/api-client.js";
+import { loadConfig } from "../common/config.js";
+import { extractResources, downloadFile, formatFrontMatter, sanitizeFilename, htmlToMarkdown, } from "../common/export-common.js";
+import { buildTocDocDirMap } from "./export-toc.js";
+import { buildIndexMd } from "./export-index.js";
+import { buildGraphMd, extractYuqueLinks } from "./export-graph.js";
+// ─── 主工具 ────────────────────────────────────────────
+export const repoExport = {
+    name: "yuque_export_repo",
+    description: "Export all docs in a repo as Markdown files organized by TOC dir structure, with images downloaded and INDEX.md+GRAPH.md generated. 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: {
+                type: "string",
+                description: "Repository ID (numeric) or namespace like group/book_slug (required)",
+            },
+            output_dir: {
+                type: "string",
+                description: "Output directory path (absolute or relative). Defaults to ./yuque-export/<book_slug>/",
+            },
+            download_images: {
+                type: "boolean",
+                description: "Download images to local (default true). Set false to skip download.",
+            },
+            raw_body: {
+                type: "boolean",
+                description: "Use raw body field instead of converting body_html to markdown (default false)",
+            },
+        },
+        required: ["book_id"],
+    },
+    async handler(args) {
+        const cfg = loadConfig();
+        const bookId = args?.book_id;
+        const downloadImages = args?.download_images !== false;
+        const rawBody = args?.raw_body === true;
+        // ── 1. 获取知识库信息 ──
+        const repoData = await apiGet(`/repos/${bookId}`, undefined, "Export: get repo");
+        if (isErrorResult(repoData))
+            return repoData;
+        const repo = repoData.data || {};
+        const bookSlug = repo.slug || bookId.replace(/\//g, "_");
+        const outputDir = args?.output_dir || `./yuque-export/${bookSlug}`;
+        const imagesDir = join(outputDir, "images");
+        const attachmentsDir = join(outputDir, "attachments");
+        // ── 2. 获取 TOC 目录树 ──
+        const tocData = await apiGet(`/repos/${bookId}/toc`, undefined, "Export: get TOC");
+        let tocNodes = [];
+        if (!isErrorResult(tocData)) {
+            tocNodes = (tocData.data || []);
+        }
+        const docDirMap = buildTocDocDirMap(tocNodes);
+        // ── 3. 分页获取全部文档 ──
+        const allDocs = [];
+        let offset = 0;
+        const pageSize = 100;
+        while (true) {
+            const listData = await apiGet(`/repos/${bookId}/docs`, { offset: String(offset), limit: String(pageSize) }, "Export: list docs");
+            if (isErrorResult(listData))
+                return listData;
+            const list = listData;
+            const docs = list.data || [];
+            allDocs.push(...docs);
+            if (docs.length < pageSize)
+                break;
+            offset += pageSize;
+        }
+        if (allDocs.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "empty",
+                            message: `知识库 "${bookSlug}" 没有文档`,
+                        }, null, 2),
+                    }],
+            };
+        }
+        // ── 4. 创建输出目录 ──
+        await mkdir(outputDir, { recursive: true });
+        if (downloadImages) {
+            await mkdir(imagesDir, { recursive: true });
+            await mkdir(attachmentsDir, { recursive: true });
+        }
+        // ── 5. 逐个导出文档 ──
+        const results = await exportDocs(allDocs, outputDir, imagesDir, attachmentsDir, downloadImages, rawBody, cfg.token, docDirMap);
+        // ── 6. 生成 INDEX.md 和 GRAPH.md ──
+        const indexContent = buildIndexMd(tocNodes, results, repo.name || bookSlug);
+        await writeFile(join(outputDir, "INDEX.md"), indexContent, "utf-8");
+        const graphContent = buildGraphMd(results);
+        await writeFile(join(outputDir, "GRAPH.md"), graphContent, "utf-8");
+        // ── 7. 生成导出报告 ──
+        const okCount = results.filter((r) => r.status === "ok").length;
+        const errorCount = results.filter((r) => r.status === "error").length;
+        const totalImagesDownloaded = results.reduce((sum, r) => sum + r.images_downloaded, 0);
+        const totalImagesFailed = results.reduce((sum, r) => sum + r.images_failed, 0);
+        const report = {
+            status: "done",
+            repo: { id: bookId, slug: bookSlug, name: repo.name },
+            output_dir: outputDir,
+            summary: {
+                total_docs: allDocs.length,
+                ok: okCount,
+                error: errorCount,
+                images_downloaded: totalImagesDownloaded,
+                images_failed: totalImagesFailed,
+            },
+            index_file: join(outputDir, "INDEX.md"),
+            graph_file: join(outputDir, "GRAPH.md"),
+            files: results,
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(report, null, 2),
+                }],
+        };
+    },
+};
+// ─── 批量导出实现 ─────────────────────────────────────
+const EXPORT_CONCURRENCY = 5;
+async function exportDocs(allDocs, outputDir, imagesDir, attachmentsDir, downloadImages, rawBody, token, docDirMap) {
+    const results = [];
+    const total = allDocs.length;
+    for (let i = 0; i < total; i += EXPORT_CONCURRENCY) {
+        const batch = allDocs.slice(i, i + EXPORT_CONCURRENCY);
+        const batchResults = await Promise.all(batch.map(async (docMeta) => {
+            try {
+                const docData = await apiGet(`/repos/docs/${docMeta.id}`, { page_size: "200", page: "1" }, `Export: get doc ${docMeta.id}`);
+                if (isErrorResult(docData)) {
+                    return {
+                        doc_id: docMeta.id, slug: docMeta.slug, title: docMeta.title,
+                        status: "error", file: "", dir: "", images_downloaded: 0, images_failed: 0,
+                        error: "Failed to fetch doc",
+                    };
+                }
+                return await exportSingleDoc(docData, docMeta, outputDir, imagesDir, attachmentsDir, downloadImages, rawBody, token, docDirMap.get(docMeta.id) || "");
+            }
+            catch (err) {
+                return {
+                    doc_id: docMeta.id, slug: docMeta.slug, title: docMeta.title,
+                    status: "error", file: "", dir: "", images_downloaded: 0, images_failed: 0,
+                    error: err instanceof Error ? err.message : String(err),
+                };
+            }
+        }));
+        results.push(...batchResults);
+        batchResults.length = 0;
+    }
+    return results;
+}
+async function exportSingleDoc(docData, docMeta, outputDir, imagesDir, attachmentsDir, downloadImages, rawBody, token, tocDir = "") {
+    const doc = docData.data || {};
+    const body = doc.body || "";
+    const bodyHtml = doc.body_html || "";
+    const format = doc.format || "markdown";
+    const title = doc.title || "无标题";
+    const slug = doc.slug || `doc_${docMeta.id}`;
+    const createdAt = doc.created_at || "";
+    const updatedAt = doc.updated_at || "";
+    const wordCount = doc.word_count || 0;
+    const description = doc.description || "";
+    const docDir = tocDir ? join(outputDir, tocDir) : outputDir;
+    await mkdir(docDir, { recursive: true });
+    const relDepth = tocDir ? tocDir.split("/").map(() => "..").join("/") + "/" : "";
+    const relImagesDir = relDepth + "images";
+    const relAttachmentsDir = relDepth + "attachments";
+    let imagesDownloaded = 0;
+    let imagesFailed = 0;
+    let resourceMap = new Map();
+    if (downloadImages && bodyHtml) {
+        const resources = extractResources(bodyHtml, imagesDir, attachmentsDir);
+        for (const res of resources) {
+            const destPath = join(outputDir, res.localPath);
+            if (existsSync(destPath)) {
+                resourceMap.set(res.url, { url: res.url, localPath: relDepth + res.localPath, success: true });
+                continue;
+            }
+            const result = await downloadFile(res.url, destPath, token);
+            resourceMap.set(res.url, {
+                url: result.url,
+                localPath: result.success ? relDepth + res.localPath : result.url,
+                success: result.success,
+            });
+        }
+    }
+    let markdown = "";
+    if (format === "markdown" && !rawBody) {
+        markdown = body;
+    }
+    else if (bodyHtml && !rawBody) {
+        markdown = htmlToMarkdown(bodyHtml);
+    }
+    else {
+        markdown = body || JSON.stringify(doc, null, 2);
+    }
+    for (const [url, result] of resourceMap) {
+        if (result.success) {
+            imagesDownloaded++;
+            markdown = markdown.replaceAll(url, result.localPath);
+        }
+        else {
+            imagesFailed++;
+        }
+    }
+    const outboundLinks = extractYuqueLinks(markdown);
+    const frontmatter = formatFrontMatter({
+        title, slug,
+        created_at: createdAt, updated_at: updatedAt,
+        word_count: wordCount, description,
+    });
+    const fileName = sanitizeFilename(title) + ".md";
+    const filePath = join(docDir, fileName);
+    await writeFile(filePath, frontmatter + markdown, "utf-8");
+    return {
+        doc_id: docMeta.id,
+        slug,
+        title,
+        status: "ok",
+        file: filePath,
+        dir: tocDir,
+        images_downloaded: imagesDownloaded,
+        images_failed: imagesFailed,
+        outboundLinks,
+    };
+}
+//# sourceMappingURL=export-repo.js.map

package/dist/repo/export-repo.js.map

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

package/dist/repo/export-toc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * repo/export-toc — TOC 树构建与目录映射
+ */
+interface TocNode {
+    uuid: string;
+    title: string;
+    parent_uuid: string;
+    child_uuid: string;
+    doc_id?: number;
+    type: string;
+    url: string;
+}
+/**
+ * 根据 TOC 树构建 doc_id → 相对目录路径 的映射
+ */
+export declare function buildTocDocDirMap(nodes: TocNode[]): Map<number, string>;
+export {};

package/dist/repo/export-toc.js

@@ -0,0 +1,33 @@
+/**
+ * repo/export-toc — TOC 树构建与目录映射
+ */
+import { join } from "node:path";
+import { sanitizeFilename } from "../common/export-common.js";
+/**
+ * 根据 TOC 树构建 doc_id → 相对目录路径 的映射
+ */
+export function buildTocDocDirMap(nodes) {
+    const map = new Map();
+    if (!nodes || nodes.length === 0)
+        return map;
+    const nodeByUuid = new Map();
+    for (const n of nodes) {
+        nodeByUuid.set(n.uuid, n);
+    }
+    function getPath(uuid) {
+        const node = nodeByUuid.get(uuid);
+        if (!node)
+            return "";
+        const parentPath = node.parent_uuid ? getPath(node.parent_uuid) : "";
+        const dirName = sanitizeFilename(node.title);
+        return parentPath ? join(parentPath, dirName) : dirName;
+    }
+    for (const n of nodes) {
+        if (n.type === "DOC" && n.doc_id != null) {
+            const dirPath = n.parent_uuid ? getPath(n.parent_uuid) : "";
+            map.set(n.doc_id, dirPath);
+        }
+    }
+    return map;
+}
+//# sourceMappingURL=export-toc.js.map

package/dist/repo/export-toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-toc.js","sourceRoot":"","sources":["../../src/repo/export-toc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAY9D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,SAAS,OAAO,CAAC,IAAY;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/repo/get-repo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * repo/get — 获取知识库详情
+ *
+ * 端点：GET /api/v2/repos/:book_id
+ * 职责：返回知识库完整信息（含 toc_yml 目录）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const repoGet: McpTool;

package/dist/repo/get-repo.js

@@ -0,0 +1,32 @@
+/**
+ * repo/get — 获取知识库详情
+ *
+ * 端点：GET /api/v2/repos/:book_id
+ * 职责：返回知识库完整信息（含 toc_yml 目录）
+ */
+import { apiGet } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { formatRepo, handleApiCall } from "../common/format.js";
+export const repoGet = {
+    name: "yuque_get_repo",
+    description: "Get repo detail including toc_yml (TOC tree in YAML), namespace, items_count, full metadata. GET /repos/:id. 详见 references/api/repo_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["book_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.book_id, "book_id");
+        if (__v)
+            return __v;
+        const raw = args?.raw;
+        const bookId = args?.book_id;
+        const data = await apiGet(`/repos/${bookId}`, undefined, "Get repo");
+        return handleApiCall(data, formatRepo, raw);
+    },
+};
+//# sourceMappingURL=get-repo.js.map

package/dist/repo/get-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-repo.js","sourceRoot":"","sources":["../../src/repo/get-repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAiB,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,OAAO,GAAY;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,4IAA4I;IAEzJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAChH,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QAEvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,MAAM,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/repo/index.d.ts

@@ -0,0 +1,10 @@
+export { repoList } from "./list-repos.js";
+export { repoCreate } from "./create-repo.js";
+export { repoGet } from "./get-repo.js";
+export { repoUpdate } from "./update-repo.js";
+export { repoDelete } from "./delete-repo.js";
+export { repoBatchGet } from "./batch-get-repos.js";
+export { repoExport } from "./export-repo.js";
+export { repoCopy } from "./copy-repo.js";
+import type { McpTool } from "../common/types.js";
+export declare const repoTools: McpTool[];

package/dist/repo/index.js

@@ -0,0 +1,18 @@
+export { repoList } from "./list-repos.js";
+export { repoCreate } from "./create-repo.js";
+export { repoGet } from "./get-repo.js";
+export { repoUpdate } from "./update-repo.js";
+export { repoDelete } from "./delete-repo.js";
+export { repoBatchGet } from "./batch-get-repos.js";
+export { repoExport } from "./export-repo.js";
+export { repoCopy } from "./copy-repo.js";
+import { repoList } from "./list-repos.js";
+import { repoCreate } from "./create-repo.js";
+import { repoGet } from "./get-repo.js";
+import { repoUpdate } from "./update-repo.js";
+import { repoDelete } from "./delete-repo.js";
+import { repoBatchGet } from "./batch-get-repos.js";
+import { repoExport } from "./export-repo.js";
+import { repoCopy } from "./copy-repo.js";
+export const repoTools = [repoList, repoCreate, repoGet, repoUpdate, repoDelete, repoBatchGet, repoExport, repoCopy];
+//# sourceMappingURL=index.js.map

package/dist/repo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC"}

package/dist/repo/list-repos.d.ts

@@ -0,0 +1,8 @@
+/**
+ * repo/list — 获取知识库列表
+ *
+ * 端点：GET /api/v2/users/:login/repos 或 GET /api/v2/groups/:login/repos
+ * 职责：获取用户或团队下的知识库列表，自动切换 user/group 端点
+ */
+import type { McpTool } from "../common/types.js";
+export declare const repoList: McpTool;

package/dist/repo/list-repos.js

@@ -0,0 +1,48 @@
+/**
+ * repo/list — 获取知识库列表
+ *
+ * 端点：GET /api/v2/users/:login/repos 或 GET /api/v2/groups/:login/repos
+ * 职责：获取用户或团队下的知识库列表，自动切换 user/group 端点
+ */
+import { apiGetWithFallback } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { formatRepo, handleApiCall } from "../common/format.js";
+export const repoList = {
+    name: "yuque_list_repos",
+    description: "List repos for a user or group. GET /users|groups/:login/repos. 详见 references/api/repo_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            login: { type: "string", description: "User or group login / ID (required)" },
+            type: { type: "string", description: "Type filter: Book (docs) / Design (boards)" },
+            offset: { type: "number", description: "Pagination offset, default 0" },
+            limit: { type: "number", description: "Page size, max 100, default 100" },
+            filterByAbility: { type: "string", description: "Ability filter: create_doc (only repos with doc creation permission)" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["login"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.login, "login");
+        if (__v)
+            return __v;
+        const raw = args?.raw;
+        const login = args?.login;
+        const type = args?.type;
+        const offset = args?.offset ?? 0;
+        const limit = args?.limit ?? 100;
+        const filterByAbility = args?.filterByAbility;
+        const params = {
+            offset: String(offset),
+            limit: String(Math.min(limit, 100)),
+        };
+        if (type)
+            params.type = type;
+        if (filterByAbility)
+            params.filterByAbility = filterByAbility;
+        const data = await apiGetWithFallback(`/users/${login}/repos`, `/groups/${login}/repos`, params, "List repos");
+        return handleApiCall(data, formatRepo, raw);
+    },
+};
+//# sourceMappingURL=list-repos.js.map

package/dist/repo/list-repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-repos.js","sourceRoot":"","sources":["../../src/repo/list-repos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAiB,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+FAA+F;IAE5G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACnF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACvE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;YACzE,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YACxH,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,MAAM,GAAI,IAAI,EAAE,MAAiB,IAAI,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,GAAG,CAAC;QAC7C,MAAM,eAAe,GAAG,IAAI,EAAE,eAAqC,CAAC;QAEpE,MAAM,MAAM,GAA2B;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SACpC,CAAC;QACF,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,eAAe;YAAE,MAAM,CAAC,eAAe,GAAG,eAAe,CAAC;QAE9D,MAAM,IAAI,GAAG,MAAM,kBAAkB,CACnC,UAAU,KAAK,QAAQ,EACvB,WAAW,KAAK,QAAQ,EACxB,MAAM,EACN,YAAY,CACb,CAAC;QACF,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/repo/update-repo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * repo/update — 更新知识库
+ *
+ * 端点：PUT /api/v2/repos/:book_id
+ * 职责：更新知识库名称/路径/简介/公开性，支持通过 toc 字段批量更新目录
+ */
+import type { McpTool } from "../common/types.js";
+export declare const repoUpdate: McpTool;

package/dist/repo/update-repo.js

@@ -0,0 +1,48 @@
+/**
+ * repo/update — 更新知识库
+ *
+ * 端点：PUT /api/v2/repos/:book_id
+ * 职责：更新知识库名称/路径/简介/公开性，支持通过 toc 字段批量更新目录
+ */
+import { apiPut } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { formatRepo, handleApiCall } from "../common/format.js";
+export const repoUpdate = {
+    name: "yuque_update_repo",
+    description: "Update repo name/description/slug/public. PUT /repos/:id. 详见 references/api/repo_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
+            name: { type: "string", description: "Name" },
+            slug: { type: "string", description: "Slug" },
+            description: { type: "string", description: "Description" },
+            public: { type: "number", description: "Visibility: 0=private, 1=public, 2=team-public" },
+            toc: { type: "string", description: "TOC in Markdown format: [Title](doc-slug), supports batch TOC update" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["book_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.book_id, "book_id");
+        if (__v)
+            return __v;
+        const raw = args?.raw;
+        const bookId = args?.book_id;
+        const payload = {};
+        if (args?.name !== undefined)
+            payload.name = args.name;
+        if (args?.slug !== undefined)
+            payload.slug = args.slug;
+        if (args?.description !== undefined)
+            payload.description = args.description;
+        if (args?.public !== undefined)
+            payload.public = args.public;
+        if (args?.toc !== undefined)
+            payload.toc = args.toc;
+        const data = await apiPut(`/repos/${bookId}`, payload, "Update repo");
+        return handleApiCall(data, formatRepo, raw);
+    },
+};
+//# sourceMappingURL=update-repo.js.map

package/dist/repo/update-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-repo.js","sourceRoot":"","sources":["../../src/repo/update-repo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAiB,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,CAAC,MAAM,UAAU,GAAY;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,yFAAyF;IAEtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAChH,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE;YAC7C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE;YAC7C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;YACzF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAC5G,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QAEvC,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,IAAI,IAAI,EAAE,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC5E,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC7D,IAAI,IAAI,EAAE,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QAEpD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QACtE,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/rss/dedup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * rss/dedup — slug 生成逻辑
+ *
+ * slug 生成优先级：
+ *   1. sources.ts 中的 slugResolver(link)  — 提取站点文章 ID
+ *   2. fallback: md5(link).slice(0, 12)
+ */
+/** 生成去重 slug */
+export declare function buildSlug(source: string, link: string): string;

package/dist/rss/dedup.js

@@ -0,0 +1,21 @@
+/**
+ * rss/dedup — slug 生成逻辑
+ *
+ * slug 生成优先级：
+ *   1. sources.ts 中的 slugResolver(link)  — 提取站点文章 ID
+ *   2. fallback: md5(link).slice(0, 12)
+ */
+import { createHash } from "crypto";
+import { RSS_SOURCES } from "./sources.js";
+/** 生成去重 slug */
+export function buildSlug(source, link) {
+    const src = RSS_SOURCES[source];
+    if (src?.slugResolver) {
+        const resolved = src.slugResolver(link);
+        if (resolved)
+            return resolved;
+    }
+    // fallback: md5 前 12 位
+    return createHash("md5").update(link).digest("hex").slice(0, 12);
+}
+//# sourceMappingURL=dedup.js.map

package/dist/rss/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/rss/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,gBAAgB;AAChB,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,IAAY;IACpD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,GAAG,EAAE,YAAY,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IACD,uBAAuB;IACvB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/rss/fetch-feed.d.ts

@@ -0,0 +1,8 @@
+/**
+ * rss/fetch-feed — 通用 RSS 抓取 → 解析 → 去重（语雀 KV）→ 写入语雀
+ *
+ * 职责：抓取 RSS/Atom Feed，解析条目，语雀 KV 去重后写入目标知识库。
+ * 去重：调用 kv/common.ts 的 loadKvMap / saveKvMap，不再自己创建 KV 标记文档。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const rssFetch: McpTool;