第24章 DeepSeek Harness

DeepSeek Harness 是 DeepSeek 开源的 AI Agent 框架，支持 Web UI 和命令行两种模式。通过阿里云百炼，可以使用按量计费、Coding Plan、Token Plan 个人版或 Token Plan 团队版接入 DeepSeek Harness。 ​安装 DeepSeek Harness 安装 Node.js（v22.19.0 或 v24.0.0 及以上版本）。 在终端中执行以下命令启动 DeepSeek Harness Web UI： Copynpx @deepseek-ai/dsh web 命令执行后，Web UI 默认运行在 http://127.0.0.1:3080。 ​配置接入凭证 编辑配置文件 ~/.dsh/settings.yaml，添加百炼供应商和默认模型。也可启动 Web UI 后在 Settings → Models → Add a custom provider 中通过界面配置。 ​Token Plan 个人版 将 YOUR_API_KEY 替换为 Token Plan 个人版专属 API Key。可用模型参见 Token Plan 个人版支持的模型。 Provider IDbailian-tppBase URLhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API Protocolopenai-completionsAPI KeyToken Plan 个人版专属 API Key模型填入模型 ID，如 auto 也可直接编辑 ~/.dsh/settings.yaml： Copyagent-default-model: provider: bailian-tpp model: auto llm-pi-ai: providers: bailian-tpp: api: openai-completions baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 apiKeyEnv: BAILIAN_API_KEY models: - id: auto - id: qwen3.8-max - id: qwen3.8-flash - id: qwen3.7-max - id: qwen3.7-plus - id: qwen3.6-flash 设置环境变量 BAILIAN_API_KEY 为你的 Token Plan 个人版 API Key： Copyexport BAILIAN_API_KEY="YOUR_API_KEY" 也可在 Web UI 的 Settings → Models 页面直接填入 API Key。 ​Token Plan 团队版 将 YOUR_API_KEY 替换为 Token Plan 团队版专属 API Key。可用模型参见 Token Plan 团队版支持的模型。 Provider IDbailian-tpBase URLhttps://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API Protocolopenai-completionsAPI KeyToken Plan 团队版专属 API Key模型填入模型 ID，如 auto 对应 ~/.dsh/settings.yaml 配置： Copyagent-default-model: provider: bailian-tp model: auto llm-pi-ai: providers: bailian-tp: api: openai-completions baseURL: https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 apiKeyEnv: BAILIAN_API_KEY models: - id: auto - id: qwen3.8-max - id: qwen3.8-flash - id: qwen3.7-max - id: qwen3.7-plus - id: qwen3.6-flash ​Coding Plan 将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。可用模型参见 Coding Plan 支持的模型。 Provider IDbailian-codingBase URLhttps://coding.dashscope.aliyuncs.com/v1API Protocolopenai-completionsAPI KeyCoding Plan 专属 API Key模型填入模型 ID，如 qwen3.7-plus 对应 ~/.dsh/settings.yaml 配置： Copyagent-default-model: provider: bailian-coding model: qwen3.7-plus llm-pi-ai: providers: bailian-coding: api: openai-completions baseURL: https://coding.dashscope.aliyuncs.com/v1 apiKeyEnv: BAILIAN_API_KEY models: - id: qwen3.7-plus - id: qwen3.6-plus ​按量计费 将 YOUR_API_KEY 替换为阿里云百炼 API Key。可用模型参见OpenAI 兼容 - 支持的模型。 Base URL 按地域设置，请将 URL 中的 {WorkspaceId} 替换为真实的Workspace ID： 华北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 美国（弗吉尼亚）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1 Provider IDbailianBase URL参见上方地域列表API Protocolopenai-completionsAPI Key百炼 API Key（sk- 开头）模型填入模型 ID，如 qwen3.7-max 对应 ~/.dsh/settings.yaml 配置： Copyagent-default-model: provider: bailian model: qwen3.7-max llm-pi-ai: providers: bailian: api: openai-completions baseURL: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 apiKeyEnv: BAILIAN_API_KEY models: - id: qwen3.7-max - id: qwen3.7-plus - id: qwen3.6-flash ​验证配置 配置保存后，在 Web UI 的模型选择器中选择已配置的模型，发送一条消息。若模型正常返回响应，配置成功。 ​常见问题 ​错误码 配置过程中遇到报错，参考对应套餐的常见问题文档： 按量计费：错误码 Coding Plan：Coding Plan 常见问题 Token Plan 个人版：Token Plan 常见问题 Token Plan 团队版：Token Plan 团队版常见问题 ​Fetch available models 返回 401 百炼 OpenAI 兼容端点不提供 GET /models 接口，点击 Fetch available models 会返回 401 或 404。该按钮可忽略，在 Model catalog 中手动输入模型 ID 即可。 ​报错 MISSING_CREDENTIAL 在 Web UI 的 Settings → Models 中重新输入 API Key 并保存；或确认环境变量 BAILIAN_API_KEY 已设置并重启 DeepSeek Harness。