前言¶
本地文档在知识库之间来回搬运时，往往需要手动复制粘贴，或者用第三方工具导出再导入，容易出错且流程繁琐。对于依赖语雀作为知识沉淀与协作平台的人来说，这种重复劳动消耗大量时间。
是什么¶
语雀连接器是 SkillHub 上由社区用户 user_c28beb7a 开发的一个 Skill，归类为 knowledge-management（知识管理）。它提供语雀知识库的双向同步能力，覆盖文档的导入与导出、搜索、创建、更新、目录管理等常见操作，并包含错误自动恢复和进阶用法。目前版本为 1.0.2。
核心功能¶
- 文件导入到语雀：支持 Word、Excel、Markdown、HTML、纯文本以及 zip 文件夹。上传时会自动识别文件类型，并按语雀的文档结构进行创建或更新。
- 文档下载到本地：从语雀知识库或指定文档下载内容到本地文件系统。
- 知识库与文档操作：支持对语雀知识库的搜索，创建新文档，更新已有文档，以及管理文档目录结构。
- 错误恢复与进阶用法：在操作过程中出现异常时，具备错误自动恢复机制，并提供进阶用法以应对复杂场景。
安装与启用¶
该 Skill 属于 community 来源，安装前需要提供 API Key。安装命令如下：
skill install @user_c28beb7a/yuque-connector
安装完成后，在对话中直接使用对应的触发词即可调用 Skill。
典型用法¶
- 导入本地文件到语雀：在对话中输入「导入语雀」或「上传语雀」，跟随系统提示提供本地文件路径或直接粘贴文件内容，Skill 会将其转换为语雀文档并保存到指定知识库或目录。
- 从语雀下载文档：输入「下载语雀」或「从语雀下载」，指定语雀文档的 URL 或知识库名称与文档路径，Skill 会将内容拉取到本地，并按格式保存。
- 创建或更新语雀文档：使用「发送到语雀」或「同步语雀」，提供文档标题与内容，Skill 会根据标题判断是创建新文档还是更新已有文档。
- 搜索与目录管理：输入「语雀知识库」或「语雀文档」，配合查询条件，可快速检索知识库中的内容或查看目录结构。
适用场景与注意¶
- 适合：需要频繁在本地与语雀之间同步文档的知识工作者、团队协作者，以及希望将语雀作为统一知识入口的开发者。
- 注意：使用前需提前准备好语雀的 API Key，并确保已获得目标知识库的访问权限。对于大体积文件或批量导入，建议分批处理以避免超时或限制。
结尾¶
语雀连接器通过 SkillHub 上的配置与触发词，将本地与语雀之间的同步流程自动化，减少重复操作，提升知识管理效率。官方地址：https://api.skillhub.cn/user_c28beb7a/yuque-connector
