语雀知识库双向同步

解决什么问题

语雀知识库常与本地 Markdown、Office 表格或批量导出文件分散，手动复制粘贴会丢失结构。该技能把本地文件导入语雀，也可把语雀文档、知识库、目录或小记下载为本地 Markdown，适合做知识迁移、备份和二次编辑。

核心能力与工作方式

技能基于 yuque-mcp 调用语雀 API，常见流程包括：读取本地文件、转换为 Markdown/HTML、创建或更新文档；下载时调用 yuque_get_doc 保存文件，批量下载时先获取目录，再逐篇抓取。导入支持 .md、.docx、.xlsx、.html、.txt、.csv、.json 以及压缩包/文件夹；Excel 多工作表会拆成多篇文档。下载支持单篇、整个知识库、指定目录和小记，默认输出 .md。进阶能力包括目录整理、文档搜索引用、文档更新、小记和 Board 资源创建。请求会处理 429 限流和 500 异常，按间隔重试并报告失败。

适用边界

图片附件、音视频等二进制文件不支持直接上传，需要外部图片 URL 或网页端处理；yuque_create_resource 仅支持 board 类型。语雀 Token 与本地 MCP 配置与设备相关，换机后需重新配置。批量任务受接口限流影响，下载会插入等待，避免一次性触发 429。