yuque-ai-mcp 2.7.4

package/dist/common/format.js

@@ -0,0 +1,199 @@
+/**
+ * 公共格式化函数 — 对 API 原始响应做字段裁剪，减少 AI token 消耗
+ *
+ * 默认精简输出，传 raw=true 可获取全量原始 JSON
+ */
+// ── User ──────────────────────────────────────────────────────
+export function formatUser(data) {
+    const d = data.data ?? data;
+    return {
+        id: d.id,
+        login: d.login,
+        name: d.name,
+        description: d.description,
+        avatar_url: d.avatar_url,
+        books_count: d.books_count,
+        followers_count: d.followers_count,
+    };
+}
+export function formatUserGroup(data) {
+    return {
+        id: data.id,
+        login: data.login,
+        name: data.name,
+        description: data.description,
+        avatar_url: data.avatar_url,
+    };
+}
+// ── Doc ───────────────────────────────────────────────────────
+export function formatDoc(data) {
+    const d = data.data ?? data;
+    return {
+        id: d.id,
+        slug: d.slug,
+        title: d.title,
+        format: d.format,
+        public: d.public,
+        word_count: d.word_count,
+        body: d.body,
+        body_html: d.body_html,
+        description: d.description,
+        book_id: d.book_id,
+        user_id: d.user_id,
+        created_at: d.created_at,
+        updated_at: d.updated_at,
+    };
+}
+export function formatDocSummary(data) {
+    const d = data.data ?? data;
+    return {
+        id: d.id,
+        slug: d.slug,
+        title: d.title,
+        format: d.format,
+        public: d.public,
+        word_count: d.word_count,
+        updated_at: d.updated_at,
+    };
+}
+export function formatDocVersion(data) {
+    return {
+        id: data.id,
+        doc_id: data.doc_id,
+        title: data.title,
+        version: data.version,
+        created_at: data.created_at,
+        content_changed: data.content_changed,
+    };
+}
+// ── Repo ──────────────────────────────────────────────────────
+export function formatRepo(data) {
+    const d = data.data ?? data;
+    return {
+        id: d.id,
+        slug: d.slug,
+        name: d.name,
+        namespace: d.namespace,
+        description: d.description,
+        public: d.public,
+        items_count: d.items_count,
+        likes_count: d.likes_count,
+        user_id: d.user_id,
+        created_at: d.created_at,
+        updated_at: d.updated_at,
+    };
+}
+// ── Group ─────────────────────────────────────────────────────
+export function formatGroupUser(data) {
+    const u = data.user ?? data;
+    return {
+        id: u.id,
+        login: u.login,
+        name: u.name,
+        role: data.role,
+        avatar_url: u.avatar_url,
+        created_at: data.created_at,
+    };
+}
+// ── Note ──────────────────────────────────────────────────────
+export function formatNote(data) {
+    const d = data.data ?? data;
+    return {
+        id: d.id,
+        slug: d.slug,
+        title: d.title,
+        content: d.content,
+        word_count: d.word_count,
+        public: d.public,
+        book_id: d.book_id,
+        created_at: d.created_at,
+        updated_at: d.updated_at,
+        note_url: d.note_url,
+    };
+}
+export function formatNoteSummary(data) {
+    const d = data.data ?? data;
+    const abstract = typeof d.content === "object" && d.content?.abstract
+        ? d.content.abstract.replace(/<[^>]*>/g, "").substring(0, 200)
+        : "";
+    return {
+        id: d.id,
+        slug: d.slug,
+        word_count: d.word_count,
+        updated_at: d.updated_at,
+        abstract,
+    };
+}
+// ── TOC ───────────────────────────────────────────────────────
+export function formatToc(data) {
+    return data.map((item) => ({
+        title: item.title,
+        uuid: item.uuid,
+        type: item.type,
+        doc_id: item.doc_id,
+        level: item.level,
+        visible: item.visible,
+        url: item.url,
+        child_uuid: item.child_uuid,
+        parent_uuid: item.parent_uuid,
+    }));
+}
+// ── Recycle ───────────────────────────────────────────────────
+export function formatRecycle(data) {
+    return {
+        id: data.id,
+        title: data.title,
+        type: data.type,
+        slug: data.slug,
+        deleted_at: data.deleted_at,
+        user_id: data.user_id,
+        book_id: data.book_id,
+    };
+}
+// ── 通用包装器 ────────────────────────────────────────────────
+/**
+ * 对工具返回做格式化包装：
+ * - 默认调 formatFn 裁剪
+ * - 如果用户传了 raw=true，透传原始 JSON
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function wrapResult(data, formatFn, raw) {
+    if (raw) {
+        return JSON.stringify(data, null, 2);
+    }
+    if (!formatFn) {
+        return JSON.stringify(data, null, 2);
+    }
+    // 处理 { data: [...] } 列表结构
+    const obj = data;
+    if (obj?.data && Array.isArray(obj.data)) {
+        const formatted = {
+            ...(obj.meta ? { meta: obj.meta } : {}),
+            data: obj.data.map(formatFn),
+        };
+        return JSON.stringify(formatted, null, 2);
+    }
+    // 处理 { data: {...} } 单个对象
+    if (obj?.data && typeof obj.data === "object" && !Array.isArray(obj.data)) {
+        return JSON.stringify(formatFn(obj.data), null, 2);
+    }
+    // 处理纯数组（formatToc 等直接处理数组的 format 函数）
+    if (Array.isArray(data)) {
+        return JSON.stringify(formatFn(data), null, 2);
+    }
+    // 处理纯对象
+    return JSON.stringify(formatFn(data), null, 2);
+}
+/**
+ * 统一处理 API 调用结果：检查错误 → 格式化 → 包装 content 返回
+ * 消除 32 处 handler 末尾重复的 isErrorResult + wrapResult 模式。
+ */
+export function handleApiCall(data, formatFn, raw) {
+    if (data && typeof data === "object" && "isError" in data && data.isError) {
+        return data;
+    }
+    return {
+        content: [{ type: "text", text: wrapResult(data, formatFn, raw) }],
+    };
+}
+//# sourceMappingURL=format.js.map

package/dist/common/format.js.map

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

package/dist/common/register-tools.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 工具注册中心 — 所有工具的 import + 数组 + 注册逻辑
+ *
+ * 这是工具列表的唯一真实来源。index.ts 和 http.ts 都从这里引用。
+ * 新增工具：在对应域的 index.ts 加 export + 数组，此处自动包含。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** 所有工具（按域展开，唯一真实来源） */
+export declare const ALL_TOOLS: import("./types.js").McpTool[];
+/** 按域统计工具数 */
+export declare const DOMAIN_COUNTS: {
+    user: number;
+    search: number;
+    group: number;
+    doc: number;
+    toc: number;
+    repo: number;
+    statistic: number;
+    note: number;
+    recycle: number;
+    upload: number;
+    board: number;
+    rss: number;
+    crawler: number;
+    mine: number;
+    kv: number;
+};
+/** 将 JSON Schema 转为 Zod raw shape 并注册到 McpServer */
+export declare function registerAllTools(server: McpServer): void;

package/dist/common/register-tools.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { userTools } from "../user/index.js";
+import { searchTools } from "../search/index.js";
+import { groupTools } from "../group/index.js";
+import { docTools } from "../doc/index.js";
+import { tocTools } from "../toc/index.js";
+import { repoTools } from "../repo/index.js";
+import { statisticTools } from "../statistic/index.js";
+import { noteTools } from "../note/index.js";
+import { recycleTools } from "../recycle/index.js";
+import { uploadTools } from "../upload/index.js";
+import { boardTools } from "../board/index.js";
+import { rssTools } from "../rss/index.js";
+import { crawlerTools } from "../crawler/index.js";
+import { mineTools } from "../mine/index.js";
+import { kvTools } from "../kv/index.js";
+/** 所有工具（按域展开，唯一真实来源） */
+export const ALL_TOOLS = [
+    ...userTools,
+    ...searchTools,
+    ...groupTools,
+    ...docTools,
+    ...tocTools,
+    ...repoTools,
+    ...statisticTools,
+    ...noteTools,
+    ...recycleTools,
+    ...uploadTools,
+    ...boardTools,
+    ...rssTools,
+    ...crawlerTools,
+    ...mineTools,
+    ...kvTools,
+];
+/** 按域统计工具数 */
+export const DOMAIN_COUNTS = {
+    user: userTools.length,
+    search: searchTools.length,
+    group: groupTools.length,
+    doc: docTools.length,
+    toc: tocTools.length,
+    repo: repoTools.length,
+    statistic: statisticTools.length,
+    note: noteTools.length,
+    recycle: recycleTools.length,
+    upload: uploadTools.length,
+    board: boardTools.length,
+    rss: rssTools.length,
+    crawler: crawlerTools.length,
+    mine: mineTools.length,
+    kv: kvTools.length,
+};
+/** 将 JSON Schema 转为 Zod raw shape 并注册到 McpServer */
+export function registerAllTools(server) {
+    for (const tool of ALL_TOOLS) {
+        if (tool.inputSchema) {
+            const shape = {};
+            for (const [key, prop] of Object.entries(tool.inputSchema.properties)) {
+                const p = prop;
+                let zodType;
+                switch (p.type) {
+                    case "string":
+                        zodType = z.string();
+                        break;
+                    case "number":
+                        zodType = z.number();
+                        break;
+                    case "boolean":
+                        zodType = z.boolean();
+                        break;
+                    default: zodType = z.string();
+                }
+                if (p.description)
+                    zodType = zodType.describe(p.description);
+                if (!tool.inputSchema.required?.includes(key))
+                    zodType = zodType.optional();
+                shape[key] = zodType;
+            }
+            server.registerTool(tool.name, {
+                description: tool.description,
+                inputSchema: shape,
+            }, tool.handler);
+        }
+        else {
+            server.registerTool(tool.name, { description: tool.description }, tool.handler);
+        }
+    }
+}
+//# sourceMappingURL=register-tools.js.map

package/dist/common/register-tools.js.map

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

package/dist/common/repo-capacity.d.ts

@@ -0,0 +1,26 @@
+/**
+ * common/repo-capacity — 仓库满了自动扩容
+ *
+ * 设计：book_id 是数组，最后一个为当前活跃仓库。
+ * 创建文档时如果仓库满了，自动创建新仓库并追加到数组末尾。
+ *
+ * 语雀 API 在超过 5000 节点的知识库上不可用。
+ */
+/**
+ * 确保有可用仓库：如果当前仓库接近上限，自动扩容
+ * 返回可用的 book_id（可能是扩容后的新 ID）
+ */
+export declare function ensureRepoCapacity(domain: "rss" | "crawler", namespace: string, currentBookId: number): Promise<number | null>;
+/**
+ * 带自动扩容的文档创建
+ *
+ * 先 try 创建，如果返回"仓库满了"错误 → 扩容 → 重试一次
+ * 如果扩容成功但重试仍失败 → 返回失败
+ */
+export declare function createDocWithAutoExpand(bookId: number, domain: "rss" | "crawler", namespace: string, payload: Record<string, unknown>, context: string): Promise<{
+    ok: boolean;
+    id?: number;
+    book_id?: number;
+    expanded?: boolean;
+    error?: string;
+}>;

package/dist/common/repo-capacity.js

@@ -0,0 +1,105 @@
+/**
+ * common/repo-capacity — 仓库满了自动扩容
+ *
+ * 设计：book_id 是数组，最后一个为当前活跃仓库。
+ * 创建文档时如果仓库满了，自动创建新仓库并追加到数组末尾。
+ *
+ * 语雀 API 在超过 5000 节点的知识库上不可用。
+ */
+import { loadConfig, saveConfig, autoSlug } from "./config.js";
+import { apiPost, apiGet, isErrorResult } from "./api-client.js";
+import { isBookFullError } from "./errors.js";
+/** 语雀 API 可用节点上限（超过此数量 API 不可用） */
+const REPO_DOC_LIMIT = 5000;
+/**
+ * 扩容：创建新仓库 → 追加 book_id → 保存 config → 返回新 book_id
+ * @returns 新仓库 ID，失败返回 null
+ */
+async function expandRepo(domain, namespace) {
+    const cfg = loadConfig();
+    const ids = cfg[domain]?.namespaces?.[namespace]?.book_id ?? [];
+    const n = ids.length + 1;
+    const repoName = `${namespace}-${domain}-${n}`;
+    const repoSlug = autoSlug(repoName);
+    const result = await apiPost(`/users/yehuoshun/repos`, { name: repoName, slug: repoSlug, public: 0 }, `Auto-expand: ${repoName}`);
+    if (isErrorResult(result)) {
+        console.error(`[expandRepo] 创建新仓库 "${repoName}" 失败:`, JSON.stringify(result));
+        return null;
+    }
+    const newId = result?.data?.id;
+    if (!newId) {
+        console.error(`[expandRepo] 创建仓库成功但未获取到 ID`);
+        return null;
+    }
+    // 追加到数组并保存
+    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].book_id.push(newId);
+    saveConfig();
+    return newId;
+}
+/**
+ * 获取 namespace 的 items_count（文档数），用于判断是否需要扩容
+ * 在创建文档前预判，避免先创建失败再扩容的性能损耗
+ */
+async function getRepoItemCount(bookId) {
+    try {
+        const data = await apiGet(`/repos/${bookId}`, undefined, "Check capacity");
+        if (isErrorResult(data))
+            return null;
+        return data?.data?.items_count ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 确保有可用仓库：如果当前仓库接近上限，自动扩容
+ * 返回可用的 book_id（可能是扩容后的新 ID）
+ */
+export async function ensureRepoCapacity(domain, namespace, currentBookId) {
+    // 检查当前仓库文档数
+    const count = await getRepoItemCount(currentBookId);
+    if (count !== null && count < REPO_DOC_LIMIT) {
+        return currentBookId; // 还有空间
+    }
+    // 满了或无法检查 → 扩容
+    return expandRepo(domain, namespace);
+}
+/**
+ * 带自动扩容的文档创建
+ *
+ * 先 try 创建，如果返回"仓库满了"错误 → 扩容 → 重试一次
+ * 如果扩容成功但重试仍失败 → 返回失败
+ */
+export async function createDocWithAutoExpand(bookId, domain, namespace, payload, context) {
+    // 第一次尝试
+    const result = await apiPost(`/repos/${bookId}/docs`, payload, context);
+    if (!isErrorResult(result)) {
+        const docId = result?.data?.id;
+        return { ok: true, id: docId, book_id: bookId };
+    }
+    // 检查是否是"满了"错误
+    if (!isBookFullError(result)) {
+        // 不是满的错误，直接返回失败
+        return { ok: false, error: JSON.stringify(result) };
+    }
+    // 扩容
+    const newBookId = await expandRepo(domain, namespace);
+    if (!newBookId) {
+        return { ok: false, error: "仓库已满且自动扩容失败" };
+    }
+    // 用新仓库重试
+    const retryResult = await apiPost(`/repos/${newBookId}/docs`, payload, `Auto-expand retry: ${context}`);
+    if (isErrorResult(retryResult)) {
+        return { ok: false, expanded: true, error: `扩容成功 (${newBookId}) 但创建仍失败: ${JSON.stringify(retryResult)}` };
+    }
+    const docId = retryResult?.data?.id;
+    return { ok: true, id: docId, book_id: newBookId, expanded: true };
+}
+//# sourceMappingURL=repo-capacity.js.map

package/dist/common/repo-capacity.js.map

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

package/dist/common/schedule-common.d.ts

@@ -0,0 +1,38 @@
+/**
+ * common/schedule-common — 定时策略公共逻辑
+ *
+ * 被 rss/schedule.ts 和 crawler/schedule.ts 共享：
+ * - 频率分档（BANDS + classifyBand）
+ * - KV 文章时间戳解析（parseArticles / countRecent）
+ * - schedule_slugs 文档查找与创建（findScheduleDoc / upsertScheduleDoc）
+ */
+export interface BandRule {
+    label: string;
+    range: string;
+    intervalDays: number;
+}
+export declare const BANDS: BandRule[];
+export declare function classifyBand(recent7d: number, recent14d: number): BandRule;
+export interface ArticleMeta {
+    date: Date;
+    link: string;
+    author?: string;
+    feed?: string;
+}
+export declare function parseArticles(kvMap: Record<string, string>): ArticleMeta[];
+export declare function countRecent(articles: ArticleMeta[], days: number, now: Date): number;
+export declare function countRecentWithAuthors(articles: ArticleMeta[], days: number, now: Date): {
+    count: number;
+    authors: string[];
+};
+export declare function getScheduleSlugs(domain: "rss" | "crawler", source: string): string[];
+export interface ScheduleDocInfo {
+    slug: string | null;
+    lastFetch: string | null;
+}
+export declare function findScheduleDoc(domain: "rss" | "crawler", source: string, matchSlug: string): Promise<ScheduleDocInfo>;
+export declare function upsertScheduleDoc(domain: "rss" | "crawler", source: string, matchSlug: string, title: string, body: string): Promise<{
+    ok: boolean;
+    slug?: string;
+    error?: string;
+}>;

package/dist/common/schedule-common.js

@@ -0,0 +1,111 @@
+/**
+ * common/schedule-common — 定时策略公共逻辑
+ *
+ * 被 rss/schedule.ts 和 crawler/schedule.ts 共享：
+ * - 频率分档（BANDS + classifyBand）
+ * - KV 文章时间戳解析（parseArticles / countRecent）
+ * - schedule_slugs 文档查找与创建（findScheduleDoc / upsertScheduleDoc）
+ */
+import { loadConfig, parseSlug, buildSlugStr } from "./config.js";
+import { apiGet, apiPost, apiPut, isErrorResult } from "./api-client.js";
+import { setScheduleSlugs } from "../kv/common.js";
+export const BANDS = [
+    { label: "高频", range: "近7天≥5篇", intervalDays: 1 },
+    { label: "中频", range: "近7天1-4篇", intervalDays: 7 },
+    { label: "低频", range: "近14天1篇", intervalDays: 15 },
+    { label: "休眠", range: "近30天0篇", intervalDays: 30 },
+];
+export function classifyBand(recent7d, recent14d) {
+    if (recent7d >= 5)
+        return BANDS[0];
+    if (recent7d >= 1 && recent7d <= 4)
+        return BANDS[1];
+    if (recent14d >= 1 && recent7d === 0)
+        return BANDS[2];
+    return BANDS[3];
+}
+export function parseArticles(kvMap) {
+    const articles = [];
+    for (const [, value] of Object.entries(kvMap)) {
+        try {
+            const meta = JSON.parse(value);
+            if (meta.date) {
+                articles.push({
+                    date: new Date(meta.date),
+                    link: meta.link || "",
+                    author: meta.author || undefined,
+                    feed: meta.feed || undefined,
+                });
+            }
+        }
+        catch { /* 旧格式 */ }
+    }
+    return articles.sort((a, b) => b.date.getTime() - a.date.getTime());
+}
+export function countRecent(articles, days, now) {
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    return articles.filter((a) => a.date >= cutoff).length;
+}
+export function countRecentWithAuthors(articles, days, now) {
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const recent = articles.filter((a) => a.date >= cutoff);
+    return { count: recent.length, authors: [...new Set(recent.map((a) => a.author).filter(Boolean))] };
+}
+// ── schedule_slugs 操作 ──
+export function getScheduleSlugs(domain, source) {
+    const cfg = loadConfig();
+    return cfg[domain]?.namespaces?.[source]?.schedule_slugs ?? [];
+}
+export async function findScheduleDoc(domain, source, matchSlug) {
+    const slugs = getScheduleSlugs(domain, source);
+    for (const s of slugs) {
+        const parsed = parseSlug(s);
+        if (!parsed)
+            continue;
+        const data = await apiGet(`/repos/${parsed.bookId}/docs/${parsed.docId}?raw=1`, undefined, `Read schedule: ${parsed.docId}`);
+        if (isErrorResult(data))
+            continue;
+        const doc = data?.data;
+        if (!doc)
+            continue;
+        if (doc.slug === matchSlug) {
+            const body = doc.body || "";
+            const m = body.match(/上次抓取:\s*(.+)/);
+            return { slug: s, lastFetch: m ? m[1].trim().slice(0, 10) : null };
+        }
+    }
+    return { slug: null, lastFetch: null };
+}
+export async function upsertScheduleDoc(domain, source, matchSlug, title, body) {
+    const { slug: existingSlug } = await findScheduleDoc(domain, source, matchSlug);
+    if (existingSlug) {
+        const parsed = parseSlug(existingSlug);
+        if (!parsed)
+            return { ok: false, error: `无效 slug: ${existingSlug}` };
+        const result = await apiPut(`/repos/${parsed.bookId}/docs/${parsed.docId}`, { title, body, slug: matchSlug, format: "markdown", public: 0 }, `Update schedule: ${matchSlug}`);
+        if (isErrorResult(result))
+            return { ok: false, error: JSON.stringify(result) };
+        return { ok: true, slug: existingSlug };
+    }
+    // 新建
+    const slugs = getScheduleSlugs(domain, source);
+    let bookId = null;
+    if (slugs.length > 0) {
+        const parsed = parseSlug(slugs[0]);
+        bookId = parsed?.bookId ?? null;
+    }
+    if (!bookId) {
+        return { ok: false, error: "无法确定 schedule 知识库 book_id，请先在 config.json 中手动创建一篇 schedule 文档并添加到 schedule_slugs" };
+    }
+    const result = await apiPost(`/repos/${bookId}/docs`, { title, body, slug: matchSlug, format: "markdown", public: 0 }, `Create schedule: ${matchSlug}`);
+    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);
+    const newSlugs = [...slugs, newSlug];
+    setScheduleSlugs(domain, source, newSlugs);
+    return { ok: true, slug: newSlug };
+}
+//# sourceMappingURL=schedule-common.js.map

package/dist/common/schedule-common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-common.js","sourceRoot":"","sources":["../../src/common/schedule-common.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUnD,MAAM,CAAC,MAAM,KAAK,GAAe;IAC/B,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,EAAE;IACjD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,EAAE;IAClD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE;IAClD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE;CACnD,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAiB;IAC9D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,SAAS,IAAI,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAWD,MAAM,UAAU,aAAa,CAAC,KAA6B;IACzD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;oBACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;oBAChC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,IAAY,EAAE,GAAS;IAC1E,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAuB,EAAE,IAAY,EAAE,GAAS;IACrF,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;IACxD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC,CAAC,EAAE,CAAC;AAClH,CAAC;AAED,0BAA0B;AAE1B,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,MAAc;IACxE,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,cAAc,IAAI,EAAE,CAAC;AACjE,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAyB,EACzB,MAAc,EACd,SAAiB;IAEjB,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,IAAI,GAAG,MAAM,MAAM,CACvB,UAAU,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,KAAK,QAAQ,EACpD,SAAS,EACT,kBAAkB,MAAM,CAAC,KAAK,EAAE,CACjC,CAAC;QACF,IAAI,aAAa,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,MAAM,GAAG,GAAI,IAAoD,EAAE,IAAI,CAAC;QACxE,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAyB,EACzB,MAAc,EACd,SAAiB,EACjB,KAAa,EACb,IAAY;IAEZ,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEhF,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,YAAY,EAAE,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,UAAU,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,KAAK,EAAE,EAC9C,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,EAC/D,oBAAoB,SAAS,EAAE,CAChC,CAAC;QACF,IAAI,aAAa,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK;IACL,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kFAAkF,EAAE,CAAC;IAClH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,UAAU,MAAM,OAAO,EACvB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,EAC/D,oBAAoB,SAAS,EAAE,CAChC,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/E,MAAM,KAAK,GAAI,MAAoC,EAAE,IAAI,EAAE,EAAE,CAAC;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAE5D,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/common/text-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * common/text-utils — 文本处理工具函数
+ *
+ * 被多个模块共享的文本处理函数：
+ * - unescapeHtml：HTML 实体解码
+ * - escapeHtml：HTML 转义
+ */
+/** HTML 实体 → 原始字符 */
+export declare function unescapeHtml(text: string): string;
+/** 原始字符 → HTML 实体 */
+export declare function escapeHtml(str: string): string;