前言¶
在多智能体系统的长期运行中,重复读取工具结果、提示压缩导致规则失效、以及昂贵的模型承担审查任务,是导致 Token 消耗过高且缺乏可观测性的常见原因。DeepSeek Harness (DSH) 插件生态旨在通过插件化手段解决这些问题。
插件介绍¶
gongyijie85/dsh-agent-frugality 是一个 DSH 插件,用于防御多智能体系统的读取台账去重、免疫压缩规则、完成机械门禁和低成本审查 lane。该插件零外部依赖,通过注入机制即可运行。
核心功能¶
插件提供以下核心能力:
1. 读取台账去重:记录每个智能体的读取内容哈希值,将重复读取的浪费可视化。
2. 免疫压缩规则:将防御规则置于不可压缩的提示区,防止上下文压缩导致规则丢失。
3. 完成机械门禁:强制完成声明必须通过验证,防止无效的完成尝试。
4. 低成本审查 lane:使用低成本模型对工作进行独立审查,主模型不审查自身。
安装与依赖¶
安装命令如下:
dsh plugin add github:gongyijie85/dsh-agent-frugality
运行环境需要满足:
* Node.js >= 20
* DSH >= 0.1.0-rc.6
典型用法¶
插件通过以下工具和配置项使用:
* 工具:
* frugality_ledger:读取台账,查看各智能体的读取、重复和字节消耗情况。
* frugality_gate:完成门禁,验证完成声明和退出码。
* frugality_review:低成本审查,在独立 lane 执行审查。
* 环境变量配置:
* DSH_FRUGALITY_DEDUP:设置为 1 时,开启去重功能(默认为 0)。
* DSH_FRUGALITY_GATE:设置为 0 时,关闭完成门禁(默认为 1)。
* DSH_FRUGALITY_GATE_MAX:门禁异议的最大次数(默认为 2)。
* DSH_FRUGALITY_REVIEW_MODEL:审查模型 ID,设为 auto 时使用 CHEAP 家族。
* DSH_FRUGALITY_RULES:自定义规则文件(默认为内置)。
* DSH_FRUGALITY_LEDGER_CAP:读取缓存表的最大条目数(默认为 30)。
* DSH_FRUGALITY_WORKDIR:门禁验证命令的工作目录(默认为当前目录)。
日志与存储¶
插件不存储内容,仅记录哈希值。
* 日志文件位于 $DSH_HOME/agent-frugality.log。
* 台账文件位于 $DSH_HOME/agent-frugality-ledger.l。
注意事项¶
- 默认行为:去重功能(DEDUP)默认关闭,完成门禁(GATE)默认开启。建议先通过
frugality_ledger观察基准数据,再决定是否开启去重。 - 权限与安全:插件以当前 DSH 进程的权限运行。安装前请检查源码与许可证(MIT)。
- 生态定位:该插件填补了共享内存、模型路由和任务编排等插件未覆盖的空白,专注于读取去重、完成门禁和廉价审查。
总结¶
dsh-agent-frugality 提供了多智能体系统中的可观测性与成本控制手段。通过读取台账量化浪费,通过机械门禁约束行为,通过廉价审查降低成本。
- GitHub 仓库:https://github.com/gongyijie85/dsh-agent-frugality