DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

xfjn /

xfjn/dsh-gov

Verified

Tool-permission guard for DSH multi-agent sessions: the coordinator cannot call execution tools, teammates cannot spawn teammates, every dispatch is brief-checked and logged. Safe by default (dry-run).

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@e097399a

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

—/ 5

No ratings yet

Verified DSH bundle

Commit e097399a767d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout