前言¶
在 DeepSeek Harness(DSH)里跑智能体时,工作区内操作可以照常进行;一旦触发一次性沙箱提权,默认会弹到你面前人工审批。提权请求频繁时,同类操作会反复打断你,而完全自动放行又违背 DSH 的权限设计。
社区插件 dshx-ai-approval(维护者 callaumyan-design,分类 admin-security)在 DSH 现有审批通道前加一层 LLM 审核:模型判为可放行则直接执行,判为拒绝、超时或出错时仍走原有人工审批,不会因为 AI 侧异常而自动越权。
这是什么¶
一句话:给 DSH 增加名为「由 AI 审批」的权限预设,让一次性沙箱提权先经审核模型判断,再决定是否还需要你点同意。
沙箱、权限策略和审批记录仍由 DSH 负责;插件通过 Cordis patch 扩展权限预设,并在客户端注入设置页(@deepseek-ai/dsh-client-ui-settings),供你选择审核用的 provider / model。实现为纯 JavaScript,无构建步骤。
核心功能¶
审核逻辑与 README 描述一致:
- 模型回答 ALLOW → 直接放行该次提权;
- 模型回答 DENY、超时或出错 → 照常弹出人工审批,不自动放行。
安装后新会话默认使用该预设(若在设置里另选了默认权限,则以你的选择为准)。可在 设置 → AI 审批 中配置主审核模型与备用审核模型(主模型报错、冷却或答非所问时使用),并支持一键测试连通性。
每次审核可写入日志文件 ~/.dsh/dshx-ai-approval.log;设置环境变量 DSHX_AI_APPROVAL_NO_LOG=1 可关闭日志。
通过 cordis.patch.yml 可配置(未填时多数项走内置默认):
| 字段 | 默认 | 说明 |
|---|---|---|
provider / model |
空(用默认模型) | 审核模型 |
fallbackProvider / fallbackModel |
空 | 备用审核模型 |
systemPrompt |
空(用内置规则) | 自定义审核规则 |
注意:插件的 patch 会重写 permission 行的预设列表(保留内置三档并新增 ai-approval)。若你曾自行改过权限预设,安装后请打开配置核对是否与预期一致。
安装与启用¶
插件面向 web 与 desktop profile,安装后需重启 DSH(requiresRestart: true)。在 SkillHub 插件目录 可查看条目;源码与说明见 GitHub 仓库。
下面命令来自仓库 README,请按你实际使用的 profile 选择其一:
# Web profile
dsh plugin --profile web add github:callaumyan-design/dshx-ai-approval
# Desktop(用 DSH Desktop 自带的 dsh 命令,先从托盘完全退出 Desktop)
dsh plugin --profile desktop add github:callaumyan-design/dshx-ai-approval
安装完成后重启 DSH。卸载示例:
dsh plugin --profile <profile> remove dshx-ai-approval
将 <profile> 换成 web 或 desktop。
兼容性说明:在 DeepSeek Harness 0.2.0-rc.2(desktop / web profile)上开发和使用。许可证为 MIT。
典型用法¶
经过上面的安装与重启,可按 README 建议的顺序使用:
- 确认新会话是否已默认「由 AI 审批」预设;若否,在 DSH 权限/预设相关设置里选择该档。
- 打开 设置 → AI 审批,选定审核用的 provider / model,按需配置备用模型,并做一次连通性测试。
- 在智能体执行可能触发沙箱提权的任务时观察行为:ALLOW 应不再弹窗;DENY 或 AI 异常时应仍出现人工审批。
- 需要排查审核结论时,查看
~/.dsh/dshx-ai-approval.log(或设DSHX_AI_APPROVAL_NO_LOG=1关闭写入)。
若要通过配置文件固定审核模型或自定义规则,在 DSH 的 cordis.patch.yml 中填写上表字段即可;systemPrompt 为空时使用插件内置审核规则。
适用场景与注意¶
适合希望在 admin-security 场景下减少重复人工点选、又不愿关闭沙箱审批链路的 DSH 用户:AI 只做「第一道筛」,最终兜底仍是 DSH 与你本人。
使用前请知悉:
- 插件与 DSH 进程同权限运行,安装前建议阅读仓库源码与 MIT 许可证,确认审核 prompt 与模型路由符合你的安全策略。
- AI 误判 ALLOW 会直接放行提权;误判 DENY 或模型不可用只会增加人工审批次数,不会静默越权。
- DSH 生态强调「一切皆插件」;SkillHub 为社区目录站点,与 DeepSeek / 幻方无官方从属关系,本文安装与配置均以该插件 GitHub README 为准。
结尾¶
dshx-ai-approval 在 DSH 原有沙箱提权审批前插入 LLM 审核层,用 ALLOW / DENY 与失败回退人工的方式,在效率与安全默认之间多一档可配置的折中。目录页:https://www.skillhub.cn/plugins/callaumyan-design/dshx-ai-approval;仓库:https://github.com/callaumyan-design/dshx-ai-approval。