dsh-ds-balance
DSH 插件：在侧边栏底部显示 DeepSeek 账户余额，并在 Plugins 页面提供配置卡片。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-ds-balance@2.0.0-alpha.1
Ds Balance 以 dsh-ds-balance 发布，当前版本为 2.0.0-alpha.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
[!NOTE] 余额读自 DeepSeek 官方
GET /user/balance，不是估算。凭据只经 DSH 的凭据通道解析：API Key 不会出现在设置文件里，也不会返回给界面。
余额要有地方看，但不该占地方。左边栏底部一个常驻的状态环，点开是三段金额与数据新鲜度；要改配置，进侧边栏**插件（Plugins）**页里本插件的详情页。
左边栏底部的「DeepSeek 余额」条目与展开的余额浮层
常驻左边栏底部，与「使用统计」「设置」并排；点开是余额、赠送 / 充值拆分与数据新鲜度。
| 界面 | 一句话 | 你会用它来 |
|---|---|---|
| 侧栏圆环 | 常驻左边栏底部的状态环 + 名称，展开态悬浮条目就报出余额金额，环里填了多少 = 余额离该币种预警线还有多远 | 扫一眼就知道还剩多少、离预警线多远 |
| 余额浮层 | 点条目展开：总额、赠送 / 充值拆分、数据新鲜度、手动刷新（带冷却）；右上角图标一键跳到插件页 | 核对具体数字，以及数据是几分钟前的 |
| 设置卡片 | 连接 / 展示 / 阈值 / 刷新四组，默认四组全收起，点组头逐组展开 | 换端点、换币种、调预警线、调节奏 |
三种界面的分工是死的：圆环回答「大概还剩多少」，浮层回答「具体是多少」，卡片回答「怎么算」。
插件页里的「DeepSeek 余额」卡片
卡片就是这四组：默认四组全收起，点组头逐组展开；组里有填错的项时那一组会自己展开。
engines.dsh 与 peerDependencies 为准，本插件跟的是宿主当前那条 alpha 线。>= 20（同上，真源是 engines.node）。装宿主时要显式点名版本线：@deepseek-ai/dsh 的 latest 标签比本插件要求的那条线还旧 —— 按默认方式装会落在声明范围之外。
npm install -g @deepseek-ai/dsh@alpha # 本插件承诺支持的线
兼容性不是推断出来的：每周由 compat.yml 在 alpha 与 next 两条线上换包实跑一遍现有测试，另有一步单独判声明面罩不罩得住；红了会开或更新一条固定标题的跟踪 issue。当前结论与红了怎么办见 兼容性，宿主版本的分水岭见版本兼容。
dsh plugin --profile web add dsh-ds-balance
装完重启 dsh --profile web 生效。
git clone https://github.com/zlZayn/dsh-ds-balance.git
cd dsh-ds-balance
npm install && npm run build
dsh plugin --profile web add "$PWD"
与 npm 那条路一样，重启后生效。
dsh-ds-balancezlZayn/dsh-ds-balance仓库带有 GitHub topic dsh-plugin，插件市场据此自动发现插件。
plugins.bundle.config 槽，该槽由 DSH 0.1.6-alpha.2 引入（下限的真源是 package.json 的 engines.dsh，现状现查 node scripts/compat-swap.mjs check）。[WARN]，说明配置界面为什么不可用、该往哪儿升级。engines.dsh 声明的那一版或更高：npm install -g @deepseek-ai/dsh@alpha。declaration 巡检专门盯这件事，红了怎么办见兼容性。打开侧边栏 插件（Plugins） →「已安装（Installed）」组，点进 dsh-ds-balance 的详情页；配置表单直接铺在那一页上，四组默认全收起，点组头逐组展开：
Plugins 页列表里「DeepSeek 余额」的位置
Plugins 页列表里的位置：dsh-ds-balance 与其他已安装插件并排；点进它的详情页才是上面那张配置表单。
保存即生效，不必重启 DSH。
密钥只经 DSH 的凭据通道解析，卡片里的 API Key 一栏默认继承官方模型页配好的那一份，且只读不可改。
由启动环境（环境变量）提供时，字段只读，徽标写明来源。
.salt 文件（在 DSH 的 home 目录下）参与派生；它丢了，旧快照就读不回来。api.deepseek.com，不代理、不转发其他流量。MIT。
外部贡献入口（报 bug 带什么、提功能前先翻什么、提 PR 前做什么）→ CONTRIBUTING.md。
设计取向与实现约束 → docs/ARCHITECTURE.md；发布流程与版本号判定 → docs/PUBLISHING.md；维护者文档地图 → AGENTS.md。
