@ek3os/dsh-balance
在侧边栏的“设置”旁显示 API 余额的 DeepSeek Harness Web 插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:eka3os/dsh-balance#f3e59c76ba857bc9abdb2719ff7f302d16c1ec80Balance 以 @ek3os/dsh-balance 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness Web plugin that displays your DeepSeek API balance in the sidebar footer.
The plugin is currently
0.2.0and requires DeepSeek Harness>=0.1.2-rc.1 <0.3.0-0.
-- while loading, when no balance is available, or when the request fails.>=0.1.2-rc.1 <0.3.0-0 (verified against 0.2.0-rc.2)web profileDEEPSEEK_API_KEYdsh plugin --profile web add github:eka3os/dsh-balance
Restart the Web profile after installation:
dsh web
dsh plugin installs the package into the selected profile and automatically activates it as a profile bundle because this package declares dsh.bundle.patch.
The plugin uses the DEEPSEEK_API_KEY credential reference. Configure the key through the DeepSeek Harness credentials/settings UI when available. You can also provide it through the launch environment for a single run:
DEEPSEEK_API_KEY=sk-your-key dsh web
For a managed local credential, add the key to $DSH_HOME/.credentials.yaml:
DEEPSEEK_API_KEY: sk-your-key
Do not commit API keys or credential files to Git.
GET /api/dsh-balance.DEEPSEEK_API_KEY through DSH credentials.https://api.deepseek.com/user/balance with a server-side Bearer token.Version 0.2.0 adapts the plugin to the DSH 0.2 client layout:
slots service moved from the retired @deepseek-ai/dsh-client-runtime package (last release 0.1.1-rc.2) to @deepseek-ai/dsh-client-ui-renderer, so the peer declarations and dsh.client.inject list now name the renderer. DSH 0.2 refuses to load any bundle whose @deepseek-ai/dsh-* peers cannot be satisfied, which is what produced the skipping profile bundle … is incompatible with dsh 0.2.0-rc.2 error.dsh.client.inject is the arrival-order contract: every listed package is loaded before this plugin's bundle, so slots is always available when apply() runs.Run npm run check to verify both halves against the installed DSH contract (host route behavior plus client slot registration).
| Method | Path | Description |
|---|---|---|
GET, HEAD | /api/dsh-balance | Returns the current DeepSeek API balance. |
Successful responses contain the following shape:
{
"isAvailable": true,
"balances": [
{ "currency": "CNY", "totalBalance": "10.00" },
{ "currency": "USD", "totalBalance": "1.00" }
]
}
The route returns 503 when the credential is missing and 502 when the DeepSeek API cannot be reached or returns an unsuccessful response. Unsupported methods return 405.
This plugin is distributed through GitHub only and is not published to npm. Push the repository to GitHub and make sure the built lib/ files and the package files listed in package.json are committed.
MIT
一个用于 DeepSeek Harness Web 界面的插件，会将 DeepSeek API 余额显示在侧边栏底部。
当前版本为
0.2.0，要求 DeepSeek Harness>=0.1.2-rc.1 <0.3.0-0。
--。>=0.1.2-rc.1 <0.3.0-0（已在 0.2.0-rc.2 上验证）web profileDEEPSEEK_API_KEYdsh plugin --profile web add github:eka3os/dsh-balance
安装完成后重新启动 Web profile：
dsh web
dsh plugin 会将包安装到指定 profile，并根据本包声明的 dsh.bundle.patch 自动将其激活为 profile 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 仓库。
GET /api/dsh-balance 路由。DEEPSEEK_API_KEY。https://api.deepseek.com/user/balance。| 方法 | 路径 | 说明 |
|---|---|---|
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 必定可用。运行 npm run check 可针对当前安装的 DSH 契约校验两部分实现（Host 路由行为与客户端 slot 注册）。
本插件仅通过 GitHub 分发，不发布到 npm。将仓库推送到 GitHub，并确保已提交 lib/ 构建产物以及 package.json 中列出的包文件。
MIT