适用对象：要把语雀知识库、文档与小记带进对话的用户。授权使用官方 Token，不嵌 iframe。
1. 模块定位与亮点
语雀连接器按你申请的 Token 权限范围，搜索与阅读文档、列知识库与目录、新建或更新文档，以及读写小记。企业空间团队 Token 可填空间域名。
亮点可以记三条：
- 凭证按用户写在本机连接器目录，接口只回脱敏。
- 保存前会向语雀校验 Token，无效不会落盘。
- 删除知识库或文档等高风险操作，须你明确确认后才会执行。
2. 能做什么
搜文档/知识库、列知识库、看目录、读正文、新建与更新文档、读写小记。
3. 从哪进
连接器 → 语雀。
4. 全流程概览
打开卡片 → 点连接 → 官方页申请 Token → 贴回并可选填空间域名 → 加号挂载 → 搜 / 读 / 写
5. 分步操作
- 打开语雀卡片，先看介绍，再点 连接。
- 在旁边弹出的官方窗口申请 Token（个人设置 → Token），复制后贴回；企业空间团队 Token 再填空间域名。
- 加号挂载语雀。
- 用自然语言搜文档、列知识库或要求写进语雀。
6. 页面结构说明
货架卡片 + 官方 Token 页（独立窗口）+ 本轮开关。禁止把语雀页嵌进 iframe。
7. 常见问题
Q：个人 Token 和企业空间有什么区别？
A：个人 Token 默认连 www.yuque.com；绑定空间的团队 Token 须填写对应空间域名，否则会鉴权失败。
Q：贴了 Token 仍提示无效？
A：确认完整复制、未过期；企业空间 Token 是否填对域名。硬刷新后再试。
Q：会不会自动改我语雀里的文档？
A：只有你明确要求新建或更新时才会写；删除类操作必须先确认。
8. 流程简表
| 步骤 | 操作 | 结果 |
|---|---|---|
| 1 | 申请并贴回 Token | 卡片显示已连接 |
| 2 | 加号挂本轮 | 可调用语雀工具 |
| 3 | 搜 / 读 / 写 | 按 Token 权限执行 |
文档版本：V1.0
编写单位：遇碳科技产品团队
最后更新：2026年8月