dsh-plugin-quota

长对话里 token 和钱往往事后才看清，上下文快满或预算快烧完时，人和模型都缺少同一套「现在还剩多少、下一步大概多少」的共识。dsh-plugin-quota 把用量追踪做成每回合可见的一行实时仪表，让模型在回复前就能看见当前累计与预算状态，必要时自行收敛输出或工具调用。

插件监听会话里的 usage 事件，累计本会话的输入、输出与缓存命中；配置价格表后可估算花费，配置 budgetTokens 后可在 /qm 面板看到预算进度。它不追求假装精确的单点预测，而是用本会话历史给出下一步 token 区间，以及按中位增速推算「第几步可能撑满上下文、第几步可能触达预算」——算不出时直说原因，避免出现 Infinity 或除零式的误导数字。

模型还可通过 quota_meter 工具自查用量与预测，调用与结果以通用卡片呈现。插件同时将 QuotaSummary 原子写入 summary.json，供 task-forge、relay 等家族插件在派发前读取，预算吃紧时提前警告，而无需耦合具体会话实现细节。

适合日常用 dsh 做长会话、需要控成本或控上下文窗口的开发者；若你正在编写 dsh 家族插件，本仓库也演示了事件接线、命令、工具展示、系统提示片段与持久化等完整 seam，可作为开发模板参考。