语雀连接器

要解决的问题

本地办公文件与语雀知识库之间缺少稳定、可重复的同步路径：Markdown、Word、Excel、CSV、JSON 等需要导入语雀；知识库、目录、小记又需要下载为本地 .md 便于编辑、备份和检索。人工复制粘贴容易出现格式丢失、目录散乱、限流失败难恢复等问题。

技能如何工作

该技能基于语雀 MCP 提供读写能力，核心围绕“导入、下载、整理、更新”四类操作：

• 导入本地文件：.md、.html 可直接导入；.docx、.xlsx、.csv、.txt、.json 读取后转成 Markdown；zip/文件夹可批量创建文档。
• 下载语雀内容：支持单篇文档、指定目录、整个知识库以及小记，输出为本地 .md 文件，并按 title 生成文件名。
• 知识库管理：可处理目录结构、文档搜索、文档更新、小记记录和 board 资源创建等进阶操作。
• 稳定性处理：批量下载有间隔等待，遇到 429、500 或网络超时时会按规则重试并报告失败详情。

适用边界与注意点

• 图片上传受 MCP 限制，外部图片 URL 可在 Markdown 中引用，通用附件需按语雀能力处理。
• 视频、音频等二进制文件通常更适合在语雀网页端上传。
• 需要配置有效的语雀 Token，并确认 MCP 服务可用；换环境后可能需重新写入本地配置。
• 批量操作涉及多篇文档时，应关注目录选择与限流提示，避免一次性请求过多。