dsh-tool-quota

当 Agent 获得一个搜索工具，单次调用本身完全合法，但这并不能阻止它在一次会话中连续发起八十次查询，或将四兆字节的网页整页塞入对话上下文。dsh-tool-quota 正是为堵住这种无节制消耗而设计的：它按工具和按会话两层维度，对调用次数和返回结果的 UTF-8 字节数设置硬性上限。

核心机制有两点值得强调。第一，超限不是截断而是丢弃：超过字节上限的结果会被整体丢弃，调用直接失败并抛出 TOOL_QUOTA_CALLS 或 TOOL_QUOTA_BYTES 错误码，调用方可以据此分支处理，而不必解析自然语言描述。第二，配额是会话级的总量，不是速率限制——没有时间窗口、没有休眠重试，用完了就没了，直到会话结束或插件重载才恢复。插件还注册了 tool_quota_status 工具，让 Agent 可以主动查询各工具的剩余额度，无需靠撞墙来发现限制。

适合在部署多工具 Agent 工作流时需要防止某个工具被过度调用的开发者使用。插件不处理费用、不处理 token 计数、不处理权限，只做一件事：让每个工具在每次会话中的用量有明确上限，超限行为有明确反馈。