核心用法
Index1 Doctor 是一款环境诊断技能，通过执行三条核心命令完成全面检测：
1. `index1 doctor` — 环境检查：验证 Python ≥3.10、SQLite ≥3.43.0、sqlite-vec 扩展、Ollama 连接状态、嵌入模型可用性及中文分词支持
2. `index1 status` — 索引状态：查看文档数量、分块统计、集合列表、最后索引时间及数据库大小
3. `ollama list` — 模型清单：列出已安装的 Ollama 模型
显著优点
- 一键诊断：单条指令触发完整环境扫描，无需手动逐项验证
- 智能修复指引：检测结果以表格形式清晰标注「通过/失败」状态，附带针对性修复命令
- 中文场景优化：专门检测 CJK/中文分词支持（jieba），推荐
bge-m3模型处理中文内容 - 轻量嵌入模型：推荐
nomic-embed-text仅 270MB，适合资源受限环境
潜在缺点与局限性
- 被动诊断：仅识别问题，不自动修复，仍需用户手动执行建议命令
- 版本锁定依赖：严格依赖 Python ≥3.10 和 SQLite ≥3.43.0，老旧系统可能无法升级
- Ollama 强耦合：向量功能完全依赖外部 Ollama 服务，未安装则核心功能不可用
- 平台覆盖未知：文档未明确支持 Windows/Linux/macOS 的具体差异
适合人群
- 首次部署 index1 的新用户
- 升级 index1 版本后的兼容性验证
- 搜索异常或向量检索失效时的故障排查
- 准备提交 issue 前的环境自检
常规风险
- 误操作风险：修复建议中包含
curl | sh等管道安装命令，需确认来源可信 - 模型下载流量：首次拉取
bge-m3（1.2GB）可能消耗较多带宽和存储 - Python 环境冲突：升级 Python 可能影响系统其他依赖项目
- 诊断盲区：不检查 GPU 可用性或网络代理配置，可能遗漏实际运行障碍