dsh-claw-policy:DSH 共享 Claw / Session 策略契约

前言

在 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 初始化约定的场景。

注意:

  1. 本插件是 契约层,不要期待安装后 alone 就能拦截工具;联调时请确认 gate 插件已就位。
  2. DSH 插件以当前 dsh 进程权限运行;安装前请自行查看 GitHub 源码 与 MIT 许可证,确认符合你的安全策略。
  3. 社区插件目录 SkillHub 条目 为独立站点,与 DeepSeek / 幻方无官方从属关系;安装与配置以仓库 README 为准。

结尾

dsh-claw-policy(包名 dsh-agent-policy)把 Claw / session 策略收成一份共享 schema 与默认配置约定,让治理套件其它插件只消费、不复制;拦截仍由 gate 负责。需要目录信息与文档时,可访问 SkillHub 插件页 与 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜