先装 Harness，
再接入 Yuanxi.one
一条主线讲清安装、注册、创建 API Key、选择分组与模型。Yuanxi.one 只配置一次，其他客户端直接复用，不再重复抄步骤。
下载并安装 DeepSeek Harness
不需要输入命令。打开官网，下载与你电脑对应的版本，像普通软件一样安装即可。
- 打开 DeepSeek Harness 官网
点击下面的按钮进入官方下载页面。
- 点击“下载 Windows 版”
如果你使用 macOS，点击下载按钮右侧的小箭头，选择对应的 macOS 版本。
进入官网后，直接点击页面上的“下载 Windows 版”。 - 安装并打开软件
下载完成后双击安装文件，按提示完成安装。打开后看到 DeepSeek Harness 主界面，就可以继续下一步。
注册 Yuanxi.one，并创建 API Key
这段是所有客户端共用的准备工作，只做一次。后面的 Harness 和其他客户端都使用同一个控制台流程。
- 注册并登录 Yuanxi.one
进入官网，完成注册、登录和必要的账户验证。
- 进入 API 密钥页面，创建新 Key
名称建议写成用途，例如
deepseek-harness，以后方便排查调用记录。 - 选择正确的分组
分组决定可调用的模型、费率和权限。优先选择明确支持你目标模型的分组，不要只看分组名字。
Yuanxi.one 操作图解
在 Harness 添加 Yuanxi.one
下面完全按 DeepSeek Harness 的“自定义模型 API”入口配置，不需要 CC Switch。
- 打开设置 → 模型
在主界面左下角打开设置，然后在左侧选择“模型”。
先打开左下角菜单中的“设置”。 
进入“模型”，点击“添加模型提供商”。 - 切换到“自定义模型 API”
Yuanxi.one 属于中转服务，不要选内置 DeepSeek 卡片；请选择自定义模型 API。
Provider ID 必须以小写字母开头，建议统一填写 yuanxi。Provider IDyuanxi（小写，创建后不建议更改）显示名称Yuanxi.one（便于在模型列表中识别）API 地址：https://yuanxi.one/v1 - 选择协议并粘贴 API Key
API 协议选择 OpenAI Chat Completions，在 API 密钥中粘贴刚才创建的 Key。
信息填写完成后，“获取可用模型”会变为可用。 - 获取模型，只选择你要用的
点击“获取可用模型”，根据当前分组返回的列表勾选模型。不同模型倍率不同，建议先选 1–3 个常用模型，确认费用后再扩展。
- 创建提供商并选择模型
点击“创建提供商”。回到新会话，在输入框右下角的模型选择器中，选择 yuanxi / 目标模型。
验证是否真的配置成功
请只回复“连接成功”。其他客户端与配置工具
点击软件查看配置弹窗；弹窗内可进入官方下载网站。已有的图文步骤按软件整理，注册和 Key 使用上方共用教程。
常见问题
提示 401 / API Key 无效
重新复制完整 Key，去掉前后空格，确认 Key 未禁用，并且来自当前填写的 Yuanxi.one 地址。
获取不到模型列表
先检查 Key 和分组权限；再确认地址是 https://yuanxi.one/v1。如果服务端没有开放模型列表，可手动添加精确模型 ID。
模型不存在或没有权限
回到 Yuanxi.one 查看该分组实际支持的模型。显示名称不等于 API 模型 ID，必须逐字一致。
能聊天，但工具调用失败
基础连通不代表所有 Agent 能力都兼容。换用该分组明确支持工具调用的模型，并检查其协议是否为 OpenAI Chat Completions。
配置已保存，但新会话仍走旧模型
在新会话右下角重新选择 yuanxi 提供商下的模型；已发送过消息的旧会话可能保留原模型。
整理日期：2026-11-10。DeepSeek Harness 处于预览阶段，界面和字段可能变化。配置逻辑参考 官方模型提供商指南 ↗；Yuanxi.one 的模型、倍率、分组和可用性以用户当前控制台为准。