> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hostlinku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek Harness

> 通过 DEEPSEEK_BASE_URL 将 DeepSeek Harness (dsh)（DeepSeek 的开源代理代码）连接到 Hostlinku。已经过测试的安装指南、cordis.patch.yml 配置指南以及故障排除指南。

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) 是 DeepSeek 推出的
开源编码代理。 在您选择的工作文件夹中，`dsh` 可以通过 Web 界面、
无头模式、SDK 或 ACP 读取文件、编辑
代码、执行 shell 命令并完成多步骤任务。

`dsh` 采用 **Anthropic Messages** 协议。Hostlinku 通过
[`POST /v1/messages`](https://docs.hostlinku.com/zh/anthropic-messages) 提供该功能，因此只需设置
两个环境变量，即可将 `dsh` 定向至 Hostlinku——无需代理，也无需额外插件。

已测试版本

本指南已使用 `@deepseek-ai/dsh` **0.2.1-rc.5** 进行了端到端验证（代理通过工具读取文件
后进行响应，无头模式）。DeepSeek Harness 仍处于 *开发预览* 阶段；文件名
或参数的行为可能会在后续版本中发生变化。

## 开始之前

* **最新 Node.js LTS 版本**（`node --version`）。`dsh` 包会拉取数百个依赖项，因此
  首次安装可能需要 1-3 分钟。
* **Hostlinku API密钥** `sk-…` 来自 [console.hostlinku.com](https://console.hostlinku.com) → **API密钥**。
* **余额**或该密钥所需的足够支出限额。
* **安全的测试文件夹。** 你运行 `dsh` 的文件夹将成为其默认工作区。
  请勿直接从主目录或包含重要数据的文件夹中运行。

### 安装 DeepSeek Harness

```bash theme={null}
npm install -g @deepseek-ai/dsh
dsh --version
```

或者不进行全局安装直接运行：`npx @deepseek-ai/dsh web`。

### 跳转至 Hostlinku

`dsh` 从 `DEEPSEEK_BASE_URL` 读取端点，从 `DEEPSEEK_API_KEY` 读取 API 密钥。

**macOS / Linux / WSL**（保存至 `~/.zshrc` 或 `~/.bashrc`）：

```bash theme={null}
export DEEPSEEK_BASE_URL=https://api.hostlinku.com
export DEEPSEEK_API_KEY=sk-your-api-key
```

**Windows PowerShell：**

```powershell theme={null}
$env:DEEPSEEK_BASE_URL = "https://api.hostlinku.com"
$env:DEEPSEEK_API_KEY  = "sk-your-api-key"
```

`dsh` 会自行添加 `/v1/messages`。基础 URL `https://api.hostlinku.com/v1` 同样被接受
（后缀 `/v1` 被复用，不会重复出现）。

### 选择模型和输出限制

内置模型 `dsh`（`deepseek-flash`）并非 Hostlinku 的 slug，且 `dsh` 默认发送 `max_tokens: 256000`
——这超出了大多数模型的输出限制。 这两项均在补丁级别文件
home：`~/.dsh/cordis.patch.yml`（或当您设置了 `DSH_HOME` 时为 `$DSH_HOME/cordis.patch.yml`）中进行配置。

```yaml theme={null}
- id: agent-default-model
  config:
    provider: deepseek-official
    model: deepseek-v4-1-flash
- id: llm-deepseek
  config:
    apiKeyEnv: DEEPSEEK_API_KEY
    maxTokens: 32000
```

Patch 替换整个配置块

Patch 不会逐个合并字段——patch 中的 `config` 块将**替换**
默认块。因此必须保留 `provider: deepseek-official` 和 `apiKeyEnv`，否则 `dsh`
将因 `$.provider missing required value` 报错而无法启动。

### 运行

通过无头模式进行快速测试（执行一项任务，输出最终结果，然后退出）：

```bash theme={null}
mkdir dsh-test && cd dsh-test
echo "the secret word is PINEAPPLE" > hello.txt
dsh --profile headless "Read hello.txt and reply with only the secret word."
```

正确输出：`PINEAPPLE`。这意味着代理成功通过 Hostlinku 调用了文件读取工具并
返回了响应。如需在浏览器中查看完整界面：

```bash theme={null}
dsh web
```

### 验证

打开控制台 → **请求日志**。来自 `dsh` 的请求会显示你选择的模型、
令牌数量、费用以及所使用的 API 密钥。

## 推荐的翻译方案

字段 `model` 可以填写 [目录](https://docs.hostlinku.com/zh/models.md) 中任何支持调用工具的 slug。您密钥的
有效列表可在 `GET /v1/models` 中找到。

| 需求 | Slug | 注释 |
| - | - | - |
| 每日默认值，快速且经济实惠 | `deepseek-v4-1-flash` | 上下文：1M、推理、工具调用。 |
| 需要图片素材（截图、图表） | `deepseek-v4-1-flash` | 支持愿景。 |
| 艰巨任务 / 重大重构 | `deepseek-v4-1-flash-hyper` | 背景 1M，更深入的推理。 |
| 开放权重选项 | `kimi-k2-7-code`, `glm-5-3` | 工具调用和推理。 |

根据模型调整 maxTokens

`maxTokens` 限制的是每次请求的输出量，而非上下文大小。示例中的值 `32000` 是初始配置，并非模型的最大值。请在 [目录](https://docs.hostlinku.com/zh/models.md) 中查看模型的输出限制；如果未列出限制，且请求被拒绝，请降低该值。

## 安全性

* 任务执行期间，提示、代码片段、文件内容和工具输出将发送至 Hostlinku 进行
  推理。未经许可，请勿在包含商业机密或个人数据的项目中运行 `dsh`。
* 请使用专用于 `dsh` 的 **独立 API 密钥** 并设置支出限额，以便在发生泄露时能轻松撤销。
  参见 [身份验证](https://docs.hostlinku.com/zh/authentication.md)。
* 请勿直接在 `cordis.patch.yml` 中写入 API 密钥。`apiKeyEnv` 仅存储变量的**名称**
  ；密钥值仍需从环境变量中读取。

## 故障排除

| 症状 | 原因与解决方案 |
| - | - |
| `INVALID_REQUEST: max_tokens (256000) exceeds the output limit of model …` | `maxTokens` 尚未设置。请在 `llm-deepseek` 代码块中添加 `maxTokens: 32000`。 |
| `startup failed … $.provider missing required value` | 补丁中的 `agent-default-model` 代码块未包含 `provider`。请按照上面的示例进行完整重写。 |
| `MISSING_CREDENTIAL` | `DEEPSEEK_API_KEY` 尚未在运行 `dsh` 的 shell 中导出。 |
| `401` / *无效的 API 密钥* | 密钥错误、已被撤销或已过期。请在控制台中创建新密钥。 |
| `404 model not found` | Slug有误或仍为`deepseek-flash`。请从`GET /v1/models`中复制slug。 |
| 图片附件上传失败 | `dsh` 会先尝试通过 `/v1/files` 上传图片，然后自动重新发送内联图片。请确保所选模型支持视觉处理（例如 `deepseek-v4-1-flash`）。 |

插件选项的完整详情请参见
[DeepSeek Harness 代码库](https://github.com/deepseek-ai/deepseek-harness)。相关指南：
[Claude Code](https://docs.hostlinku.com/zh/integrations/claude-code.md) · [CC Switch](https://docs.hostlinku.com/zh/integrations/cc-switch.md) ·
[Anthropic Messages](https://docs.hostlinku.com/zh/anthropic-messages.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.