前言¶
在 DeepSeek Harness（DSH）里跑智能体时，内置用量统计能回答「用了多少 token」，但很难直接回答「这个 New API 中继站点上还剩多少钱、按最近消耗还能撑几天」。若你通过 开物云（Kaiwu Cloud，New API 中继）转发模型请求，余额和充值入口通常在站点控制台，和 DSH 界面是分开的。
下面介绍社区插件 dsh-zhijiang-connector（维护者 Guan-HP），它把开物云的余额、消耗与充值入口接到 DSH Web GUI 侧栏，并在余额紧张时用颜色提示。插件归类为 admin-security，当前 GitHub 星标为 1；目录页见 SkillHub，源码与文档在 GitHub 仓库。DSH 社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-zhijiang-connector（npm 包名 dsh-zhijiang-connector，版本 0.1.0，MIT 许可证）在 DSH Web 界面提供：
- 侧栏持久徽章（例如
开物云 ¥16.80，可用天数不足时变琥珀色或红色）； - 点击后的浮动面板：余额、已用、近 24 小时、日均消耗、可用天数（runway）、密钥名称、过期时间等；
- 一键打开站点钱包页充值（插件不处理支付数据）。
官方简介：Balance, spend runway and top-up entry for a New API relay in the DSH web GUI sidebar。
核心功能¶
侧栏与面板¶
- Sidebar badge：显示站点名与金额；根据
warningDays/criticalDays改变严重程度颜色。 - Floating panel：汇总余额、消耗与预测；
forecast.level可为normal、warning、critical或unknown（新装无消耗历史时如实显示，不假装「还剩 0 天」）。 - Top-up entry：一键跳转
walletURL（默认<baseURL>/console/wallet），不嵌入支付、不代付、不处理兑换码。
两条只读通道¶
| 通道 | 上游 | 需要 | 回答的问题 |
|---|---|---|---|
| 密钥 | GET /api/usage/token/ |
sk- API key |
该密钥的上限与该密钥归因的消耗 |
| 账户 | GET /api/user/self |
控制台 PAT（nap_） |
钱包里还剩多少钱 |
只配置 sk- 时，插件不展示账户余额（显示 —），并提示配置 access token；密钥 unlimited_quota: true 只表示该密钥无消费上限，不能代替钱包余额。金额换算从每次刷新的 /api/status 读取 quota_per_unit 与汇率，不做硬编码默认值；CNY 站点若缺汇率会失败并回退缓存，避免静默算错。
降级与边界¶
- 超时或限流时保留上次成功值，并标记 stale。
- 明确不做：嵌入支付、新增独立页面路由、探测模型连通（避免真实扣费）、修改
llm-pi-ai提供商配置。 - 本地缓存文件：
$DSH_HOME/storages/zhijiang-connector.json；密钥写入~/.dsh/.credentials.yaml（明文，仅当前用户可读）。
安装与启用¶
要求：Node.js >= 20，DSH >= 0.2.1-rc.1 且 < 0.3.0-0（见 package.json 的 engines）。
Web 配置（推荐从 npm 安装）：
dsh plugin --profile web add dsh-zhijiang-connector
或从 Git 仓库安装（README 占位符为 OWNER，实际仓库为 Guan-HP）：
dsh plugin --profile web add git+https://github.com/Guan-HP/dsh-zhijiang-connector.git
桌面版需先完全退出 Electron，再执行：
dsh plugin --profile desktop add dsh-zhijiang-connector
安装会在 $DSH_HOME/profiles/<profile>/package.json 的 dsh.profile.bundles 中登记，并通过 cordis.patch.yml 挂载宿主侧逻辑。
典型用法：配置与查看¶
- 打开 Web GUI → 侧栏 Settings → Kaiwu Cloud。
- 在 API key 粘贴
sk-密钥；在 Balance token 粘贴nap_仪表盘访问令牌（建议在开物云「Security & Access → Access Tokens」创建，范围仅 usage:read + wallet:read）。 - 点击 Save 一次；侧栏即出现余额徽章，无需再找第二个按钮。
站点地址、刷新间隔、告警阈值在 ▸ Advanced（默认折叠）；默认 baseURL 为 https://ai.zhijianginc.com。凭证槽位只读显示 Stored as: zhijiangApiKey；多站点用户可用 Change 改 credentialRef。Clear 与保存空框分离，避免误删已存密钥。
常用配置项（完整表见 README）：
| 字段 | 默认值 | 含义 |
|---|---|---|
baseURL |
https://ai.zhijianginc.com |
站点地址，热更新 |
credentialRef |
zhijiangApiKey |
存放 sk- 的凭证名 |
accountCredentialRef |
空 | 存放 PAT 的凭证名；空则关闭账户通道 |
refreshSeconds |
300 |
刷新间隔，最小 60 |
warningDays |
3 |
低于此可用天数徽章变琥珀 |
criticalDays |
1 |
低于此变红 |
walletURL |
<baseURL>/console/wallet |
充值深链 |
保存 PAT 时内部指向 ZHIJIANG_ACCESS_TOKEN；清除 token 会一并清除对应凭证名。
宿主 HTTP 接口（仅 loopback）¶
插件在 /api/zhijiang/ 下提供五条路径，均限制为 loopback 对等访问；任何路由都不返回密钥明文。设置页主要使用 POST /api/zhijiang/credential 与 POST /api/zhijiang/settings；可读 GET /api/zhijiang/snapshot 获取缓存或触发刷新。请求体超过 8 KiB 会拒绝；校验失败返回 400 及逐字段 reason。
适用场景与注意¶
适合：在 DSH Web 或 Desktop 中长期使用开物云（或其它兼容 New API 且行为一致的中继），希望在 harness 内一眼看到「还剩多少钱、还能用几天」，并快速打开钱包充值的用户。
注意：
- 插件以当前 DSH 进程权限运行；安装前请自行审阅 源码 与 MIT 许可证。
- 只看密钥额度无法替代钱包余额；要显示真实余额必须配置 PAT。
- 仅
sk-时访问/api/user/self得到 401 是站点设计，不是配错。 - 社区目录 SkillHub 插件页 便于发现同类 admin-security 插件；安装与配置仍以 GitHub README 为准。
结尾¶
dsh-zhijiang-connector 补上了 DSH 内置统计没有的一问：中继站点上还剩多少资金、按近期消耗还能撑多久，并把充值入口放在侧栏一步可达。需要细节时打开 GitHub README（含 中文 README）与 SkillHub 目录页 即可。
