pact-dsh
在终端中运行以下命令:
dsh plugin install onlookor/pact-dsh
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install onlookor/pact-dsh,从 https://github.com/onlookor/pact-dsh 安装 PACT 治理插件。
插件介绍
在 DeepSeek Harness 里跑多步 Agent 时,你往往既要保留官方 ReactLoopAgent 的模型调用、工具执行与会话持久化,又希望在关键节点上能问一句:这一步能不能开始、这个工具能不能跑。PACT 是一套协作治理思路;pact-dsh 是把它接到 DSH 侧的那一层——它接管 AgentFactory 的注册,但不重写 DSH 的 AgentLoop,治理与执行职责分得很清楚。
插件通过 bundle patch 禁用默认 agent-loop 行,并插入 pact-agent-loop 与观察模块。只有 agentPreset 以 pact- 开头的 Agent 会进入 PACT 门控;其余 Agent 仍走官方 loop。档位上,缺省的 observe 会把 session/event 镜像到有界缓冲,可选写入 JSONL,不阻断执行;govern 则在 agent/pre-step 与 tools/pre-execute 查询 PACT 门,拒绝时返回 reject 或 deny,且 fail-closed——后端不可用或查询异常一律按拒绝处理。
配置从 PACT_DSH_CONFIG 读取,可选用 fake 后端做演示与单测,或 wasm 后端对接上游 pact-wasm 宿主以运行真实门逻辑。审计侧只记录类型、序号、工具名与 call id,不记录参数、结果或用户内容;mirror 目录权限收紧,不新增端口、不拉子进程、不联网。
适合已经在用 DSH developer preview、需要为 pact-* 预设 Agent 做可观测或策略门控的团队;若你只想换 loop 实现而非治理,这不是本插件的目标。已知限制包括:resume 后第一步暂不受门控、本轮不做 token 级 produce/consume 映射,且依赖 DSH 预发布 API,升级 DSH 后需复核行为。
使用场景
- 需要为 pact-* 预设 Agent 在 govern 模式下拦截不合规的工具调用
- 希望在不动官方 AgentLoop 的前提下审计 session 与工具事件
- 对接上游 pact-wasm 后端做真实策略门查询
适合人员
- 使用 DSH developer preview 并启用 pact-* Agent 的开发者
- 负责 Agent 安全与合规、需要 fail-closed 门控的团队
- 需要 observe 镜像或 JSONL 审计轨迹的运维与平台同学