快速判断

安装前先看这几项

配置资料: 配置资料部分完整
配置难度: 未知，待补配置
适合新手: 建议具备相关经验
兼容状态: 声明兼容，尚未实测
验证状态: 源码已审阅，未标记运行实测

配置资料部分完整

本站已整理安装目标，但尚未补齐该插件的全部专属配置。完成配置前需要核对固定来源。

仍需核对：插件专属配置项、成功验证结果、首次使用示例、数据清理方法。

功能

这个插件能做什么

在每次 DSH 工具执行前按 YAML 规则匹配工具、Agent、参数、路径、环境和网络目标，执行 allow、deny 或 ask，并提供审计日志、热重载、试运行模式和本机网络代理。

适合谁

需要多 Agent、工作流、编排能力的用户。

使用门槛

该插件涉及较高配置难度或敏感权限，不建议在生产工作区直接试装。

准备

安装前准备

本站尚未核验该插件的专属前置条件。请先准备独立 Web Profile、测试工作区，并核对固定来源中的运行时、外部服务和账号要求。

安装

如何安装 dsh-permission-rules

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到: web Profile
DSH 基线: 0.1.1-rc.2
安装来源: GitHub 源码（锁定提交）
固定目标: github:PerryLink/dsh-permission-rules#50e50ee38360

01
检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：
环境检查
```
node --version && pnpm --version
```
02
安装到 Web Profile
这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。
GitHub 源码（锁定提交）
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add github:PerryLink/dsh-permission-rules#50e50ee38360
```
03
如遇构建脚本拦截
GitHub 源码插件可能通过 prepare 构建。pnpm 10 及以上会先阻止未授权构建；只把终端明确提示的包名加入该 Profile 的 pnpm-workspace.yaml 中 allowBuilds，审阅脚本后再重复上一步，不要使用全局放行。
04
确认 Bundle 已进入配置
安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-permission-rules或对应 Bundle 层。
检查配置
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
```
05
启动并完成最小验证
启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。
启动 DSH Web
```
npx --yes @deepseek-ai/dsh@0.1.1-rc.2 web
```

卸载与回退

测试不通过时先停止 DSH，再从同一 Profile 移除插件。移除后重新运行配置检查，确认对应 Bundle 层已经消失；插件自己创建的数据和外部账号配置可能需要另行清理。

从 Web Profile 移除

npx --yes @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-permission-rules

阅读 DSH 插件安装基础指南核对项目 README

配置

插件专属配置

专属配置路径和字段尚未完成核验，请不要根据同类插件猜测参数名。

验证

配置检查与成功结果

本站尚未获得插件专属的验证命令和期望结果。安装后只能确认 Bundle 是否进入组合配置，不能据此宣称插件功能已经运行通过。

使用

第一次使用建议这样验证

以下步骤是根据插件类别提供的安全验证顺序，不是作者仓库的专用命令。具体入口和参数仍以固定提交对应的 README 为准。

在隔离环境中配置最小权限策略
构造允许和拒绝两类操作进行验证
检查审计记录是否完整且可以追溯

权限

它可能接触哪些数据和能力

执行本机命令写入本地文件读取本地文件

读取、监听并经设置页写入已知 .dsh/rules.yaml，挂接 tools/pre-execute、官方 approval 与 Session audit；可在 127.0.0.1 启动 HTTP/CONNECT 代理并临时改写宿主进程的代理环境变量

数据存储：尚未完成独立核验，测试前应确认插件是否写入工作区、用户目录、数据库或外部服务。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

排查

故障排查与数据清理

本站尚未整理插件专属故障模式。遇到问题时先停止 DSH、保存日志、核对固定提交对应的 README，不要反复扩大权限重试。

清理边界待核对：从 Profile 移除插件通常不会自动删除插件创建的数据、外部账号或凭据。

证据

兼容性与审阅记录

兼容性说明

插件版本 0.5.3、Apache-2.0，要求 Node.js ^22.19 或 24+，DSH peer >=0.1.0-rc.8 <0.2.0；版本范围覆盖本站 0.1.1-rc.2 基线。本站完成固定提交静态审阅，未运行其 139 项测试、真实 sandbox、CONNECT 代理、Windows 路径或多插件审批链

数据流

工具名、参数、Agent 身份、cwd、环境和候选网络目标 → 有界规则解析与首条命中决策 → allow 继续下游、deny 阻断、ask 交给官方审批 → 决策及网络阻断以 ignorable Session 事件和本机设置状态呈现；规则不发送给模型或外部服务。

源码审阅结论

已审阅固定提交的规则解析、运行时、Typert 设置桥、已知路径写入限制、代理监听和环境恢复。规则语法拒绝未知字段、危险正则和越界路径，代理默认绑定 loopback，ask 不自行调用模型，失效规则可配置为响亮失败；但它是策略层而非内核隔离，路径和 URL 来自启发式参数提取，不遵守代理环境变量的程序可绕过网络代理，无 sandboxPolicy 时 autoFallback 默认为 allow-all。先用 enforce=false 审计，再启用 deny/ask；关键边界仍依赖 DSH sandbox 和操作系统权限。

来源与维护信息

本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后，请重新核对作者说明。

精确来源: GitHub：PerryLink/dsh-permission-rules（外部链接，在新标签页打开）
来源登记表: Awesome DSH Plugin（外部链接，在新标签页打开）
来源快照: 5909d7aad5a4
固定提交: 50e50ee38360
许可证: Apache-2.0
主要语言: TypeScript
中文资料: 有中文审阅摘要

dsh-permission-rules