一、DeepSeek Harness 是什么
DeepSeek Harness（命令 dsh） 是 DeepSeek 开源的智能体框架，采用「一切皆插件」（everything-is-a-plugin）架构。它内置 Web UI，也支持命令行与 SDK 方式运行，适合让 AI 在你的工作区里读文件、改代码、执行任务。
二、启动 Web UI
需要先安装 Node.js，然后执行：
npx @deepseek-ai/dsh web该命令默认在 http://127.0.0.1:3080 启动 Web UI 并自动打开浏览器。不想自动打开可加 --no-open。从源码运行则：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install && pnpm run build
pnpm dsh web三、将模型指向本站网关
打开 Web UI → Settings → Models → Add a custom provider，填写：
Provider ID : jizhi
Base URL : https://www.azztimes.com
API 协议 : OpenAI Compatible（openai-completions）
API Key : sk-你的密钥
模型 : claude-sonnet-5（OpenAI 端点用 https://www.azztimes.com/v1，Gemini 端点用 https://www.azztimes.com/v1beta，可按需新增多个 Provider。）
也可以在 settings.yaml 中配置
llm-pi-ai:
providers:
jizhi:
apiKeyEnv: JIZHI_API_KEY
api: openai-completions
baseURL: "https://www.azztimes.com"
models:
- id: claude-sonnet-5保存后在模型选择器中选中该模型，即可开始会话。
四、选择工作区并运行任务
启动后点击 Choose workspace，选择你在其中启动 dsh 的项目目录；选中工作区后即可新建会话，例如发送「总结这个仓库并列出主要包」。框架会在需要授权时征求你的同意。
五、常见问题排查
| 现象 | 处理 |
|---|---|
| 401 | 密钥无效；检查 API Key，或在 Models 页重新填写、暴露对应的环境变量。 |
| UNKNOWN_MODEL | 模型未配置或不匹配；在自定义 Provider 的模型列表中加入精确 slug。 |
| 网关拒绝 | 请求结构与 OpenAI 不完全一致时，可在 route 上配置 compat.supportsDeveloperRole: false 与 compat.maxTokensField: max_tokens。 |
安全建议：sk- 密钥勿写进公开仓库，建议通过环境变量引用；智能体任务量较大，注意余额与用量。