dsh-balance：对话界面余额监控

前言¶

DeepSeek Harness (DSH) 采用插件化架构，方便扩展功能。在开发或日常使用中，监控 API 余额消耗是刚需。dsh-balance 插件通过在对话界面下方嵌入余额组件，解决了“余额不足未察觉”的问题。

插件定位¶

这是一个客户端插件，由 Shawnxxboxx 维护，开源 MIT 协议。它的核心作用是在 DSH web 界面的消息区与输入框之间，显示 DeepSeek 账户的当前余额。

核心功能¶

• 界面嵌入：在 conversation.input.dock 槽位渲染紧凑余额条，例如 💰 CNY 19.63。
• 自动刷新：每 15 秒自动刷新余额，轮询 host 路由 /dsh-balance/balance。
• 交互详情：鼠标悬停可查看“赠送/充值”拆分详情。
• 容错处理：余额不可用时显示降级文案，不打扰对话。
• 安全设计：零依赖、无构建脚本，API key 仅保留在 host 侧，永不下发浏览器。

安装与启用¶

前置条件：DSH 已安装且 dsh web 可运行；Node.js ≥ 20；pnpm ≥ 10。

1. 执行安装命令：

    dsh plugin --profile web add dsh-balance-dock

2. 重启 dsh web（插件包含 host 侧逻辑，需要重启挂载）。
3. 硬刷新浏览器（Cmd/Ctrl+Shift+R）。

典型用法¶

• 在插件列表中搜索 dsh-balance-dock。
• 确认 DEEPSEEK_API_KEY 已在模型设置页配置。

注意事项¶

• 命名差异：npm 包名是 dsh-balance-dock，GitHub 仓库名是 dsh-balance，两者是同一个插件。
• pnpm 11 策略：如果遇到新版本安装失败或装到旧版本，需在 profile 的 pnpm-workspace.yaml 中添加 minimumReleaseAgeExclude 策略排除该包。
• 热更新差异：host 侧改动需重启 dsh web，client 侧改动刷新页面即可生效。

总结¶

该插件通过轻量级的设计实现了余额监控，适合需要精细化管理 API 使用的开发者。更多详情可访问 GitHub 或 技能库目录。