核心功能
index1-doctor 是 Index1 生态系统的官方环境诊断技能，通过执行 /doctor 指令触发三级健康检查：
1. 环境检查：验证 Python ≥3.10、SQLite ≥3.43.0、sqlite-vec 扩展加载状态
2. 索引状态：统计文档/分块数量、集合列表、数据库容量
3. Ollama 集成：检测服务连通性，推荐 nomic-embed-text（通用）或 bge-m3（CJK优化）
显著优点
- 一站式诊断：单次调用覆盖完整依赖链，避免手动逐项排查
- 智能降级提示：SQLite 版本不足时自动说明功能受限范围，不中断流程
- 精准修复指引：每项检查失败均附带官方安装命令，降低运维门槛
- 中文场景优化：专项检测 jieba 分词组件，针对中文内容推荐 bge-m3 模型
潜在局限
- 被动检测为主：仅能识别已部署组件状态，无法自动修复（需用户执行建议命令）
- Ollama 依赖限定：当前仅支持 Ollama 后端，未覆盖其他推理框架（如 vLLM、TGI）
- 网络诊断薄弱：若 Ollama 连接失败，无法区分本地服务未启动 vs 防火墙阻断
- Windows 兼容性：部分修复命令（如
curl | sh）需手动适配 PowerShell 环境
适用人群
- Index1 新用户首次部署验证
- 升级版本后排查兼容性问题
- 搜索异常时快速区分「索引损坏」与「模型缺失」
- 提交 Issue 前生成环境报告
常规风险
- 信息泄露：
index1 status输出包含文档数量、集合名称等元数据，分享日志时需脱敏 - 命令注入：技能执行系统命令（
index1 doctor,ollama list），需确保 Index1 CLI 本身可信 - 自动升级风险：建议的
pip install可能引入大版本变更，生产环境建议先测试
---
版本：2.0.1 | 协议：Apache-2.0 | 作者：gladego