← 返回列表
D

@eco-dsh/eco-permission-gate

v0.3.0 · 0 天前发布

dsh plugin: L1-L4 risk permission gate (port of eco-agent permissions.py)

dshdsh-plugincordispermissionsecurityriskeco-agent

README

eco-permission-gate

dsh plugin — L1-L4 风险权限闸门。

移植自 xiejianjun000/eco-agent 的 agent_core/permissions.py（MIT License），能力对齐原版五级风险分级思路（L1-L4 + 默认 L3）。

作用

在 dsh 的工具调用前拦截（tools/pre-execute 钩子），按工具名/命令前缀解析风险等级，自动放行安全操作、对高危操作要求用户确认或直接拒绝：

| 级别 | 含义 | 默认行为 |
|------|------|----------|
| L1 | READ（只读查询） | 自动放行 |
| L2 | WRITE_LOCAL（本地安全区写入） | 自动放行 |
| L3 | EXEC（命令/代码执行） | 白名单自动放行，其余按 mode（auto/ask/deny） |
| L4 | EXTERNAL（外部服务写入） | 默认 ask，可配 deny |

等级解析顺序：PERMISSION.md / 配置覆盖 > 前缀映射 > 默认 L3。mcp__{server}__{tool} 远程工具一律保守解析为 L3。

v0.2.0 — 策略热更新 + 三插件联动

  • 新增 eco_policy_reload 工具：运行时重新解析 PERMISSION.md 与配置 overrides，无需重启插件；同时提供 ctx.ecoPolicy.reload() 服务。

  • 新增 recordDeniedToMemory 配置：开启后每次拒绝事件自动写入记忆树（[SECURITY] 前缀 + `securi

    • 版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ❓ 未知 metadata 缺失
    dsh@0.1.0 ❓ 未知 —
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    @eco-dsh/eco-permission-gate
    Repo
    —
    Engines
    {}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {}