DeepSeek Harness

按你的系统查看 Windows 或 macOS 步骤。

Windows

1. 安装

从开始菜单打开 PowerShell。

检查 Node.js 和 npm：

node --version
npm --version

如果提示找不到命令，从 Node.js 官网安装 LTS 版本，再重新打开终端。能看到版本号后，运行：

npm install --global @deepseek-ai/dsh
dsh --version

2. 配置

准备一个 API Key，从模型目录复制该 Key 可用、支持 Chat Completions 的模型 ID，用它替换下方的 YOUR_MODEL。

配置文件位于 %USERPROFILE%\.dsh\settings.yaml。

1. 按 Win + E 打开文件资源管理器。
2. 在地址栏输入 %USERPROFILE%\.dsh，按回车。
3. 右键 settings.yaml，选择打开方式 → 记事本。
4. 如果目录不存在，在 %USERPROFILE% 中逐级创建 .dsh 文件夹；文件不存在时，在记事本中新建。

llm-pi-ai:
  providers:
    getrun:
      displayName: GetRun
      apiKeyEnv: GETRUN_API_KEY
      api: openai-completions
      baseURL: https://api.get-apikey.com/v1
      models:
        - id: YOUR_MODEL
          name: YOUR_MODEL

将两处 YOUR_MODEL 替换为同一个模型 ID。apiKeyEnv: GETRUN_API_KEY 保持不变，API Key 稍后在 Web 界面中填写。已有文件时合并 llm-pi-ai.providers.getrun，保留其他设置；YAML 缩进使用空格。

保存到上面的目录。使用记事本新建时，选择另存为 → 所有文件 → UTF-8，文件名填 settings.yaml，确认没有多余的 .txt 后缀。

3. 使用

用文件资源管理器打开项目文件夹，在地址栏输入 powershell 并按回车。

dsh web

在浏览器中打开终端显示的本地地址，然后：

1. 打开 **Models（模型）**页面，找到 GetRun 提供商。
2. 填写并保存自己的 API Key。
3. 新建会话，在模型选择器中选择刚配置的模型。
4. 发送 只回复 OK。收到回复后，即可输入任务。

使用期间保持终端运行。结束时回到终端按 Ctrl + C。

macOS

1. 安装

按 Command + 空格 搜索并打开终端。

检查 Node.js 和 npm：

node --version
npm --version

如果提示找不到命令，从 Node.js 官网安装 LTS 版本，再重新打开终端。能看到版本号后，运行：

npm install --global @deepseek-ai/dsh
dsh --version

2. 配置

准备一个 API Key，从模型目录复制该 Key 可用、支持 Chat Completions 的模型 ID，用它替换下方的 YOUR_MODEL。

配置文件位于 ~/.dsh/settings.yaml。

1. 打开 Finder（访达），按 Command + Shift + G。
2. 输入 ~/.dsh，点击前往。
3. 右键 settings.yaml，用“文本编辑”或 VS Code 打开。
4. 如果目录或文件不存在，在 VS Code 中选择文件 → 打开文件夹，按 Command + Shift + G 并输入 ~，打开用户主目录。在左侧逐级新建 .dsh 文件夹，再在其中新建 settings.yaml。

llm-pi-ai:
  providers:
    getrun:
      displayName: GetRun
      apiKeyEnv: GETRUN_API_KEY
      api: openai-completions
      baseURL: https://api.get-apikey.com/v1
      models:
        - id: YOUR_MODEL
          name: YOUR_MODEL

将两处 YOUR_MODEL 替换为同一个模型 ID。apiKeyEnv: GETRUN_API_KEY 保持不变，API Key 稍后在 Web 界面中填写。已有文件时合并 llm-pi-ai.providers.getrun，保留其他设置；YAML 缩进使用空格。

按 Command + S 保存。使用“文本编辑”时选择格式 → 制作纯文本，文件名保持为 settings.yaml。

3. 使用

打开“终端”，输入 cd （末尾留一个空格），将项目文件夹从 Finder 拖入终端，再按回车。

dsh web

在浏览器中打开终端显示的本地地址，然后：

1. 打开 **Models（模型）**页面，找到 GetRun 提供商。
2. 填写并保存自己的 API Key。
3. 新建会话，在模型选择器中选择刚配置的模型。
4. 发送 只回复 OK。收到回复后，即可输入任务。

使用期间保持终端运行。结束时回到终端按 Ctrl + C。

配置位置说明

设置了 DSH_HOME 时，编辑该目录中的 settings.yaml。Linux 使用相同的安装和启动命令，默认配置路径为 ~/.dsh/settings.yaml。更多使用方法见 DeepSeek Harness 官方文档。