DeepSeek Harness

1安装 Node.js

从 nodejs.org 安装 Node.js 22 LTS 或更新版本，然后确认版本：

node --version

2启动 Web UI

在你的项目目录中运行：

cd your-project
npx @deepseek-ai/dsh web

默认在 http://127.0.0.1:3080 启动并自动打开浏览器；加 --no-open 可只启动服务。dsh 会把启动时所在目录作为默认文件系统位置。

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

3注册 Codelux 并创建 API 密钥

1. 打开 Codelux Portal 注册账号（已有账号直接登录）。
2. 在「财务中心」选择订阅套餐或按需充值——余额对所有 Agent 通用。
3. 在左侧菜单进入「API 密钥」，点击「新建密钥」，名称建议写成对应 Agent 的名字，方便以后区分用量。
4. 创建成功后，复制「API 密钥」（以 sk- 开头）和「API 地址」。密钥只完整显示一次，请妥善保存。

4添加自定义模型 API

1. 打开「设置 → 模型」，点击「添加模型提供商」；
2. 把卡片从「第三方模型提供商」切换到「自定义模型 API」；
3. Provider ID 填 codelux（小写，创建后不能改名），显示名称填 Codelux；
4. API 地址填 https://codelux.io/v1；
5. API 协议选「OpenAI Chat Completions」（Codelux 也支持 OpenAI Responses 与 Anthropic Messages，一个提供商只能用一种协议）；
6. API 密钥粘贴 Codelux 密钥，密钥只写不读，保存在 $DSH_HOME/.credentials.yaml。

5获取并添加模型

在「模型目录」中点击「获取可用模型」，dsh 会调用 Codelux 的模型列表接口；搜索并勾选需要的模型，点击「添加所选」，最后保存提供商。探测失败时，手动输入 Portal「AI 中心」中的模型 ID 效果完全一样。

6（遇到请求被拒时）调整兼容性

如果地址和密钥都正确但请求仍被拒绝，可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中为 Codelux 路由加上兼容设置（也可以在设置页顶部点「打开配置文件」）：

- id: llm-pi-ai
  config:
    providers:
      codelux:
        apiKeyEnv: CODELUX_API_KEY
        api: openai-completions
        baseURL: https://codelux.io/v1
        compat:
          supportsDeveloperRole: false
          maxTokensField: max_tokens
        models:
          - id: deepseek-v4-flash
          - id: claude-sonnet-5

通过 OpenAI 兼容网关使用 DeepSeek V4 等默认思考的模型时，可在模型上设置 compat.thinkingFormat: deepseek，让“off”推理等级真正关闭思考。

7选择工作区

点击「选择工作区」，添加启动 dsh 时所在的项目目录并选中它。选中工作区前，会话输入框不可用。

8选择模型并运行任务

在模型选择器中选择 Codelux 下的模型（选择的模型会成为新会话的默认值），然后发送一个任务，例如：

总结这个仓库，并列出主要的包。

Agent 会读取和编辑工作区文件、运行命令并维护计划；需要审批的操作会先询问你。每次请求的用量与扣费可在 Portal「使用日志」查看。