前言¶

团队把文档散在各人电脑上，语雀上又是另一份，两边版本经常对不上。改了本地 Word 或 Excel，要人工复制粘贴到语雀；想在本地留一份语雀文档的离线副本，也得手动导出。yuque-connector 这个 Skill 把这条路接上：本地文件可以导入语雀，语雀文档也可以下载回本地，中间的搜索、创建、更新、目录管理交给 Skill 完成。下面介绍它的能力、启用方式和适用边界。

这是什么¶

yuque-connector 是一个社区来源的语雀知识库双向同步技能，坐标 @user_15292d5a/yjkj-yuque-connector，版本 1.0.0，发布者 user_15292d5a，分类 knowledge-management，来源标记为 community。它解决的问题是本地文件与语雀知识库之间的搬运：把 Word、Excel、Markdown、HTML、文本以及 zip 文件夹导入语雀，反向也能从语雀把文档下载到本地，并覆盖搜索、创建、更新、目录管理等日常操作。

核心功能¶

1、本地文件导入语雀，支持 Word、Excel、Markdown、HTML、纯文本，以及 zip 文件夹（打包后整体导入）。
2、语雀文档下载到本地，用于留离线副本或做版本对比。
3、搜索、创建、更新、目录管理四类基础操作，覆盖知识库的日常维护。
4、错误自动恢复，导入或更新中途失败时不必从头再来。
5、进阶用法，官方简介中提到但未展开细节。

官方给出的触发词为：导入语雀、上传语雀、下载语雀、语雀知识库、语雀文档、发送到语雀、从语雀下载、yuque、传到语雀、同步语雀。在支持该 Skill 的客户端里用这些词触发即可。

安装与启用¶

该 Skill 遵循通用 SKILL.md 格式。需要在客户端中按 SKILL.md 方式引入，并把坐标填为 @user_15292d5a/yjkj-yuque-connector。

坐标：@user_15292d5a/yjkj-yuque-connector
版本：1.0.0

它带 requires_api_key=true 标签，启用前需要准备好语雀的 API Key 并在客户端中配置，否则调用会失败。具体的安装命令、配置字段名称与取值，在现有资料中没有给出；官方页面（见文末地址）在本文写作时无法访问，因此这里不臆造命令，请以 Skill 包内的 SKILL.md 为准。

不同客户端的接入方式有差异：Cursor、Codex CLI、Claude Code 各自读取 SKILL.md 的机制不同，但本 Skill 的资料未按客户端分别说明，故不在此分列，实际以包内文档为准。

典型用法¶

官方简介列出了三类典型操作，按触发词发起：

1、导入：把本地 Word、Excel、Markdown、HTML、文本文件或 zip 文件夹传到语雀，对应触发词「导入语雀」「上传语雀」「发送到语雀」「传到语雀」。
2、下载：从语雀把文档取回本地，对应「下载语雀」「从语雀下载」。
3、管理：在语雀知识库内搜索、创建、更新文档和调整目录结构，对应「语雀知识库」「语雀文档」「同步语雀」「yuque」。

适用场景与注意¶

适合个人或小团队把本地产出的文档批量落到语雀、以及需要语雀内容的本地副本时使用。单向导入和反向下载都能覆盖，但双向同步意味着同一批内容在两端都可能被修改，建议约定好「以哪端为准」，避免两边互相覆盖。

注意三点：一是必须配置 API Key，否则无法调用；二是它面向文档搬运，不替代语雀自身的权限体系，导入到哪个知识库、哪个目录仍需预先确定；三是 zip 文件夹导入会展开为多个文档，目录层级最好提前规划。

该 Skill 在 SkillHub 上评分 100000，下载 678 次，安装数显示为 0，来源为社区发布，采用前建议自行审一遍包内脚本再接入。

结尾¶

yuque-connector 的价值在于把本地与语雀之间的搬运动作收敛成一次触发，省掉人工复制粘贴和手动导出的来回。官方地址：https://api.skillhub.cn/user_15292d5a/yjkj-yuque-connector ，SkillHub 页面：https://www.skillhub.cn/skills/user_15292d5a/yjkj-yuque-connector 。