yuque-ai-mcp 2.7.4

package/dist/rss/schedule.js

@@ -0,0 +1,171 @@
+/**
+ * rss/schedule — 定时抓取策略分析
+ *
+ * 主方案：读取 RSS 配置知识库（config.json 中 rss.namespaces.{source}.schedule_slugs），
+ * 分析每个 feed 的最近更新频率，生成推荐下次抓取时间，写回知识库。
+ *
+ * 频率分档（保守策略，最小间隔 1 天）：
+ *   - 高频：近 7 天 ≥5 篇 → 每天 1 次
+ *   - 中频：近 7 天 1-4 篇 → 每 7 天
+ *   - 低频：近 14 天 1 篇 → 每 15 天
+ *   - 休眠：近 30 天 0 篇 → 每 30 天
+ */
+import { check, requiredString } from "../common/validate.js";
+import { loadConfig } from "../common/config.js";
+import { RSS_SOURCES } from "./sources.js";
+import { loadKvMap } from "../kv/common.js";
+import { classifyBand, parseArticles, countRecentWithAuthors, getScheduleSlugs, findScheduleDoc, upsertScheduleDoc, } from "../common/schedule-common.js";
+// ── RSS 专用：schedule body 构建 ──
+function buildRssScheduleBody(sourceName, label, source, feed, lastFetch, nextFetch, band, recent7d, recent14d, recent30d, authors) {
+    const lines = [];
+    lines.push(`# ${sourceName}/${label}`);
+    lines.push("");
+    lines.push(`- 数据源: ${source}`);
+    lines.push(`- Feed: ${feed}`);
+    lines.push(`- 上次抓取: ${lastFetch || "无记录"}`);
+    lines.push(`- 推荐下次抓取: ${nextFetch}`);
+    lines.push(`- 抓取间隔: ${band.intervalDays}天`);
+    lines.push(`- 频率分档: ${band.label}`);
+    lines.push(`- 近7天文章数: ${recent7d}`);
+    lines.push(`- 近14天文章数: ${recent14d}`);
+    lines.push(`- 近30天文章数: ${recent30d}`);
+    if (authors.length > 0) {
+        lines.push(`- 活跃作者: ${authors.slice(0, 10).join(", ")}${authors.length > 10 ? "..." : ""}`);
+    }
+    return lines.join("\n");
+}
+// ── 工具定义 ──
+export const rssSchedule = {
+    name: "yuque_rss_schedule",
+    description: "Analyze RSS feed recent update frequency and recommend next fetch time. 主方案：读取 schedule_slugs 配置知识库，分析最近更新频率，生成推荐抓取时间并写回。",
+    inputSchema: {
+        type: "object",
+        properties: {
+            source: { type: "string", description: "Source key, e.g. 'cnblogs'. Use yuque_rss_list_sources to list available sources." },
+            kv_namespace: { type: "string", description: "KV namespace for dedup data. Defaults to source key." },
+            mode: { type: "string", description: "Mode: 'analyze' (analyze + write back, default) | 'dry_run' (analyze only, no write)" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false)" },
+        },
+        required: ["source"],
+    },
+    async handler(args) {
+        const __v = check(requiredString(args?.source, "source"));
+        if (__v)
+            return __v;
+        const source = args?.source;
+        const kvNamespace = args?.kv_namespace || source;
+        const mode = args?.mode ?? "analyze";
+        const cfg = loadConfig();
+        const enableKv = !!(cfg.kv?.enabled);
+        const src = RSS_SOURCES[source];
+        if (!src) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "UNKNOWN_SOURCE",
+                            message: `未知数据源: ${source}`,
+                            hint: "调用 yuque_rss_list_sources 查看可用数据源",
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        if (!enableKv) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "KV_DISABLED",
+                            message: "KV 功能未启用",
+                            hint: "在 config.json 中设置 kv.enabled: true",
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const kvMap = await loadKvMap("rss", kvNamespace);
+        const totalEntries = Object.keys(kvMap).length;
+        if (totalEntries === 0) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "NO_DATA",
+                            message: `KV namespace '${kvNamespace}' 中没有数据`,
+                            hint: "先用 yuque_rss_fetch 抓取一些文章后再调用此工具",
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const articles = parseArticles(kvMap);
+        if (articles.length === 0) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            source: src.name,
+                            kv_namespace: kvNamespace,
+                            total_articles: totalEntries,
+                            warning: "KV 中数据为旧格式（无时间戳），无法分析频率。建议重新抓取。",
+                            fallback_recommendation: { strategy: "保守策略", interval: "每 7 天", reason: "无历史频率数据" },
+                        }, null, 2) }],
+            };
+        }
+        const now = new Date();
+        const hasScheduleSlugs = getScheduleSlugs("rss", source).length > 0;
+        const analysisMode = hasScheduleSlugs ? "schedule_book" : "kv_fallback";
+        const analyses = [];
+        for (const [feedKey, feed] of Object.entries(src.feeds)) {
+            const feedArticles = articles.filter((a) => a.feed === feedKey);
+            const { count: recent7d, authors: authors7d } = countRecentWithAuthors(feedArticles, 7, now);
+            const recent14d = countRecentWithAuthors(feedArticles, 14, now).count;
+            const recent30d = countRecentWithAuthors(feedArticles, 30, now).count;
+            const band = classifyBand(recent7d, recent14d);
+            let lastFetch = null;
+            if (hasScheduleSlugs) {
+                const feedSlug = `${source}--${feedKey}`;
+                const found = await findScheduleDoc("rss", source, feedSlug);
+                lastFetch = found.lastFetch;
+            }
+            const nextFetchDate = new Date(now.getTime() + band.intervalDays * 24 * 60 * 60 * 1000);
+            analyses.push({
+                feed: feedKey,
+                label: feed.label,
+                lastFetch,
+                nextFetch: nextFetchDate.toISOString().slice(0, 10),
+                intervalDays: band.intervalDays,
+                band: band.label,
+                recent7dCount: recent7d,
+                recent14dCount: recent14d,
+                recent30dCount: recent30d,
+                activeAuthors: authors7d,
+            });
+        }
+        const writeResults = [];
+        if (analysisMode === "schedule_book" && mode !== "dry_run") {
+            for (const analysis of analyses) {
+                const feedSlug = `${source}--${analysis.feed}`;
+                const title = `${src.name}/${analysis.label}`;
+                const body = buildRssScheduleBody(src.name, analysis.label, source, analysis.feed, analysis.lastFetch, analysis.nextFetch, { label: analysis.band, intervalDays: analysis.intervalDays }, analysis.recent7dCount, analysis.recent14dCount, analysis.recent30dCount, analysis.activeAuthors);
+                const result = await upsertScheduleDoc("rss", source, feedSlug, title, body);
+                writeResults.push({
+                    feed: analysis.feed,
+                    status: result.ok ? "updated" : "failed",
+                    slug: result.slug,
+                    error: result.error,
+                });
+            }
+        }
+        const summary = {
+            high: analyses.filter((a) => a.band === "高频").length,
+            mid: analyses.filter((a) => a.band === "中频").length,
+            low: analyses.filter((a) => a.band === "低频").length,
+            dormant: analyses.filter((a) => a.band === "休眠").length,
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        source,
+                        sourceName: src.name,
+                        mode: analysisMode,
+                        analyses,
+                        summary,
+                        writeResults: writeResults.length > 0 ? writeResults : undefined,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=schedule.js.map

package/dist/rss/schedule.js.map

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

package/dist/rss/sources.d.ts

@@ -0,0 +1,26 @@
+/**
+ * rss/sources — 数据源配置
+ *
+ * 新增数据源只需在此文件追加一个条目，无需改 tool 代码。
+ */
+export interface RssFeed {
+    label: string;
+    description?: string;
+    url?: string;
+    url_template?: string;
+    params_schema?: Record<string, ParamDef>;
+}
+export interface ParamDef {
+    type: "string" | "number";
+    description: string;
+    required?: boolean;
+    default?: string | number;
+}
+export interface RssSource {
+    name: string;
+    description?: string;
+    feeds: Record<string, RssFeed>;
+    /** 从文章链接提取站点文章 ID，生成 slug 用于去重。返回 null 则 fallback 到 md5(link) */
+    slugResolver?: (link: string) => string | null;
+}
+export declare const RSS_SOURCES: Record<string, RssSource>;

package/dist/rss/sources.js

@@ -0,0 +1,54 @@
+/**
+ * rss/sources — 数据源配置
+ *
+ * 新增数据源只需在此文件追加一个条目，无需改 tool 代码。
+ */
+export const RSS_SOURCES = {
+    cnblogs: {
+        name: "博客园",
+        description: "开发者的网上家园，技术博客聚合平台",
+        slugResolver: (link) => {
+            const m = link.match(/\/p\/(\d+)/);
+            return m ? `cnblogs-${m[1]}` : null;
+        },
+        feeds: {
+            sitehome: {
+                label: "首页最新",
+                description: "博客园首页最新发布的文章",
+                url: "https://feed.cnblogs.com/blog/sitehome/rss",
+            },
+            picked: {
+                label: "编辑推荐",
+                description: "博客园编辑精选推荐",
+                url: "https://feed.cnblogs.com/blog/sitehome/picked",
+            },
+            "48h": {
+                label: "48小时阅读排行",
+                description: "博客园48小时内阅读量最高的文章",
+                url: "https://feed.cnblogs.com/blog/sitehome/48h",
+            },
+            "10d": {
+                label: "10天推荐排行",
+                description: "博客园10天内推荐最多的文章",
+                url: "https://feed.cnblogs.com/blog/sitehome/10d",
+            },
+            user: {
+                label: "用户博客",
+                description: "指定用户的博客文章",
+                url_template: "https://feed.cnblogs.com/blog/u/{username}/rss",
+                params_schema: {
+                    username: { type: "string", description: "博客园用户名，如 hsewr333", required: true },
+                },
+            },
+            category: {
+                label: "分类",
+                description: "指定分类的文章",
+                url_template: "https://feed.cnblogs.com/blog/category/{category}/rss",
+                params_schema: {
+                    category: { type: "string", description: "分类名，如 dotnet, python, web", required: true },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=sources.js.map

package/dist/rss/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/rss/sources.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,OAAO,EAAE;QACP,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACnC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,KAAK,EAAE;YACL,QAAQ,EAAE;gBACR,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,cAAc;gBAC3B,GAAG,EAAE,4CAA4C;aAClD;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,WAAW;gBACxB,GAAG,EAAE,+CAA+C;aACrD;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE,kBAAkB;gBAC/B,GAAG,EAAE,4CAA4C;aAClD;YACD,KAAK,EAAE;gBACL,KAAK,EAAE,SAAS;gBAChB,WAAW,EAAE,gBAAgB;gBAC7B,GAAG,EAAE,4CAA4C;aAClD;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,WAAW;gBACxB,YAAY,EAAE,gDAAgD;gBAC9D,aAAa,EAAE;oBACb,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;iBAC/E;aACF;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,IAAI;gBACX,WAAW,EAAE,SAAS;gBACtB,YAAY,EAAE,uDAAuD;gBACrE,aAAa,EAAE;oBACb,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE,QAAQ,EAAE,IAAI,EAAE;iBACvF;aACF;SACF;KACF;CACF,CAAC"}

package/dist/search/index.d.ts

@@ -0,0 +1,4 @@
+export { searchGeneral } from "./search.js";
+export { searchRag } from "./rag-search.js";
+import type { McpTool } from "../common/types.js";
+export declare const searchTools: McpTool[];

package/dist/search/index.js

@@ -0,0 +1,6 @@
+export { searchGeneral } from "./search.js";
+export { searchRag } from "./rag-search.js";
+import { searchGeneral } from "./search.js";
+import { searchRag } from "./rag-search.js";
+export const searchTools = [searchGeneral, searchRag];
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC"}

package/dist/search/rag-search-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * search/rag-search-utils — RAG 搜索工具函数
+ *
+ * 从 rag-search.ts 拆分出来的工具函数：
+ * - normalizeKeywords：过滤语雀分词器不支持的符号
+ * - searchYuque：调语雀搜索 API
+ * - fetchDoc：获取文档完整内容
+ */
+export declare function normalizeKeywords(raw: string[]): string[];
+export interface SearchResult {
+    id: number;
+    doc_id: number;
+    title: string;
+    summary: string;
+    url: string;
+    book_name: string;
+    book_slug: string;
+    updated_at: string;
+}
+export declare function searchYuque(q: string, scope: string | undefined, creator: string | undefined): Promise<SearchResult[]>;
+export interface DocContent {
+    doc_id: number;
+    title: string;
+    body: string;
+    url: string;
+    book_name: string;
+}
+export declare function fetchDoc(docId: number): Promise<DocContent | null>;

package/dist/search/rag-search-utils.js

@@ -0,0 +1,74 @@
+/**
+ * search/rag-search-utils — RAG 搜索工具函数
+ *
+ * 从 rag-search.ts 拆分出来的工具函数：
+ * - normalizeKeywords：过滤语雀分词器不支持的符号
+ * - searchYuque：调语雀搜索 API
+ * - fetchDoc：获取文档完整内容
+ */
+import { apiGet, isErrorResult } from "../common/api-client.js";
+// ─── 关键词过滤 ──────────────────────────────────
+/** 语雀分词器会切分的符号 */
+const SPLIT_CHARS = /[-._]/;
+/** 需要丢弃的纯符号 */
+const STRIP_CHARS = /[\[\](){}<>【】「」『』""'']/g;
+export function normalizeKeywords(raw) {
+    const result = [];
+    for (const kw of raw) {
+        const trimmed = kw.trim();
+        if (!trimmed)
+            continue;
+        const stripped = trimmed.replace(STRIP_CHARS, "").trim();
+        if (!stripped)
+            continue;
+        if (SPLIT_CHARS.test(stripped)) {
+            result.push(stripped.replace(SPLIT_CHARS, " "));
+            result.push(stripped.replace(SPLIT_CHARS, ""));
+        }
+        else {
+            result.push(stripped);
+        }
+    }
+    return [...new Set(result)].slice(0, 10);
+}
+export async function searchYuque(q, scope, creator) {
+    const params = { q, type: "doc", page: "1" };
+    if (scope)
+        params.scope = scope;
+    if (creator)
+        params.creator = creator;
+    const data = await apiGet("/search", params, `RAG search: ${q}`);
+    if (isErrorResult(data))
+        return [];
+    const typed = data;
+    if (!typed?.data)
+        return [];
+    return typed.data.map((item) => ({
+        id: item.id,
+        doc_id: item.target?.id ?? item.id,
+        title: item.title?.replace(/<em>|<\/em>/g, "") ?? "",
+        summary: item.summary?.replace(/<em>|<\/em>/g, "") ?? "",
+        url: item.url ?? "",
+        book_name: item.target?.book?.name ?? "",
+        book_slug: item.target?.book?.slug ?? "",
+        updated_at: item.target?.content_updated_at ?? item.target?.updated_at ?? "",
+    }));
+}
+export async function fetchDoc(docId) {
+    const data = await apiGet(`/repos/docs/${docId}`, undefined, `RAG fetch doc: ${docId}`);
+    if (isErrorResult(data))
+        return null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const typed = data;
+    const doc = typed?.data;
+    if (!doc)
+        return null;
+    return {
+        doc_id: docId,
+        title: doc.title ?? "",
+        body: doc.body ?? "",
+        url: `https://www.yuque.com/${doc.book?.namespace ?? ""}/${doc.slug ?? ""}`,
+        book_name: doc.book?.name ?? "",
+    };
+}
+//# sourceMappingURL=rag-search-utils.js.map

package/dist/search/rag-search-utils.js.map

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

package/dist/search/rag-search.d.ts

@@ -0,0 +1,16 @@
+/**
+ * search/rag-search — RAG 检索增强生成搜索
+ *
+ * 流程：
+ *   1. Agent 用 LLM 生成搜索关键词
+ *   2. 调本工具，传入关键词列表
+ *   3. 本工具：过滤语雀分词器不支持的符号（- . _）
+ *   4. 并发调语雀搜索
+ *   5. 按 doc_id 去重合并
+ *   6. 获取前 N 篇文档的完整内容
+ *   7. 返回搜索结果 + 文档内容，由 Agent 侧 LLM 总结
+ *
+ * 端点：复用 GET /api/v2/search + GET /api/v2/repos/docs/:id
+ */
+import type { McpTool } from "../common/types.js";
+export declare const searchRag: McpTool;

package/dist/search/rag-search.js

@@ -0,0 +1,103 @@
+/**
+ * search/rag-search — RAG 检索增强生成搜索
+ *
+ * 流程：
+ *   1. Agent 用 LLM 生成搜索关键词
+ *   2. 调本工具，传入关键词列表
+ *   3. 本工具：过滤语雀分词器不支持的符号（- . _）
+ *   4. 并发调语雀搜索
+ *   5. 按 doc_id 去重合并
+ *   6. 获取前 N 篇文档的完整内容
+ *   7. 返回搜索结果 + 文档内容，由 Agent 侧 LLM 总结
+ *
+ * 端点：复用 GET /api/v2/search + GET /api/v2/repos/docs/:id
+ */
+import { normalizeKeywords, searchYuque, fetchDoc, } from "./rag-search-utils.js";
+// ─── Tool 定义 ────────────────────────────────────
+export const searchRag = {
+    name: "yuque_rag_search",
+    description: "RAG-enhanced search: accepts LLM-generated keywords, runs concurrent multi-path searches, deduplicates by doc_id, fetches top-N full doc content. 详见 references/api/search_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            keywords: {
+                type: "string",
+                description: "Search keywords, comma-separated. Generated by the calling LLM, 5-10 recommended",
+            },
+            scope: {
+                type: "string",
+                description: "Search scope, e.g. scope=group for team-only, or scope=group/book_slug for a repo. Leave empty for global",
+            },
+            creator: { type: "string", description: "Filter by author login" },
+            max_results: {
+                type: "number",
+                description: "Max search results (default 10)",
+            },
+            fetch_docs: {
+                type: "number",
+                description: "Fetch full content of top N documents (default 3, max 5)",
+            },
+        },
+        required: ["keywords"],
+    },
+    async handler(args) {
+        const keywordsStr = args?.keywords;
+        const scope = args?.scope;
+        const creator = args?.creator;
+        const maxResults = args?.max_results ?? 10;
+        const fetchDocs = Math.min(args?.fetch_docs ?? 3, 5);
+        // 解析关键词
+        const rawKeywords = keywordsStr
+            .split(/[,，、\s]+/)
+            .map((k) => k.trim())
+            .filter(Boolean);
+        if (rawKeywords.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            meta: { total: 0, method: "rag_search", keywords_used: [] },
+                            data: [],
+                            docs: [],
+                        }, null, 2),
+                    }],
+            };
+        }
+        // 过滤符号
+        const keywords = normalizeKeywords(rawKeywords);
+        // 并发多路搜索
+        const allResults = await Promise.all(keywords.map((kw) => searchYuque(kw, scope, creator)));
+        // 按 doc_id 去重合并
+        const seen = new Set();
+        const merged = [];
+        for (const results of allResults) {
+            for (const r of results) {
+                if (!seen.has(r.doc_id)) {
+                    seen.add(r.doc_id);
+                    merged.push(r);
+                }
+            }
+        }
+        const finalResults = merged.slice(0, maxResults);
+        // 获取前 N 篇文档的完整内容
+        const docsToFetch = finalResults.slice(0, fetchDocs);
+        const docs = (await Promise.all(docsToFetch.map((r) => fetchDoc(r.doc_id)))).filter(Boolean);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        meta: {
+                            total: finalResults.length,
+                            method: "rag_search",
+                            keywords_used: keywords,
+                            raw_keywords: rawKeywords,
+                            docs_fetched: docs.length,
+                        },
+                        data: finalResults,
+                        docs,
+                    }, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=rag-search.js.map

package/dist/search/rag-search.js.map

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

package/dist/search/search.d.ts

@@ -0,0 +1,8 @@
+/**
+ * search/search — 通用搜索
+ *
+ * 端点：GET /api/v2/search
+ * 职责：搜索文档或知识库，支持 scope 范围过滤
+ */
+import type { McpTool } from "../common/types.js";
+export declare const searchGeneral: McpTool;

package/dist/search/search.js

@@ -0,0 +1,43 @@
+/**
+ * search/search — 通用搜索
+ *
+ * 端点：GET /api/v2/search
+ * 职责：搜索文档或知识库，支持 scope 范围过滤
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const searchGeneral = {
+    name: "yuque_search",
+    description: "General search across Yuque docs and repos. GET /search?q=:q&type=:type. 详见 references/api/search_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            q: { type: "string", description: "Search keyword (required, max 200 chars)" },
+            type: { type: "string", description: "Search type: doc (document) / repo (repository)" },
+            scope: { type: "string", description: "Search scope (max 400 chars), e.g. group or group/book_slug" },
+            page: { type: "number", description: "Page number (1-100)" },
+            creator: { type: "string", description: "Filter by author login" },
+        },
+        required: ["q", "type"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.q, "q");
+        if (__v)
+            return __v;
+        const q = args?.q;
+        const type = args?.type;
+        const scope = args?.scope;
+        const page = args?.page ?? 1;
+        const creator = args?.creator;
+        const params = { q, type, page: String(page) };
+        if (scope)
+            params.scope = scope;
+        if (creator)
+            params.creator = creator;
+        const data = await apiGet("/search", params, "Search");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=search.js.map

package/dist/search/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,0GAA0G;IAEvH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;YAC9E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;YACxF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;YACrG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;YAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;SACnE;QACD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC;KACxB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,CAAC,GAAG,IAAI,EAAE,CAAW,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,EAAE,KAA2B,CAAC;QAChD,MAAM,IAAI,GAAI,IAAI,EAAE,IAAe,IAAI,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,EAAE,OAA6B,CAAC;QAEpD,MAAM,MAAM,GAA2B,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvE,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAChC,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAEtC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/statistic/book-statistics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * statistic/books — 团队知识库统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/books
+ */
+import type { McpTool } from "../common/types.js";
+export declare const bookStatistics: McpTool;

package/dist/statistic/book-statistics.js

@@ -0,0 +1,49 @@
+/**
+ * statistic/books — 团队知识库统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/books
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const bookStatistics = {
+    name: "yuque_get_book_statistics",
+    description: "Get group repo statistics. GET /groups/:login/statistics/books. 详见 references/api/statistic_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            login: { type: "string", description: "Group login or ID (required)" },
+            name: { type: "string", description: "Filter by repository name" },
+            range: { type: "number", description: "Date range: 0=all, 30=last 30 days, 365=last year (default 0)" },
+            page: { type: "number", description: "Page number, default 1" },
+            limit: { type: "number", description: "Page size, max 20, default 10" },
+            sortField: { type: "string", description: "Sort field: content_updated_at_ms, word_count, post_count, read_count, like_count, watch_count, comment_count" },
+            sortOrder: { type: "string", description: "Sort order: desc (default) / asc" },
+        },
+        required: ["login"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.login, "login");
+        if (__v)
+            return __v;
+        const login = args?.login;
+        const name = args?.name;
+        const range = args?.range ?? 0;
+        const page = args?.page ?? 1;
+        const limit = args?.limit ?? 10;
+        const sortField = args?.sortField;
+        const sortOrder = args?.sortOrder ?? "desc";
+        const params = {
+            range: String(range), page: String(page),
+            limit: String(Math.min(limit, 20)), sortOrder,
+        };
+        if (name)
+            params.name = name;
+        if (sortField)
+            params.sortField = sortField;
+        const data = await apiGet(`/groups/${login}/statistics/books`, params, "Get book stats");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=book-statistics.js.map