DeepSeek Harness
DeepSeek Harness
DeepSeek Harness（命令 dsh）是 DeepSeek 开源的智能体框架。用它的自定义模型 API 接入上上之钥后，点一下获取可用模型就能拿到当前 Key 可用的全部模型，模型名称、上下文窗口和最大输出 token 数会自动填好，不用手动输入。
1. 准备 API Key
在控制台 API 密钥页面创建 Key。Key 所属的分组决定能用哪些模型：
2. 启动 DeepSeek Harness
浏览器会打开 http://127.0.0.1:3080（加 --no-open 则不自动打开）。
3. 添加自定义模型 API
打开设置 → 模型，点击自定义模型 API，按下表填写：
API 地址和协议按 Key 的分组选择：
4. 获取模型列表
填好 API 地址、协议和 Key 后，点击获取可用模型； 在选择要添加的模型里勾选需要的模型（可以搜索），点击添加所选； 保存这个提供商，然后在会话的模型选择器里选择它下面的模型即可开始使用。
国产模型分组还包含图片、视频、语音等模型。DeepSeek Harness 是对话智能体，只勾选文本模型即可，例如 deepseek-v4-pro、deepseek-v4.1-flash、kimi-k3、glm-5.3。
获取到的每个模型都会带上：
名称：如 DeepSeek V4 Pro； 上下文窗口：如 DeepSeek V4 系列为 1,000,000； 最大输出 token 数：如 DeepSeek V4 系列为 384,000。
如果某个模型没有自动填好上下文窗口，可以在模型行里手动修改。不填时 DeepSeek Harness 默认按 262,144 计算，可能比模型实际支持的小。
常见问题
获取到的是 Claude 模型，没有 DeepSeek？ Key 不属于「国产模型」分组。请在控制台换一个国产模型分组的 Key。
提示 401 或 check the API key？检查 Key 是否正确、是否已禁用或过期，以及 API 地址是否和上表一致。使用 Anthropic Messages 协议时，地址不要带 /v1。
能不能用 DeepSeek Harness 自带的「DeepSeek」提供商？不推荐。自带的 DeepSeek 提供商是为 DeepSeek 官方接口设计的，会发送官方专有的扩展参数，模型列表也是写死的。接入上上之钥请使用自定义模型 API。
怎么查看用量和费用？在控制台使用记录页面按 Key 查看，计费方式与其他客户端相同。