zhaixin244-wq DeepTutor Setup
任务
检测 DeepTutor 部署状态，未部署时自动完成安装配置。确保 deeptutor CLI 可用且 API key 已配置。
前置条件
| 条件 | 检测命令 | 说明 |
|---|---|---|
| Python 3.11+ | python --version |
后端运行时 |
| Git | git --version |
克隆仓库（仅首次） |
| 网络连接 | ping github.com |
下载依赖 |
执行步骤
Step 1: 检测部署状态
按以下顺序检测，记录每步结果：
# 1.1 检测 DeepTutor 目录是否存在
ls .claude/tools/DeepTutor/
# 1.2 检测 Python venv 是否存在
ls .claude/tools/DeepTutor/.venv/Scripts/python.exe 2>/dev/null && echo "VENV_OK" || echo "VENV_MISSING"
# 1.3 检测 deeptutor CLI 是否可用
.claude/tools/DeepTutor/deeptutor.bat --help 2>/dev/null && echo "CLI_OK" || echo "CLI_MISSING"
# 1.4 检测 .env 是否存在且已配置 API key
cat .claude/tools/DeepTutor/.env 2>/dev/null | grep -c "YOUR_.*_API_KEY_HERE" && echo "KEY_MISSING" || echo "KEY_CONFIGURED"
状态判定：
| 状态 | 条件 | 动作 |
|---|---|---|
| ✅ 完全就绪 | 目录 + venv + CLI + API key 均存在 | 跳到 Step 5 输出报告 |
| ⚠️ 部分就绪 | 目录存在但 venv/CLI/key 缺失 | 从缺失步骤开始 |
| ❌ 未部署 | 目录不存在 | 从 Step 2 开始完整部署 |
Step 2: 克隆仓库（如目录不存在）
cd .claude/tools/ && git clone https://ghfast.top/https://github.com/HKUDS/DeepTutor.git 2>&1
镜像备选（ghfast.top 失败时）：
https://gitclone.com/github.com/HKUDS/DeepTutor.githttps://hub.gitclone.com/github.com/HKUDS/DeepTutor.git- 直连：
https://github.com/HKUDS/DeepTutor.git
超时：120 秒。超时后尝试下一个镜像。
Step 3: 安装依赖（如 venv/CLI 不存在）
cd .claude/tools/DeepTutor
# 创建 venv
python -m venv .venv
# 激活 venv 并安装
source .venv/Scripts/activate && pip install -e ".[server]" 2>&1 | tail -10
超时：300 秒。使用清华 PyPI 镜像加速。
验证：
.claude/tools/DeepTutor/deeptutor.bat --help
Step 4: 配置 .env（如 API key 未配置）
cd .claude/tools/DeepTutor && cp .env.example .env
默认配置（LLM + Embedding）：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| LLM_BINDING | xiaomi_mimo |
小米 MIMO |
| LLM_MODEL | mimo-v2.5-pro |
模型名 |
| LLM_HOST | https://api.xiaomimimo.com/v1 |
API 端点 |
| EMBEDDING_BINDING | siliconflow |
硅基流动 |
| EMBEDDING_MODEL | BAAI/bge-large-zh-v1.5 |
中文向量模型 |
| EMBEDDING_HOST | https://api.siliconflow.cn/v1/embeddings |
Embedding 端点 |
| EMBEDDING_DIMENSION | 1024 |
向量维度 |
API key 提示：输出提示信息，要求用户填写：
请编辑 .claude/tools/DeepTutor/.env，填写以下 API key：
- LLM_API_KEY：MIMO 平台 API key
- EMBEDDING_API_KEY：硅基流动 API key
Step 5: 输出部署报告
## DeepTutor 部署报告
| 检查项 | 状态 | 详情 |
|--------|------|------|
| 仓库目录 | ✅/❌ | `.claude/tools/DeepTutor/` |
| Python venv | ✅/❌ | `.claude/tools/DeepTutor/.venv/` |
| CLI 可用 | ✅/❌ | `deeptutor --help` |
| .env 配置 | ✅/❌ | API key 已配置/待配置 |
| LLM 连通性 | ✅/❌/⏭️ | `deeptutor config show` |
| Embedding 连通性 | ✅/❌/⏭️ | 需 API key 配置后验证 |
**CLI 路径**：`.claude/tools/DeepTutor/deeptutor.bat`
**知识库目录**：`.claude/tools/DeepTutor/data/knowledge_bases/`
异常处理
| 场景 | 触发条件 | 处理动作 |
|---|---|---|
| Git 克隆失败 | 网络不通/镜像超时 | 尝试备选镜像，全部失败提示用户手动下载 |
| pip 安装失败 | 依赖冲突/网络超时 | 使用 --no-deps 降级安装，报告缺失依赖 |
| CLI 启动报错 | 缺少模块 | pip install {missing_module} 逐个补装 |
| .env 格式错误 | 编辑导致格式异常 | 重新从 .env.example 复制，保留已填 key |
| Python 版本不满足 | < 3.11 | 提示用户升级 Python |
检查点
- Step 1 后：输出检测结果，确认需要执行的步骤
- Step 3 后：验证 CLI 可用，输出
--help结果 - Step 4 后：提醒用户填写 API key（如未填写）
- Step 5 后：输出完整部署报告
使用示例
Agent：调用 Skill("deeptutor-setup")
# 输出：
## DeepTutor 部署检测
| 检查项 | 状态 |
|--------|------|
| 仓库目录 | ✅ 存在 |
| Python venv | ✅ 存在 |
| CLI 可用 | ✅ 正常 |
| .env 配置 | ⚠️ API key 待填写 |
CLI 已就绪，API key 需要配置后才能使用 DeepTutor 研究功能。