dsh-ration（配给）

> 自己给自己防沉迷的 token 限额插件 —— 5 小时滚动窗 + 周，两把闸；越线就不接新活。
> 刻度对标 Kimi：5h : 周 = 1 : 5（默认 4000 万 / 2 亿）。

是什么

DSH 里没有"套餐额度"这回事，按 token 烧钱、无限续杯——很容易一坐就是十几个小时。
配给给你装两把闸：

越线不做：任一把闸越线 → 左下角挂件变红，新的指令发不出去（正在跑的回合不受影响）。
"/" 开头的命令永远放行，所以被拦时可以用 /ration off 当场自救。

界面

• 左下角小挂件：两根细条 —— 5 小时窗、周（平时不打扰，瞄一眼就知道用了多少）。
  亮暗跟随 DSH 主题（走设计令牌，不需要手动切）。
• 点开：两把闸的进度 + 详细 Token 消耗（今日拆分：新 prompt / 输出 / 缓存读；
  缓存占比；近 7 天迷你柱状图）。
• 配色会自动预警：80% 起变黄，越线变红。

命令

/ration                          查看两闸状态
/ration on | off                 越线不做 开 / 关
/ration set 5h|week N            改额度（支持 k/m/b/万/亿：/ration set week 1.5亿）
/ration unset 5h|week            撤回改值，回到 profile 配置
/ration gate 5h|week on|off      单独开关某把闸

实现要点

• 账本：启动时回填全部会话日志（sessionPersistence），之后由 session/event
  实时增量；按 (会话, seq) 幂等，重启/重放不重复计。零 token、不打扰模型。
• 统计口径：每条 assistant 消息的 usage.totalTokens（含缓存读与写入）。
• 越线拦截：客户端在捕获层拦下输入框 Enter 与发送按钮；状态过期时自动 fail-open
  （不会因为插件故障挡住你干活）。
• 状态持久化在 $DSH_HOME/storages/dsh-ration/state.json，账本默认保留 35 天。
• 跨插件接口（v0.1.2）：ctx.provide('ration') 服务（setCaps / getCaps）+ POST /dsh-ration/set
  路由——供 dsh-plan 订阅后自动校准额度。

配置（profile 层可覆盖）

- id: dsh-ration
config:
cap5h: 40000000      # 5 小时滚动窗
capWeek: 200000000   # 周
enforce: true        # 越线不做
gate5h: true
gateWeek: true
warnPct: 0.8
keepDays: 35

安装

dsh plugin --profile web add 'https://codeload.github.com/wobenshiwomu/dsh-ration/tar.gz/v0.1.1'

或在图形界面：侧栏「插件」→ 添加插件 → 填上面这条 URL。装完重启 DSH 生效。
URL 末段的 v0.1.1 是版本标签；升级时换成本仓库的新版本标签重装即可。

开发

node test/sim.mjs          # 72 项断言（含真实会话日志回填校验）
# 重建客户端（需要一个 esbuild 二进制：cp 别家的 scripts/esbuild，或 npm i -g esbuild）
ESBUILD_BIN=scripts/esbuild node scripts/build-client.mjs