快速上手
约 10 分钟 启动 UI 并跑通首个任务。
目标
完成一次 安全首环:UI 起来 → 配好模型 → 选好工作区 → 提示有回复 → 能看工具轨迹。
分步操作
1. 用上一章的 npx @deepseek-ai/dsh web 启动。
2. 浏览器打开 http://127.0.0.1:3080/。
3. 进入 设置 → 模型,填入 DeepSeek API Key 并选模型。密钥不要提交到 git。
4. 选择工作区——建议用可重置的示例仓库。
5. 发送低风险任务:例如「列出顶层文件」或「用五点总结 README」。
6. 观察工具调用。若出现过宽操作(如删库类风险),立刻停止并收紧权限。
成功标准
- 预期端口可打开 UI。
- 模型配置能保存。
- 工作区路径符合预期。
- Agent 回答合理,工具轨迹看起来是故意的。
常见失败
| 现象 | 排查 |
|------|------|
| 端口占用 | 3080 上已有进程;结束进程或按上游文档改端口 |
| API 报错 | 密钥、模型 ID、官方平台额度 |
| 看不到文件 | 工作区根目录选错 / 系统权限不足 |
下一步
阅读 核心架构:一切皆插件,理解换工具为何不必 fork 核心。
继续学习 DeepSeek Harness
本章提到扩展时,可回到安装步骤、查看运行模式,或打开插件目录。