Overview
dsh-workspace-fee
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
1. `pricing.effectiveFrom` 只作元数据:**早于该时刻的记录仍按当前表计价**,条数与金额记在 `diagnostics.beforeEffectiveFrom*`。 2. 自定义价格版本的 segment 若覆盖不全,未命中记录回退内置表,并计入 `diagnostics.unpricedUsageRecords`(可见,不静默)。 3. 目录名 → `cwd` 的解码对含 `-` 的目录名有损,仅在日志缺 `type:"session"` 时使用 (此时 `cwdSource = "directory-name"`)。目录名编解码的**回退路径**按常见的 `--<盘符>-…--` 形状实现;POSIX 路径的极端形态可能定位不到工作区,主路径按 `sessionId` 不受影响。 4. 宿主装配在 **DSH 0.2.0-rc.2** 上实测(桌面版 `desktop` profile + 独立隔离 profile): `apply` 跑完、四条路由 200、模型工具 `workspace_fee` 在真实会话里可用。 `ctx.settings` 在命令行 profile 里不可用,此时 `/health` 报 `settingsAvailable:false` 并自动降级到 `config.json` —— 这是预期降级。 5. 默认数据目录(`$DSH_HOME/workspace-fee`)在宿主进程内可写;受限沙箱下写失败只告警,不影响账目。 6. 费用数字是**按日志自算**的估算值,不是官方账单。 7. **会话日志格式版本可能继续变**(v4 → v5…)。选版本按**文件名里的数字**,通常无需改代码; 若 DSH 改成不带版本号段的其它文件名,插件会记 `session-log-missing`(不静默当作零消耗), 此时更新 `lib/session-log.js` 的 `SESSION_LOG_FILE_RE`。 8. `pricing.currency` 切到 `USD` 时,`/summary` 与面板正确;**模型工具文案与按日 JSONL 账单里的 币种字段仍是 `CNY`**(未随配置切换)。金额本身按所选费率表计算。 9. 时区与高峰时段固定为**北京时间 / 中国区口径**;非中国区用户看到的「今日」「按日」分桶会不同。 可通过 `pricing.peakWindows` 覆盖高峰段,但 UTC+8 的日界不可配置。 10. 独立验证不是全绿:见 §5 的 17/19 说明。 ---
