概览
dsh-workspace-fee
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
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 说明。 ---