dsh-ration(配给):DSH 自设 Token 限额与防沉迷

前言

DeepSeek Harness(DSH)按 token 计费,会话可以长时间续下去,缺少类似「套餐额度」的硬边界时,很容易一坐就是十几个小时。社区里有人用外部记账或自觉停手,但和客户端输入链路脱节,拦不住「再发一条」的冲动。

下面介绍维护者 wobenshiwomu 的插件 dsh-ration(配给):在 DSH 内用两把闸做 5 小时滚动窗与周限额,越线则不再接受新的指令;分类为 admin-security。目录页见 SkillHub,源码与说明在 GitHub。

这是什么

配给是 DSH 插件,给自己装 token 用量上限。默认刻度对标 Kimi:5 小时窗与周额度比例为 1 : 5,即 4000 万 / 2 亿 token。

闸 默认额度 重置方式
5 小时滚动窗 4000 万 token 滚动:已消耗份额随时间流回(Kimi 式)
周 2 亿 token 每周一 00:00

任一把闸越线且 enforcement 开启时,左下角挂件变红,新的指令发不出去;正在执行的回合不受影响。以 / 开头的命令始终放行,被拦时可用 /ration off 当场关闭 enforcement。

界面与统计

左下角有小挂件:两根细条分别表示 5 小时窗与周用量,亮暗跟随 DSH 主题(设计令牌,无需手改主题)。

点开可查看两闸进度与详细 Token 消耗,包括今日拆分(新 prompt / 输出 / 缓存读)、缓存占比,以及近 7 天迷你柱状图。用量到配置中的预警比例(默认 80%)起变黄,越线变红。

统计口径为每条 assistant 消息的 usage.totalTokens(含缓存读与写入)。账本在启动时通过 sessionPersistence 回填全部会话日志,之后由 session/event 增量更新;按 (会话, seq) 幂等,重启或重放不重复计数,且不额外消耗 token、不打扰模型。

命令

日常可在 DSH 里用 slash 命令查看与改限额:

/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      单独开关某把闸

安装与启用

README 给出的安装方式为指定 tar 包 URL(末尾 v0.1.1 为版本标签,升级时换成仓库新版本标签重装即可):

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

图形界面路径:侧栏「插件」→ 添加插件 → 填入上述 URL。装完需重启 DSH 生效。

package.json 声明运行环境为 Node ^22.19.0 || >=24.0.0,DSH >=0.2.0-rc.1;插件面向 web profile 客户端 bundle。许可证为 MIT。

Profile 配置

可在 profile 层覆盖默认额度与行为:

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

状态持久化在 $DSH_HOME/storages/dsh-ration/state.json,账本默认保留 35 天。

实现要点与生态接口

越线拦截在客户端捕获层处理输入框 Enter 与发送按钮;状态过期时自动 fail-open,避免因插件故障挡住正常工作。

自 v0.1.2 起提供跨插件接口:ctx.provide('ration') 服务(setCaps / getCaps)以及 POST /dsh-ration/set 路由,供 dsh-plan 等插件订阅后自动校准额度。

适用场景与注意

适合长期在 DSH 里写代码、跑智能体、且希望用硬边界约束 token 支出的开发者。两把闸可单独开关,额度可用命令或 profile 调整,适合「工作日严、周末松」一类自订规则。

插件在当前 DSH 进程权限下运行,会读会话日志并写本地 state;安装前建议阅读仓库源码与 MIT 许可证,确认符合你的安全策略。SkillHub 为社区目录站点,与 DeepSeek / 幻方无官方从属关系。

DSH 生态强调「一切皆插件」;配给不替你做时间管理,只在越线时拦住新指令,把「无限续杯」变成可配置的自律工具。更多细节见 目录页 与 GitHub README。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye