Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.
he build-index
为知识库构建或重建向量搜索索引。
概要
he build-index KA_PATH [OPTIONS]
参数
| 参数 | 描述 |
|---|---|
KA_PATH |
知识库目录的路径 |
选项
| 选项 | 简写 | 描述 |
|---|---|---|
--force |
-f |
即使索引存在也强制重建 |
描述
为语义搜索和聊天功能构建向量搜索索引:
- 读取所有实体/关系 — 从知识库数据中
- 生成嵌入 — 使用配置的嵌入模型
- 构建 FAISS 索引 — 用于快速相似度搜索
- 保存到磁盘 — 在
index/子目录中
必需用于:he search 和 he talk 命令。
示例
构建索引
he build-index ./output/
输出:
Template: general/biography_graph
Language: en
Success! Index built for ./output/
Now you can:
he search ./output/ "关键词" # Semantic search
he talk ./output/ -i # Interactive chat
强制重建
如果索引损坏或您想重建:
he build-index ./output/ -f
何时构建索引
Parse 后(默认)
默认情况下,he parse 会自动构建索引:
he parse doc.md -t general/biography_graph -o ./ka/ -l zh
# 索引自动构建
如果不需要搜索/聊天,使用 --no-index 跳过:
he parse doc.md -t general/biography_graph -o ./ka/ -l zh --no-index
Feed 后
喂养新文档后始终重建:
he feed ./ka/ new_doc.md
he build-index ./ka/
手动更改后
如果您手动修改了 data.json:
he build-index ./ka/ -f
索引存储
索引存储在知识库目录中。布局取决于 Auto-Type:
AutoModel / AutoList(自 v0.10.1 起为无 pickle 的 JSON):
./ka/
├── data.json
├── metadata.json
└── index/
└── index.json # 向量 + 文档,无 pickle
图谱家族 / AutoSet / AutoDocument(仍由 OMem 落盘,不是 v0.10.1 的 JSON 路径):
./ka/
├── data.json
├── metadata.json
└── index/
├── index.faiss # FAISS 向量索引
└── docstore.json # 文档存储映射
请只加载自己生成或完全信任的知识库目录中的 index/。对 AutoModel / AutoList,v0.10.1+ 写入 index.json 并在加载时不执行代码;<= v0.10.0 残留的 index.faiss / index.pkl 加载时仍会反序列化——用 --force 重建即可迁移。图谱 / set / document 索引仍走 OMem,因此这条信任警告仍然成立。
性能
构建时间
| 知识库大小 | 预计构建时间 |
|---|---|
| 小型(< 100 项) | < 5 秒 |
| 中型(100-1000) | 5-30 秒 |
| 大型(1000+) | 30+ 秒 |
搜索速度
一旦构建完成,搜索非常快:
he search ./ka/ "查询" # 通常 < 1 秒
最佳实践
- Feed 后构建 —
he feed后索引会变旧 - 批量处理使用
--no-index— 所有解析后统一构建一次 - 有问题时强制重建 — 如果搜索返回意外结果,使用
-f - 备份大型索引 —
index/目录可能很大
批量工作流程
高效处理多个文档:
# 解析所有文件,不构建索引
he parse doc1.md -t general/biography_graph -o ./ka/ -l zh --no-index
he feed ./ka/ doc2.md
he feed ./ka/ doc3.md
# 最后统一构建索引
he build-index ./ka/
# 现在可以进行搜索/聊天
he search ./ka/ "查询"
he talk ./ka/ -q "问题"
故障排除
"索引已存在"
使用 -f 强制重建:
he build-index ./ka/ -f
"索引构建失败"
检查:
- 知识库有数据:
he info ./ka/ - API 密钥已配置:
he config show - 有足够的磁盘空间存储索引
搜索仍然不工作
尝试强制重建:
he build-index ./ka/ -f