yuque-ai-mcp 2.7.4

package/dist/kv/common.d.ts

@@ -0,0 +1,34 @@
+/**
+ * kv/common — KV 存储底层逻辑
+ *
+ * 方案：单文档 JSON map，按 domain:namespace 定位 config 中的 kv_slugs。
+ * slug 格式：`{book_id}/{doc_id}`，config.json 中存为数组。
+ *
+ * config 结构：
+ *   { "rss": { "namespaces": { "cnblogs": { "book_id": ..., "kv_slugs": ["80197550/274164064"], ... } } } }
+ *
+ * set 流程：取最后一个 slug → GET 读 body → 判断大小 → PUT 更新或 POST 创建新分片 → push 新 slug 到 config
+ * get 流程：遍历 kv_slugs 数组 → 逐个读 → 合并返回
+ */
+/** 更新 namespace 的 schedule_slugs 数组并持久化 */
+export declare function setScheduleSlugs(domain: "rss" | "crawler", namespace: string, slugs: string[]): void;
+/**
+ * 读取 namespace 的所有分片，合并为完整 JSON map
+ */
+export declare function loadKvMap(domain: "rss" | "crawler", namespace: string): Promise<Record<string, string>>;
+/**
+ * 增量 set：在 namespace 中设置一个 key-value
+ */
+export declare function kvIncrementalSet(domain: "rss" | "crawler", namespace: string, key: string, value: string): Promise<{
+    ok: boolean;
+    error?: string;
+    shards?: number;
+}>;
+/**
+ * 增量 delete：从 namespace 中删除一个 key
+ */
+export declare function kvIncrementalDelete(domain: "rss" | "crawler", namespace: string, key: string): Promise<{
+    ok: boolean;
+    error?: string;
+    shards?: number;
+}>;

package/dist/kv/common.js

@@ -0,0 +1,191 @@
+/**
+ * kv/common — KV 存储底层逻辑
+ *
+ * 方案：单文档 JSON map，按 domain:namespace 定位 config 中的 kv_slugs。
+ * slug 格式：`{book_id}/{doc_id}`，config.json 中存为数组。
+ *
+ * config 结构：
+ *   { "rss": { "namespaces": { "cnblogs": { "book_id": ..., "kv_slugs": ["80197550/274164064"], ... } } } }
+ *
+ * set 流程：取最后一个 slug → GET 读 body → 判断大小 → PUT 更新或 POST 创建新分片 → push 新 slug 到 config
+ * get 流程：遍历 kv_slugs 数组 → 逐个读 → 合并返回
+ */
+import { loadConfig, saveConfig, parseSlug, buildSlugStr } from "../common/config.js";
+import { apiGet, apiPost, apiPut, isErrorResult } from "../common/api-client.js";
+/** 单文档 body 大小上限（字节） */
+const MAX_BODY_SIZE = 250 * 1024; // 250KB
+/** 获取 domain 下 namespace 的 kv_slugs */
+function getKvSlugs(domain, namespace) {
+    const cfg = loadConfig();
+    return cfg[domain]?.namespaces?.[namespace]?.kv_slugs ?? [];
+}
+/** 获取 domain 下 namespace 的 book_id（取最后一个，为当前活跃仓库） */
+function getBookId(domain, namespace) {
+    const cfg = loadConfig();
+    const ids = cfg[domain]?.namespaces?.[namespace]?.book_id;
+    if (ids && ids.length > 0)
+        return ids[ids.length - 1];
+    return null;
+}
+/** 更新 namespace 的 kv_slugs 数组并持久化 */
+function setKvSlugs(domain, namespace, slugs) {
+    const cfg = loadConfig();
+    if (!cfg[domain])
+        cfg[domain] = { enabled: true, namespaces: {} };
+    if (!cfg[domain].namespaces)
+        cfg[domain].namespaces = {};
+    if (!cfg[domain].namespaces[namespace]) {
+        cfg[domain].namespaces[namespace] = { book_id: [] };
+    }
+    cfg[domain].namespaces[namespace].kv_slugs = slugs;
+    saveConfig();
+}
+/** 更新 namespace 的 schedule_slugs 数组并持久化 */
+export function setScheduleSlugs(domain, namespace, slugs) {
+    const cfg = loadConfig();
+    if (!cfg[domain])
+        cfg[domain] = { enabled: true, namespaces: {} };
+    if (!cfg[domain].namespaces)
+        cfg[domain].namespaces = {};
+    if (!cfg[domain].namespaces[namespace]) {
+        cfg[domain].namespaces[namespace] = { book_id: [] };
+    }
+    cfg[domain].namespaces[namespace].schedule_slugs = slugs;
+    saveConfig();
+}
+/**
+ * 读取 namespace 的所有分片，合并为完整 JSON map
+ */
+export async function loadKvMap(domain, namespace) {
+    const slugs = getKvSlugs(domain, namespace);
+    if (slugs.length === 0)
+        return {};
+    const result = {};
+    for (const slug of slugs) {
+        const parsed = parseSlug(slug);
+        if (!parsed)
+            continue;
+        const data = await apiGet(`/repos/${parsed.bookId}/docs/${parsed.docId}?raw=1`, undefined, `KV load: ${parsed.docId}`);
+        if (isErrorResult(data))
+            continue;
+        const body = data?.data?.body;
+        if (!body)
+            continue;
+        try {
+            Object.assign(result, JSON.parse(body));
+        }
+        catch { /* ignore */ }
+    }
+    return result;
+}
+/**
+ * 增量 set：在 namespace 中设置一个 key-value
+ */
+export async function kvIncrementalSet(domain, namespace, key, value) {
+    const slugs = getKvSlugs(domain, namespace);
+    const entryJson = JSON.stringify({ [key]: value });
+    const bookId = getBookId(domain, namespace);
+    // 没有分片 → 首次创建
+    if (slugs.length === 0) {
+        if (!bookId) {
+            return { ok: false, error: `namespace '${namespace}' 未配置 book_id` };
+        }
+        const result = await apiPost(`/repos/${bookId}/docs`, { title: namespace, body: entryJson, slug: namespace, format: "markdown", public: 0 }, `KV create: ${namespace}`);
+        if (isErrorResult(result)) {
+            return { ok: false, error: JSON.stringify(result) };
+        }
+        const docId = result?.data?.id;
+        if (!docId) {
+            return { ok: false, error: "创建文档后未获取到 doc_id" };
+        }
+        const newSlug = buildSlugStr(bookId, docId);
+        setKvSlugs(domain, namespace, [newSlug]);
+        return { ok: true, shards: 1 };
+    }
+    // 取最后一个分片
+    const lastSlug = slugs[slugs.length - 1];
+    const parsed = parseSlug(lastSlug);
+    if (!parsed) {
+        return { ok: false, error: `无效 slug: ${lastSlug}` };
+    }
+    // 读最后一个分片
+    const data = await apiGet(`/repos/${parsed.bookId}/docs/${parsed.docId}?raw=1`, undefined, `KV load: ${parsed.docId}`);
+    if (isErrorResult(data)) {
+        return { ok: false, error: `读分片 ${parsed.docId} 失败` };
+    }
+    const doc = data?.data;
+    if (!doc) {
+        return { ok: false, error: `分片 ${parsed.docId} 数据为空` };
+    }
+    const currentBody = doc.body || "{}";
+    let currentMap;
+    try {
+        currentMap = JSON.parse(currentBody);
+    }
+    catch {
+        currentMap = {};
+    }
+    currentMap[key] = value;
+    const newBody = JSON.stringify(currentMap, null, 2);
+    // 判断大小
+    if (Buffer.byteLength(newBody, "utf-8") <= MAX_BODY_SIZE) {
+        // 没超 → PUT 更新当前分片
+        const result = await apiPut(`/repos/${parsed.bookId}/docs/${doc.id}`, { title: namespace, body: newBody, slug: namespace, format: "markdown", public: 0 }, `KV update: ${parsed.docId}`);
+        if (isErrorResult(result)) {
+            return { ok: false, error: JSON.stringify(result) };
+        }
+        return { ok: true, shards: slugs.length };
+    }
+    // 超了 → 创建新分片，只写这一个 key
+    const result = await apiPost(`/repos/${parsed.bookId}/docs`, { title: `${namespace}-${slugs.length + 1}`, body: entryJson, slug: `${namespace}-${slugs.length + 1}`, format: "markdown", public: 0 }, `KV create shard: ${namespace}-${slugs.length + 1}`);
+    if (isErrorResult(result)) {
+        return { ok: false, error: JSON.stringify(result) };
+    }
+    const newDocId = result?.data?.id;
+    if (!newDocId) {
+        return { ok: false, error: "创建分片后未获取到 doc_id" };
+    }
+    const newSlug = buildSlugStr(parsed.bookId, newDocId);
+    const newSlugs = [...slugs, newSlug];
+    setKvSlugs(domain, namespace, newSlugs);
+    return { ok: true, shards: newSlugs.length };
+}
+/**
+ * 增量 delete：从 namespace 中删除一个 key
+ */
+export async function kvIncrementalDelete(domain, namespace, key) {
+    const slugs = getKvSlugs(domain, namespace);
+    if (slugs.length === 0) {
+        return { ok: false, error: `namespace '${namespace}' KV 分片不存在` };
+    }
+    for (const slug of slugs) {
+        const parsed = parseSlug(slug);
+        if (!parsed)
+            continue;
+        const data = await apiGet(`/repos/${parsed.bookId}/docs/${parsed.docId}?raw=1`, undefined, `KV load: ${parsed.docId}`);
+        if (isErrorResult(data))
+            continue;
+        const doc = data?.data;
+        if (!doc)
+            continue;
+        const currentBody = doc.body || "{}";
+        let currentMap;
+        try {
+            currentMap = JSON.parse(currentBody);
+        }
+        catch {
+            continue;
+        }
+        if (!(key in currentMap))
+            continue;
+        delete currentMap[key];
+        const newBody = JSON.stringify(currentMap, null, 2);
+        const result = await apiPut(`/repos/${parsed.bookId}/docs/${doc.id}`, { title: namespace, body: newBody, slug: namespace, format: "markdown", public: 0 }, `KV delete key: ${parsed.docId}`);
+        if (isErrorResult(result)) {
+            return { ok: false, error: JSON.stringify(result) };
+        }
+        return { ok: true, shards: slugs.length };
+    }
+    return { ok: false, error: `key '${key}' not found in namespace '${namespace}'` };
+}
+//# sourceMappingURL=common.js.map

package/dist/kv/common.js.map

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

package/dist/kv/delete.d.ts

@@ -0,0 +1,7 @@
+/**
+ * kv/delete — 增量删除 namespace 中的一个 key
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{doc_id}（逐个分片查找）+ PUT
+ */
+import type { McpTool } from "../common/types.js";
+export declare const kvDelete: McpTool;

package/dist/kv/delete.js

@@ -0,0 +1,52 @@
+/**
+ * kv/delete — 增量删除 namespace 中的一个 key
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{doc_id}（逐个分片查找）+ PUT
+ */
+import { check, requiredString } from "../common/validate.js";
+import { kvIncrementalDelete } from "./common.js";
+export const kvDelete = {
+    name: "yuque_kv_delete",
+    description: "Delete a key from a KV namespace. 需指定 domain（rss/crawler）定位 kv_slugs。详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Domain: 'rss' or 'crawler'. Locates kv_slugs in config." },
+            namespace: { type: "string", description: "KV namespace, e.g. 'cnblogs'." },
+            key: { type: "string", description: "Key to delete" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns summary)" },
+        },
+        required: ["domain", "namespace", "key"],
+    },
+    async handler(args) {
+        const __v = check(requiredString(args?.domain, "domain"), requiredString(args?.namespace, "namespace"), requiredString(args?.key, "key"));
+        if (__v)
+            return __v;
+        const domain = args?.domain;
+        const namespace = args?.namespace;
+        const key = args?.key;
+        const result = await kvIncrementalDelete(domain, namespace, key);
+        if (!result.ok) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "KV_DELETE_FAILED",
+                            message: result.error,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        domain,
+                        namespace,
+                        key,
+                        action: "deleted",
+                        shards: result.shards,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=delete.js.map

package/dist/kv/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/kv/delete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wGAAwG;IAErH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAClG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YAC3E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE;YACrD,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;SAC/F;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC;KACzC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,KAAK,CACf,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EACtC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAC5C,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CACjC,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QAEpB,MAAM,MAAM,GAAG,IAAI,EAAE,MAA2B,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAmB,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,EAAE,GAAa,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,kBAAkB;4BACzB,OAAO,EAAE,MAAM,CAAC,KAAK;yBACtB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM;wBACN,SAAS;wBACT,GAAG;wBACH,MAAM,EAAE,SAAS;wBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/kv/get.d.ts

@@ -0,0 +1,7 @@
+/**
+ * kv/get — 读取 namespace 的完整 JSON map
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{doc_id}（逐个分片）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const kvGet: McpTool;

package/dist/kv/get.js

@@ -0,0 +1,52 @@
+/**
+ * kv/get — 读取 namespace 的完整 JSON map
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{doc_id}（逐个分片）
+ */
+import { check, requiredString } from "../common/validate.js";
+import { loadConfig } from "../common/config.js";
+import { loadKvMap } from "./common.js";
+export const kvGet = {
+    name: "yuque_kv_get",
+    description: "Get the full JSON key-value map for a namespace. 需指定 domain（rss/crawler）定位 kv_slugs。详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Domain: 'rss' or 'crawler'. Locates kv_slugs in config." },
+            namespace: { type: "string", description: "KV namespace, e.g. 'cnblogs'." },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns summary)" },
+        },
+        required: ["domain", "namespace"],
+    },
+    async handler(args) {
+        const __v = check(requiredString(args?.domain, "domain"), requiredString(args?.namespace, "namespace"));
+        if (__v)
+            return __v;
+        const domain = args?.domain;
+        const namespace = args?.namespace;
+        const slugs = loadConfig()[domain]?.namespaces?.[namespace]?.kv_slugs ?? [];
+        if (slugs.length === 0) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "NAMESPACE_NOT_FOUND",
+                            message: `namespace '${namespace}' 未配置 kv_slugs，请先在 config.json 的 ${domain}.namespaces.${namespace} 中设置`,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const map = await loadKvMap(domain, namespace);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        domain,
+                        namespace,
+                        shards: slugs.length,
+                        count: Object.keys(map).length,
+                        data: map,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=get.js.map

package/dist/kv/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/kv/get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,KAAK,GAAY;IAC5B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,uHAAuH;IAEpI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAClG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YAC3E,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;SAC/F;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAClC;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,KAAK,CACf,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EACtC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,CAC7C,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QAEpB,MAAM,MAAM,GAAG,IAAI,EAAE,MAA2B,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAmB,CAAC;QAE5C,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;QAE5E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,qBAAqB;4BAC5B,OAAO,EAAE,cAAc,SAAS,oCAAoC,MAAM,eAAe,SAAS,MAAM;yBACzG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE/C,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM;wBACN,SAAS;wBACT,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM;wBAC9B,IAAI,EAAE,GAAG;qBACV,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/kv/index.d.ts

@@ -0,0 +1,6 @@
+export { kvGet } from "./get.js";
+export { kvSet } from "./set.js";
+export { kvDelete } from "./delete.js";
+export { kvList } from "./list.js";
+import type { McpTool } from "../common/types.js";
+export declare const kvTools: McpTool[];

package/dist/kv/index.js

@@ -0,0 +1,10 @@
+export { kvGet } from "./get.js";
+export { kvSet } from "./set.js";
+export { kvDelete } from "./delete.js";
+export { kvList } from "./list.js";
+import { kvGet } from "./get.js";
+import { kvSet } from "./set.js";
+import { kvDelete } from "./delete.js";
+import { kvList } from "./list.js";
+export const kvTools = [kvGet, kvSet, kvDelete, kvList];
+//# sourceMappingURL=index.js.map

package/dist/kv/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kv/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,MAAM,CAAC,MAAM,OAAO,GAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC"}

package/dist/kv/list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * kv/list — 列出所有已配置的 KV namespace（从 rss/crawler namespaces 汇总）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const kvList: McpTool;

package/dist/kv/list.js

@@ -0,0 +1,42 @@
+/**
+ * kv/list — 列出所有已配置的 KV namespace（从 rss/crawler namespaces 汇总）
+ */
+import { loadConfig } from "../common/config.js";
+export const kvList = {
+    name: "yuque_kv_list",
+    description: "List all configured KV namespaces from config.json (rss + crawler). 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns summary)" },
+        },
+        required: [],
+    },
+    async handler() {
+        const cfg = loadConfig();
+        const list = [];
+        for (const domain of ["rss", "crawler"]) {
+            const namespaces = cfg[domain]?.namespaces || {};
+            for (const [name, ns] of Object.entries(namespaces)) {
+                list.push({
+                    domain,
+                    namespace: name,
+                    book_id: ns.book_id,
+                    kv_shards: ns.kv_slugs?.length ?? 0,
+                    kv_slugs: ns.kv_slugs ?? [],
+                    schedule_slugs: ns.schedule_slugs ?? [],
+                });
+            }
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        count: list.length,
+                        namespaces: list,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=list.js.map

package/dist/kv/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/kv/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,uGAAuG;IAEpH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;SAC/F;QACD,QAAQ,EAAE,EAAE;KACb;IAED,KAAK,CAAC,OAAO;QACX,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,GAAqI,EAAE,CAAC;QAElJ,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE,SAAS,CAAU,EAAE,CAAC;YACjD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,IAAI,CAAC;oBACR,MAAM;oBACN,SAAS,EAAE,IAAI;oBACf,OAAO,EAAE,EAAE,CAAC,OAAO;oBACnB,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;oBACnC,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE;oBAC3B,cAAc,EAAE,EAAE,CAAC,cAAc,IAAI,EAAE;iBACxC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK,EAAE,IAAI,CAAC,MAAM;wBAClB,UAAU,EAAE,IAAI;qBACjB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/kv/set.d.ts

@@ -0,0 +1,7 @@
+/**
+ * kv/set — 增量设置 namespace 中的一个 key-value 对
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{lastDocId} + PUT 或 POST（新分片）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const kvSet: McpTool;

package/dist/kv/set.js

@@ -0,0 +1,54 @@
+/**
+ * kv/set — 增量设置 namespace 中的一个 key-value 对
+ *
+ * 端点到语雀：GET /repos/{book_id}/docs/{lastDocId} + PUT 或 POST（新分片）
+ */
+import { check, requiredString } from "../common/validate.js";
+import { kvIncrementalSet } from "./common.js";
+export const kvSet = {
+    name: "yuque_kv_set",
+    description: "Set a key-value pair in a KV namespace. 需指定 domain（rss/crawler）定位 kv_slugs。详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            domain: { type: "string", description: "Domain: 'rss' or 'crawler'. Locates kv_slugs in config." },
+            namespace: { type: "string", description: "KV namespace, e.g. 'cnblogs'." },
+            key: { type: "string", description: "Key to set" },
+            value: { type: "string", description: "Value to store" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns summary)" },
+        },
+        required: ["domain", "namespace", "key", "value"],
+    },
+    async handler(args) {
+        const __v = check(requiredString(args?.domain, "domain"), requiredString(args?.namespace, "namespace"), requiredString(args?.key, "key"), requiredString(args?.value, "value"));
+        if (__v)
+            return __v;
+        const domain = args?.domain;
+        const namespace = args?.namespace;
+        const key = args?.key;
+        const value = args?.value;
+        const result = await kvIncrementalSet(domain, namespace, key, value);
+        if (!result.ok) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "KV_SET_FAILED",
+                            message: result.error,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        domain,
+                        namespace,
+                        key,
+                        value,
+                        shards: result.shards,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=set.js.map

package/dist/kv/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../src/kv/set.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,MAAM,KAAK,GAAY;IAC5B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8GAA8G;IAE3H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAClG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YAC3E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YAClD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACxD,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;SAC/F;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC;KAClD;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,KAAK,CACf,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EACtC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAC5C,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAChC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CACrC,CAAC;QACF,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QAEpB,MAAM,MAAM,GAAG,IAAI,EAAE,MAA2B,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,EAAE,SAAmB,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,EAAE,GAAa,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QAEpC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACtD,KAAK,EAAE,eAAe;4BACtB,OAAO,EAAE,MAAM,CAAC,KAAK;yBACtB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACd,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,MAAM;wBACN,SAAS;wBACT,GAAG;wBACH,KAAK;wBACL,MAAM,EAAE,MAAM,CAAC,MAAM;qBACtB,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mine/common.d.ts

@@ -0,0 +1,4 @@
+/**
+ * mine/common — mine 域公共常量
+ */
+export declare const MINE_BASE = "https://www.yuque.com/api/mine";

package/dist/mine/common.js

@@ -0,0 +1,5 @@
+/**
+ * mine/common — mine 域公共常量
+ */
+export const MINE_BASE = "https://www.yuque.com/api/mine";
+//# sourceMappingURL=common.js.map

package/dist/mine/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/mine/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,gCAAgC,CAAC"}

package/dist/mine/editor-center.d.ts

@@ -0,0 +1,9 @@
+/**
+ * mine/editor-center — 获取个人编辑中心全景数据
+ *
+ * 端点：GET /api/mine/editor_center（Web API，Cookie 认证）
+ * 职责：返回当前用户的知识库数、文档数、字数、编辑次数、活跃天数、
+ *       互动用户、最多字的知识库等全景统计数据
+ */
+import type { McpTool } from "../common/types.js";
+export declare const mineEditorCenter: McpTool;

package/dist/mine/editor-center.js

@@ -0,0 +1,57 @@
+/**
+ * mine/editor-center — 获取个人编辑中心全景数据
+ *
+ * 端点：GET /api/mine/editor_center（Web API，Cookie 认证）
+ * 职责：返回当前用户的知识库数、文档数、字数、编辑次数、活跃天数、
+ *       互动用户、最多字的知识库等全景统计数据
+ */
+import { webRequest } from "../common/web-request.js";
+import { MINE_BASE } from "./common.js";
+export const mineEditorCenter = {
+    name: "yuque_get_editor_center",
+    description: "获取个人编辑中心全景数据：知识库数、文档数、总字数、编辑次数、活跃天数、互动用户排行、最多字的知识库等。需要 cookie+ctoken 认证。GET /api/mine/editor_center",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    async handler() {
+        const data = (await webRequest(`${MINE_BASE}/editor_center`));
+        const d = data?.data;
+        if (!d) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "NO_DATA" }, null, 2) }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        overview: {
+                            books: { all: d.books_count, last_30d: d.books_count_30, last_365d: d.books_count_365 },
+                            docs: { all: d.docs_count, last_30d: d.docs_count_30, last_365d: d.docs_count_365 },
+                            public_docs: { all: d.docs_public_count, last_30d: d.docs_public_count_30, last_365d: d.docs_public_count_365 },
+                            notes: { all: d.notes_count, last_30d: d.notes_count_30, last_365d: d.notes_count_365 },
+                            words: { all: d.word_count, last_30d: d.word_count_30, last_365d: d.word_count_365 },
+                            selections: d.selections,
+                            days_since_join: d.days,
+                        },
+                        editing: {
+                            edit_times: { all: d.edit_times_all, last_30d: d.edit_times_30, last_365d: d.edit_times_365 },
+                            edit_days: { all: d.edit_days_all, last_30d: d.edit_days_30, last_365d: d.edit_days_365 },
+                            edit_doc_count: { all: d.edit_doc_count_all, last_30d: d.edit_doc_count_30, last_365d: d.edit_doc_count_365 },
+                        },
+                        engagement: {
+                            liked: { all: d.liked_count_all, last_30d: d.liked_count_30, last_365d: d.liked_count_365 },
+                            public_likes: { all: d.public_doc_likes, last_30d: d.public_doc_likes_30, last_365d: d.public_doc_likes_365 },
+                            interactive_users: d.interactive_users || [],
+                        },
+                        max_word_book: d.max_word_book_info
+                            ? { name: d.max_word_book_info.name, items_count: d.max_word_book_info.items_count }
+                            : null,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=editor-center.js.map

package/dist/mine/editor-center.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-center.js","sourceRoot":"","sources":["../../src/mine/editor-center.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,qGAAqG;IAElH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,SAAS,gBAAgB,CAAC,CA4C3D,CAAC;QAEF,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;QACrB,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,QAAQ,EAAE;4BACR,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE;4BACvF,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,cAAc,EAAE;4BACnF,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,oBAAoB,EAAE,SAAS,EAAE,CAAC,CAAC,qBAAqB,EAAE;4BAC/G,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE;4BACvF,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,cAAc,EAAE;4BACpF,UAAU,EAAE,CAAC,CAAC,UAAU;4BACxB,eAAe,EAAE,CAAC,CAAC,IAAI;yBACxB;wBACD,OAAO,EAAE;4BACP,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,cAAc,EAAE;4BAC7F,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,aAAa,EAAE;4BACzF,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,kBAAkB,EAAE,QAAQ,EAAE,CAAC,CAAC,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,kBAAkB,EAAE;yBAC9G;wBACD,UAAU,EAAE;4BACV,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,eAAe,EAAE;4BAC3F,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC,mBAAmB,EAAE,SAAS,EAAE,CAAC,CAAC,oBAAoB,EAAE;4BAC7G,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,IAAI,EAAE;yBAC7C;wBACD,aAAa,EAAE,CAAC,CAAC,kBAAkB;4BACjC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,kBAAkB,CAAC,WAAW,EAAE;4BACpF,CAAC,CAAC,IAAI;qBACT,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mine/get-book-stacks.d.ts

@@ -0,0 +1,8 @@
+/**
+ * mine/book-stacks — 获取知识库分组（书架）列表
+ *
+ * 端点：GET /api/mine/book_stacks（Web API，Cookie 认证）
+ * 职责：返回当前用户的知识库分组（书架），含每个分组下的知识库列表
+ */
+import type { McpTool } from "../common/types.js";
+export declare const mineBookStacks: McpTool;