yuque-ai-mcp 2.7.4

package/dist/doc/import-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * doc/import-file — 从本地文件导入文档到语雀（三种模式）
+ *
+ * 模式：
+ * 1. direct       — 原样导入，不处理附件和外部图片
+ * 2. upload_assets — 本地图片/附件上传到语雀 CDN，替换路径后导入
+ * 3. embed_assets  — 附件（docx/xlsx/pptx/pdf）解析内容创建子文档，
+ *                    替换引用为语雀文档链接后导入原文档
+ *
+ * 所有模式均在内存中处理，不修改源文件。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docImportFile: McpTool;

package/dist/doc/import-file.js

@@ -0,0 +1,333 @@
+/**
+ * doc/import-file — 从本地文件导入文档到语雀（三种模式）
+ *
+ * 模式：
+ * 1. direct       — 原样导入，不处理附件和外部图片
+ * 2. upload_assets — 本地图片/附件上传到语雀 CDN，替换路径后导入
+ * 3. embed_assets  — 附件（docx/xlsx/pptx/pdf）解析内容创建子文档，
+ *                    替换引用为语雀文档链接后导入原文档
+ *
+ * 所有模式均在内存中处理，不修改源文件。
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, basename } from "node:path";
+import { apiPost, apiPut, isErrorResult } from "../common/api-client.js";
+import { requiredString, oneOf } from "../common/validate.js";
+import { loadConfig } from "../common/config.js";
+import { ensureDirectoryPath } from "../common/toc-cache.js";
+import { uploadImage, uploadAttachmentFile, isEmbeddable, parseAttachmentContent, extractLocalRefs, } from "./import-file-utils.js";
+// ─── 主工具 ────────────────────────────────────────────
+export const docImportFile = {
+    name: "yuque_import_file",
+    description: "Import a local Markdown/HTML file into Yuque. 3 modes: direct / upload_assets / embed_assets. 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "Local file path (required, .md or .html)",
+            },
+            book_id: {
+                type: "string",
+                description: "Target repository ID or namespace (required)",
+            },
+            paths: {
+                type: "string",
+                description: "JSON array of directory paths, e.g. '[\"导入/技术文档\"]'. 1-5 paths (required)",
+            },
+            mode: {
+                type: "string",
+                description: "Import mode: direct / upload_assets / embed_assets (default: direct)",
+            },
+            title: {
+                type: "string",
+                description: "Document title, defaults to filename without extension",
+            },
+            slug: {
+                type: "string",
+                description: "Document slug, auto-generated if omitted",
+            },
+            format: {
+                type: "string",
+                description: "Content format: markdown / html, defaults to markdown",
+            },
+            raw: {
+                type: "boolean",
+                description: "Return raw full JSON",
+            },
+        },
+        required: ["file_path", "book_id", "paths"],
+    },
+    async handler(args) {
+        const cfg = loadConfig();
+        const filePath = args?.file_path;
+        const bookId = args?.book_id;
+        const mode = args?.mode || "direct";
+        const title = args?.title || basename(filePath).replace(/\.[^.]+$/, "") || "无标题";
+        const slug = args?.slug;
+        const format = args?.format || "markdown";
+        // 校验
+        for (const [val, name] of [[filePath, "file_path"], [bookId, "book_id"]]) {
+            const err = requiredString(val, name);
+            if (err)
+                return err;
+        }
+        const modeErr = oneOf(mode, "mode", ["direct", "upload_assets", "embed_assets"]);
+        if (modeErr)
+            return modeErr;
+        // 解析 paths
+        const pathsErr = requiredString(args?.paths, "paths");
+        if (pathsErr)
+            return pathsErr;
+        let paths;
+        try {
+            paths = JSON.parse(args?.paths);
+            if (!Array.isArray(paths) || paths.length === 0) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是非空 JSON 数组" }, null, 2) }],
+                    isError: true,
+                };
+            }
+            paths = paths.slice(0, 5);
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是有效的 JSON 数组" }, null, 2) }],
+                isError: true,
+            };
+        }
+        // ── 1. 读取文件 ──
+        if (!existsSync(filePath)) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "FILE_NOT_FOUND",
+                            message: `文件不存在: ${filePath}`,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        let body;
+        try {
+            body = readFileSync(filePath, "utf-8");
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "READ_ERROR",
+                            message: `无法读取文件: ${filePath}`,
+                            detail: err instanceof Error ? err.message : String(err),
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        // ── 2. 提取本地引用 ──
+        const baseDir = dirname(filePath);
+        const refs = extractLocalRefs(body, baseDir);
+        const assetResults = [];
+        // ── 3. 按模式处理引用 ──
+        if (mode === "direct") {
+            for (const ref of refs) {
+                assetResults.push({ original: ref.originalPath, type: ref.type });
+            }
+        }
+        if (mode === "upload_assets") {
+            const cookie = cfg.cookie || "";
+            const ctoken = cfg.ctoken || "";
+            const hasCookie = !!cookie && !!ctoken;
+            if (!hasCookie) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "NO_COOKIE",
+                                message: "upload_assets 模式需要配置 Cookie 和 ctoken",
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+            // 获取 user_id
+            let userId = "";
+            try {
+                const userRes = await fetch(`${cfg.api_base}/user`, {
+                    headers: { "X-Auth-Token": cfg.token },
+                });
+                if (userRes.ok) {
+                    const userData = (await userRes.json());
+                    userId = String(userData.data.id);
+                }
+            }
+            catch { /* 继续 */ }
+            for (const ref of refs) {
+                if (!existsSync(ref.absolutePath)) {
+                    assetResults.push({ original: ref.originalPath, type: ref.type, error: "文件不存在" });
+                    continue;
+                }
+                if (ref.type === "image") {
+                    const result = await uploadImage(ref.absolutePath, cookie, ctoken, userId);
+                    if (result.ok) {
+                        assetResults.push({ original: ref.originalPath, type: "image", cdnUrl: result.url });
+                    }
+                    else {
+                        assetResults.push({ original: ref.originalPath, type: "image", error: result.error });
+                    }
+                }
+                else {
+                    const result = await uploadAttachmentFile(ref.absolutePath, cookie, ctoken, userId);
+                    if (result.ok) {
+                        assetResults.push({ original: ref.originalPath, type: "attachment", cdnUrl: result.url });
+                    }
+                    else {
+                        assetResults.push({ original: ref.originalPath, type: "attachment", error: result.error });
+                    }
+                }
+            }
+        }
+        if (mode === "embed_assets") {
+            for (const ref of refs) {
+                try {
+                    if (!existsSync(ref.absolutePath)) {
+                        assetResults.push({ original: ref.originalPath, type: ref.type, error: "文件不存在" });
+                        continue;
+                    }
+                    if (ref.type === "image") {
+                        assetResults.push({ original: ref.originalPath, type: "image" });
+                        continue;
+                    }
+                    if (!isEmbeddable(ref.ext)) {
+                        assetResults.push({
+                            original: ref.originalPath,
+                            type: "attachment",
+                            error: `不支持转义的格式: ${ref.ext}`,
+                        });
+                        continue;
+                    }
+                    let content;
+                    try {
+                        content = parseAttachmentContent(ref.absolutePath, ref.ext);
+                    }
+                    catch (parseErr) {
+                        const errMsg = parseErr instanceof Error ? parseErr.message : String(parseErr);
+                        content = `*（${basename(ref.absolutePath)} 解析异常: ${errMsg}，请手动查看附件）*`;
+                        assetResults.push({
+                            original: ref.originalPath,
+                            type: "attachment",
+                            error: `解析异常: ${errMsg}`,
+                        });
+                        continue;
+                    }
+                    const assetTitle = basename(ref.absolutePath).replace(/\.[^.]+$/, "");
+                    const payload = {
+                        title: assetTitle,
+                        body: content,
+                        format: "markdown",
+                    };
+                    const data = await apiPost(`/repos/${bookId}/docs`, payload, `Create embed doc: ${assetTitle}`);
+                    if (isErrorResult(data)) {
+                        assetResults.push({
+                            original: ref.originalPath,
+                            type: "attachment",
+                            error: "创建子文档失败",
+                        });
+                        continue;
+                    }
+                    const newDoc = data.data;
+                    if (!newDoc?.id) {
+                        assetResults.push({
+                            original: ref.originalPath,
+                            type: "attachment",
+                            error: "子文档创建返回无 ID",
+                        });
+                        continue;
+                    }
+                    assetResults.push({
+                        original: ref.originalPath,
+                        type: "attachment",
+                        embedDocId: newDoc.id,
+                        embedDocSlug: newDoc.slug,
+                    });
+                }
+                catch (err) {
+                    assetResults.push({
+                        original: ref.originalPath,
+                        type: ref.type,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+        // ── 4. 替换引用（在内存中，不修改源文件） ──
+        let finalBody = body;
+        let assetsUploaded = 0;
+        let assetsEmbedded = 0;
+        let assetsFailed = 0;
+        for (const result of assetResults) {
+            if (result.cdnUrl) {
+                finalBody = finalBody.replaceAll(result.original, result.cdnUrl);
+                assetsUploaded++;
+            }
+            else if (result.embedDocId) {
+                const yuqueLink = `https://www.yuque.com/yehuoshun/${bookId}/${result.embedDocSlug}`;
+                finalBody = finalBody.replaceAll(result.original, yuqueLink);
+                assetsEmbedded++;
+            }
+            else if (result.error) {
+                assetsFailed++;
+            }
+        }
+        // ── 5. 逐路径创建文档 ──
+        const results = [];
+        for (const path of paths) {
+            try {
+                const dirUuid = await ensureDirectoryPath(bookId, path);
+                if (!dirUuid) {
+                    results.push({ path, error: "目录创建失败" });
+                    continue;
+                }
+                const payload = { title, body: finalBody, format };
+                if (slug)
+                    payload.slug = slug;
+                const data = await apiPost(`/repos/${bookId}/docs`, payload, `Import file doc to ${path}`);
+                if (isErrorResult(data)) {
+                    const errMsg = data.content?.[0]?.text || "Unknown error";
+                    results.push({ path, error: errMsg });
+                    continue;
+                }
+                const newDoc = data.data;
+                if (!newDoc?.id) {
+                    results.push({ path, error: "文档创建返回无 ID" });
+                    continue;
+                }
+                await apiPut(`/repos/${bookId}/toc`, {
+                    action: "appendNode",
+                    action_mode: "child",
+                    type: "DOC",
+                    doc_ids: [newDoc.id],
+                    target_uuid: dirUuid,
+                }, `Append doc to TOC: ${path}`);
+                results.push({ path, doc_id: newDoc.id, slug: newDoc.slug });
+            }
+            catch (err) {
+                results.push({ path, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        mode,
+                        source_file: filePath,
+                        title,
+                        book_id: bookId,
+                        paths,
+                        assets: {
+                            total: refs.length,
+                            uploaded: assetsUploaded,
+                            embedded: assetsEmbedded,
+                            failed: assetsFailed,
+                            details: assetResults,
+                        },
+                        results,
+                        total: results.length,
+                        success: results.filter((r) => r.doc_id).length,
+                        failed: results.filter((r) => r.error).length,
+                    }, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=import-file.js.map

package/dist/doc/import-file.js.map

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

package/dist/doc/import-url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * doc/import-url — 从网页 URL 导入内容到语雀
+ *
+ * 一把梭：Agent 传 url + book_id + paths → 工具抓取 → 清洗 → 创建文档 → 挂载 TOC → 返回
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docImportUrl: McpTool;

package/dist/doc/import-url.js

@@ -0,0 +1,245 @@
+/**
+ * doc/import-url — 从网页 URL 导入内容到语雀
+ *
+ * 一把梭：Agent 传 url + book_id + paths → 工具抓取 → 清洗 → 创建文档 → 挂载 TOC → 返回
+ */
+import { apiPost, apiPut, isErrorResult } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { ensureDirectoryPath } from "../common/toc-cache.js";
+import { appendSourceLink } from "../common/copy-common.js";
+import { escapeHtml } from "../common/text-utils.js";
+export const docImportUrl = {
+    name: "yuque_import_url",
+    description: "Import content from a web URL into Yuque. Fetches page, extracts readable content, creates doc. 详见 references/api/extended_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: {
+                type: "string",
+                description: "Target repository ID or namespace (required)",
+            },
+            url: {
+                type: "string",
+                description: "Web page URL to import (required)",
+            },
+            paths: {
+                type: "string",
+                description: "JSON array of directory paths, e.g. '[\"收集/技术文章\"]'. 1-5 paths (required)",
+            },
+            title: {
+                type: "string",
+                description: "Document title, defaults to page title",
+            },
+            format: {
+                type: "string",
+                description: "Content format: markdown / html, defaults to markdown",
+            },
+            raw: {
+                type: "boolean",
+                description: "Return raw full JSON",
+            },
+        },
+        required: ["book_id", "url", "paths"],
+    },
+    async handler(args) {
+        const bookId = args?.book_id;
+        const url = args?.url;
+        const format = args?.format || "markdown";
+        // 校验
+        for (const [val, name] of [[bookId, "book_id"], [url, "url"]]) {
+            const err = requiredString(val, name);
+            if (err)
+                return err;
+        }
+        // 解析 paths
+        const pathsErr = requiredString(args?.paths, "paths");
+        if (pathsErr)
+            return pathsErr;
+        let paths;
+        try {
+            paths = JSON.parse(args?.paths);
+            if (!Array.isArray(paths) || paths.length === 0) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是非空 JSON 数组" }, null, 2) }],
+                    isError: true,
+                };
+            }
+            paths = paths.slice(0, 5);
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "INVALID_PATHS", message: "paths 必须是有效的 JSON 数组" }, null, 2) }],
+                isError: true,
+            };
+        }
+        // ── 1. 抓取网页 ──
+        let pageTitle;
+        let pageBody;
+        try {
+            const fetchRes = await fetch(url, {
+                headers: {
+                    "User-Agent": "Mozilla/5.0 (compatible; YuqueMCP/1.0; +https://github.com/yehuoshun/yuque-ai-mcp)",
+                },
+                redirect: "follow",
+            });
+            if (!fetchRes.ok) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "FETCH_URL_FAILED",
+                                message: `抓取 URL 失败，HTTP ${fetchRes.status}`,
+                                url,
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+            const html = await fetchRes.text();
+            // 提取标题
+            const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+            pageTitle = titleMatch
+                ? titleMatch[1].trim().replace(/\s+/g, " ")
+                : new URL(url).hostname;
+            // 提取正文（按 format 分支）
+            pageBody = extractAndCleanContent(html, format);
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "FETCH_URL_ERROR",
+                            message: `抓取 URL 时发生网络错误: ${err instanceof Error ? err.message : String(err)}`,
+                            url,
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const title = args?.title || pageTitle;
+        // ── 2. 追尾源链接（按 format 输出 markdown 或 html） ──
+        const finalBody = appendSourceLinkByFormat(pageBody, url, "原文", format);
+        // ── 3. 逐路径创建文档 ──
+        const results = [];
+        for (const path of paths) {
+            try {
+                const dirUuid = await ensureDirectoryPath(bookId, path);
+                if (!dirUuid) {
+                    results.push({ path, error: "目录创建失败" });
+                    continue;
+                }
+                const payload = { title, body: finalBody, format };
+                const data = await apiPost(`/repos/${bookId}/docs`, payload, `Import URL doc to ${path}`);
+                if (isErrorResult(data)) {
+                    const errMsg = data.content?.[0]?.text || "Unknown error";
+                    results.push({ path, error: errMsg });
+                    continue;
+                }
+                const newDoc = data.data;
+                if (!newDoc?.id) {
+                    results.push({ path, error: "文档创建返回无 ID" });
+                    continue;
+                }
+                // 挂到目录节点下
+                await apiPut(`/repos/${bookId}/toc`, {
+                    action: "appendNode",
+                    action_mode: "child",
+                    type: "DOC",
+                    doc_ids: [newDoc.id],
+                    target_uuid: dirUuid,
+                }, `Append doc to TOC: ${path}`);
+                results.push({ path, doc_id: newDoc.id, slug: newDoc.slug });
+            }
+            catch (err) {
+                results.push({ path, error: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        source_url: url,
+                        source_title: pageTitle,
+                        title,
+                        book_id: bookId,
+                        paths,
+                        results,
+                        total: results.length,
+                        success: results.filter((r) => r.doc_id).length,
+                        failed: results.filter((r) => r.error).length,
+                    }, null, 2) }],
+        };
+    },
+};
+// ─── 网页内容提取与清洗 ───────────────────────────────
+/** 按 format 追尾源链接：markdown 用 appendSourceLink，html 用 HTML 格式 */
+function appendSourceLinkByFormat(body, sourceUrl, sourceTitle, format) {
+    if (format === "html") {
+        const footer = `<hr>\n<blockquote>📋 源文档：<a href="${escapeHtml(sourceUrl)}">${escapeHtml(sourceTitle)}</a></blockquote>`;
+        return body + "\n" + footer;
+    }
+    return appendSourceLink(body, sourceUrl, sourceTitle);
+}
+function extractAndCleanContent(html, format) {
+    // 1. 移除噪音标签（script/style/nav/footer/header/aside/noscript/iframe）
+    let cleaned = html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<nav[^>]*>[\s\S]*?<\/nav>/gi, "")
+        .replace(/<footer[^>]*>[\s\S]*?<\/footer>/gi, "")
+        .replace(/<header[^>]*>[\s\S]*?<\/header>/gi, "")
+        .replace(/<aside[^>]*>[\s\S]*?<\/aside>/gi, "")
+        .replace(/<noscript[^>]*>[\s\S]*?<\/noscript>/gi, "")
+        .replace(/<iframe[^>]*>[\s\S]*?<\/iframe>/gi, "");
+    // 2. 优先提取 <article> 或 <main>
+    const articleMatch = cleaned.match(/<article[^>]*>([\s\S]*?)<\/article>/i);
+    const mainMatch = cleaned.match(/<main[^>]*>([\s\S]*?)<\/main>/i);
+    if (articleMatch)
+        cleaned = articleMatch[1];
+    else if (mainMatch)
+        cleaned = mainMatch[1];
+    // 3. format=html：保留 HTML 结构，只做噪音清理
+    if (format === "html") {
+        // 移除注释
+        cleaned = cleaned.replace(/<!--[\s\S]*?-->/g, "");
+        // 限制长度
+        if (cleaned.length > 100000) {
+            cleaned = cleaned.substring(0, 100000) + "\n<p>... (内容过长，已截断)</p>";
+        }
+        return cleaned.trim();
+    }
+    // 4. format=markdown：转为纯文本（保留链接并转 Markdown）
+    // 4a. 保留 <a href> 转为 [text](href)
+    cleaned = cleaned.replace(/<a[^>]*href\s*=\s*["']([^"']*)["'][^>]*>([\s\S]*?)<\/a>/gi, (_, href, text) => {
+        const cleanText = text.replace(/<[^>]+>/g, "").trim();
+        return cleanText ? `[${cleanText}](${href})` : "";
+    });
+    // 4b. 保留 <img> 转为 ![alt](src)
+    cleaned = cleaned.replace(/<img[^>]*alt\s*=\s*["']([^"']*)["'][^>]*src\s*=\s*["']([^"']*)["'][^>]*\/?>/gi, "![$1]($2)");
+    cleaned = cleaned.replace(/<img[^>]*src\s*=\s*["']([^"']*)["'][^>]*alt\s*=\s*["']([^"']*)["'][^>]*\/?>/gi, "![$2]($1)");
+    cleaned = cleaned.replace(/<img[^>]*src\s*=\s*["']([^"']*)["'][^>]*\/?>/gi, "![]($1)");
+    // 4c. 块级标签 → 换行
+    let text = cleaned
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n\n")
+        .replace(/<\/h[1-6]>/gi, "\n\n")
+        .replace(/<\/li>/gi, "\n")
+        .replace(/<\/div>/gi, "\n")
+        .replace(/<\/tr>/gi, "\n")
+        .replace(/<[^>]+>/g, "");
+    // 5. HTML 实体解码
+    text = text
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ");
+    // 6. 清理空白
+    text = text
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .join("\n");
+    // 7. 合并连续空行
+    text = text.replace(/\n{3,}/g, "\n\n");
+    // 8. 限制长度
+    if (text.length > 100000) {
+        text = text.substring(0, 100000) + "\n\n... (内容过长，已截断)";
+    }
+    return text;
+}
+//# sourceMappingURL=import-url.js.map

package/dist/doc/import-url.js.map

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

package/dist/doc/index.d.ts

@@ -0,0 +1,16 @@
+export { docList } from "./list-docs.js";
+export { docCreate } from "./create-doc.js";
+export { docGet } from "./get-doc.js";
+export { docUpdate } from "./update-doc.js";
+export { docDelete } from "./delete-doc.js";
+export { docVersions } from "./versions.js";
+export { docVersionDetail } from "./version-detail.js";
+export { docEmbedUrl } from "./embed-url.js";
+export { docBatchGet } from "./batch-get-docs.js";
+export { docExportSingle } from "./export-doc.js";
+export { docCopySingle } from "./copy-doc.js";
+export { docImportUrl } from "./import-url.js";
+export { docImportFile } from "./import-file.js";
+export { docDiff } from "./diff-doc.js";
+import type { McpTool } from "../common/types.js";
+export declare const docTools: McpTool[];