DeepSeek Harness（dsh）接入与思考难度配置

什么是 DeepSeek Harness（dsh）

DeepSeek Harness（命令 dsh）是 DeepSeek 官方开源的 AI 编程助手（agent harness），对标 Claude Code。通过本站 OpenAI 兼容 API 即可接入使用。

安装 Node.js 后启动：npx @deepseek-ai/dsh web（浏览器打开 http://127.0.0.1:3080）。

第一步：获取 API 密钥

登录本站，进入「令牌」页面创建一个 API 密钥（oki- 开头）。

第二步：写入配置

在 dsh 的设置中编辑 settings.yaml（Web 界面：设置 → 编辑配置文件），加入以下内容，并把 apiKeyEnv 指向的环境变量设为你的密钥：

- id: llm
  name: '@deepseek-ai/dsh-llm-pi-ai'
  config:
    providers:
      shanhe:
        displayName: 山河云
        apiKeyEnv: SHANHE_API_KEY
        api: openai-completions
        baseURL: https://hs32.com/v1
        compat:
          thinkingFormat: deepseek
        models:
          - id: DeepSeek-V4-Flash-0731
            name: DeepSeek V4 Flash
            contextWindow: 131072
            maxTokens: 8192
            reasoningEfforts:
              off:
              low: low
              high: high
              max: max
          - id: deepseek-v4-pro-0813
            name: DeepSeek V4 Pro
            contextWindow: 131072
            maxTokens: 8192
            reasoningEfforts:
              off:
              high: high
              max: max

启动前设置环境变量（Windows PowerShell：$env:SHANHE_API_KEY="oki-你的密钥"；Linux/macOS：export SHANHE_API_KEY=oki-你的密钥），然后重启 dsh。

第三步：选择思考难度

配置生效后，dsh 的模型选择器旁会出现思考档位（关 / 低 / 高 / 最大）。档位越高，模型思考越充分，回答质量越好但耗时更长。

常见问题

看不到思考档位选择器？dsh 对自定义 API 网关默认不显示思考档位，必须按上方配置声明 reasoningEfforts 才会出现——这是 dsh 的设计，不是密钥或网络问题。

提示鉴权失败？检查环境变量是否在启动 dsh 的同一个终端里设置，密钥以 oki- 开头且未过期。

安全提醒：API 密钥等同于账户余额，请勿写入公开仓库或分享给他人。