index1 Doctor

核心用法

index1-doctor 是一款环境诊断技能，用户可通过输入 /doctor 指令或主动请求诊断，让 Agent 执行三步检测流程：运行 index1 doctor 检查基础环境（Python ≥3.10、SQLite ≥3.43.0、sqlite-vec 扩展、Ollama 连通性、嵌入模型可用性及 CJK 支持），执行 index1 status 查看文档数、分块数、集合列表与数据库大小，最后调用 ollama list 列出已安装模型。诊断结果以结构化表格呈现，失败项配有明确修复命令。

显著优点

• 自动化程度高：三步命令顺序执行，无需用户手动逐条输入
• 问题覆盖全面：从 Python 运行时到向量扩展、从本地模型到中文分词组件，涵盖 index1 全链路依赖
• 修复指引即时：每项检测失败均提供对应安装/升级命令，降低排障门槛
• 场景化触发：明确列出首次设置、升级后、搜索结果异常、向量检索失效及提报 Issue 前五大使用场景

潜在缺点与局限性

• 依赖外部命令：需预装 index1 CLI 与 ollama，若未在 PATH 中则诊断失败
• 被动诊断模式：仅检测已安装组件，无法自动下载或修复缺失依赖，仍需用户手动执行建议命令
• 平台假设：示例命令偏向 Unix-like 系统（curl | sh），Windows 用户需自行转换
• 版本锁较严：Python 3.10+ 与 SQLite 3.43.0 为硬性门槛，旧系统可能无法直接满足

适合人群

• 初次部署 index1 的新用户进行环境验收
• 升级 index1 后验证兼容性
• 遇到搜索结果异常或向量检索失效时的快速自查
• 向社区报告 Issue 前收集环境信息的开发者

常规风险

• 信息泄露风险：index1 status 与 ollama list 会暴露本地模型清单、文档数量及数据库路径，若输出被记录至日志或分享至公共平台，可能间接披露内部项目规模
• 命令注入隐患：虽诊断脚本固定，但若 Agent 实现不当、将用户输入直接拼接入命令参数，存在理论上的注入风险
• 网络依赖：Ollama 连通性检测需访问本地 11434 端口，若防火墙或代理配置不当可能产生误报
• 误操作引导：修复命令中部分涉及系统级安装（如 Ollama 脚本、Python 升级），新手用户直接复制执行可能影响其他环境