Overview
dsh-tidewatch
README / EN
Package documentation
Registry summary
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
- **价格表内置**，官方调价后需手动同步 `lib/pricing.js`（计费）与 `lib/client.js` 的 `DISPLAY_PRICES`（展示）两处常量，并为旧价补一段历史档 - **节假日表内置 2026 年**，2027 年安排公布后需手动同步 `CN_PUBLIC_HOLIDAYS`（同样两处）；过期后周一到周五一律按工作日计，法定节假日会被按峰期收费，面板会提示表已过期 - **V4 Pro 换价分界**目前是哨兵值：官方声明计费方式保持不变，如有变动需把日期填回 `V4_PRO_RETIRE_BOUNDARY` - **失败或被重试的调用不计费**，与官方 token-meter 口径一致；这是口径上限 - **账号内置通道的两种口径**：本机实测该通道（provider `deepseek-account`）的结算事件**自带 usage**，按 token 精确计价；若某次确实拿不到 usage，才退回「账户余额下降了多少」估算，金额后标注「（估算）」。余额属于账户级，多会话或多设备同时使用会一起下降，估算因此偏大；只累加下降、充值不抵消消耗 - **官方投影采样的两处取舍**：宿主侧用 `sessionProjections.snapshot(session, ['tokenUsage'])` 读取 DSH 官方的 `tokenUsage` 投影（对话页底部「351M tok · 缓存命中 97%」那行的来源），随视图下发供前端计价。官方投影只给累计总数，故这条路径按**当前**价目折算，无法精确到每次调用的历史档位；采样也只保留最近一次，多会话并发时以前台活跃的那个为准。这份采样只在「本会话收到过结算事件」时才随视图下发，空会话不会继承上一场的数字 - **用量缺失时如实标注**：拿不到任何用量又估算不出时，界面显示「未提供」而不是 `¥0.00`，避免把「没有数据」呈现成「免费」。用量的读取口径与 DSH 官方 `token-meter` 一致：同时读 `assistant/message` 与 `assistant/attempt`，按 `(turn, step)` 替换，重试清槽；若结算事件里字段名对不上（`totalTokens` 有值而各分桶全空），同样按「未提供」处理，不会静默记成零 - **不提供余额预警**：早期版本有一个「余额低于阈值响一声」的功能，阈值写死且不可配置，属于半成品；DeepSeek 控制台本身可能已有余额提醒，故移除，不做重复建设