前言¶
在 DeepSeek Harness（DSH）里长时间跑会话时，账户余额、当前是峰时还是非峰时、以及本会话已经烧了多少 token，往往要切到浏览器或平台页面才能看清。官方账户区能查余额，但和 Composer 输入区不在同一视线里，补余额也要离开当前工作流。
下面介绍社区插件 dsh-wallet-ru（npm 包名 dsh-plugin-wallet-ru）。它在 Composer 文档栏以一行「芯片」展示 тариф（峰时 / 非峰时）、多币种余额、本会话 token 与费用，并支持应用内打开充值页、点击会话费用查看近 7 日支出柱状图。界面文案为俄语；维护者为 Vasyarot，归类为 DSH 客户端插件。插件在 SkillHub 目录 与 GitHub 分发，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-wallet-ru 面向 DSH 0.2.x（engines.dsh: >=0.2.1-rc.5 <0.3.0），在 Web 与 Desktop 配置文件的 Composer 文档区域注入客户端 UI，并由插件宿主提供 /wallet-ru 等路由聚合定价与用量数据。
芯片示例（来自 README，布局示意）：
Не пик 12 ч 45 мин · Баланс: $0.83 · ¥12.50 · бонус $1.00 · Сессия: 12,3 тыс. ток · $0.04
↑ 悬停：单价 ↑ 悬停：$, ¥, 赠金 ↑ 点击：近 7 日支出
文档栏芯片展示什么¶
| 元素 | 含义 |
|---|---|
| тариф | Не пик（非峰）绿色，Пик（峰时）红色 |
| 剩余时间 | 距离切换 тариф 的倒计时（如 12 ч 45 мин） |
| 余额 | 美元始终排在最前，下划线可点击跳转充值；人民币与赠金仅在余额大于零时显示 |
| 会话 | 当前会话 token 与美元费用，下划线可点击打开 7 日图表 |
平台通过 normal_wallets 与 bonus_wallets（每项为 {currency, balance}）下发币种；客户端先打印 USD，再打印非美元钱包（CNY 用 ¥），赠金带「бонус」标记。
悬停提示与点击行为¶
各区块有独立 tooltip，不再使用一条长字符串。
峰时 / 非峰时：只展示每百万 token 的输入、缓存读、输出单价；当前生效 тариф 在上，另一档在下。非峰时示例价为输入 $0.14、缓存 $0.014、输出 $0.21；峰时约为 ×2。具体数值来自宿主 GET /wallet-ru 的 perMillion，平台调价后无需改客户端。
余额：分别列出美元、人民币、赠金；无人民币时显示「нет」，无赠金时显示 0。
会话：无 tooltip；点击打开近 7 日支出窗口。
点击余额金额：在应用内全屏 overlay 打开 platform.deepseek.com/top_up，顶栏含「返回 · 充值 · 重新加载 · 在浏览器中打开」。overlay 挂在 shell.overlay，与账户模块的 PlatformOverlay 同一稳定宿主，避免 Composer 文档重绘把原生 WebView 清掉。若遇 AWS WAF 挑战导致白屏，可点「重新加载」；open() 网络失败时插件最多自动重试 3 次（间隔约 0.8–2.2 秒），成功打开后不会盲目重载。
点击会话费用：在芯片上方弹出宽 300px 的 7 日柱状图，Esc、点外部或再次点击可关闭。
7 日支出窗口¶
窗口含标题、周合计、详情行与 7 根柱。柱高对应当日费用；无请求的日子为细灰条，便于看出空档。柱下为俄文缩写 weekday（пн、вт …）。悬停柱体显示日期、金额、token 与请求数；未悬停时底部行显示本周 token 与请求总数。宿主从 sessionPersistence 读会话日志，按日汇总并按各请求时刻的 тариф 计费；客户端也会补齐 7 天窗口以兼容只返回「有消费日期」的旧宿主。
会话 token 与定价数据来源¶
会话 token 来自 slot 的 tokenUsage 投影（useProjection）：无缓存输入 + 缓存读 + 缓存写 + 输出。壳层未提供投影时显示 —。美元费用按当前 тариф 的每百万 token 价计算；缓存写入按输入价计。
余额获取顺序¶
- 已登录 DeepSeek 账户：
deepseekAccount.getBalance()，无需 API Key。 - API Key：
GET https://api.deepseek.com/user/balance，使用 credentials 或环境变量中的DEEPSEEK_API_KEY。
展示金额取自美元钱包；缺失时显示 $—，原因写在 tooltip 中。
安装与启用¶
插件版本 1.2.0，许可证 MIT，Node >=24。
Web 配置文件（命令须带 --profile web）：
dsh plugin --profile web add github:Vasyarot/dsh-wallet-ru
CLI 会把包写入 profile 依赖与 dsh.profile.bundles。安装后重启 DSH。
Desktop 配置文件不能用上述 CLI 管理；Electron 会提示 profile "desktop" is managed exclusively by the Electron application。在桌面应用内：
- 侧栏 → Plugins（插件）；
- Add plugin（添加插件） → 填入
github:Vasyarot/dsh-wallet-ru或插件目录绝对路径； - Install（安装），再启用对应 bundle；
- 重启应用。
卸载：Web 执行 dsh plugin --profile web remove dsh-plugin-wallet-ru；Desktop 在同一插件页对卡片点 Remove（删除）。
典型用法¶
安装并重启后，无需额外配置即可在 Composer 文档栏看到芯片。需要充值时点击下划线的余额金额，在 overlay 内完成；若白屏，使用顶栏「重新加载」。要核对近期消耗，点击会话费用行打开 7 日图，悬停各柱查看单日明细。
仅使用 API Key 查余额时，在 DSH credentials 或环境中配置 DEEPSEEK_API_KEY；登录账户路径优先，一般不必双配。
开发者在仓库根目录可跑本地检查（不随 npm 包发布）：
node tools/smoke.mjs # tooltip、图表几何、芯片 markup
node tools/route-test.mjs # 假宿主上的 /wallet-ru 与 /wallet-ru/usage
适用场景与注意¶
适合在 DSH 0.2.x 下长期用 Composer、希望余额与 тариф 与输入区同屏、并偶尔在应用内充值的开发者。界面为俄语，阅读 tooltip 与菜单时需接受该语言。
插件与当前 DSH 进程同权限运行；安装前请自行审阅 源码 与 MIT 许可证。充值页依赖平台 WebView 与网络；WAF / TLS 异常时以 README 说明的重试与「在浏览器中打开」为准。
主要文件：index.js（GET /wallet-ru、GET /wallet-ru/usage?days=7）、client.js（芯片与图表）、cordis.patch.yml（profile 树中的 wallet-ru 条目）。
结尾¶
dsh-wallet-ru 把 DeepSeek 美元 / 人民币 / 赠金余额、峰时与非峰时 тариф、本会话用量，以及 7 日支出和内置充值入口，收进 Composer 文档栏一行交互区，减少在平台页与 IDE 之间来回切换。
