DeepSeek Harness 一键配置

用桌面助手一键配置

1. 下载桌面助手（ZHENG API桌面助手.exe），双击打开。Windows 弹出安全提示时，点「更多信息 → 仍要运行」。
2. 注册或登录：新用户点「注册」，填用户名、邮箱、密码，点「发送验证码」并填入邮箱里的验证码；老用户直接用本站账号密码登录。登录状态加密保存在本机，下次打开不用重新登录。
3. 充值：在「兑换额度卡」里粘贴卡密，点「立即兑换」，余额立即刷新。没有卡密可以点「购买额度卡」。
4. 一键配置：点「一键配置并打开 DeepSeek Harness」。工具会自动安装或更新官方 DSH、写入接口地址和你的 Key、开启图片输入和七档推理强度，然后启动 DSH。在 DSH 底部模型列表选「ZHENG API · Claude」就能开始用。

工具具体做了什么

• 官方下载并校验：直接从 DeepSeek 官方地址 download.deepseek.com 下载 DSH 安装包，用官方提供的 SHA-512 校验后才安装。
• 写入模型配置：添加 Claude（Opus / Sonnet / Haiku 5.5）和 Gemini 3.8 Flash，默认打开图片输入和七档推理强度（off / minimal / low / medium / high / xhigh / max），默认模型设为 Claude Opus 5.5。
• 不动你的东西：只改 cordis.patch.yml 和 .credentials.yaml 两个文件，改前自动备份为 *.bak-zheng-*；你的对话、其他模型、Key 和插件都保留。
• 不关你的 DSH：DSH 正在运行时不会被关掉，配置写入后自动生效；这种情况下本次不更新 DSH 程序，想更新时先自己关掉 DSH 再点一次。

模型与推理档位

Claude 官方没有 minimal 档，在 DSH 里选 minimal 会按 low 处理；选 off 则完全关闭思考。

手动配置（macOS / Linux / 高级用户）

1. 按 DeepSeek Harness 官方文档 安装 DSH。
2. 登录 控制台 →「令牌」→「添加令牌」，分组选 auto，创建后复制完整 Key。
3. 编辑 ~/.dsh/profiles/desktop/cordis.patch.yml，在 id: llm-pi-ai 的 providers 下加入下面的配置，并把 Key 写进 ~/.dsh/.credentials.yaml 的 refs.ZHENG_DSH_API_KEY：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      zheng-claude:
        displayName: "ZHENG API · Claude"
        apiKeyEnv: ZHENG_DSH_API_KEY
        api: anthropic-messages
        baseURL: https://newapi.zheng.edu.kg
        compat: { forceAdaptiveThinking: true }
        defaultInput: [text, image]
        models:
          - id: claude-opus-5-5
            name: "Claude Opus 5.5"
            input: [text, image]
            contextWindow: 1000000
            maxTokens: 64000
            reasoningEfforts: { off: null, minimal: low, low: low, medium: medium, high: high, xhigh: xhigh, max: max }
      zheng-gemini:
        displayName: "ZHENG API · Gemini"
        apiKeyEnv: ZHENG_DSH_API_KEY
        api: openai-completions
        baseURL: https://newapi.zheng.edu.kg/v1
        compat: { supportsReasoningEffort: true }
        defaultInput: [text, image]
        models:
          - id: gemini-3.8-flash
            name: "Gemini 3.8 Flash"
            input: [text, image]
            contextWindow: 1048576
            reasoningEfforts: { off: null, minimal: minimal, low: low, medium: medium, high: high, xhigh: xhigh, max: max }
- id: agent-default-model
  name: "@deepseek-ai/dsh-agent-default-model"
  config: { provider: zheng-claude, model: claude-opus-5-5, reasoningEffort: high }

示例里每个分组只写了一个模型，Sonnet、Haiku 照同样格式添加即可。

恢复原来的配置

到 %USERPROFILE%\.dsh\profiles\desktop\ 找到带 .bak-zheng-* 后缀的备份文件，去掉后缀覆盖回去即可；%USERPROFILE%\.dsh\.credentials.yaml 同理。

开启了两步验证（2FA）？

开了 2FA 的账号不能由桌面助手自动登录。请在控制台「令牌」里手动建一个 auto 分组的 Key，再按上面的「手动配置」把 Key 写进 DSH。