- Home
- Plugins
- Security & Permissions
- dsh-web-toggle
dsh-web-toggle
aluminiumranran/dsh-web-toggle
按会话的断网开关:每个工具有四种模式——放行、拒绝(从列表移除)、检查(每次看参数)、调用时拒绝;没配置过的工具默认检查。面板分三处(输入框小箭头、设置页侧边栏、插件详情页)。 / A per-session network switch: every tool has one of four modes — keep, hide (drop from the list), inspect each call, or refuse each call; tools you never configured
Install
dsh plugin --profile web add github:aluminiumranran/dsh-web-toggleREADME
dsh-web-toggle
为 DeepSeek Harness(DSH)对话输入框工具栏加一个按会话独立的断网开关:点灭之后,本会话里标成「隐藏」的工具从模型眼前消失(出厂默认包括 web_search / web_fetch、浏览器、MCP、子代理、插件管理、定时任务),ops_bash 这类通用执行器保留但每次调用前过一遍联网内容检查;再点一次恢复。只影响这一个会话。
每个工具有四种模式:keep(放行)/ hide(拒绝,藏起来)/ inspect(检查)/ refuse(调用时拒绝)。出厂只标例外、不维护白名单——没见过的工具默认「检查」:还在列表里,但每次调用都看一眼参数,既不误放也不会把工具表改乱。
两条与缓存有关的规则:不切换就隐藏;要切换 / 热调整就用「调用时拒绝」——只有 hide 会改动工具列表、打断提示词缓存。会话开始之后,插件会自动把 hide 按 refuse 执行,并(默认)锁住开关,避免半路换掉工具声明。
安装
方式一:单个 tgz(发行版)
从 Releases 下载 dsh-web-toggle-0.6.0.tgz,然后在 DSH 里:
plugin_manager install_bundle target="file:/绝对路径/dsh-web-toggle-0.6.0.tgz"
方式二:从 npm
plugin_manager install_bundle target="dsh-web-toggle@0.6.0"
方式三:从源码目录
git clone <this repo>
# 在 DSH 里:
# plugin_manager install_bundle target="file:/绝对路径/dsh-web-toggle-20261116/dsh-web-toggle"
装完刷新页面(客户端模块要重新下发)。要求 DSH >= 0.2.2-rc.1 < 0.3.0。
用法
输入框左边会多出一个小地球按钮,亮 = 联网开启,灭 = 已断网;旁边的小箭头打开本会话面板,里面能逐个工具改模式。也可以用命令:
/webtoggle 切换
/webtoggle on|off 显式开关(幂等)
/webtoggle status 只读状态
/webtoggle tools 报一句「共 N 个工具」,--json 才给目录
/webtoggle lock on|off 开关「会话开始后锁定开关」
/webtoggle mode <tool> keep|hide|inspect|refuse [--global]
/webtoggle mode reset [--global]
轮次正在执行时会被拒绝,等这一轮结束再点。面板里的点击不写聊天日志:按钮写的是本插件的配置,宿主在下一个请求前落到 restrict() / guard() 上;只有手敲命令才留回执。
它做什么
- 用内核自带的
agent.ctx.tools.restrict({ deny })做例外表:断网时只 deny 那些标了hide的工具,inspect的工具照常可见。作用域绑定在 agent 上,所以按会话隔离、可逆。 inspect模式的工具(默认ops_bash)用同一作用域的agent.ctx.tools.guard()做内容检查(三层:字面匹配、去引号/加号/IFS 伪装后再匹配、读出要执行的脚本和npm run的脚本体再匹配)。- 拒绝理由写成给模型的指令:不要换工具、不要写脚本或编码后执行、不要起子进程找替代通道;真需要联网就停下请用户打开开关。
- 模式分「本会话 / 全局 / 出厂默认」三层,界面改动即时生效;开始说话的会话把
hide按refuse执行,保住缓存。
它挡不住什么
这是提示性护栏,不是网络层的墙。DSH 内核没有按会话断网的能力(沙箱只约束文件系统),所以运行时拼出来的模块名、编译出的二进制、放在读不到路径里的脚本、已经在跑的进程,都能绕过去。真要一个字节都不许出,只能在无网 VM/容器里跑 DSH。
设计细节、红队记录、真机验证见 dsh-web-toggle/docs/。
目录
dsh-web-toggle/ 插件源码(Host 半侧 index.js、Browser 半侧 client.js、patch、locale、图标)
dsh-web-toggle/docs/设计细节、红队记录、验证清单
dsh-web-toggle/tests/离线测试(host 18 组、client 15 组)
PROMPT.md 最初的实现要求(保留作为设计背景)
许可
MIT,见 dsh-web-toggle/LICENSE。
声明
本插件使用 AI 辅助完成(设计、实现、测试与文档均由人和 AI 协作产出,并经真机红队测试)。它的定位是提示性护栏,不是网络隔离,发布前请自行复核是否满足你的安全要求。
Related plugins
dsh-purge
hunyisage/dsh-purge
dsh-infinite-gen-4
minglink/dsh-infinite-gen-4
dsh-purge
mmparko/dsh-purge
cc-safety-net
kenryu42/cc-safety-net