余额看板 eka3os/dsh-balance

dsh-balance

一个 DeepSeek Harness Web 插件，在侧边栏底部显示你的 DeepSeek API 余额。

show balance

插件当前版本为 0.2.0，要求 DeepSeek Harness >=0.1.2-rc.1 <0.3.0-0。

功能

- 在侧边栏设置区域旁显示人民币和美元余额。
- 通过 DeepSeek 官方 API 端点读取余额。
- API key 保留在服务端，浏览器只会收到规范化后的余额数据。
- 每 60 秒自动刷新余额。
- 加载中、没有可用余额或请求失败时显示 --。
- 支持直接从 GitHub 仓库安装。

要求

- DeepSeek Harness >=0.1.2-rc.1 <0.3.0-0（已在 0.2.0-rc.2 上验证）
- web 配置档
- 已配置 DEEPSEEK_API_KEY

安装

直接从 GitHub 安装

dsh plugin --profile web add github:eka3os/dsh-balance

安装完成后重启 Web 配置档：

dsh web

dsh plugin 会把包安装到选定的配置档，并自动将其激活为配置档 bundle，因为该包声明了 dsh.bundle.patch。

配置

插件使用 DEEPSEEK_API_KEY 凭据引用。有可用的 DeepSeek Harness 凭据/设置界面时，请通过该界面配置 key。你也可以在单次运行的启动环境中提供：

DEEPSEEK_API_KEY=sk-your-key dsh web

如需托管本地凭据，把 key 添加到 $DSH_HOME/.credentials.yaml：

DEEPSEEK_API_KEY: sk-your-key

不要把 API key 或凭据文件提交到 Git。

工作原理

1. Host 插件注册 GET /api/dsh-balance。
2. 该路由通过 DSH 凭据解析 DEEPSEEK_API_KEY。
3. Host 携带服务端 Bearer token 请求 https://api.deepseek.com/user/balance。
4. 客户端插件在侧边栏底部渲染返回的人民币/美元余额。
5. 宽侧边栏可见时，客户端每 60 秒重复一次请求。

兼容性说明

版本 0.2.0 让插件适配 DSH 0.2 客户端布局：

- slots 服务从已退役的 @deepseek-ai/dsh-client-runtime 包（最后版本 0.1.1-rc.2）迁移到了 @deepseek-ai/dsh-client-ui-renderer，因此 peer 声明和 dsh.client.inject 列表现在都指向 renderer。DSH 0.2 会拒绝加载任何 @deepseek-ai/dsh- peer 无法满足的 bundle，这正是 skipping profile bundle … is incompatible with dsh 0.2.0-rc.2 错误的来源。
- dsh.client.inject 是到达顺序约定：列出的每个包都会先于本插件的 bundle 加载，因此 apply() 运行时 slots 总是可用。
- 侧边栏底部的标记、样式表钩子和布局类名在 0.1.7-rc.2 与 0.2.0-rc.2 之间没有变化，所以渲染结果完全一致。
运行 npm run check，对照已安装的 DSH 契约验证前后两半（host 路由行为加 client 插槽注册）。

API 端点

| 方法 | 路径 | 说明 |
| GET、HEAD | /api/dsh-balance | 返回当前 DeepSeek API 余额。 |

成功响应包含以下结构：

{
"isAvailable": true,
"balances": [
{ "currency": "CNY", "totalBalance": "10.00" },
{ "currency": "USD", "totalBalance": "1.00" }
]
}

凭据缺失时路由返回 503；DeepSeek API 无法访问或返回失败响应时返回 502；不支持的方法返回 405。

GitHub 分发

本插件只通过 GitHub 分发，未发布到 npm。把仓库推送到 GitHub，并确保构建产物 lib/ 下的文件以及 package.json 中列出的包文件都已提交。

许可证

MIT

一个 DeepSeek Harness Web 界面插件，把 DeepSeek API 余额显示在侧边栏底部。

show balance

当前版本为 0.2.0，要求 DeepSeek Harness >=0.1.2-rc.1 <0.3.0-0。

功能

- 在侧边栏设置区域附近显示 CNY 和 USD 余额。
- 通过 DeepSeek 官方余额接口获取数据。
- API Key 只在服务端使用，浏览器只接收规范化后的余额数据。
- 每 60 秒自动刷新一次余额。
- 加载中、没有余额或请求失败时显示 --。
- 支持直接从 GitHub 仓库安装。

环境要求

- DeepSeek Harness >=0.1.2-rc.1 <0.3.0-0（已在 0.2.0-rc.2 上验证）
- web 配置档
- 已配置的 DEEPSEEK_API_KEY

安装

直接从 GitHub 安装

dsh plugin --profile web add github:eka3os/dsh-balance

安装完成后重新启动 Web 配置档：

dsh web

dsh plugin 会把包安装到指定配置档，并根据本包声明的 dsh.bundle.patch 自动将其激活为配置档 bundle。

配置

插件使用 DEEPSEEK_API_KEY 作为凭据引用。建议在 DeepSeek Harness 的凭据／设置界面中配置 API Key。也可以在启动时通过环境变量提供，仅对本次运行生效：

DEEPSEEK_API_KEY=sk-your-key dsh web

如果使用 DSH 的本地凭据文件，可以把密钥写入 $DSH_HOME/.credentials.yaml：

DEEPSEEK_API_KEY: sk-your-key

请勿将 API Key 或凭据文件提交到 Git 仓库。

工作原理

1. Host 插件注册 GET /api/dsh-balance 路由。
2. 路由通过 DSH credentials 服务解析 DEEPSEEK_API_KEY。
3. Host 使用服务端 Bearer Token 请求 https://api.deepseek.com/user/balance。
4. Client 插件把返回的 CNY/USD 余额渲染到侧边栏底部。
5. 侧边栏处于宽布局时，Client 每 60 秒重复请求一次。

API 接口

| 方法 | 路径 | 说明 |
| GET、HEAD | /api/dsh-balance | 返回当前 DeepSeek API 余额。 |

成功响应示例：

{
"isAvailable": true,
"balances": [
{ "currency": "CNY", "totalBalance": "10.00" },
{ "currency": "USD", "totalBalance": "1.00" }
]
}

凭据缺失时返回 503；DeepSeek API 无法访问或返回失败状态时返回 502；不支持的方法返回 405。

兼容性说明

0.2.0 版本适配了 DSH 0.2 的客户端结构：

- slots 服务已从被移除的 @deepseek-ai/dsh-client-runtime 包（最后一个版本为 0.1.1-rc.2）迁移到 @deepseek-ai/dsh-client-ui-renderer，因此 peer 依赖声明与 dsh.client.inject 列表现在指向 renderer。DSH 0.2 会拒绝加载任何 @deepseek-ai/dsh- peer 无法满足的 bundle，这正是 skipping profile bundle … is incompatible with dsh 0.2.0-rc.2 报错的原因。
- dsh.client.inject 是加载顺序契约：其中列出的每个包都会先于本插件 bundle 加载，因此 apply() 执行时 slots 必定可用。
侧边栏底部结构、样式钩子与布局类名在 0.1.7-rc.2 与 0.2.0-rc.2 之间没有变化，因此渲染结果保持一致。

运行 npm run check 可针对当前安装的 DSH 契约校验两部分实现（Host 路由行为与客户端 slot 注册）。

GitHub 分发

本插件仅通过 GitHub 分发，不发布到 npm。将仓库推送到 GitHub，并确保已提交 lib/ 构建产物以及 package.json 中列出的包文件。

许可证

MIT