DeepSeek Harness（DSH）接入

DeepSeek Harness（DSH）是 DeepSeek 开源的编程代理运行环境，可通过自定义提供商连接 ModelFold 的 OpenAI Chat Completions 接口，使用模型阅读代码、编辑文件和调用工具。

安装与启动

安装 Node.js 后，在终端执行官方 npm 启动命令：

bash

npx @deepseek-ai/dsh web

默认在 http://127.0.0.1:3080 打开 Web 界面。只启动服务、不自动打开浏览器可加 --no-open。DSH 仍处于开发者预览阶段，升级可能改变设置界面或配置文件格式。

配置 ModelFold

打开 DSH Settings → Models → Add model provider，切换到 Custom model API。
按下表填写。不要把 ModelFold Key 填进默认 DeepSeek 官方提供商。
在 Model catalog → Fetch available models 获取模型，或手动添加准确的模型 ID；保存提供商。
在模型选择器中选中刚添加的模型，开启新会话。已有会话可能保留原先的模型。

字段	填写值
Provider ID	`modelfold`（自定义小写标识，保存后不可改名）
Display name	`ModelFold`
Base URL	`https://modelfold.ai/v1`
API protocol	OpenAI Chat Completions（配置值 `openai-completions`）
API key	你的 ModelFold Key 原文，不加 `Bearer`
Model ID	如 `claude-opus-5-5`；不要填展示名称或 `modelfold/` 前缀

DSH 会补上 /chat/completions，因此 Base URL 不要再带这个后缀，也不要重复 /v1。模型列表接口为 GET https://modelfold.ai/v1/models，需要同一把 Key。

可复制配置

推荐先通过界面保存 Key。下面是官方当前版本支持的环境变量配置方式，适合手动配置；变量必须在启动 DSH 的同一个终端设置：

bash

export MODELFOLD_API_KEY="你的 ModelFold API Key"
npx @deepseek-ai/dsh web

Windows PowerShell 使用 $env:MODELFOLD_API_KEY = "你的 ModelFold API Key" 后再启动 DSH。

在 Settings → Open configuration file 打开的配置中合并以下内容。当前官方 Web profile 对应 $DSH_HOME/profiles/web/cordis.patch.yml（默认 DSH_HOME 为 ~/.dsh）。若已有 llm-pi-ai 条目，在它的 config.providers 下添加 modelfold，保留其他提供商和字段；不要用片段覆盖整个文件。

yaml

- id: llm-pi-ai
  config:
    providers:
      modelfold:
        apiKeyEnv: MODELFOLD_API_KEY
        api: openai-completions
        baseURL: https://modelfold.ai/v1
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
        models:
          - id: claude-opus-5-5
          - id: gpt-6-1-sol
          - id: deepseek-v4-1-flash

apiKeyEnv 是环境变量名，不是 Key 本身。compat 使用系统提示和 max_tokens 兼容字段。旧版可能使用不同配置布局，以 DSH 当前版本设置界面为准，不要把新版 YAML 直接覆盖旧版配置。

模型	使用建议
claude-opus-5-5	复杂代码任务的 Claude 选项；长对话先阅读下方缓存说明
gpt-6-1-sol	长任务可优先试用；本次接口测试返回非零缓存 token，但未证实长前缀新增命中
deepseek-v4-1-flash	可作为 DeepSeek 候选；本次未观测到缓存命中，不承诺第二轮更便宜

验证是否接通

先拉取模型列表（不生成内容），再在 DSH 新会话发送“只回复 OK”：

bash

curl https://modelfold.ai/v1/models \
  -H "Authorization: Bearer $MODELFOLD_API_KEY"

本页缓存测试使用测试 Key 直接调用兼容接口，未在 DSH 界面完成端到端工具操作。模型列表成功也不代表工具调用、流式输出和长任务都已验证。

省钱提示

本次接口实测（2026-11-10）

模型	第一轮输入 / cached_tokens	第二轮输入 / cached_tokens	结论
`gpt-6-1-sol`	9420 / 2048	9443 / 2048	两轮 HTTP 200，第二轮有缓存用量；缓存数未增加，不能确认新增长上下文被缓存
`deepseek-v4-1-flash`	4882 / 0	4895 / 0	两轮 HTTP 200，本次未观察到缓存命中

常见问题

现象	处理
401 / `invalid_api_key`	使用有效 ModelFold Key；密钥框不加 Bearer，确认环境变量在 DSH 进程中生效；检查是否误选官方提供商
模型不存在 / `UNKNOWN_MODEL` / `unsupported_model`	从 `/v1/models` 或模型 ID 文档复制准确 ID，添加到自定义提供商并在新会话重新选择
404 / 返回网页	使用 `https://modelfold.ai/v1`，检查重复 `/v1` 或 `/chat/completions`
超时 / 502 / 504	缩短上下文和任务，检查网络与请求日志；确认前次状态后再重试，避免并发重复提交
空回复 / `finish_reason: length`	推理可能耗尽输出预算，适当增加输出 token 上限；不要只反复发送相同请求
Key 和地址正确仍报参数错误	按上方 `compat` 设置系统提示和 `max_tokens` 字段；其余选项以当前 DSH 界面及模型支持能力为准

官方参考

安装、界面路径及 YAML 字段于 2026-11-10 核对：DeepSeek 官方仓库与安装说明、官方提供商配置指南、pi-ai 适配器参考。DSH 更新后以官方当前版本为准。

DeepSeek Harness（DSH）接入 ​

安装与启动 ​

配置 ModelFold ​

可复制配置 ​

推荐模型 ​

验证是否接通 ​

省钱提示 ​

本次接口实测（2026-11-10） ​

常见问题 ​

官方参考 ​

DeepSeek Harness（DSH）接入

安装与启动

配置 ModelFold

可复制配置

推荐模型

验证是否接通

省钱提示

本次接口实测（2026-11-10）

常见问题

官方参考