dsh-peak-bar

dsh-peak-bar

简体中文 | English

⚠️ 测试版（pre-release） —— 版本号仍是 0.x，CSS 变量名与文件结构可能变动。

窗口标题栏正中一枚小胶囊：峰谷时段、距下次切换的倒计时、账户余额、今日已用。

DSH 插件。点胶囊在主区域打开详情面板。颜色默认跟随当前皮肤 —— 样式表里没有任何颜色字面值， 每个变量都回退到宿主的语义 token（--dsw-alias-*），自定义只需覆盖要改的那几个。

---

外观与位置

截图为中文界面；图中金额与倒计时是示意值，真实数据已替换。

• 胶囊显示峰谷状态、倒计时、余额；倒计时剩余超过一小时时只到分钟（59小时24分）， 最后一小时内到秒（18分57秒）。
• 点击胶囊在主区域打开详情面板，右上角 ✕ 退回对话。
• 落在标题栏正中，Windows 上与最小化/关闭按钮同一行、位于其左侧（实测中心在 49.9%）。
• 座位 pointer-events:none，只有胶囊可点，标题栏其余部分仍可拖动窗口。
• 用 shell.overlay 而非 shell.leading：后者只在 macOS + 侧栏收起时挂载，Windows 上没有槽位。

读取失败时

• 还没读到过数值：胶囊写一句短原因，不静默显示 --。
• 已经有数值：保留旧值，失败持续超过 2 分钟才挂两字标记「余额未刷新」。
• 未配置 API key：只说「未配置 API key」——这是配置事实，不是错误。
• 完整原因始终在悬停提示与详情面板里（胶囊窄，长原因会把它撑出窗口）。
• 重试按 15s → 30s → 60s 递退（正常 60s 轮询）；网络恢复或窗口重新可见时立刻重试。

安装

改完必须整进程重启 DSH，刷新页面不够：Host 在插件激活时把客户端产物快照进内存。

峰谷规则

余额与隐私

两条路按顺序尝试，口径一致（充值 + 赠金）：

不往任何第三方发数据。面板里会写明这次余额来自哪条路。

今日已用

账号接口给的是余额、不是账单，所以按余额下降观测累计：两次读取之间余额跌的差额算消费， 余额上升（充值/赠金）不计入也不抹除已记消费，按北京时间日分账。

账本由 Host 半写在 <DSH_HOME>/.dsh-peak-bar.json（默认 ~/.dsh/），只留最近 14 天，原子写， 文件损坏时当空账本继续。放 Host 是因为桌面端每次启动端口可能不同、origin 一变 localStorage 就被清空。 Host 路由不可用时退回「本次运行统计」——丢的是历史，不是功能。

语言

没有自己的语言开关，跟随 DSH 的界面语言：

DSH 设置 → 通用 → 语言 → 中文 / English

词典注册在插件自己的命名空间，zh / en 键齐全且 zh 回退到 en。切换无需重装或重启。 插件卡片的标题与描述来自 locale/zh.json / locale/en.json。

自定义颜色

插件不声明 --dsh-peak-bar-* 自身，只在用到的地方写 var(--dsh-peak-bar-x, 主题 token)。 这是刻意的：主题把 --dsw-alias-* 挂在 body 上，若在 html 上声明，就会在 token 尚不存在的 元素上求值成非法值（早期版本正是这样丢掉描边）。因此任何覆盖都直接生效，不必比优先级。

只改几个变量时不必写全表，没提到的继续跟皮肤走。引用皮肤 token 一律带字面量兜底 （var(--dsw-xxx, 兜底值)）——莱茵生命皮肤里就有若干 token（如 --dsw-radius-*）并未定义。

/* 皮肤作者：接管差异部分即可 */
:root {
  --dsh-peak-bar-bg: var(--dsw-specific-sidebar-fill, transparent);
  --dsh-peak-bar-border: var(--dsw-alias-border-l3);
  --dsh-peak-bar-radius: var(--dsw-radius-sm, 4px);
  --dsh-peak-bar-peak: var(--dsw-alias-brand-primary);
}

/* 三套现成配色，任选其一 */
:root { --dsh-peak-bar-bg:#2a1a10cc; --dsh-peak-bar-border:#ff8a3d55; --dsh-peak-bar-peak:#ff9d4d; --dsh-peak-bar-text:#ffe9d2 }  /* 莱茵生命橙 */
:root { --dsh-peak-bar-bg:#101010;   --dsh-peak-bar-border:#ffffff;   --dsh-peak-bar-text:#ffffff; --dsh-peak-bar-radius:6px }  /* 纯灰高对比 */
:root { --dsh-peak-bar-bg:#06222a;   --dsh-peak-bar-border:#1de9b644; --dsh-peak-bar-peak:#35e0d0; --dsh-peak-bar-countdown:#7fd7d0 }  /* 冷色青 */

位置

想自己钉住落点就覆盖座位类 —— 类名不是公开契约，改版可能变，请自行验证：

.dshPeakBarSeat { position: fixed; left: 50%; right: auto; transform: translateX(-50%) }  /* 真·整窗居中 */
.dshPeakBarSeat { position: absolute; left: auto; right: 132px; transform: none }         /* 紧贴按钮左侧 */

---

项目结构

dsh-peak-bar/
├── index.js            ★ Host 半：本机路由 + 原子写账本 + API key 余额路
├── client.js           ★ Client 半：胶囊、详情面板、词典、样式
├── cordis.patch.yml    注册进 profile 的 bundle patch
├── package.json        清单（dsh.bundle / dsh.client）
├── icon.svg            图标
├── locale/             插件卡片元数据（zh / en）
├── docs/               README 用的实机截图
├── tests/              三套离线测试（peak / render / host）
├── .github/workflows/  test.yml（三平台 × Node 20/22）、release.yml（推 tag 打包）
└── README / CHANGELOG / LICENSE

自检：npm test —— 三套测试全部离线跑，host 用临时 DSH_HOME，不碰真实的 ~/.dsh。

已知限制

• 账号路与 API key 路都不可用时才显示失败原因，面板会列出两条路各自的原因。
• 账户读取在 Host 侧，60 秒轮询；页面重新可见时立即刷新一次。
• 法定节假日表只覆盖 2026 年，2027 年起需补表，否则节假日会算成高峰（面板会提示）。
• 只在 Windows 官方客户端 + DSH 0.2.0-rc.2 实测；macOS / Linux 与纯浏览器模式未测。
• 「今日已用」是按余额差推算的估计值，不是平台账单，也不含其他厂商渠道的消费。
• 请求里的客户端版本是 'unknown'：官方客户端构建时内联，第三方插件拿不到。

---

设计取向

• 跟随优先，覆盖可选：默认值全指向宿主语义 token，插件不发明自己的配色体系。
• 失败要说话：宁可挂两字标记，也不静默显示 --；完整原因放到有空间的地方。
• 状态放 Host，页面只负责显示：端口会变、origin 会变，localStorage 靠不住。

贡献

欢迎 Issue / PR，尤其是你自己皮肤下的配色问题与新的节假日表。

致谢

• dsh-whale-widget —— Host 持凭据与账本的分工、余额下降记账口径、API key 余额路的思路。
• dsh-plugin-rhine-lab-theme —— 「跟随皮肤」的判据以它定义的语义 token 与深浅两套值为准。
• DSH 自带的「账号与余额」卡片 —— 余额读取路径与返回结构。

icon.svg 为本项目自有，不打包任何第三方代码或素材。

License

MIT © Woo3aN —— 见 LICENSE。