概览
dsh-usage-dock
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **失败安全**:`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')`)。
