展开本页目录
开始前准备什么
- 将练习包解压到独立目录，不覆盖已有项目或真实业务资料。
- 先运行本包校验并查看实测范围，再按官方文档使用自己的软件、账号与准确版本。
- 需要真实模型的步骤只使用自己的 Key，截图与下载包不包含凭据。
- 检查六条原始记录
- 在测试 Khoj 索引笔记
- 先搜不带过滤的语句
- 添加 file 与日期区间
- 人工核对两条命中
- 需要问答时配置聊天模型
- 检查错日期与错文件负例
原创输入、运行脚本、字段校验、负例和执行范围；不含可用密钥。
已真实解析六条原创记录并验证日期、文件与负词条件；未运行 Khoj 服务、索引或模型。官方 search 图标明来源。
对应正文的具体资料，保持输入可追溯。
验证字段与负例；不能代替未执行的软件或模型。
明确区分材料验证、框架执行和模型调用。
1. 检查六条原始记录
两份 Markdown 中共六条虚构日记，明确记录日期、项目和正文。日期是正文 YYYY-MM-DD，不是磁盘修改时间。
bash
python3 verify.py
2. 在测试 Khoj 索引笔记
使用自己的自托管实例，将 notes/ 目录加入资料。首次索引需下载或调用搜索 embedder；不要把聊天模型设置当索引已经完成。
3. 先搜不带过滤的语句
搜索“展览设备检查”并记录结果，回读 source。官方 search 截图只展示入口，不是我们的日记检索结果。
4. 添加 file 与日期区间
复制 query.txt，按官方语法组合 file、dt>= 与 dt<=。October 旧外记录和另一文件应被排除；负词“撤销”进一步排除一条已作废记录。
5. 人工核对两条命中
预期为 lake-project.md 中 10 月 03 日、10 月 12 日两条有效记录。真实 Khoj 搜索输出须自己保存；离线筛选结果只是原文条件基线。
6. 需要问答时配置聊天模型
自托管管理员可增加 OpenAI-compatible API 与 Chat Model。Cloud 官方限制第一方模型，不能声称云账号也能改 apizt Base URL；Embedding 与聊天地址分开。
7. 检查错日期与错文件负例
verify.py 会验证 9 月记录、other-project.md 与带撤销条目均被排除。保存实际 source 与过滤语句，不由模型一句自报确认过滤正确。
bash
python3 verify.py
怎样确认已经完成
- 自托管管理员可增加 OpenAI-compatible API 与 Chat Model。Cloud 官方限制第一方模型，不能声称云账号也能改 apizt Base URL；Embedding 与聊天地址分开。
- verify.py 会验证 9 月记录、other-project.md 与带撤销条目均被排除。保存实际 source 与过滤语句，不由模型一句自报确认过滤正确。
- 已真实解析六条原创记录并验证日期、文件与负词条件；未运行 Khoj 服务、索引或模型。官方 search 图标明来源。
常见问题
日期过滤依据文件修改时间吗？
本例按官方 query filters 的文本日期范围工作，输入正文包含 YYYY-MM-DD。不要把它解释成文件系统 mtime 条件。
Khoj Cloud 可以用自己的兼容 API 吗？
当前官方说明 Cloud 限第一方模型；自托管才能按 OpenAI proxy 指南设置。