dsh-usage-dock

LIMITATIONS

Known limitations

- **失败安全**：`useProjection` 缺席、投影未到达、四桶全为 0（空白会话）、或路由不是 `deepseek-official` 时渲染 `null`，不留空壳、不报错。 - **不改官方元素**：药丸是 portal 进官方那排的，插件不移动、不重设官方那排的位置或样式，也不碰它的数据；找不到那排时退回自己一行，卸载即消失。 - **它是估算值**：会话中途换过模型、或跨高峰/空闲时段时，真实账单介于面板两档之间；药丸只按当前时段显示其中一档。 - **档位不会自己刷新**：金额在重渲染时计算（新用量到达即重算），没有定时器，所以闲置会话跨过时段边界后药丸会短暂停留在旧档位。 - **金额不谎报零**：`fmtMoney` 自动加小数位，费用非零时绝不显示 `¥0.00`。 - **药丸上的数字不带货币符号**：`¥` 只出现在那颗 14px 图标上（官方药丸也是"图标 + 数字"的排版）；面板与 tooltip 里仍带 `¥`，因为那里没有图标可依赖。 - **命中率口径**：`cacheRead / (uncachedInput + cacheRead + cacheWrite)`，与官方 `cacheHitPercent` 同一口径（分母是提示侧计费输入，不含输出）；整数四舍五入到 100% 时会自动加精度，**绝不把未命中说成 100%**。 - **文案按浏览器语言**（`zh*` → 中文，否则英文），没有走 DSH 的 locale seat。 - **只报消耗，不报余额**：本地不存在剩余额度数据，会话投影里也没有。 - **数字口径**：`总计` = 四桶之和，含 cacheRead，所以它明显大于"计费输入"——看成本时别拿它乘输入价。 - 无 React 依赖打包：客户端 bundle 走宿主注入的虚拟 `react`（`require('react')`）。