Skip to main content

在 DeepSeek Harness 中接入 Syon

DeepSeek Harness(命令名 dsh)支持配置 OpenAI 兼容的模型提供方。完成本节配置后,可以在 DeepSeek Harness 中通过 Syon 调用 deepseek-flash、,并继续使用 Harness 的 Web 界面、会话和 Agent 能力。 支持的模型
  • DeepSeek:deepseek-flash(DeepSeek V4.1 Flash)、deepseek-v4-pro(0813正式版)、,请安装 Node.js 24,并准备好一个可用的 Syon API Key。

1.1 安装 Node.js 24

DeepSeek Harness 要求使用 Node.js 24。npm 会随 Node.js 一起安装,请根据自己的操作系统和 CPU 架构下载安装包: 使用国内镜像时,请在目录中选择 v24.x.x 版本,再下载适合当前系统的安装包。安装完成后,重新打开终端并检查版本:
node --version 的输出应以 v24. 开头。

1.2 准备 Syon API Key

API Key 以 sk- 开头,可以在 Syon 控制台创建。 创建 Syon API Key

2. 一键配置并启动

无需打开或手动修改任何配置文件。先在代码块中把 sk-请替换成你的真实Key 替换为你自己的 Syon API Key,再复制整段命令到终端运行。命令会自动完成安装、配置并启动 DeepSeek Harness。 macOS / Linux
Windows PowerShell
命令会自动完成安装、备份并合并现有配置、保存 Key、设置 Syon 模型,然后启动 DeepSeek Harness。它不会删除已有的主题或其他设置。 启动成功后,终端会显示本地地址,默认通常为 http://127.0.0.1:3080。在浏览器打开该地址并新建会话即可使用。以后再次启动时,只需在项目目录运行:
如需在指定项目中使用,请先进入项目的真实目录再运行 dsh web。不要直接照抄 /path/to/my-project,它只是占位符。

3. 验证接入

可以先用 Headless 模式发送一条最小请求,验证配置、Key 和模型是否都可用:
如果终端返回 OK,说明 DeepSeek Harness 已经通过 Syon 成功调用模型。随后运行 dsh web 即可进入 Web 界面。

4. 添加和切换其他模型

如果需要在 Harness 中选择多个 Syon 模型,可以在同一个 models 列表中继续添加模型。以下示例同时提供 DeepSeek V4.1 Flash、DeepSeek V4 付费与免费模型,以及多个 GPT 模型:
修改 agent-default-model.model 可以更换新会话的默认模型。已经创建的会话可能继续沿用原模型,因此修改默认模型后,建议刷新页面并新建会话;也可以在界面的模型选择器中手动切换。 Syon 的模型列表会持续更新。需要确认实时模型 ID 时,可调用:

5. 常见问题

返回 401 或 invalid_bearer_token。 请确认 API Key 完整、没有多余空格、尚未被删除,并确认它以 sk- 开头。如仍失败,请在 Syon 控制台新建 Key 后重试。 提示 MISSING_CREDENTIAL。 DSH 没有读取到 SYON_API_KEY。请在设置环境变量的同一个终端窗口中运行 dsh web,不要先关闭窗口再从其他位置启动。 提示未知模型或模型不在列表中。 请确认模型 ID 已写入 settings.yaml 的 models 列表,并通过 GET /v1/models 核对当前模型 ID。 修改默认模型后仍在使用旧模型。 默认模型只保证用于新会话。请新建会话,或在当前会话中手动切换模型。 端口 3080 已被占用。 可以改用其他端口:
GPT 的推理参数表现异常。 GPT 接入时不要在 Syon provider 上配置 compat.thinkingFormat: deepseek。该字段用于 DeepSeek 模型的推理格式,不适用于 GPT。若同一 provider 同时配置 GPT 和 DeepSeek,应仅将该字段写在对应的 DeepSeek 模型条目下。

6. Key 安全

不要把真实 API Key 写入项目源码、提交到 Git、打包进前端应用或发送到公开聊天中。推荐通过 SYON_API_KEY 环境变量传入。若怀疑 Key 已泄露,请立即在 Syon 控制台删除旧 Key 并创建新 Key。 相关文档:Syon API 接入文档 上一篇GPT Image 2 API 调用下一篇Codex 客户端