dsh-usage-balance
在 DeepSeek Harness（dsh）侧边栏底部显示账号余额与余额剩余比例环；余额达到你设定的预警阈值时圆环变红。
一个 Host 半边（占位）+ 一个浏览器半边（全部界面），零运行时依赖，不需要构建步骤。
英文摘要：A DeepSeek Harness plugin that shows the account balance and a remaining-share ring in the sidebar footer. Both the ring's denominator (a baseline you enter) and the alert threshold are yours to set; the ring turns red once the balance reaches the threshold. No build step, no runtime dependencies. See 安装 — install it from the Plugins page by absolute path.
目录
功能
侧边栏底部、"设置"上方多出一行与宿主同款样式的控件。悬停给出操作提示：
Alt + 左键打开的面板，余额明细、基准与阈值都在这里：
| 状态 | 胶囊显示 |
|---|---|
| 读取中 | 图标 + 骨架条 |
| 已登录 | 图标 + 金额 + 圆环 |
| 未登录 | 登录后查看 |
| 读取失败 | 红色 读取失败，点击重试 |
| 未充值 | 未充值 |
圆环：两个数字都由你决定
插件不猜任何分母。你在面板里填两个值，它们共同决定圆环：
| 值 | 作用 |
|---|---|
| 余额基准 | 圆环的分母。填充比例 = 当前余额 / 基准，余额越少环越空 |
| 预警阈值 | 只决定颜色。余额 ≤ 阈值时圆环变红 |
两者按币种分别存储（CNY、USD 各一套）。没配基准的币种不画环；配了但当前没有该币种钱包时静默跳过，配置保留。
因为没有分母就不画环，所以首次安装后请先打开面板填一个基准。点「用当前余额」可以一键填成当前余额，环就从 100% 开始。
安装
需要 dsh 桌面版或 Web 版，且能打开 Plugins（插件） 页面。
- 把本目录放到一个稳定位置（不要之后移动或删除）。
- 侧边栏 → Plugins → Add plugin。
- 填入本目录的绝对路径，例如：
C:\Users\you\plugins\dsh-usage-balance - 安装完成后确认 bundle 已开启，然后刷新页面。
安装走的是 profile 的 link: 依赖，所以目录必须留在原处；移动目录会导致插件失效，需要重新安装。
使用
- 左键胶囊 → 刷新余额。
- Alt + 左键（macOS 为 Option + 左键）→ 打开面板。
面板里：
- 输入基准时，上面的「剩余」行会实时预览新比例，保存前就能看到结果。
- 两个字段一起提交，不会写一半。
- 输入非法会点名到字段（
余额基准必须是大于 0 的数字），且不会落盘。 - 两个字段都清空会被拒绝（否则环没有东西可显示）。
- 「清除」只影响当前编辑的币种。
- 「用当前余额」把基准填成当前余额，仍需点保存才生效。
数据与存储
余额来自宿主已有的 account.getBalance——也就是"设置 → 账号"里那张余额卡片用的同一条 Host 查询。插件不直接访问网络，也拿不到你的凭证。
阈值与基准存在浏览器 localStorage（展示偏好，不写进 profile 配置）：
| key | 内容 |
|---|---|
dsh-usage-balance:thresholds |
各币种预警阈值，单位「分」的整数 |
dsh-usage-balance:baselines |
各币种余额基准，单位「分」的整数 |
- 换浏览器、清空站点数据会丢失；卸载重装则保留。
- 两个字段都按币种分开读写，所以清除一个币种不会动另一个。
前提与限制
- 余额只对「DeepSeek 账号登录」可见。 若你在用 API Key 而未登录账号，胶囊会显示
登录后查看。 - 宿主没有充值流水接口。 账号 remote 只暴露余额快照（底层
/api/v0/users/get_summary），没有充值记录。所以插件不会自动知道"这次充了多少"——基准完全由你手动维护。充值后想重新起算，点「用当前余额」。 - 只统计充值钱包，不含赠金。 这样赠金发放不会抬高分母、赠金过期也不会看着像消费。纯赠金账号不画环。
- 侧边栏只画一个环。 同时配置 CNY 与 USD 时，存储与计算是分开的，但胶囊只显示第一个；面板编辑的是"环的币种，否则第一个有钱包的币种，否则 CNY"。
- 面板上报给宿主的
CLIENT_VERSION = '0.2.0-rc.2'是"调用方 UI 身份"用的版本号，随 dsh 升级可同步更新。
实现要点
给想改代码、或想写同类 dsh 插件的人：
- 包结构：
package.json声明dsh.bundle.patch与dsh.client.platform: 'web'；cordis.patch.yml往 profile 插入一行；index.js是空的 Host 半边（只为让 bundle 有一行，从而让浏览器半边可被发现）；client.js是全部界面。client.js由宿主按原样作为普通脚本加载，不经过打包，所以里面只能用React.createElement，没有 JSX、没有 ESM。 - 渲染进槽位：注册到
sidebar.footer.action（由dsh-client-ui-sidebar声明的 list 槽位）。组件由框架注入t（翻译）与wide（侧边栏是否展开）。 - 不 import 宿主的 Client 包（如
dsh-client-ui-primitives），这是 dsh 插件规范的要求。因此两处宿主控件是照抄而非引用：- Tooltip：
position: fixed+ 锚点getBoundingClientRect()。几何直接写到 DOM 节点、不经过 state，所以定位不会自触发重渲染。侧边栏列是overflow: hidden且本组合没有 portal 服务，只有 fixed 能逃出裁剪。 - ContextMeter 圆环：14px viewBox、r=5.5、2px stroke，用
stroke-dasharray填充。
- Tooltip：
- 只用主题 token（
--dsw-alias-*、--dsw-specific-menu、--dsw-elevation-panel等），深浅色自动跟随。样式表里没有任何硬编码颜色。 - 纯函数负责计算 + 一个 store 负责读取协调：
ringReadings(balance, baselines, thresholds)之类是纯函数；createBalanceStore处理并发——每个刷新请求会等到"一次在它之后开始的读取"，且只有最新的读取能发布结果，所以慢读不会覆盖新值。 - 文案走 Client locale 服务，中英两套字典。
开发与验证
三个离线脚本，对着真实模块契约跑（不是对着假设），位于上一层 plugins/ 目录：
| 脚本 | 覆盖 |
|---|---|
../_verify-balance.js |
注册形状、悬停气泡、五种状态渲染、点击与 Alt+点击、圆环几何与阈值变色、多币种、面板两个字段的校验与保存、清除范围、rebase |
../_probe-store.js |
数据层：首读、并发刷新不被慢读覆盖、未登录不重复请求、拒绝与抛错、金额格式 |
../_verify-theme.js |
把插件引用的每个 --dsw-* 变量沿 var() 链解析成最终色值，逐项比对深浅两套调色板 |
node ../_verify-balance.js
node ../_probe-store.js
node ../_verify-theme.js
三个脚本都以非零退出码表示失败。_verify-theme.js 还会拒绝两类问题：引用了不存在的变量、以及某个表面在深浅两色下取值相同。
许可
MIT
还没有评论，来写第一条。