前言¶
在 DeepSeek Harness(DSH)里给 Claw Agent 做权限与 MCP 治理时,常见做法是各插件各自定义一套策略字段和默认值。字段名、枚举值一旦不一致,后续 registry、session-permissions、gate 等组件就要重复解析或各自维护「方言」,联调成本高,也容易在卸载某个插件时误以为权限被放宽。
下面介绍社区插件 dsh-claw-policy(仓库 xingyingyuzhui/dsh-claw-policy,包内名 dsh-agent-policy):它提供治理套件 Phase 1–2 的共享契约——policy schema、预设基类、MCP 初始化默认与策略版本。它不拦截工具;真正拒绝与隐藏发生在 dsh-agent-gate 等闸插件侧。
这是什么¶
维护者 xingyingyuzhui,目录分类为 admin-security。
一句话定位:为 DSH 提供可复用的 Claw / session 策略 schema 与默认配置落盘约定,供其它插件 消费 同一份结构,而不是各自复制一份策略定义。卸掉本插件 不会 自动放宽权限;缺省时仍回落到 DSH 原有的 permission-presets,闸仍在 dsh-agent-gate。
核心功能¶
策略契约,不执行拦截¶
README 明确说明:本插件负责 schema / 预设基类 / MCP 初始化默认,不 deny 工具。MCP 工具在 DSH 中的命名形式为 mcp__<服务>__<工具>;与本插件相关的 MCP 面默认值有三种模式(具体放行逻辑在闸里完成):
none:全关explicit:只放行servers.allow中列出的服务init-defaults:当允许名单为空时放行(初始化场景)
供生态插件统一引用¶
package.json 导出 ./schema(policy-schema.mjs)与 ./store(policy-store.mjs),其它插件应引用这些入口,避免再维护重复 schema。当前版本 0.1.8,运行时要求 Node.js >= 20,许可证 MIT。
默认配置与 Claw 模板¶
新建 Claw Agent 的常驻模板与 MCP 初始化默认值写在用户目录下的 ~/.dsh/agent-policy/defaults.json(卸载插件后该文件仍会留在磁盘上)。
安装与启用¶
官方安装命令如下(资料原文,勿改仓库 slug):
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-policy
建议安装顺序:装在 dsh-agent-registry、dsh-session-permissions、dsh-agent-gate 之前。安装完成后重启 dsh web。
本地开发时可使用 link 方式挂载源码目录:
dsh plugin --profile web add link:/abs/path/to/dsh-agent-policy
卸载:
dsh plugin --profile web remove dsh-agent-policy
典型用法:编辑 defaults.json¶
经过上面的安装步骤后,按需编辑 ~/.dsh/agent-policy/defaults.json。README 中列出的字段如下。
| 字段 | 含义 |
|---|---|
preset |
新建 Claw Agent 的常驻模板,取值如 research、developer 等;在设置界面中对应 Claw Agent模板 |
mcp |
新 Agent 的 MCP 面默认值:none | explicit | init-defaults |
servers.allow / servers.deny |
初始化时可见的 MCP 服务名列表 |
示例结构(字段名与枚举以 README 为准,值请按你的环境填写):
{
"preset": "developer",
"mcp": "explicit",
"servers": {
"allow": ["example-mcp-server"],
"deny": []
}
}
说明:BOOTSTRAP.md 仍存在于工作区时,闸会 额外 放行询问名字、写入本工作区人设文件等 bootstrap 相关能力;这些放宽 不在 上述 defaults.json 里配置,也不会通过本契约默认放开终端类权限。
适用场景与注意¶
适合谁: 正在搭建或维护 DSH 智能体治理链路的开发者——尤其是已使用或计划使用 dsh-agent-registry、dsh-session-permissions、dsh-agent-gate 等组件、需要统一策略 schema 与 MCP 初始化约定的场景。
注意:
- 本插件是 契约层,不要期待安装后 alone 就能拦截工具;联调时请确认 gate 插件已就位。
- DSH 插件以当前
dsh进程权限运行;安装前请自行查看 GitHub 源码 与 MIT 许可证,确认符合你的安全策略。 - 社区插件目录 SkillHub 条目 为独立站点,与 DeepSeek / 幻方无官方从属关系;安装与配置以仓库 README 为准。
结尾¶
dsh-claw-policy(包名 dsh-agent-policy)把 Claw / session 策略收成一份共享 schema 与默认配置约定,让治理套件其它插件只消费、不复制;拦截仍由 gate 负责。需要目录信息与文档时,可访问 SkillHub 插件页 与 GitHub 仓库。