Overview
dsh-cost-pill
costPill session projection and a loopback-only balance route; browser half renders it through the slot runtime.README / EN
Package documentation
Registry summary
costPill session projection and a loopback-only balance route; browser half renders it through the slot runtime.dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **不做跨调价的历史分段**：所有历史样本都按**当前**价目表重算。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/其他客户端没有该插槽。