DSH_CLIAPI

August 25, 2026 · View on GitHub

面向 DeepSeek Harness 的统一 CLI/OAuth 授权中心、原生 Auto 故障切换与多模态模型调度插件。

从 0.5.0 起，原 DSHLLM_API 已合并进 DSH_CLIAPI。插件随 Harness 启停官方 CLIProxyAPI，并在「设置 → 模型与授权」的两个页签中统一提供账号连接、默认模型、Auto 候选和图片/视频/音频调度。

0.5.1 修复 rc.8 Web 客户端 ModuleLoader 注册名，使模块 ID 与包名 @local/dsh-cliapi 精确一致。

DSH 兼容声明

本版本标准 DSH Bundle 的兼容范围是 dsh >=0.1.0-rc.8 <0.2.0：rc.7 不兼容，rc.8、0.1.1-rc.1 和 0.1.1-rc.2 为兼容声明。这是来源包的版本契约，不等同于每个版本的真实 Profile 安装、启动、卸载或回滚验收；这些生命周期证据由 DSH STORE 独立记录。

本项目是社区插件，并非 DeepSeek 或 CLIProxyAPI 官方项目。源码包不包含 CLIProxyAPI 二进制。

一条命令安装

已经使用 DeepSeek Harness 的 macOS / Linux 用户，直接执行：

curl -fsSL https://raw.githubusercontent.com/AI-Scarlett/DSH_CLIAPI/v0.5.1/install.sh | bash

安装器会下载并校验官方 CLIProxyAPI、生成本机随机密钥、注册 Harness 插件，最后输出并尝试打开：

http://127.0.0.1:3080/dsh-cliapi

再次执行同一命令即可升级。OAuth 账号、Auto 顺序和已有 CLIProxyAPI 配置会保留。完整行为、脚本审阅方法和手动安装说明见中文文档。

功能

当前 CLIProxyAPI 内置的全部 5 种 CLI/OAuth 授权入口：Codex、Claude、Antigravity、Kimi、Grok/xAI；
永久可见的三步首次使用向导，以及每个提供方的授权说明和脱敏连接状态；
Harness 默认模型设置；
自动汇总 Harness 已配置的 DeepSeek、MiniMax、其他 API provider，以及 CLIProxyAPI 授权模型；
Harness 原生 Auto 故障切换：不同来源可混排，遇到鉴权、限流、网关或模型错误时切换下一模型；
合并原 DSHLLM_API 的文本、图片、视频、音频任务分类与同类候选回退；
「设置 → 模型与授权」单一入口，内部为「授权与 Auto」「多模态调度」两个页签；
Auto 固定在 Harness 模型列表第一项；
回环地址、同源写操作校验、管理密钥隔离和令牌不出本机。

授权目录

面板项	授权方式	状态
Codex	OpenAI / ChatGPT OAuth	支持
Claude	Anthropic OAuth	支持
Antigravity	Google OAuth，提供 Gemini 模型	支持
Kimi	设备码 OAuth	支持
Grok / xAI	设备码 OAuth	支持
Cursor	客户端配置，不是 CLIProxyAPI OAuth 提供方	仅说明

Gemini AI Studio API Key、Vertex 服务账号和自定义 OpenAI 兼容上游属于凭据或配置接入，不属于本版本的 CLI/OAuth 按钮。

安装后配置

如果 Harness 正在运行旧配置，安装器会提示重启一次。

安装并启动 Harness 后：

打开 Harness「设置 → 模型与授权」；
使用 Harness 已配置的 API 模型，或连接至少一个 CLI/OAuth 账号；
设置 Auto 候选顺序；
点击“保存并设为默认”。

默认本机面板地址为：http://127.0.0.1:3080/dsh-cliapi

Auto 候选按 provider + model 保存，面板会分别标注“Harness 已配置模型”和“CLIProxyAPI 授权模型”。0.3.x 的字符串候选和旧 Auto HTTP route 会在重启时自动迁移。兼容入口 /dsh-cliapi/v1/chat/completions 只能调度 CLIProxyAPI 候选；混合来源请在 Harness 内选择 Auto。

从独立 DSHLLM_API 升级时，原 $DSH_HOME/dshllm-api.json、dshllm-api/auto provider ID 与 /dshllm-api/api 路由继续兼容；商城迁移会下架旧插件条目，避免两个 bundle 同时加载。

验证

./verify.sh

无需真实账号的 Auto 故障切换测试：

node test/auto-failover.mjs

当前状态：源码测试、安装器一次性目录测试和打包清单已验证；真实 Profile 安装、重启后的 DSH Web UI 与商城公开回读是独立验收门，未验证时不会标记完成。若官方 CLI、CLIProxyAPI 或账号前提缺失，对应运行时验收属于受阻，不用静态测试替代。

安全说明

CLIProxyAPI 主服务及管理接口只绑定回环地址；
浏览器状态接口不返回 OAuth token、API key 或管理密钥；
修改接口校验回环来源和同源 Origin；
OAuth 同意动作仍在提供方官方页面完成；
提交问题前请删除日志、配置和截图中的邮箱、令牌、密钥及本机路径。

上游与许可

本项目在 CLIProxyAPI v7.2.132、提交 78f0c407 上完成验证。CLIProxyAPI 的 MIT 许可副本见 UPSTREAM_CLIProxyAPI_LICENSE.txt。

DSH_CLIAPI 本身使用 MIT License。