知识库
wesclaw 内置知识库系统,让 AI 在对话中检索和引用你上传的文档。
什么是知识库
知识库将你提供的文档转化为 AI 可以搜索和引用的知识:
- 上传文档后自动分块索引
- AI 对话中按需语义搜索
- 支持多种文档格式
文档管理
上传文档
在知识库界面上传文件:
| 格式 | 说明 |
|---|---|
| 技术文档、手册 | |
| Markdown | 笔记、指南 |
| 纯文本 | 配置说明 |
| Word | 报告、方案 |
本地路径导入
也可以从本地路径导入文档(不移动原文件):
"导入 ~/Documents/工作手册/ 目录下的所有文档"
文件状态
| 状态 | 含义 |
|---|---|
| Ready | 已索引,可检索 |
| Processing | 正在处理中 |
| Quarantined | 被隔离(含安全敏感内容) |
搜索与检索
语义搜索
知识库支持语义理解的搜索:
用户:"我们的报销流程是什么?"
AI 行为:
1. 语义搜索知识库
2. 找到《员工手册》中的报销章节
3. 引用具体段落回答
AgenticRAG
AI 在需要时主动检索知识库:
- 不是每次对话都搜索
- 只有相关问题才触发
- 搜索结果作为参考注入
数据源管理
查看数据源
在知识库界面查看:
- 数据源列表
- 每个源的文件数量
- 索引状态和统计
数据源操作
| 操作 | 说明 |
|---|---|
| 添加 | 上传或导入新文档 |
| 删除 | 移除数据源 |
| 重建索引 | 强制重新索引 |
Agent 绑定
指定 Agent 的知识
将知识文件绑定到特定 Agent:
"把《法律合规手册》绑定给法务 Agent"
效果:
- 法务 Agent 搜索时优先搜索这些文件
- 其他 Agent 也能搜索到,但不优先
绑定管理
- 查看文件绑定的 Agent
- 添加或解除绑定
- 查看 Agent 可访问的文件
安全扫描
内容过滤
上传的文件会经过安全扫描:
- 检测 PEM 格式的私钥材料
- Per-chunk 过滤(不是整文件隔离)
- 含敏感内容的 chunk 被跳过,其余正常索引
隔离文件
被隔离的文件:
- 可以手动解除隔离
- 解除后重新索引
- 原文件不受影响
Per-Cell 隔离
数据归属
知识库数据属于当前 Cell:
- 个人 Cell 的知识库独立
- 切换 Cell 时知识库跟着切换
- 导出 Cell 时包含知识库
存储位置
~/Library/Application Support/wesclaw/
cells/main/
knowledge/ ← 知识库索引数据
最佳实践
文档组织
| 建议 | 说明 |
|---|---|
| 按主题分类 | 一个数据源对应一个主题 |
| 保持更新 | 文档变更后重新索引 |
| 适当粒度 | 不要上传过大的文件 |
| 清晰标题 | 文档标题要有意义 |
不适合的内容
- 频繁变化的数据(用数据库替代)
- 超大文件(拆分后再上传)
- 代码文件(用 CKG 替代)
- 临时笔记(用记忆替代)
注意事项
- 知识库索引存储在本地
- 删除知识库索引不删原始文件
- 大文件自动分块索引
- 索引更新需要重新处理
- 含私钥材料的块被自动跳过