核心功能
index1-doctor 是专为 index1 知识库系统设计的自动化环境诊断工具。通过执行 index1 doctor、index1 status 和 ollama list 三条命令，全方位扫描运行环境的健康状态。
检测维度
| 类别 | 检测项 | 标准 |
|------|--------|------|
| 基础环境 | Python 版本 | ≥ 3.10 |
| 数据库 | SQLite 版本 | ≥ 3.43.0（不足时自动降级） |
| 向量扩展 | sqlite-vec | 已加载 |
| 本地嵌入 | ONNX + bge-small-en-v1.5 | 内置可用 |
| 可选服务 | Ollama 连通性 | 在线/离线状态 |
| 模型就绪 | 推荐模型安装 | nomic-embed-text / bge-m3 |
| 中文支持 | jieba 分词 | CJK 内容必需 |
| 索引状态 | 文档/分片数量 | 非空验证 |
显著优点
- 一键自动化：无需手动执行多条命令，智能串联诊断流程
- 精准修复指引：每个失败项对应明确解决方案，降低排障门槛
- 场景化触发：支持首次安装验证、升级后检查、搜索异常排查等多场景
局限性与风险
- 依赖外部 CLI：需预装 index1 和 Ollama 命令行工具
- 被动诊断：仅检测状态不自动修复，需用户手动执行建议命令
- 网络依赖：Ollama 模型检查需联网，离线环境会误报失败
- 版本敏感：升级后可能出现新不兼容项，需重新诊断
适合人群
- index1 新用户首次环境验证
- 升级版本后的回归测试
- 遇到搜索异常或向量检索失效的排障场景
- 提交 Issue 前的环境自检
安全评估
诊断命令均为只读操作（doctor、status、list），不修改系统配置或数据。但技能可能建议执行 pip install、ollama pull 等命令，用户需确认来源可信度。