知识库
员工用自然语言浏览和查询飞书知识库（Wiki），查找公司沉淀的知识和规范；支持在知识库中创建新页面。
背景与现状
| 维度 | 现状 |
|---|---|
| 使用场景 | 公司 Wiki 知识库存放产品手册、技术文档、流程规范、新人指南等 |
| 当前痛点 | 知识库层级深，新员工不知道怎么找，老员工记不住在哪个空间 |
| 清海角色 | 帮员工"问知识库"，用自然语言检索 Wiki 内容，帮员工在知识库中创建页面 |
场景概览
场景一：知识查询
核心价值：不用翻 Wiki 层级目录，直接问清海。
典型对话
| 用户说 | 清海做 |
|---|---|
| "我们的代码规范是什么" | 在技术 Wiki 中语义检索，返回规范要点 + 链接 |
| "新人入职流程有哪些步骤" | 在 HR Wiki 中检索入职指南，摘出关键步骤 |
| "XX 产品的用户手册在哪" | 搜索知识库，返回匹配的 Wiki 页面链接 |
| "帮我找一下关于 API 鉴权的文档" | 在技术文档空间中检索，列出匹配页面 |
数据流转
场景二：目录浏览
核心价值：快速了解知识库结构，不用打开飞书翻层级。
典型对话
| 用户说 | 清海做 |
|---|---|
| "公司有哪些知识库空间" | 列出所有知识空间（名称 + 描述） |
| "技术文档空间下有哪些内容" | 列出指定空间的一级节点 |
| "帮我看看 XX 目录下有什么" | 列出指定节点的子节点 |
场景三：创建 Wiki 页面
核心价值：口述内容，清海在知识库中创建结构化页面。
典型对话
| 用户说 | 清海做 |
|---|---|
| "在技术文档空间下创建一个 XX 的设计文档" | 在指定空间/节点下创建 Wiki 页面 |
| "把刚才讨论的内容整理到知识库" | 根据对话内容生成文档，创建 Wiki 页面 |
数据流转
权限规则
| 角色 | 可访问范围 |
|---|---|
| 老板 | 所有知识空间 |
| 部门负责人 | 公司公开空间 + 本部门知识空间 |
| 普通员工 | 公司公开知识空间 + 本人有权限的空间 |
越权处理： 同文档场景，返回引导提示。
边界与约束
| 约束 | 处理方式 |
|---|---|
| Wiki 页面内容超长 | 仅引用相关段落回答，附原文链接 |
| 知识库层级深 | 最多展示 3 层节点，更深层引导用户点击查看 |
| 创建页面无空间权限 | 「我没有这个知识空间的写入权限，需要管理员配置」 |
| 知识库索引未同步 | 回答时注明「内容来自 {最后同步时间}」 |
所需飞书 API 权限
| API | 用途 | 权限 scope |
|---|---|---|
GET /wiki/v2/spaces | 获取知识空间列表 | wiki:wiki:readonly |
GET /wiki/v2/spaces/{space_id}/nodes | 获取空间下节点列表 | wiki:wiki:readonly |
GET /wiki/v2/spaces/get_node | 获取节点详情 | wiki:wiki:readonly |
POST /wiki/v2/spaces/{space_id}/nodes | 创建 Wiki 节点 | wiki:wiki |
POST /docx/v1/documents | 创建文档（Wiki 页面底层是文档） | docx:document |
实现路线
| # | 事项 | 状态 |
|---|---|---|
| 1 | 飞书 Wiki API 封装（列空间、列节点、获取节点） | 🔲 待开发 |
| 2 | 知识库内容向量索引（定期同步到 Qdrant） | 🔲 待开发 |
| 3 | search_wiki Tool（语义检索知识库内容） | 🔲 待开发 |
| 4 | list_wiki_nodes Tool（浏览空间/节点目录） | 🔲 待开发 |
| 5 | create_wiki_page Tool（创建 Wiki 页面） | 🔲 待开发 |
| 6 | feishu_wiki SKILL.md | 🔲 待开发 |