dsh-cpa-status

CLIProxyAPI（CPA） 的 DeepSeek Harness 状态面板插件：侧栏常驻状态灯，点开即看账号池配额、健康与流量——不用每次开 CPA 管理页。

<p align="center"> <img src="https://raw.githubusercontent.com/xohmai/dsh-cpa-status/main/docs/images/panel.png" alt="状态面板" width="820"> </p>

• 收起态：● CPA · 3/3 账号 · 28 次/30min，成功率异常或账号缺员时自动变色告警
• 账号卡：套餐徽章（含订阅剩余天数）、指标宫格（请求总数 / 成功率 / 近 30 分钟）、健康刻度带（约 3.3 小时逐 10 分钟成败）、配额进度条（剩余 % + 重置倒计时）
• AI 供应商页：api-key 网关列表（类型 / 地址 / 模型 / 密钥末四位 / 启停），与认证文件分页签切换
• 配额手动同步：点「同步配额」才探测上游（codex / kimi / xai 已实测），平时只读 CPA 本地数据
• 非侵入：不碰 usage 队列、不写 CPA 数据；密钥仅存本机凭据库，网关密钥只显示末四位

<p align="center"> <img src="https://raw.githubusercontent.com/xohmai/dsh-cpa-status/main/docs/images/collapsed.png" alt="侧栏底部收起态"> </p>

安装

dsh plugin add 会自动完成依赖链接与 profile 注册，装完重启 dsh web 生效。卸载：dsh plugin --profile web remove dsh-cpa-status。

方式一：GitHub 直装（推荐）

dsh plugin --profile web add github:xohmai/dsh-cpa-status
# 锁定版本更安全：github:xohmai/dsh-cpa-status#<commit-sha>

本插件零构建（纯 JS，无 TypeScript / 无打包步骤），git 安装不会踩「源码拉下来没跑 build」的坑，也无需 pnpm allowBuilds 授权。

方式二：tarball 离线分发（内网场景）

npm pack                                             # 产出 dsh-cpa-status-0.1.0.tgz（约 31 kB / 6 个文件）
dsh plugin --profile web add ./dsh-cpa-status-0.1.0.tgz

配置

点侧栏「连接 CPA」，填两项：

• Base URL：CPA 地址，如 http://127.0.0.1:8317；反代场景填到子路径根（https://example.com/abc123）
• Management Key：CPA 管理密钥，仅存本机凭据库

Public URL 可选（「管理页 ↗」外链，默认 {Base URL}/management.html）。亦可用环境变量 CPA_BASE_URL / CPA_MANAGEMENT_KEY 预置（env 注入时表单密钥只读）。

安全

• Management Key 只写入本机凭据库，接口响应不回传完整密钥
• 账号/网关字段白名单返回；网关密钥仅显示末四位
• 面板可开脱敏模式，进一步打码邮箱、地址与名称

详见 [SECURITY.md](./SECURITY.md)。

License

Apache-2.0