dsh-gov
为 DeepSeek Harness 的多智能体会话加一道代码层权限护栏。
MIT · node >=18 · tests 120
这是什么
给 DSH 多智能体会话加一道代码层护栏。三件事:
- 协调者不能调用执行类工具 —— 自己动手 = 绕过部门,判断和执行必须分开
- 成员不能再开人 —— 否则一层套一层,谁也说不清谁在花钱
- 每次派活自动校验 brief 六项(目标 / 验收 / 不做项 / 工具与坑 / 权限边界 / 防打转),写进 per-agent 案卷
它不改变模型能力,只在工具调用那一刻做判断。
装之前请确认(这段最重要)
- 默认 dry-run:只写日志、不拦任何调用。要真生效,把
gov.config.json的mode改成enforce。 - 没开 Agent Teams 的话,这个插件等于没装:检测不到团队服务就静默降级 —— 不裁人、不写日志、不报错。
- 它管的是「协调者和成员之间的权限边界」,不管你的单会话用法。单人用一个会话,装它没有收益。
安装
dsh plugin --profile web add github:xfjn/dsh-gov
装完确认文件落在 profile 的 node_modules/dsh-gov 下,然后打开真实的配置文件:
# Windows
notepad "%APPDATA%\dsh-desktop\harness\profiles\web\node_modules\dsh-gov\gov.config.json"
# macOS / Linux
$EDITOR ~/.dsh-desktop/harness/profiles/web/node_modules/dsh-gov/gov.config.json
要真拦人,把 "mode" 改成 "enforce";只想观察就留 "dry-run"(默认)。
它到底挡什么
四条规则,规则表在 src/rules.json,改它不需要改代码:
| ruleId | 挡谁 | 挡什么 |
|---|---|---|
root.no-hands |
协调者(主会话) | 不能直接跑命令、装插件、开无名子 agent —— 只能派活给有名字的成员 |
member.no-delegation |
部门成员 | 不能再派活,只能执行 |
unknown.fail-closed |
身份判不出的人 | 一律不许派活(宁可错拦一次派活,也不放一个不明身份的人去开花钱) |
team-service.unavailable |
所有人 | 团队服务不可用时,任何派活直接拒 —— 因为没法确认新成员的层级 |
被拒时会返回一句人话,带规则 id 和 rules.json 的绝对路径,例如:
[gov] 拒绝工具 `spawn_teammate` —— 命中规则 member.no-delegation:成员不能再派活。
身份:member(agent 3f2a…);规则文件:…\src\rules.json
两道锁怎么分工
这是实现里最值得说的一件事:
- restrict(解析期):
ctx.tools.restrict({ deny })把工具从该 agent 的可见工具面里摘掉 —— 调用时工具根本不存在。它只能管全局工具。 - guard(prepare 期):在
tools/pre-execute之后、真正执行之前判断,返回非undefined即拒 —— 调用时工具在,但被拒绝。
spawn_teammate 是团队插件用 agent.ctx.tools.register 注册在 own layer 的,restrictableNames 只从 inherited(全局 + 祖先层)收集,所以它结构上不可 restrict;subagent / subagent_fork 是全局工具,可以 restrict。
一句话:看不见 / 被拒绝,两道锁合起来才完整。 只靠 guard 是事后拦,只靠 restrict 挡不住 own layer 注册的工具。
日志与案卷
两个文件,都在工作目录的 .gov/ 下:
.gov/gov.log.jsonl 每行一个 JSON,看 decision 字段就知道发生了什么
.gov/cases/<agentId>.jsonl L1 派遣档(谁在什么时候派了谁、brief 六项判成什么样)
常见 decision 值:
| decision | 含义 |
|---|---|
allow / deny |
放行 / 拒绝(deny 带 ruleId) |
would-deny |
dry-run 下"本该拒"(不拦,只记) |
restrict-installed / restrict-skip-names |
成员创建时裁掉了哪些工具、哪些裁不掉 |
brief-complete / brief-incomplete |
派活时 brief 六项是否齐全(只记不拒) |
案卷分三层,只有 L1 是自动写的:
- L1 派遣档:guard 放行派活时自动写;
- L2 事件流:从
gov.log.jsonl按 agentId 归集; - L3 交付指针:必须手工补 —— 工具不生成、也不假装生成。
Kill switch
三个层级,从轻到重:
// 1. 只记不拦(最轻)
{ "mode": "dry-run" }
// 2. 整个插件停用(guard 放行,成员限制一并撤掉)
{ "enabled": false }
# 3. 进程级逃生门(需要重启进程才生效)
GOV_DISABLE=1
前两个改完立即生效,不用重启(guard 每次调用都会重读配置)。
已知边界(照实写)
- brief 判定是启发式的:靠锚点词 + 有效字数阈值。换个说法、换种语言就可能判 missing。它只记账,不能当合规闸门读。
- 同一行的两个区块会重叠:
目标:a。验收:b写在一行时,两个块会互相包含内容,判定偏宽松。 - L3 交付指针必须手工补,工具不生成。
- 只覆盖
spawn_teammate/subagent/subagent_fork:workflow之类的内部分派不进案卷。 - 默认 dry-run 意味着"装了不生效" —— 这是有意的:陌生人第一次装上,不该一装就拦他的调用。
开发
git clone https://github.com/xfjn/dsh-gov
cd dsh-gov
node --test test/*.test.mjs
别写成
node --test test/(传目录)——test/corpus.mjs是语料模块不是测试文件, 会被当成空测试发现,报tests 0 / fail 1的假红。传文件模式或npm test都对。
120 条测试,含 30 条 brief 语料的混淆矩阵(假阳性必须为 0:没写判成写了,是自欺)。
语料与期望值在 test/corpus.mjs(30 条,分全写 / 部分 / 纯口语 / 陷阱四类),跑 test/corpus.test.mjs 即校验假阳性必须为 0。
目录:
src/
index.js guard 主流程、配置加载、日志
policy.js 规则求值(读 rules.json)
identity.js 这个 agent 是谁(root / member / unknown)
m4-restrict.js 成员创建时裁工具面
brief-check.js brief 六项判定(纯函数,无 IO)
case-file.js 案卷 L1 写入 / L2 归集 / 脱敏
rules.json 规则表
test/ 120 条
名字的来历
最早一版按中国传统的三省六部制给角色起名(协调者 = 中书令、各成员 = 各部尚书),沿用至今只留在规则文案里 —— 纯属趣味,不影响任何功能。对外文档一律用「协调者 / 成员」;被拒消息里偶尔会看到官制名,那是同一件事的旧称呼。
License
MIT
No comments yet. Be the first to write one.