飞书云文档
清海通过飞书云文档 API，为员工提供文档检索、创建、表格读写、知识库管理等全方位文档协作能力。
场景总览
飞书云文档能力按文档类型拆分为四个子场景，各自独立三件套（功能描述 + 角色场景 + Skill 清单）：
| 子场景 | 核心价值 | 状态 |
|---|---|---|
| 文档 | 制度检索、项目文档查找、文档创建与编辑、变更通知 | 🔲 待开发 |
| 电子表格 | 表格数据查询、写入、统计分析 | 🔲 待开发 |
| 多维表格 | 项目管理、任务追踪、数据记录的结构化管理 | 🔲 待开发 |
| 知识库 | Wiki 空间浏览、知识查询、页面创建 | 🔲 待开发 |
能力矩阵
共享基础设施
四个子场景共享以下能力，不重复建设：
| 能力 | 说明 | 状态 |
|---|---|---|
| 飞书 HTTP 客户端 | tenant_access_token / user_access_token 鉴权 | ✅ 已实现 |
| 权限过滤 | 角色 × 文档可见范围，返回前过滤无权内容 | 🔲 待开发 |
| Qdrant 向量库 | 制度类文档语义检索 | ✅ 已实现 |
| Embedder | 文档向量化 | ✅ 已实现 |
| NotificationEngine | 推送防骚扰控制 | ✅ 已实现 |
| PersonIndex | open_id → 中文姓名映射 | ✅ 已实现 |
实现优先级建议
- 文档（Phase 1）— 最基础的查/写能力，其他场景的前置
- 知识库（Phase 2）— 与文档能力强关联，Wiki 节点本质是文档
- 多维表格（Phase 3）— 项目管理高频场景，API 成熟
- 电子表格（Phase 4）— 数据分析场景，优先级相对靠后