概览
dsh-cost-pill
costPill session projection and a loopback-only balance route; browser half renders it through the slot runtime.README / ZH
插件文档
目录摘要
costPill session projection and a loopback-only balance route; browser half renders it through the slot runtime.dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **不做跨调价的历史分段**：所有历史样本都按**当前**价目表重算。2026-09-10 12:00 之前的调用当时更贵（命中 0.05 / 未命中 1.5 / 输出 4.5），因此旧会话的金额会偏低。 需要精确对账请用 `scripts/fold-session.mjs` 或在 `pricing` 里按需覆盖。 - **在线刷新在下一个计费样本体现**：投影注册表只在事件提交时重算 `wire.view`，刷新本身 不会立刻改变界面上的数字。 - **金额是估算值，不等于账单**：中转渠道、合同折扣、赠送额度、按小时计费的缓存存储等 都无法从会话 token 推算。 - **子代理发现只认磁盘日志**：树按 `$DSH_HOME/sessions/<工作区>/` 下的日志目录收集， 依赖头部 `parentSession` / `origin` 字段；通过其他机制派生或日志被清理的子代理不在 统计内。树汇总按日志重算，轮询成本与子代理数量线性相关。 - **面板是自锚定的**（`position: absolute` 相对 pill），不做官方那种 fixed + 视口 边缘重排；极端窄窗口下可能贴边，但已被 `max-width: min(440px, 100vw - 24px)` 夹住。 - **图标是自绘内联 SVG**：官方图标包 `dsh-client-ui-primitives` 里的是 React 组件， 而本插件的 pill/面板由命令式 DOM 构建（为了能安全地合入官方那一行），React 元素不能 直接当 DOM 节点用；要渲染官方图标就得引入 react-dom，而它并不保证在模块表里存在。 - **只在 Web 面渲染**：TUI/其他客户端没有该插槽。