yuque-ai-mcp 2.7.4

package/dist/common/text-utils.js

@@ -0,0 +1,29 @@
+/**
+ * common/text-utils — 文本处理工具函数
+ *
+ * 被多个模块共享的文本处理函数：
+ * - unescapeHtml：HTML 实体解码
+ * - escapeHtml：HTML 转义
+ */
+/** HTML 实体 → 原始字符 */
+export function unescapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&#x27;/g, "'")
+        .replace(/&#x2F;/g, "/")
+        .replace(/&nbsp;/g, " ");
+}
+/** 原始字符 → HTML 实体 */
+export function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/common/text-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.js","sourceRoot":"","sources":["../../src/common/text-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAqB;AACrB,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}

package/dist/common/toc-cache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * common/toc-cache — TOC 缓存与目录操作公共逻辑
+ *
+ * 职责：TOC 缓存（24h TTL + 定时清理）、目录创建/查找。
+ * copy-doc 和 batch-update-toc 共用。
+ */
+/** 获取知识库 TOC（优先缓存，24h TTL） */
+export declare function getTocCached(bookId: string): Promise<Array<Record<string, unknown>>>;
+/** 使缓存失效（写操作后调用） */
+export declare function invalidateTocCache(bookId: string): void;
+/** 在 TOC 中查找 TITLE 节点（按名称 + 可选父节点） */
+export declare function findTitleNode(nodes: Array<Record<string, unknown>>, title: string, parentUuid?: string): Record<string, unknown> | undefined;
+/**
+ * 确保目录存在：有则复用 uuid，无则创建。
+ * PUT 返回完整 TOC，直接从中提取 uuid 并更新缓存，不额外 GET。
+ */
+export declare function ensureTitle(bookId: string, title: string, parentUuid?: string): Promise<{
+    uuid: string;
+    created: boolean;
+}>;
+/**
+ * 确保目录路径存在（多层级），返回最末端节点 uuid。
+ * 用于 copy-doc 等需要 "Java/Spring/Boot" 路径的场景。
+ */
+export declare function ensureDirectoryPath(bookId: string, path: string): Promise<string | null>;
+/** 解析 target：支持 target_uuid 或 target_title */
+export declare function resolveTarget(bookId: string, op: {
+    target_uuid?: string;
+    target_title?: string;
+}): Promise<string | undefined>;

package/dist/common/toc-cache.js

@@ -0,0 +1,109 @@
+/**
+ * common/toc-cache — TOC 缓存与目录操作公共逻辑
+ *
+ * 职责：TOC 缓存（24h TTL + 定时清理）、目录创建/查找。
+ * copy-doc 和 batch-update-toc 共用。
+ */
+import { apiGet, apiPut, isErrorResult } from "./api-client.js";
+const tocCache = new Map();
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 1 天
+// 每小时清理过期缓存
+const CLEANUP_INTERVAL = 60 * 60 * 1000;
+const cleanupTimer = setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of tocCache) {
+        if (entry.expiresAt <= now)
+            tocCache.delete(key);
+    }
+}, CLEANUP_INTERVAL);
+if (cleanupTimer && typeof cleanupTimer === "object" && "unref" in cleanupTimer) {
+    cleanupTimer.unref();
+}
+/** 获取知识库 TOC（优先缓存，24h TTL） */
+export async function getTocCached(bookId) {
+    const cached = tocCache.get(bookId);
+    if (cached && cached.expiresAt > Date.now()) {
+        return cached.nodes;
+    }
+    const data = await apiGet(`/repos/${bookId}/toc`, undefined, "Get TOC (cached)");
+    if (isErrorResult(data)) {
+        return [];
+    }
+    const nodes = data.data || [];
+    tocCache.set(bookId, { nodes, expiresAt: Date.now() + CACHE_TTL_MS });
+    return nodes;
+}
+/** 使缓存失效（写操作后调用） */
+export function invalidateTocCache(bookId) {
+    tocCache.delete(bookId);
+}
+// ─── 目录查找 ────────────────────────────────────────────
+/** 在 TOC 中查找 TITLE 节点（按名称 + 可选父节点） */
+export function findTitleNode(nodes, title, parentUuid) {
+    return nodes.find((n) => n.type === "TITLE" &&
+        n.title === title &&
+        (parentUuid ? n.parent_uuid === parentUuid : !n.parent_uuid));
+}
+// ─── 目录创建/复用 ────────────────────────────────────────
+/**
+ * 确保目录存在：有则复用 uuid，无则创建。
+ * PUT 返回完整 TOC，直接从中提取 uuid 并更新缓存，不额外 GET。
+ */
+export async function ensureTitle(bookId, title, parentUuid) {
+    const nodes = await getTocCached(bookId);
+    const existing = findTitleNode(nodes, title, parentUuid);
+    if (existing) {
+        return { uuid: existing.uuid, created: false };
+    }
+    const payload = {
+        action: "appendNode",
+        action_mode: "child",
+        type: "TITLE",
+        title,
+    };
+    if (parentUuid)
+        payload.target_uuid = parentUuid;
+    const data = await apiPut(`/repos/${bookId}/toc`, payload, `Create TITLE: ${title}`);
+    if (isErrorResult(data)) {
+        throw new Error(`创建目录失败: ${title}`);
+    }
+    const tocNodes = data.data || [];
+    tocCache.set(bookId, { nodes: tocNodes, expiresAt: Date.now() + CACHE_TTL_MS });
+    const created = tocNodes.find((n) => n.type === "TITLE" && n.title === title &&
+        (parentUuid ? n.parent_uuid === parentUuid : !n.parent_uuid));
+    if (!created?.uuid)
+        throw new Error(`创建目录后找不到: ${title}`);
+    return { uuid: created.uuid, created: true };
+}
+/**
+ * 确保目录路径存在（多层级），返回最末端节点 uuid。
+ * 用于 copy-doc 等需要 "Java/Spring/Boot" 路径的场景。
+ */
+export async function ensureDirectoryPath(bookId, path) {
+    const parts = path.split("/").filter(Boolean);
+    let parentUuid;
+    for (const part of parts) {
+        try {
+            const { uuid } = await ensureTitle(bookId, part, parentUuid);
+            parentUuid = uuid;
+        }
+        catch {
+            return null;
+        }
+    }
+    return parentUuid || null;
+}
+/** 解析 target：支持 target_uuid 或 target_title */
+export async function resolveTarget(bookId, op) {
+    if (op.target_uuid)
+        return op.target_uuid;
+    if (op.target_title) {
+        const nodes = await getTocCached(bookId);
+        const node = findTitleNode(nodes, op.target_title);
+        if (!node)
+            throw new Error(`找不到 TITLE: ${op.target_title}`);
+        return node.uuid;
+    }
+    return undefined;
+}
+//# sourceMappingURL=toc-cache.js.map

package/dist/common/toc-cache.js.map

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

package/dist/common/types.d.ts

@@ -0,0 +1,17 @@
+/** 公共类型定义 — 所有工具模块共享 */
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema?: {
+        type: "object";
+        properties: Record<string, any>;
+        required?: string[];
+    };
+    handler(args?: Record<string, unknown>): Promise<{
+        content?: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+    }> | Promise<unknown>;
+}

package/dist/common/types.js

@@ -0,0 +1,3 @@
+/** 公共类型定义 — 所有工具模块共享 */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,wBAAwB"}

package/dist/common/validate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * validate — 轻量参数校验
+ *
+ * 不引入 zod/ajv，用简单函数保证运行时安全。
+ * 校验失败返回 MCP error 对象，通过返回 null 表示通过。
+ * 错误信息：中文 + English 双语。
+ */
+type ErrorResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+/** 非空字符串 */
+export declare function requiredString(value: unknown, name: string): ErrorResult | null;
+/** 可选字符串（有值时不能为空） */
+export declare function optionalString(value: unknown, name: string): ErrorResult | null;
+/** 正整数 */
+export declare function positiveInt(value: unknown, name: string): ErrorResult | null;
+/** 数值上限 */
+export declare function maxValue(value: unknown, name: string, max: number): ErrorResult | null;
+/** 枚举值 */
+export declare function oneOf(value: unknown, name: string, allowed: readonly (string | number)[]): ErrorResult | null;
+/** 批量校验，返回第一个失败的结果 */
+export declare function check(...results: (ErrorResult | null)[]): ErrorResult | null;
+export {};

package/dist/common/validate.js

@@ -0,0 +1,70 @@
+/**
+ * validate — 轻量参数校验
+ *
+ * 不引入 zod/ajv，用简单函数保证运行时安全。
+ * 校验失败返回 MCP error 对象，通过返回 null 表示通过。
+ * 错误信息：中文 + English 双语。
+ */
+function fail(msgCn, msgEn) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({
+                    error: `${msgCn} / ${msgEn}`,
+                    hint: "zh/en",
+                }, null, 2) }],
+        isError: true,
+    };
+}
+/** 非空字符串 */
+export function requiredString(value, name) {
+    if (value === undefined || value === null)
+        return fail(`${name} 是必填参数`, `${name} is required`);
+    if (typeof value !== "string")
+        return fail(`${name} 必须是字符串`, `${name} must be a string`);
+    if (value.trim() === "")
+        return fail(`${name} 不能为空`, `${name} cannot be empty`);
+    return null;
+}
+/** 可选字符串（有值时不能为空） */
+export function optionalString(value, name) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "string")
+        return fail(`${name} 必须是字符串`, `${name} must be a string`);
+    return null;
+}
+/** 正整数 */
+export function positiveInt(value, name) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        return fail(`${name} 必须是正整数`, `${name} must be a positive integer`);
+    }
+    return null;
+}
+/** 数值上限 */
+export function maxValue(value, name, max) {
+    if (value === undefined || value === null)
+        return null;
+    if (typeof value !== "number" || value > max) {
+        return fail(`${name} 不能超过 ${max}`, `${name} must be ≤ ${max}`);
+    }
+    return null;
+}
+/** 枚举值 */
+export function oneOf(value, name, allowed) {
+    if (value === undefined || value === null)
+        return null;
+    if (!allowed.includes(value)) {
+        return fail(`${name} 取值必须为: ${allowed.join(", ")}`, `${name} must be one of: ${allowed.join(", ")}`);
+    }
+    return null;
+}
+/** 批量校验，返回第一个失败的结果 */
+export function check(...results) {
+    for (const r of results) {
+        if (r !== null)
+            return r;
+    }
+    return null;
+}
+//# sourceMappingURL=validate.js.map

package/dist/common/validate.js.map

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

package/dist/common/web-request.d.ts

@@ -0,0 +1,13 @@
+/**
+ * common/web-request — 语雀 Web API 请求（Cookie 认证）
+ *
+ * 适用于 /api/mine/* 路径的 Web API，需要 Cookie 登录态。
+ * 配置：config/config.json 中的 cookie 和 ctoken 字段
+ *
+ * 统一 mine 和 recycle 域共用的请求层，消除重复代码。
+ */
+export declare function webRequest(url: string, opts?: {
+    method?: "GET" | "PUT" | "DELETE";
+    body?: unknown;
+    referer?: string;
+}): Promise<unknown>;

package/dist/common/web-request.js

@@ -0,0 +1,53 @@
+/**
+ * common/web-request — 语雀 Web API 请求（Cookie 认证）
+ *
+ * 适用于 /api/mine/* 路径的 Web API，需要 Cookie 登录态。
+ * 配置：config/config.json 中的 cookie 和 ctoken 字段
+ *
+ * 统一 mine 和 recycle 域共用的请求层，消除重复代码。
+ */
+import { loadConfig } from "./config.js";
+export async function webRequest(url, opts = {}) {
+    const cfg = loadConfig();
+    const cookie = cfg.cookie || "";
+    const ctoken = cfg.ctoken || "";
+    if (!cookie || !ctoken) {
+        throw new Error("此 API 需要 Cookie 登录态，请在 config/config.json 中配置 cookie 和 ctoken 字段。" +
+            "获取方式：浏览器打开 yuque.com 登录 → F12 → Application → Cookies → 复制 _yuque_session 和 yuque_ctoken");
+    }
+    const headers = {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+        "Cookie": cookie,
+        "x-csrf-token": ctoken,
+        "Referer": opts.referer || "https://www.yuque.com/dashboard/books",
+        "User-Agent": "Mozilla/5.0",
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const res = await fetch(url, {
+            method: opts.method || "GET",
+            headers,
+            body: opts.body ? JSON.stringify(opts.body) : undefined,
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            let msg = `语雀 Web API 错误 [${res.status}]`;
+            try {
+                const err = JSON.parse(text);
+                msg += `: ${err.message || text.slice(0, 200)}`;
+            }
+            catch {
+                msg += `: ${text.slice(0, 200)}`;
+            }
+            throw new Error(msg);
+        }
+        return JSON.parse(text);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=web-request.js.map

package/dist/common/web-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-request.js","sourceRoot":"","sources":["../../src/common/web-request.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,OAAgF,EAAE;IAElF,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAEhC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mEAAmE;YACnE,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,QAAQ,EAAE,kBAAkB;QAC5B,cAAc,EAAE,kBAAkB;QAClC,QAAQ,EAAE,MAAM;QAChB,cAAc,EAAE,MAAM;QACtB,SAAS,EAAE,IAAI,CAAC,OAAO,IAAI,uCAAuC;QAClE,YAAY,EAAE,aAAa;KAC5B,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;YAC5B,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;YACvD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,GAAG,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC7B,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/crawler/extract.d.ts

@@ -0,0 +1,19 @@
+/**
+ * crawler/extract — CSS 选择器提取
+ *
+ * 职责：传入 HTML 字符串 + CSS 选择器，提取文本/属性/HTML。
+ * 使用简单的正则 + 字符串解析，不依赖 jsdom（保持零外部依赖）。
+ *
+ * 支持的选择器：
+ *   - tag: "div", "p", "a", "h1" 等
+ *   - .class: ".content", ".article-title"
+ *   - #id: "#main"
+ *   - tag.class: "div.content", "a.link"
+ *   - [attr]: "[href]", "[data-id]"
+ *   - 组合: "div.content a.link"
+ *
+ * 限制：不支持伪类 (:nth-child)、属性值匹配 ([attr=val])、兄弟选择器 (+/~)。
+ *       复杂场景建议 Agent 用 yuque_crawl_fetch 拿 HTML 后自行解析。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const crawlExtract: McpTool;

package/dist/crawler/extract.js

@@ -0,0 +1,220 @@
+/**
+ * crawler/extract — CSS 选择器提取
+ *
+ * 职责：传入 HTML 字符串 + CSS 选择器，提取文本/属性/HTML。
+ * 使用简单的正则 + 字符串解析，不依赖 jsdom（保持零外部依赖）。
+ *
+ * 支持的选择器：
+ *   - tag: "div", "p", "a", "h1" 等
+ *   - .class: ".content", ".article-title"
+ *   - #id: "#main"
+ *   - tag.class: "div.content", "a.link"
+ *   - [attr]: "[href]", "[data-id]"
+ *   - 组合: "div.content a.link"
+ *
+ * 限制：不支持伪类 (:nth-child)、属性值匹配 ([attr=val])、兄弟选择器 (+/~)。
+ *       复杂场景建议 Agent 用 yuque_crawl_fetch 拿 HTML 后自行解析。
+ */
+import { check, requiredString } from "../common/validate.js";
+import { unescapeHtml } from "../common/text-utils.js";
+function parseSelector(selector) {
+    return selector
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((part) => {
+        const result = { tag: "", cls: "", id: "", attr: "" };
+        // [attr]
+        const attrMatch = part.match(/^\[([^\]]+)\]$/);
+        if (attrMatch) {
+            result.attr = attrMatch[1];
+            return result;
+        }
+        // #id
+        const idMatch = part.match(/#([\w-]+)/);
+        if (idMatch)
+            result.id = idMatch[1];
+        // .class (可能有多个)
+        const clsMatches = part.match(/\.([\w-]+)/g);
+        if (clsMatches)
+            result.cls = clsMatches.map((c) => c.slice(1)).join(" ");
+        // tag
+        const tagMatch = part.match(/^([\w-]+)/);
+        if (tagMatch)
+            result.tag = tagMatch[1].toLowerCase();
+        return result;
+    });
+}
+/** 检查元素是否匹配选择器片段 */
+function matchesPart(el, part) {
+    if (part.tag && !el.startsWith(`<${part.tag}`))
+        return false;
+    if (part.id && !el.includes(`id="${part.id}"`) && !el.includes(`id='${part.id}'`))
+        return false;
+    if (part.cls) {
+        const clsParts = part.cls.split(" ");
+        for (const c of clsParts) {
+            if (!el.includes(`class="${c}"`) && !el.includes(`class='${c}'`) &&
+                !el.match(new RegExp(`class="[^"]*\\b${c}\\b[^"]*"`)) &&
+                !el.match(new RegExp(`class='[^']*\\b${c}\\b[^']*'`))) {
+                return false;
+            }
+        }
+    }
+    if (part.attr && !el.includes(`${part.attr}=`))
+        return false;
+    return true;
+}
+/** 提取元素的属性 */
+function extractAttrs(el) {
+    const attrs = {};
+    const attrRe = /(\w[\w-]*)=["']([^"']*)["']/g;
+    let m;
+    while ((m = attrRe.exec(el)) !== null) {
+        attrs[m[1]] = m[2];
+    }
+    return attrs;
+}
+/** 提取元素的文本内容（去除标签） */
+function extractText(el) {
+    return unescapeHtml(el.replace(/<[^>]*>/g, "")
+        .replace(/\s+/g, " ")).trim();
+}
+/**
+ * 在 HTML 中查找匹配选择器的所有元素
+ * 策略：先按最后一个选择器部分找候选元素，再向上验证父级匹配
+ */
+function findAll(html, parts) {
+    if (parts.length === 0)
+        return [];
+    const lastPart = parts[parts.length - 1];
+    const parentParts = parts.slice(0, -1);
+    // 构建候选元素的正则
+    let tagPattern;
+    if (lastPart.tag) {
+        tagPattern = lastPart.tag;
+    }
+    else {
+        tagPattern = "\\w+";
+    }
+    const tagRe = new RegExp(`<(${tagPattern})(\\s[^>]*)?>([\\s\\S]*?)</\\1>`, "gi");
+    const results = [];
+    let m;
+    while ((m = tagRe.exec(html)) !== null) {
+        const fullTag = m[0];
+        if (!matchesPart(fullTag, lastPart))
+            continue;
+        // 检查父级匹配
+        if (parentParts.length > 0) {
+            const beforeText = html.substring(0, m.index);
+            if (!checkParents(beforeText, parentParts))
+                continue;
+        }
+        results.push(fullTag);
+    }
+    return results;
+}
+/** 检查 HTML 前缀中是否包含匹配的父级元素 */
+function checkParents(beforeText, parts) {
+    // 从后往前匹配父级
+    const reversed = [...parts].reverse();
+    let remaining = beforeText;
+    for (const part of reversed) {
+        const tag = part.tag || "\\w+";
+        const openRe = new RegExp(`<(${tag})(\\s[^>]*)?>`, "gi");
+        const closeRe = new RegExp(`</(${tag})>`, "gi");
+        // 从末尾往前找，匹配开闭标签
+        let depth = 0;
+        let found = false;
+        const markers = [];
+        let m;
+        while ((m = openRe.exec(remaining)) !== null) {
+            markers.push({ pos: m.index, isOpen: true, raw: m[0] });
+        }
+        while ((m = closeRe.exec(remaining)) !== null) {
+            markers.push({ pos: m.index, isOpen: false, raw: m[0] });
+        }
+        markers.sort((a, b) => b.pos - a.pos); // 从后往前
+        for (const mk of markers) {
+            if (mk.isOpen) {
+                if (depth === 0 && matchesPart(mk.raw, part)) {
+                    remaining = remaining.substring(0, mk.pos);
+                    found = true;
+                    break;
+                }
+                depth--;
+            }
+            else {
+                depth++;
+            }
+        }
+        if (!found)
+            return false;
+    }
+    return true;
+}
+export const crawlExtract = {
+    name: "yuque_crawl_extract",
+    description: "Extract content from HTML using CSS selectors (tag, .class, #id, [attr]). Returns text/html/attrs for each match. For complex selectors (:nth-child, etc.), Agent should parse raw HTML from yuque_crawl_fetch. 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            html: { type: "string", description: "Raw HTML string to extract from" },
+            selector: { type: "string", description: "CSS selector, e.g. 'div.content a.link', '.article-title', '#main'" },
+            attr: { type: "string", description: "Extract specific attribute value instead of text, e.g. 'href', 'src'" },
+            limit: { type: "number", description: "Max items to return (default 50, max 200)" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns summary)" },
+        },
+        required: ["html", "selector"],
+    },
+    async handler(args) {
+        const __v = check(requiredString(args?.html, "html"), requiredString(args?.selector, "selector"));
+        if (__v)
+            return __v;
+        const html = args?.html;
+        const selector = args?.selector;
+        const attr = args?.attr;
+        const limit = Math.min(args?.limit ?? 50, 200);
+        const parts = parseSelector(selector);
+        if (parts.length === 0) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "INVALID_SELECTOR",
+                            message: `无法解析选择器: ${selector}`,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const elements = findAll(html, parts).slice(0, limit);
+        const items = elements.map((el) => {
+            const attrs = extractAttrs(el);
+            return {
+                text: extractText(el),
+                html: el,
+                attrs,
+            };
+        });
+        // 如果指定了 attr，只返回属性值
+        if (attr) {
+            const attrItems = items.map((item) => item.attrs[attr] || null).filter(Boolean);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            selector,
+                            attr,
+                            count: attrItems.length,
+                            values: attrItems,
+                        }, null, 2),
+                    }],
+            };
+        }
+        const result = { selector, count: items.length, items };
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    },
+};
+//# sourceMappingURL=extract.js.map

package/dist/crawler/extract.js.map

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

package/dist/crawler/fetch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * crawler/fetch — HTTP 请求抓取网页原始 HTML
+ *
+ * 职责：发 HTTP GET 请求，返回原始 HTML + 响应头 + 状态码。
+ * 不做任何解析、提取、清洗。Agent 拿到原始 HTML 后自行决定下一步。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const crawlFetch: McpTool;