dsh-cpa

dsh-cpa

English | 简体中文

CLI Proxy API（CPA）的 dsh bundle 插件。注册 cpa provider，请求走
CPA 的 /v1/chat/completions，同步 /v1/models 模型列表。

快速开始

npx @deepseek-ai/dsh plugin --profile web add dsh-cpa

headless profile 同理：

npx @deepseek-ai/dsh plugin --profile headless add dsh-cpa

从源码安装

开发或本地构建时使用：

npx @deepseek-ai/dsh plugin --profile web add .

headless profile 同理：

npx @deepseek-ai/dsh plugin --profile headless add .

使用已有 CPA

在设置面板切换到“外部 CPA”，填写 URL、API key、management key 后点击
“应用”。

自动启动 CPA

默认生成 $DSH_HOME/cpa/config.yaml，启动 cli-proxy-api，并把生成的 key
注入 provider 适配器。启动前会先在 PATH 中解析可执行文件；二进制不在 PATH
时，在 CPA 设置页的内部 CPA 路径中填写绝对路径。

模型每 5 分钟从 /v1/models 同步一次。

Agent 路由与故障切换

请求进入 agent 的 cpa provider 时，插件会使用 CPA 已同步的模型能力、上下文窗口、认证账号可用模型和 quota 快照生成候选顺序。用户指定的模型始终是第一候选；只有在请求尚未产生任何流内容，并且 CPA 返回额度耗尽、限流、服务端、传输或空响应类错误时，才会按候选顺序重试。流已经开始后不会重放请求，避免 agent 收到重复内容或产生重复副作用。

账号凭据和账号切换仍由 CPA 管理，插件只消费其脱敏后的账号/quota 数据，不复制 CPA 的账号管理能力。

设置面板

CPA 页面使用 dsh web-app 组件，支持内部、外部两种启动方式，保存到
$DSH_HOME/cpa/settings.json。只有内部 CPA 运行时显示停止操作。管理面板
在弹窗中打开。外部模式可配置 URL、API key、management key；内部
模式可配置 CPA 可执行文件路径。高级设置可配置端口、模型刷新间隔、
quota 缓存与并发，以及配置、设置、执行记录路径。其中端口、配置路径和
“使用统计”只对内部 CPA 生效；模型刷新间隔、quota 缓存/并发、设置路径和执行记录
路径对两种模式都生效。

使用状态

插件会解析成功与失败响应中的 x-cpa-trace-id，把脱敏后的执行记录写入
$DSH_HOME/cpa/executions.json，并给当前会话提供 cpaUsage 投影。
/dsh-cpa/execution-status?sessionId=... 返回脱敏后的账号、额度快照和
最近一次执行记录，供 composer 下方的紧凑状态行读取。浏览器无法调用 CPA 的
/v0/management/api-call，该接口仅由服务端 quota 查询使用。状态行只展示 CPA
集成特有的信息：当前使用服务商/套餐、失败/不可用状态和一个主额度窗口，不重复
dsh 已展示的 token、耗时和性能统计。服务商同时从认证文件和 API key 配置读取；
有执行记录时按 CPA trace 的账号定位当前服务商；trace 没有账号或账号不在已读取
配置中时，只按模型推断服务商。点击可展开账号、来源、Base URL/前缀、额度、
模型/用途和 CPA trace/request 标识。同一会话仍按 CPA 账号聚合请求、失败与
token，作为 cpaUsage 投影保留；无管理 API 时状态行自动隐藏。

内部 CPA 的 usage-statistics-enabled 默认开启，可在 CPA 设置面板中关闭。

CPA 摘要

只读 /dsh-cpa/summary 接口由服务端使用 management key 调用 CPA 管理 API，
浏览器只收到脱敏汇总数据，不包含 management key 或账号凭据。摘要包含版本/更新
状态、白名单过滤的运行时配置、/v0/management/api-key-usage 与认证文件计数聚合
的请求统计、脱敏账号，以及认证文件提供的模型到账号可用性。CPA 管理 API 不暴露
token 汇总，因此 token 项保持为 0。服务端做短时缓存；单个来源失败只记录错误，
不影响其他数据。

设置页提供紧凑的“CPA 摘要”区域：版本/更新、运行配置、用量总计、用量明细、账号。
composer 状态详情在有 requestId 时提供“日志”链接，打开 CPA 原始 management
日志界面。管理面板仍是完整管理入口。