dsh-api-balance：Web 侧边栏余额小组件与查询工具

在 DeepSeek Harness (DSH) 开发智能体时，监控 API 消耗是日常运维的一部分。通常开发者需要切换到官方控制台或使用外部工具查看余额。dsh-api-balance 插件直接解决了这个问题，它将余额查询能力集成到 DSH Web 界面中，同时暴露给模型使用。

该插件由用户 neltharion11 维护，开源协议为 MIT。

核心功能¶

插件包含三个主要部分：

Web 侧边栏小组件：插入到 sidebar.footer.action 槽位。展开侧边栏时显示余额（取第一个币种），收起时显示钱包图标。悬停可查看明细（充值、赠金、更新时间），点击可刷新。小组件每 20 秒轮询一次，宿主端有 60 秒缓存兜底，避免高频调用。
api_balance 工具：模型可在对话中调用此工具，获取详细的余额信息（币种、总额、充值、赠金、更新时间）。
系统提示词小节：自动向模型注入说明，告知其存在余额小组件与工具。

环境要求¶

DeepSeek Harness：使用 web profile。
Node.js：版本需大于等于 22.19。
API 密钥：需要一个可用的 DeepSeek API 密钥。

安装¶

方式一：从 GitHub 安装（推荐）¶

插件依赖 pnpm。请在终端执行以下命令：

dsh plugin --profile web add git+https://github.com/neltharion11/dsh-api-balance.git

dsh plugin 会将包安装到 profile 并加入 dsh.profile.bundles 列表。

方式二：本地路径安装¶

如果本地已有源码，可以使用本地路径：

dsh plugin --profile web add file:F:\path\to\dsh-api-balance

方式三：手动安装¶

当机器上没有安装 pnpm 时，请严格按以下步骤操作：

准备文件夹：确保文件夹名与包名完全一致，即 dsh-api-balance（从 GitHub 下载 ZIP 解压后，默认名称通常包含 -main 后缀，需重命名）。
放置文件：将 dsh-api-balance 文件夹复制到 %DSH_HOME%\profiles\node_modules\dsh-api-balance。
修改配置：编辑 %DSH_HOME%\profiles\web\package.json。
- 在 dependencies 中添加："dsh-api-balance": "file:../node_modules/dsh-api-balance"。
- 在 dsh.profile.bundles 中添加："dsh-api-balance"。
验证：执行 dsh --profile web --dump-config | findstr api-balance，确认输出包含 - id: api-balance。

安装后必须重启 dsh web 才能生效。

配置¶

通过 profile 的 cordis.patch.yml 覆盖插件配置（行 id 为 api-balance）：

- id: api-balance
  config:
    apiKeyEnv: DEEPSEEK_API_KEY   # 凭据引用名
    baseURL: https://api.deepseek.com
    timeoutMs: 15000              # 单次上游请求超时
    cacheMs: 60000                # 宿主缓存余额快照的时长
    enabled: true

注意事项¶

密钥安全：密钥仅在宿主内存中用于 Authorization: Bearer 头，永不会出现在 HTTP 响应、工具结果或日志里。
依赖：除方式三外，安装过程依赖 pnpm。
生效时机：安装后需要重启 DSH Web 进程。

总结¶

dsh-api-balance 将 API 余额监控从外部流程整合进了 DSH 生态。开发者无需离开工作流即可查看余额，模型也能自主查询。更多细节可参考 GitHub 仓库或 SkillHub 插件目录。