index1 Doctor
Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.
Usage
Type /doctor or ask the agent to diagnose index1.
What it checks
The skill runs three commands sequentially and analyzes results:
1. Environment Check
CODEBLOCK0
Checks:
- - Python version (>= 3.10 required)
- SQLite version (>= 3.43.0 for full features)
- sqlite-vec extension
- ONNX embedding (built-in, bge-small-en-v1.5)
- Ollama connectivity (optional, for multilingual/CJK)
- Embedding model availability
- CJK/Chinese support (jieba)
2. Index Status
CODEBLOCK1
Shows:
- - Document count and chunk count
- Collections list
- Last index time
- Database size
3. Ollama Models
CODEBLOCK2
Shows installed models. Recommended embedding models:
- -
nomic-embed-text — Standard, 270MB - INLINECODE2 — Best for CJK content, 1.2GB
Interpreting Results
| Check | Pass | Fail Fix |
|---|
| Python | >= 3.10 | Install Python 3.11+ |
| SQLite |
>= 3.43.0 | Auto-degrades, no action needed |
| sqlite-vec | Loaded |
pip install index1 (bundled) |
| Ollama | Connected |
curl -fsSL https://ollama.com/install.sh \| sh |
| Model | Available |
ollama pull nomic-embed-text |
| CJK | jieba loaded |
pip install index1[chinese] |
| Index | Has documents |
index1 index ./src ./docs |
When to use
- - First-time setup verification
- After upgrading index1
- When search returns unexpected results
- When vector search stops working
- Before reporting issues
index1 Doctor
index1的环境诊断技能。运行健康检查并提供修复建议。
使用方法
输入/doctor或让代理诊断index1。
检查内容
该技能按顺序运行三个命令并分析结果：
1. 环境检查
bash
index1 doctor
检查项：
- - Python版本（需要>= 3.10）
- SQLite版本（需要>= 3.43.0以获得完整功能）
- sqlite-vec扩展
- ONNX嵌入（内置，bge-small-en-v1.5）
- Ollama连接（可选，用于多语言/CJK支持）
- 嵌入模型可用性
- CJK/中文支持（jieba）
2. 索引状态
bash
index1 status
显示：
- - 文档数量和分块数量
- 集合列表
- 最后索引时间
- 数据库大小
3. Ollama模型
bash
ollama list
显示已安装的模型。推荐的嵌入模型：
- - nomic-embed-text — 标准版，270MB
- bge-m3 — 最适合CJK内容，1.2GB
结果解读
| 检查项 | 通过条件 | 失败修复 |
|---|
| Python | >= 3.10 | 安装Python 3.11+ |
| SQLite |
>= 3.43.0 | 自动降级，无需操作 |
| sqlite-vec | 已加载 | pip install index1（已捆绑） |
| Ollama | 已连接 | curl -fsSL https://ollama.com/install.sh \| sh |
| 模型 | 可用 | ollama pull nomic-embed-text |
| CJK | jieba已加载 | pip install index1[chinese] |
| 索引 | 有文档 | index1 index ./src ./docs |
使用场景
- - 首次安装验证
- 升级index1后
- 搜索结果异常时
- 向量搜索失效时
- 报告问题前
