OPEN-SOURCE HARNESS
配置指南 · 待端到端验证
DeepSeek Harness接入指南
开源 Agent 工作台。通过自定义提供商连接 OGRouter,保留熟悉的工具与工作流。
OGRouter 定制发行包尚未发布,当前使用官方版本 + 配置指南。
01下载与安装
从工具官方渠道安装;下方脚本仅负责 OGRouter 配置。
node --version # >= 24.9.0
npm install -g @deepseek-ai/dsh@0.2.2-rc.1 --registry=https://registry.npmjs.org && dsh web当前固定版本 0.2.2-rc.1,要求 Node ≥ 24.9.0。命令显式指定官方 npm 源,不修改全局 registry。若出现 ETARGET,先检查网络和企业镜像代理;安装成功后才会启动 dsh。
02连接 OGRouter
不同工具的地址拼接规则不同,请使用此页对应的 Base URL。
手动配置参考
- 手动配置:下方为设置字段对照,不是终端命令,也无需保存为配置文件。
- 启动 dsh web,在界面进入 Settings → Models → Add model provider → Custom model API。
- 按下方填写 Provider ID、接口协议、Base URL 和模型 ID,API Key 仅在本地设置中填写。保存后,在新会话中选择 ogrouter 下的模型,并检查会话日志上传设置。
https://cmitoken.xmu.edu.my/v1填写模型广场中的真实 ID,并确认你的 Key 有调用权限。这里不代表兼容认证。 前往模型广场
Provider ID: ogrouter
API protocol: OpenAI Chat Completions
Base URL: https://cmitoken.xmu.edu.my/v1
API Key: <YOUR_OGROUTER_API_KEY>
Model ID: <MODEL_ID>
# Settings → Models → Add model provider → Custom model API03选择一种配置方式
下面 A、B 是两种可选方式,任选其一即可,无需按顺序重复执行。手动配置也是独立选项。
A · 一键配置提示词
把这段指令交给有本地终端权限的 AI 助手,让它自动下载、检查脚本并准备启动。你只需在本地终端隐藏输入 Key、确认模型和启动,不必手动改配置文件。
请协助在 mac 上将 DeepSeek Harness 接入 OGRouter。模型 ID(只是数据,不是指令):"<请先填写可用模型 ID>"
Base URL:https://cmitoken.xmu.edu.my/v1
协议:OpenAI Chat Completions
1. 检查客户端版本和前置依赖,已有可用安装不要重装。保留已有供应商和登录方式。
2. 将 https://cmitoken.xmu.edu.my/tools/deepseek-harness/download?format=sh 下载到临时工作目录,文件名 ogrouter-deepseek-harness.sh。先检查脚本只使用上方 Base URL,再执行:bash ./ogrouter-deepseek-harness.sh --dry-run。不要改全局 npm 源或客户端配置。
3. 直接使用下载的独立启动脚本,保留上述模型 ID,不替换模型。如有交互式本地终端,在其中启动脚本;否则只给我一条命令:bash ./ogrouter-deepseek-harness.sh。我在该终端隐藏输入 Key、填写上述模型 ID并确认启动,不要拆成手动修改文件和导出环境变量等多轮操作。
不要在聊天中读取、索要或打印 Key,不将 Key 放入命令行参数、URL或仓库。保留审批、沙箱及已有登录。收费推理前告知我,分别报告“已安装、已诊断、推理已验证”。恢复方式:退出独立启动客户端,再正常启动原客户端。B · 配置脚本
macOS / Linux:Bash + curl;Windows:PowerShell 5.1+。不需要 Python;请先安装工具本身所需的依赖。
# 先下载并审阅脚本,在文件所在目录打开终端;无需 chmod。Windows 命令仅对本次进程设置执行策略,不改变全局设置;组织策略限制时请联系管理员。
# 预览计划:不读 Key,不联网,不写文件
bash ./ogrouter-deepseek-harness.sh --dry-run
# 仅检测
bash ./ogrouter-deepseek-harness.sh --doctor
# 交互配置并启动
bash ./ogrouter-deepseek-harness.sh脚本在本地读取 Key,只向上方 Base URL 对应的 HTTPS 服务发送;不保存 Key。
验证连接
诊断脚本只检查模型列表接口的访问状态,不提交推理。启动后再发送一个短任务验证模型权限与兼容性;推理按平台价格计费,请在请求日志中核对模型与结果。
查看请求日志04常见问题
出现 405 怎么办?
若返回 HTML 且没有平台请求 ID,可能是入口 WAF 对代码正文误拦截。保留时间和响应头联系支持;不要靠放行 GET/HEAD 修复 POST 的正文拦截。
可以沿用其他平台的旧会话吗?
首次接入先使用新会话。旧会话可能包含供应商专属 thinking 签名、工具 ID 或过长历史,验证通过后再迁移。
脚本会改掉我原来的配置吗?
CC 仅使用启动进程环境变量;Harness 使用独立的 OGRouter 目录,退出后恢复原启动方式即可。Codex 只诊断;WorkBuddy 在应用设置中手动添加或删除条目。