yuque-ai-mcp 2.7.4

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

@@ -0,0 +1,7 @@
+/**
+ * board/create — 在文档中创建画板资源
+ *
+ * 端点：POST /api/v2/yfm/boards
+ */
+import type { McpTool } from "../common/types.js";
+export declare const boardCreate: McpTool;

package/dist/board/create-board.js

@@ -0,0 +1,50 @@
+/**
+ * board/create — 在文档中创建画板资源
+ *
+ * 端点：POST /api/v2/yfm/boards
+ */
+import { apiPost } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const boardCreate = {
+    name: "yuque_create_board",
+    description: "Create a board resource (mindmap/flowchart/architecture diagram) in a document. POST /yfm/boards. 详见 references/api/board_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            doc_id: { type: "number", description: "Document ID (mutually exclusive with url)" },
+            url: { type: "string", description: "Document URL (mutually exclusive with doc_id)" },
+            type: { type: "string", description: "Board type (required): mindmap, flowchart, architecturediagram" },
+            dsl: { type: "string", description: "Board DSL text content (required), format depends on type" },
+            insert_after_lake_id: { type: "string", description: "Insert after specified Lake node, appends to document end if omitted" },
+        },
+        required: ["type", "dsl"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.dsl, "dsl");
+        if (__v)
+            return __v;
+        const docId = args?.doc_id;
+        const url = args?.url;
+        const type = args?.type;
+        const dsl = args?.dsl;
+        const insertAfter = args?.insert_after_lake_id;
+        if (!docId && !url) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "请提供 doc_id 或 url / Provide doc_id or url" }, null, 2) }],
+                isError: true,
+            };
+        }
+        const payload = { resource_type: "board", type, dsl };
+        if (docId)
+            payload.doc_id = docId;
+        if (url)
+            payload.url = url;
+        if (insertAfter)
+            payload.insert_after_lake_id = insertAfter;
+        const data = await apiPost("/yfm/boards", payload, "Create board");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=create-board.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-board.js","sourceRoot":"","sources":["../../src/board/create-board.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,kIAAkI;IAE/I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACpF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACrF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;YACvG,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;YACjG,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;SAC9H;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;KAC1B;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,MAA4B,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAyB,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,EAAE,GAAa,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,EAAE,oBAA0C,CAAC;QAErE,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC1H,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAC/E,IAAI,KAAK;YAAE,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;QAClC,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QAC3B,IAAI,WAAW;YAAE,OAAO,CAAC,oBAAoB,GAAG,WAAW,CAAC;QAE5D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACnE,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * board/get — 获取文档中的画板资源
+ *
+ * 端点：GET /api/v2/yfm/boards
+ */
+import type { McpTool } from "../common/types.js";
+export declare const boardGet: McpTool;

package/dist/board/get-board.js

@@ -0,0 +1,44 @@
+/**
+ * board/get — 获取文档中的画板资源
+ *
+ * 端点：GET /api/v2/yfm/boards
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const boardGet = {
+    name: "yuque_get_board",
+    description: "Get board resource JSON DSL and summary stats from a document. GET /yfm/boards. 详见 references/api/board_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            doc_id: { type: "number", description: "Document ID (mutually exclusive with url)" },
+            url: { type: "string", description: "Document URL (mutually exclusive with doc_id)" },
+            resource_id: { type: "string", description: "Board resource ID (required, extract the ID part from board://<resource_id>)" },
+        },
+        required: ["resource_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.resource_id, "resource_id");
+        if (__v)
+            return __v;
+        const docId = args?.doc_id;
+        const url = args?.url;
+        const resourceId = args?.resource_id;
+        if (!docId && !url) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "请提供 doc_id 或 url / Provide doc_id or url" }, null, 2) }],
+                isError: true,
+            };
+        }
+        const params = { resource_type: "board", src: resourceId };
+        if (docId)
+            params.doc_id = String(docId);
+        if (url)
+            params.url = url;
+        const data = await apiGet("/yfm/boards", params, "Get board");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=get-board.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-board.js","sourceRoot":"","sources":["../../src/board/get-board.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gHAAgH;IAE7H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACpF,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACrF,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8EAA8E,EAAE;SAC7H;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QAC7D,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,MAA4B,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAyB,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,EAAE,WAAqB,CAAC;QAE/C,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC1H,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAA2B,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QACnF,IAAI,KAAK;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;QAE1B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC9D,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/board/index.d.ts

@@ -0,0 +1,5 @@
+export { boardGet } from "./get-board.js";
+export { boardCreate } from "./create-board.js";
+export { boardUpdate } from "./update-board.js";
+import type { McpTool } from "../common/types.js";
+export declare const boardTools: McpTool[];

package/dist/board/index.js

@@ -0,0 +1,8 @@
+export { boardGet } from "./get-board.js";
+export { boardCreate } from "./create-board.js";
+export { boardUpdate } from "./update-board.js";
+import { boardGet } from "./get-board.js";
+import { boardCreate } from "./create-board.js";
+import { boardUpdate } from "./update-board.js";
+export const boardTools = [boardGet, boardCreate, boardUpdate];
+//# sourceMappingURL=index.js.map

package/dist/board/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,UAAU,GAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * board/update — 更新文档中的画板资源
+ *
+ * 端点：PUT /api/v2/yfm/boards
+ */
+import type { McpTool } from "../common/types.js";
+export declare const boardUpdate: McpTool;

package/dist/board/update-board.js

@@ -0,0 +1,65 @@
+/**
+ * board/update — 更新文档中的画板资源
+ *
+ * 端点：PUT /api/v2/yfm/boards
+ */
+import { apiPut } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const boardUpdate = {
+    name: "yuque_update_board",
+    description: "Update a board resource (text or dsl, choose one). PUT /yfm/boards. 详见 references/api/board_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            doc_id: { type: "number", description: "Document ID (mutually exclusive with url)" },
+            url: { type: "string", description: "Document URL (mutually exclusive with doc_id)" },
+            resource_id: { type: "string", description: "Board resource ID (required, extract from board://<resource_id>)" },
+            text: { type: "string", description: "New textual DSL content (mutually exclusive with dsl)" },
+            dsl: { type: "string", description: "New JSON DSL object (mutually exclusive with text), sent as JSON" },
+        },
+        required: ["resource_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.resource_id, "resource_id");
+        if (__v)
+            return __v;
+        const docId = args?.doc_id;
+        const url = args?.url;
+        const resourceId = args?.resource_id;
+        const text = args?.text;
+        const dslRaw = args?.dsl;
+        if (!docId && !url) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "请提供 doc_id 或 url / Provide doc_id or url" }, null, 2) }],
+                isError: true,
+            };
+        }
+        if (!text && !dslRaw) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "请提供 text 或 dsl（二选一）/ Provide text or dsl (choose one)" }, null, 2) }],
+                isError: true,
+            };
+        }
+        const payload = { resource_type: "board", src: resourceId };
+        if (docId)
+            payload.doc_id = docId;
+        if (url)
+            payload.url = url;
+        if (text !== undefined) {
+            payload.text = text;
+        }
+        else if (dslRaw !== undefined) {
+            try {
+                payload.dsl = JSON.parse(dslRaw);
+            }
+            catch {
+                payload.dsl = dslRaw;
+            }
+        }
+        const data = await apiPut("/yfm/boards", payload, "Update board");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=update-board.js.map

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

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

package/dist/cli-http.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli-http.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * yuque-mcp-http CLI — HTTP SSE 模式（端口 3099）
+ * 用法：yuque-mcp-http [--config /path/to/config.json] [--port 3099]
+ */
+import { spawn } from "child_process";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const args = [resolve(__dirname, "http.js")];
+const child = spawn("node", args, {
+    stdio: "inherit",
+    env: { ...process.env },
+});
+child.on("exit", (code) => process.exit(code ?? 0));
+//# sourceMappingURL=cli-http.js.map

package/dist/cli-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-http.js","sourceRoot":"","sources":["../src/cli-http.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;IAChC,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;CACxB,CAAC,CAAC;AACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * yuque-mcp CLI — stdio 模式
+ * 用法：yuque-mcp [--config /path/to/config.json]
+ */
+import { spawn } from "child_process";
+import { resolve } from "path";
+import { fileURLToPath } from "url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const child = spawn("node", [resolve(__dirname, "index.js")], {
+    stdio: "inherit",
+    env: { ...process.env },
+});
+child.on("exit", (code) => process.exit(code ?? 0));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,EAAE;IAC5D,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;CACxB,CAAC,CAAC;AACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/common/api-client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * api-client — 公共 HTTP 请求层
+ *
+ * 封装 fetch + 错误处理（含网络异常）+ 自动重试（429/5xx）+ 响应格式化，
+ * 减少工具文件中的重复代码。
+ * 重试策略：指数退避 1s → 2s → 4s，最多 3 次。
+ */
+/** API 调用结果的类型 guard：检查是否是 MCP error */
+export declare function isErrorResult(result: unknown): result is {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+/** GET 请求 */
+export declare function apiGet(path: string, params?: Record<string, string>, context?: string): Promise<unknown>;
+/** POST 请求 */
+export declare function apiPost(path: string, body: Record<string, unknown>, context?: string): Promise<unknown>;
+/** PUT 请求 */
+export declare function apiPut(path: string, body: Record<string, unknown>, context?: string): Promise<unknown>;
+/** DELETE 请求 */
+export declare function apiDelete(path: string, context?: string): Promise<unknown>;
+/** POST 请求：支持 404 时 fallback 到备用路径（用于 user/group 端点自动切换） */
+export declare function apiPostWithFallback(path: string, fallbackPath: string, body: Record<string, unknown>, context?: string): Promise<unknown>;
+/** GET 请求：支持 404 时 fallback 到备用路径 */
+export declare function apiGetWithFallback(path: string, fallbackPath: string, params?: Record<string, string>, context?: string): Promise<unknown>;

package/dist/common/api-client.js

@@ -0,0 +1,198 @@
+/**
+ * api-client — 公共 HTTP 请求层
+ *
+ * 封装 fetch + 错误处理（含网络异常）+ 自动重试（429/5xx）+ 响应格式化，
+ * 减少工具文件中的重复代码。
+ * 重试策略：指数退避 1s → 2s → 4s，最多 3 次。
+ */
+import { loadConfig } from "./config.js";
+import { handleApiError } from "./errors.js";
+const cfg = loadConfig();
+/** 最大重试次数 */
+const MAX_RETRIES = 3;
+/** 基延迟（ms） */
+const BASE_DELAY = 1000;
+/** 是否应该重试：网络异常、429、5xx */
+function shouldRetry(res) {
+    if (!res)
+        return true; // 网络异常
+    return res.status === 429 || (res.status >= 500 && res.status < 600);
+}
+/** 等待 N ms */
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/** 执行 fetch 并自动重试 */
+async function fetchWithRetry(url, options, context, attempt = 1) {
+    try {
+        const res = await fetch(url, options);
+        if (shouldRetry(res) && attempt <= MAX_RETRIES) {
+            const delay = BASE_DELAY * Math.pow(2, attempt - 1);
+            // 重试日志仅在 DEBUG 环境变量设置时输出
+            if (process.env.DEBUG)
+                console.error(`[RETRY] ${context} 第 ${attempt} 次失败 (${res.status})，${delay}ms 后重试`);
+            await sleep(delay);
+            return fetchWithRetry(url, options, context, attempt + 1);
+        }
+        return res;
+    }
+    catch (err) {
+        if (attempt <= MAX_RETRIES) {
+            const delay = BASE_DELAY * Math.pow(2, attempt - 1);
+            if (process.env.DEBUG)
+                console.error(`[RETRY] ${context} 第 ${attempt} 次网络异常，${delay}ms 后重试`);
+            await sleep(delay);
+            return fetchWithRetry(url, options, context, attempt + 1);
+        }
+        throw err;
+    }
+}
+/** API 调用结果的类型 guard：检查是否是 MCP error */
+export function isErrorResult(result) {
+    return typeof result === "object" && result !== null && "isError" in result && result.isError === true;
+}
+/** 网络异常 → 结构化错误（避免未捕获异常炸到 AI 侧） */
+function networkError(context, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    error: "NETWORK_ERROR",
+                    message: `网络请求失败 / Network request failed: ${context}`,
+                    detail: message,
+                    hint: "请检查网络连接、api_base 配置或语雀服务状态 / Check network, api_base config, or Yuque service status",
+                }, null, 2),
+            }],
+        isError: true,
+    };
+}
+/** 标准请求头（Token 认证） */
+function authHeaders(extra) {
+    return { "X-Auth-Token": cfg.token, ...extra };
+}
+/** 构建完整 URL */
+function buildUrl(path, params) {
+    const url = `${cfg.api_base}${path}`;
+    if (!params || Object.keys(params).length === 0)
+        return url;
+    const qs = new URLSearchParams(params);
+    return `${url}?${qs}`;
+}
+/** GET 请求 */
+export async function apiGet(path, params, context) {
+    const ctx = context ?? `GET ${path}`;
+    try {
+        const url = buildUrl(path, params);
+        const res = await fetchWithRetry(url, { headers: authHeaders() }, ctx);
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+/** POST 请求 */
+export async function apiPost(path, body, context) {
+    const ctx = context ?? `POST ${path}`;
+    try {
+        const url = `${cfg.api_base}${path}`;
+        const res = await fetchWithRetry(url, {
+            method: "POST",
+            headers: authHeaders({ "Content-Type": "application/json" }),
+            body: JSON.stringify(body),
+        }, ctx);
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+/** PUT 请求 */
+export async function apiPut(path, body, context) {
+    const ctx = context ?? `PUT ${path}`;
+    try {
+        const url = `${cfg.api_base}${path}`;
+        const res = await fetchWithRetry(url, {
+            method: "PUT",
+            headers: authHeaders({ "Content-Type": "application/json" }),
+            body: JSON.stringify(body),
+        }, ctx);
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+/** DELETE 请求 */
+export async function apiDelete(path, context) {
+    const ctx = context ?? `DELETE ${path}`;
+    try {
+        const url = `${cfg.api_base}${path}`;
+        const res = await fetchWithRetry(url, {
+            method: "DELETE",
+            headers: authHeaders(),
+        }, ctx);
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+/** POST 请求：支持 404 时 fallback 到备用路径（用于 user/group 端点自动切换） */
+export async function apiPostWithFallback(path, fallbackPath, body, context) {
+    const ctx = context ?? `POST ${path}`;
+    try {
+        const cfg = loadConfig();
+        let url = `${cfg.api_base}${path}`;
+        let res = await fetchWithRetry(url, {
+            method: "POST",
+            headers: authHeaders({ "Content-Type": "application/json" }),
+            body: JSON.stringify(body),
+        }, ctx);
+        if (res.status === 404) {
+            url = `${cfg.api_base}${fallbackPath}`;
+            res = await fetchWithRetry(url, {
+                method: "POST",
+                headers: authHeaders({ "Content-Type": "application/json" }),
+                body: JSON.stringify(body),
+            }, ctx);
+        }
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+/** GET 请求：支持 404 时 fallback 到备用路径 */
+export async function apiGetWithFallback(path, fallbackPath, params, context) {
+    const ctx = context ?? `GET ${path}`;
+    try {
+        const cfg = loadConfig();
+        const qs = params && Object.keys(params).length > 0
+            ? `?${new URLSearchParams(params)}`
+            : "";
+        let url = `${cfg.api_base}${path}${qs}`;
+        let res = await fetchWithRetry(url, { headers: authHeaders() }, ctx);
+        if (res.status === 404) {
+            url = `${cfg.api_base}${fallbackPath}${qs}`;
+            res = await fetchWithRetry(url, { headers: authHeaders() }, ctx);
+        }
+        if (!res.ok)
+            return handleApiError(res, ctx);
+        return res.json();
+    }
+    catch (err) {
+        return networkError(ctx, err);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/common/api-client.js.map

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

package/dist/common/config.d.ts

@@ -0,0 +1,46 @@
+/**
+ * config — 读取 config/config.json
+ *
+ * 所有工具模块通过此文件获取配置，不再依赖环境变量。
+ *
+ * slug 格式：`{book_id}/{doc_id}`，用 / 分割解析。
+ * kv_slugs / schedule_slugs 均为数组，支持多文档。
+ */
+interface NamespaceConfig {
+    book_id: number[];
+    kv_slugs?: string[];
+    schedule_slugs?: string[];
+}
+interface RssConfig {
+    enabled: boolean;
+    namespaces?: Record<string, NamespaceConfig>;
+}
+interface KvConfig {
+    enabled: boolean;
+}
+interface CrawlerConfig {
+    enabled: boolean;
+    namespaces?: Record<string, NamespaceConfig>;
+}
+interface Config {
+    token: string;
+    api_base: string;
+    cookie?: string;
+    ctoken?: string;
+    rss?: RssConfig;
+    kv?: KvConfig;
+    crawler?: CrawlerConfig;
+}
+export declare function loadConfig(): Config;
+/** 持久化 config 到文件 */
+export declare function saveConfig(): void;
+/** 解析 slug：`{book_id}/{doc_id}` → { bookId, docId } */
+export declare function parseSlug(slug: string): {
+    bookId: number;
+    docId: number;
+} | null;
+/** 组装 slug：bookId/docId */
+export declare function buildSlugStr(bookId: number, docId: number): string;
+/** 自动生成 slug：英文/拼音 + 时间戳，中文名兜底纯时间戳 */
+export declare function autoSlug(name: string): string;
+export {};

package/dist/common/config.js

@@ -0,0 +1,86 @@
+/**
+ * config — 读取 config/config.json
+ *
+ * 所有工具模块通过此文件获取配置，不再依赖环境变量。
+ *
+ * slug 格式：`{book_id}/{doc_id}`，用 / 分割解析。
+ * kv_slugs / schedule_slugs 均为数组，支持多文档。
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** 查找 config 文件：--config 参数 → cwd → ~/.yuque-mcp → 开发路径 */
+function findConfigPath() {
+    // 1. 命令行参数 --config /path/to/config.json
+    const cliArg = process.argv.findIndex(a => a === "--config" || a === "-c");
+    if (cliArg !== -1 && process.argv[cliArg + 1]) {
+        return process.argv[cliArg + 1];
+    }
+    // 2. 当前工作目录
+    const cwdPath = resolve(process.cwd(), "yuque-config.json");
+    if (existsSync(cwdPath))
+        return cwdPath;
+    // 3. 用户目录
+    const homePath = resolve(homedir(), ".yuque-mcp", "config.json");
+    if (existsSync(homePath))
+        return homePath;
+    // 4. 开发模式（相对 dist/ 的路径）
+    const devPath = resolve(__dirname, "../../../config/config.json");
+    if (existsSync(devPath))
+        return devPath;
+    // 5. 包内默认
+    return resolve(homedir(), ".yuque-mcp", "config.json");
+}
+let _config = null;
+export function loadConfig() {
+    if (_config)
+        return _config;
+    const configPath = findConfigPath();
+    try {
+        const raw = readFileSync(configPath, "utf-8");
+        _config = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`无法读取配置文件。请将 config.example.json 复制为 yuque-config.json（当前目录）或 ~/.yuque-mcp/config.json，并填入 Token。\n` +
+            `Cannot read config. Copy config.example.json to yuque-config.json (cwd) or ~/.yuque-mcp/config.json.`);
+    }
+    if (!_config.token || _config.token === "在此填入语雀 API Token") {
+        throw new Error("请在 config/config.json 中填入有效的语雀 API Token / Please fill in a valid Yuque API Token in config/config.json");
+    }
+    _config.api_base = _config.api_base || "https://www.yuque.com/api/v2";
+    return _config;
+}
+/** 持久化 config 到文件 */
+export function saveConfig() {
+    if (!_config)
+        return;
+    const configPath = findConfigPath();
+    writeFileSync(configPath, JSON.stringify(_config, null, 2) + "\n", "utf-8");
+}
+/** 解析 slug：`{book_id}/{doc_id}` → { bookId, docId } */
+export function parseSlug(slug) {
+    const parts = slug.split("/");
+    if (parts.length !== 2)
+        return null;
+    const bookId = parseInt(parts[0], 10);
+    const docId = parseInt(parts[1], 10);
+    if (isNaN(bookId) || isNaN(docId))
+        return null;
+    return { bookId, docId };
+}
+/** 组装 slug：bookId/docId */
+export function buildSlugStr(bookId, docId) {
+    return `${bookId}/${docId}`;
+}
+/** 自动生成 slug：英文/拼音 + 时间戳，中文名兜底纯时间戳 */
+export function autoSlug(name) {
+    const ascii = name
+        .replace(/[^a-zA-Z0-9]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    const ts = Date.now().toString(36);
+    return ascii ? `${ascii.substring(0, 30)}-${ts}` : `repo-${ts}`;
+}
+//# sourceMappingURL=config.js.map