Skip to main content
A

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-toggle

README

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