Agent Skills
返回列表
📚

语雀双模式连接

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/acedatacloud-skills-yuque。

技能介绍

要解决什么问题

语雀上的知识库、文档往往只能通过网页或官方开放 API 访问,而 API 又要求超级会员的个人访问令牌;若你只想用本账号已有的浏览器登录态做查询和新建,和令牌模式下的整篇改写、删除混在一起,很容易在助手里猜错鉴权方式或误用只读连接去改文档。

本技能把语雀 CLI 的约定写清楚:凭据只注入一种($YUQUE_COOKIES 或 $YUQUE_TOKEN),每条命令用返回的 auth_mode 表明当前模式,而不是在对话里回显密钥。

技能如何工作

  • Cookie 模式:由 ACE 扩展采集的登录 Cookie,免费,走语雀内部 Web API;支持 whoami、repos、docs、doc、create。
  • 令牌模式:在 语雀令牌设置 创建的个人访问令牌,需语雀超级会员;在上述命令之外还支持 update、delete(整篇重写正文前应先 doc 拉取现有内容)。
  • 知识库定位:必须先执行 repos,把其输出的 repo_id 原样用于后续操作;不要猜测 user/book 命名空间或数字 id;Cookie 下只能匹配本账号拥有的知识库。
  • 创建文档:在本地准备好完整 Markdown 再创建;默认私密,仅在你明确要求且经 --confirm(且作为最后一个参数)时才 --public 发布;发布前应展示目标知识库、标题、可见性与全文。
  • Bash 调用:每次 fenced Bash 内都要先解析 helper,因为子 shell 不共享变量。

边界与注意点

Cookie 连接无法 update/delete;若用户要改删,应说明需超级会员令牌,并可提议新建文档而非绕道实现。写入若超时,结果未知,先用 docs 核对再重试,否则可能重复创建。响应里的 doc_id、url 必须用返回值;Cookie 下公开链可能为 null,只报 doc_id、不编造链接。外链图片语雀不会转存,防盗链站点需先在语雀内上传再引用。API 宜保持人工可接受的用量,避免大批量自动发布导致账号受限。确认公开发布且 url 非空时,才按技能要求调用 publish_artifact 记录交付;私密或失败/未知写入不记录。

使用场景

  • 助手需要先列出本账号下所有语雀知识库,再按用户指定的库拉取某篇文档正文做摘要
  • 用 ACE 采集的 Cookie 在私密知识库里新建一篇整理好的 Markdown 笔记,默认不公开
  • 用户明确要求公开对外发布时,先展示目标库、标题与全文,经确认后再以 --public 创建
  • 整篇修订或删除已有语雀文档时,改用超级会员个人令牌连接后再执行 update 或 delete

适合人员

  • 维护团队内部语雀知识库、需要把会议纪要写成新私密文档而非网页手贴的文档管理员
  • 在助理里对接语雀只读查询,且暂不开超级会员、依赖浏览器 Cookie 的研发或支持同学
  • 对外发布技术文章到语雀公开库、并需在交付后按 URL 登记发布记录的内容运营
  • 偶尔用令牌批量整理旧文档正文、必须整篇 update 前会先读当前 doc 的技术写作者