前言¶
在 DeepSeek Harness（DSH）里跑 Claw 智能体时，模型会不断调用 Shell、文件、技能、MCP 等工具。官方权限能框住一部分能力，但 Claw 会话往往还要叠加 Agent 与会话级策略；若缺少统一的拦截与留痕，一次误调用就可能越过预期边界。下面介绍社区插件 dsh-agent-gate（目录条目 dsh-claw-gate，维护者 xingyingyuzhui，分类 admin-security）：在 Claw 会话上按分层权限拦截工具调用，必要时走 DSH 官方一次性审批，并把结果写入本地审计日志；官方文件沙箱仍建议由同生态的 dsh-session-permissions 负责钉住。
这是什么¶
dsh-agent-gate 是面向 DSH Web 配置的权限闸插件（package.json 当前版本 0.1.14，MIT 许可证）。它解决的是 Claw/session 场景下的三件事：拦截不符合策略的工具调用、审批需要人工确认的高风险操作、审计可筛选与导出的调用记录。策略计算复用 dsh-session-permissions 的分层模型（官方 ∩ Agent ∩ 会话）；闸本身只作用于 Claw 会话，工作区会话仍只走官方权限。
核心功能¶
分层拦截与审批¶
插件通过 tools/pre-execute 与 tools.guard 在工具真正执行前做校验。策略不允许且规则要求确认时，会走 DSH 官方的一次性审批流程；通过或拒绝后的结果会追加写入：
~/.dsh/agent-gate/audit.jsonl
与 session-permissions 的分工¶
Claw 会话的官方沙箱（如 read-only、workspace-write）由 dsh-session-permissions 钉住，而不是由本闸单独实现。两者可以搭配安装：权限插件管沙箱与策略基线，agent-gate 管 Claw 上的拦截、审批与审计 UI。
技能与 MCP 的可见性¶
Agent 技能拒绝名单会从该会话的官方技能目录和 / 选单里移除对应项，不只拦截名为 skill 的工具调用。未授权的 MCP 服务同样会被拒绝，并在会话开始时从模型可见工具列表中拿掉，减少「模型先看到、执行再拦」的窗口。
Web 设置中的审计页¶
安装并启用 Web 客户端后，设置里提供 审计 页面：可按时间、结果、工具类型、Claw Agent 筛选记录，并导出当前筛选结果，便于事后核对或归档。
单独卸载闸¶
卸载 dsh-agent-gate 后，新的工具调用不再被本插件拦截；只要 dsh-session-permissions 仍在，官方文件沙箱不会因为卸闸而变宽。
安装与启用¶
建议与 dsh-session-permissions 一并安装。在 Web 配置下执行：
dsh plugin --profile web add github:xingyingyuzhui/dsh-agent-gate
装完后重启 dsh web，使插件与 Cordis 补丁生效。
本地开发时，可将仓库以 link 方式挂入（路径换成你本机绝对路径）：
dsh plugin --profile web add link:/abs/path/to/dsh-agent-gate
卸载命令（资料原文）：
dsh plugin --profile web remove dsh-agent-gate
典型用法¶
- 安装 dsh-session-permissions 与本插件，重启
dsh web。 - 在 DSH 中创建或打开 Claw 会话，按 Agent 与会话权限配置工具与技能范围。
- 触发一次可能越界的工具调用：观察是否被闸拦截、是否弹出官方一次性审批。
- 打开设置中的 审计 页，按时间或 Agent 筛选，必要时导出当前结果；同时可在本机查看
~/.dsh/agent-gate/audit.jsonl是否与界面一致。
工作区会话不会走本闸的 Claw 专用逻辑，排查权限问题时要区分会话类型。
适用场景与注意¶
适合谁： 需要在 DSH 里跑 Claw Agent、且希望工具调用可审批、可审计的团队或个人；分类上属于 admin-security，偏治理与合规而非业务功能扩展。
注意： 插件以当前 dsh 进程权限 运行，安装前请自行阅读 GitHub 仓库 源码与 MIT 许可证。社区插件目录 SkillHub 条目 为独立站点，与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 DSH 生态的常见做法，本闸是其中一层安全补强，不能替代你对 Agent 提示词、密钥与主机环境的整体管控。
结尾¶
dsh-agent-gate 把 Claw 会话的工具调用收进分层策略、官方审批与可导出审计三条线里，并与 dsh-session-permissions 的沙箱策略对齐。进一步了解可访问目录页 skillhub.cn/plugins/xingyingyuzhui/dsh-claw-gate 与源码 github.com/xingyingyuzhui/dsh-claw-gate。
