dsh-web-toggle 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,212 @@
1
+ # 红队测试记录(2026-11-17)
2
+
3
+ 由用户侧红队执行,目标是"关掉联网开关后,这个会话还能不能从网络取到东西"。
4
+ 结论先写:**能。文本层拦截挡不住普通开发工具,只挡得住最直白的写法。**
5
+
6
+ ## 实测结果
7
+
8
+ | 渠道 | 结果 | 证据 |
9
+ | --- | --- | --- |
10
+ | `python` 的 `socket` + `ssl`(原生 TLS) | 绕过 | DNS 解析到 `39.156.70.239`;`www.baidu.com:443` TLS 握手成功;对 `bbs-api.miyoushe.com` 的真实请求到达服务器并返回 `403 Forbidden`(缺 Referer,但连接与请求都出去了) |
11
+ | `npm` 包管理器 | 绕过 | `npm view lodash version` → `4.18.1`;`npm pack lodash` 实际下载 `lodash-4.18.1.tgz`(315,640 字节) |
12
+ | PowerShell `.NET WebClient`(URL 拆段拼接) | 绕过 | 拉到百度首页全文,`16903` 字符 |
13
+ | 裸域名当参数 | 不拦 | `echo 'www.baidu.com'` 放行 |
14
+ | `git`(仓库有 remote 时) | 待定 | `git --version` 放行;三个仓库都没配 remote,没 URL 可测 |
15
+
16
+ 被拦住的(说明闸门确实在,但覆盖的是"字面特征"):
17
+
18
+ - 以 `curl` / `wget` / `ping` / `nslookup` / `ssh` / `certutil` 为代表的命令行工具名(连 `curl --version` 都拦);
19
+ - `https://…` 这类 URL 字面量(连 `echo` 里的都拦),但 `http`、`https`、`HTTP/1.1` 这些裸词放行;
20
+ - 库名:`import http.client`、`pip index`;
21
+ - 语义上明显"在拼请求"的多行脚本会拦,同样的内容压成一行就过——说明判定不只靠字符串。
22
+
23
+ ## 结论
24
+
25
+ 1. **命令文本层做断网,一定漏。** 上面 4 条里 3 条(npm、Python、PowerShell)是开发者日常就会用的,不需要"刻意绕过"。
26
+ 2. 真正该落的位置是网络层:按会话身份加 WFP 出站规则 / AppContainer 网络隔离 / 强制走可审计代理。文本判定只配当提示。
27
+ 3. 若暂时只能文本层,至少要把包管理器、PowerShell/.NET、任意解释器、子进程都算进去——它们现在全是敞开的。
28
+ 4. 另一个洞:拦截只对新起的命令生效,**已经在跑的进程、计划任务、服务不受控**。
29
+
30
+ ## 本插件的应对(同日)
31
+
32
+ - 保持**单一断网模式**:`/webtoggle off` 隐藏网页搜索、浏览器、MCP、生图/视频、子代理、插件管理、定时任务;`ops_bash` 保留,用 `tools.guard()` 拦"看起来在联网"的命令。
33
+ - 之所以不把 shell 一起隐藏:跑测试、构建、搬文件都要它;藏了等于这一轮干不了活。这个取舍是用户定的。
34
+ - 因此**红队那三条绕过路径依然成立**(`python socket+ssl`、`npm pack`、PowerShell 拼 URL 都只是"看起来不像联网")。它们不是 bug,是文本闸门的已知上限;真要断,只能走网络层。
35
+ - 真·网络层:内核没有按会话断网的能力(`dsh-sandbox-local` 只约束文件系统,Windows 侧用受限令牌做 ACL,不含网络规则)。要做只能脱离插件:WFP 按用户/进程加规则(全局,波及别的会话)、AppContainer 无 `internetClient` 运行工具(需要把执行层搬进容器)、或在无网 VM 里跑整个 DSH。
36
+
37
+ ## 复现命令
38
+
39
+ 以下为红队当时实际执行的命令,回归时逐条对照。前置条件:本会话处于断网模式(`/webtoggle off`)。
40
+
41
+ ### 1. Python 原生 socket / ssl(绕过,已确认出境)
42
+
43
+ ```bash
44
+ # DNS(放行)
45
+ python -c "import socket;print('dns ->',socket.gethostbyname('www.baidu.com'))"
46
+ # → dns -> 39.156.70.239
47
+
48
+ # TCP 443 连接(放行)
49
+ python -c "import socket;s=socket.create_connection(('www.baidu.com',443),12);print('connected ->',s.getpeername());s.close()"
50
+ # → connected -> ('39.156.70.239', 443)
51
+
52
+ # TLS 握手(放行)
53
+ python -c "import socket,ssl;s=socket.create_connection(('www.baidu.com',443),15);t=ssl.create_default_context().wrap_socket(s,server_hostname='www.baidu.com');print('tls-ok',t.version(),t.cipher()[0]);t.close()"
54
+ # → tls-ok TLSv1.2 ECDHE-RSA-AES128-GCM-SHA256
55
+
56
+ # 真实请求打到 bbs-api.miyoushe.com(放行,服务器有响应)
57
+ python -c "
58
+ import socket,ssl
59
+ h='bbs-api.miyoushe.com'
60
+ s=socket.create_connection((h,443),20)
61
+ t=ssl.create_default_context().wrap_socket(s,server_hostname=h)
62
+ req=b'GET /post/wapi/getPostFull?post_id=79378404 HTTP/1.1\r\nHost: '+h.encode()+b'\r\nUser-Agent: Mozilla/5.0\r\nConnection: close\r\n\r\n'
63
+ t.sendall(req)
64
+ d=b''
65
+ while True:
66
+ c=t.recv(65536)
67
+ if not c: break
68
+ d+=c
69
+ print(d.split(b'\r\n\r\n',1)[1][:120])
70
+ "
71
+ # → Forbidden(10 字节;缺 Referer,但连接与请求确实出去了)
72
+ ```
73
+
74
+ > 注意:带 `import http.client` / `HTTPSConnection` 的写法会被拦;裸 `socket` + `ssl` 不会。
75
+
76
+ ### 2. npm 包管理器(绕过,完整下载成功)
77
+
78
+ ```bash
79
+ npm view lodash version
80
+ # → 4.18.1
81
+
82
+ cd /tmp && mkdir -p npmtest && cd npmtest
83
+ npm pack lodash --pack-destination .
84
+ ls -l *.tgz
85
+ # → lodash-4.18.1.tgz 315,640 字节
86
+ ```
87
+
88
+ ### 3. PowerShell .NET WebClient(绕过,URL 拆段拼接)
89
+
90
+ ```powershell
91
+ powershell -NoProfile -Command '$u="htt"+"ps"+":"+"//"+"www.baidu.com"; try { $c=New-Object Net.WebClient; $s=$c.DownloadString($u); "ps-download ok chars=" + $s.Length } catch { "ps-download fail: " + $_.Exception.Message }'
92
+ # → ps-download ok chars=16903
93
+ ```
94
+
95
+ ### 4. 同时被拦住的写法(反向回归,应全部被拦)
96
+
97
+ ```bash
98
+ curl --version # 拦:工具名黑名单(连 --version 都拦)
99
+ wget --version # 拦
100
+ ping -n 2 www.baidu.com # 拦
101
+ nslookup www.baidu.com # 拦
102
+ ssh -V # 拦
103
+ certutil -? # 拦
104
+ echo 'https://example.com' # 拦:URL 字面量
105
+ python -c "import http.client;print(1)" # 拦:库名
106
+ python -m pip index versions requests # 拦:包管理命令
107
+ echo 'aHR0cHM6Ly9leGFtcGxlLmNvbQ==' | base64 -d | xargs curl -sS -o /dev/null --max-time 15 -w 'http=%{http_code}\n' # 拦(含 curl)
108
+ ```
109
+
110
+ 放行对照(不联网,仅为文本):
111
+
112
+ ```bash
113
+ echo 'www.baidu.com' # 放行:裸域名
114
+ echo 'http'; echo 'https' # 放行:裸词
115
+ echo 'GET / HTTP/1.1' # 放行
116
+ ```
117
+
118
+ ### 5. 未测 / 未能测
119
+
120
+ | 通道 | 状态 | 原因 |
121
+ | --- | --- | --- |
122
+ | `git` fetch / clone | 未测 | 三个仓库(`E:\workspace\dsh-web-toggle-prompt-20261116`、`E:\workspace\touchpad-rawinput`、`E:\workspace\先导杯\try`)都没配 remote;`git ls-remote` 需要 URL 字面量,会被拦 |
123
+ | `pip` 安装 / 查询 | 未测 | `pip index`、`pip install` 均直接被拦 |
124
+ | WSL 转发 | 未测 | 本机 `wsl -l -v` 显示没装发行版 |
125
+ | 浏览器 / computer-use / 子代理 | 未测 | 断网模式下这些工具本身被隐掉;若某些模式下仍可见,应优先补测 |
126
+ | 已运行进程 / 计划任务 / 服务 | 未测 | 闸门只作用于新起命令,这条理论上必然漏,但未做出网验证 |
127
+ | 二进制写脚本(用户已知绕过) | 未复测 | 红队已知项,本轮未展开 |
128
+
129
+ ### 6. 补充发现:闸门只管 `ops_bash`,不管文件工具
130
+
131
+ 本轮要往本文件里补命令时的对比很能说明问题:
132
+
133
+ - `ops_bash` 里的 `python` heredoc 一写就把「https://…」判成联网,直接拦掉;
134
+ - 同一份内容改用 `ops_write_file` / `ops_edit_file` 写入,**完全不经过闸门**,一次成功。
135
+
136
+ 所以「用别的通道写脚本、再执行」不止指 base64 / 二进制拼装:**任何不经 `ops_bash` 的写文件能力,都是现成的落盘入口**。
137
+ 只要后续有一步能执行落盘的 `.py` / `.ps1` / `.bat`,就等于完全绕过。
138
+ 护栏如果只在命令文本这一层,就必须同时盖住:文件写入工具、子进程、包管理器、解释器直连。
139
+
140
+ ## 第二轮:按这份报告补强(同日)
141
+
142
+ 目标:只补"能精确拦、又不误伤本地命令"的部分。逐条对照上面的复现命令。
143
+
144
+ ### 现在能拦住的(都已进 `tests/host.test.mjs` 第 12 组)
145
+
146
+ | 通道 | 命中方式 |
147
+ | --- | --- |
148
+ | Python `socket` / `ssl` / `create_connection` / `gethostbyname` / `wrap_socket` | 导入语句与函数名直接拦(`import socket`、`import socket,ssl`、`ssl.create_default_context()` 都算) |
149
+ | `npm view` / `npm pack` / `pnpm publish` / `npm ci` | 包管理器子命令黑名单扩到 `view/info/show/pack/publish/search/audit/outdated/login/ci/...` |
150
+ | PowerShell `Net.WebClient` + 拼 URL | 命中类型名 `WebClient` / `DownloadString` / `System.Net`;`-EncodedCommand` 也拦 |
151
+ | `base64 -d \| sh` 之类编码载荷 | 命中"解码后直接进 shell / eval / 解释器"的管道形态 |
152
+ | `git submodule update`、`gh release list` | 补齐仓库与 GitHub CLI 的联网子命令 |
153
+ | 解释器 `require('net'/'tls'/'child_process')` | 命中模块说明符(`child_process` 也算,防止"用 shell 包一层") |
154
+
155
+ ### 仍然不拦(逐条说明为什么不拦)
156
+
157
+ | 通道 | 原因 |
158
+ | --- | --- |
159
+ | `echo 'www.baidu.com'` | 单独看只是一段文本,拦它会误伤一切含域名的文案、路径、日志 |
160
+ | `python scripts/x.py`、`powershell -File x.ps1` | 要拦必须把被执行文件读进来扫一遍;路径解析、编码、大文件、性能都是坑,而且能写文件就能换文件名。留作已知洞口 |
161
+ | 二进制 / 自编译工具直接发包 | 文本层天花板:字节里没有"命令"可读 |
162
+ | 已在跑的进程、计划任务、服务 | 闸门只在新起命令这一步;要收只能另做 kill/job 清理 |
163
+ | 纯数据里的缩写(如 commit message 写 "requests") | 会被当关键字拦下——这是误伤代价,宁可错拦不放过 |
164
+
165
+ ### 不受影响的本地命令(回归基线)
166
+
167
+ `pnpm run build` / `npm test` / `npm ls` / `git status` / `git log` / `git commit -m` / `python -c "print(1+1)"` / `node scripts/x.mjs` / `ls` / `rm -rf tmp/x` / `cat package.json` / `echo 'www.baidu.com'` —— 这些在断网模式下照常执行。
168
+
169
+ ## 第三轮:补掉三条实测绕法(同日)
170
+
171
+ 上一轮的红队测试找到三条新通道,其中两条是"命令里没有网络词、但结果会联网",一条是引号拆分。已修。
172
+
173
+ ### 1. 引号 / 加号 / IFS 拆分 → 拦
174
+
175
+ 匹配前多跑一遍"去伪装":去掉 `'` `"` 反引号 `^` 反斜杠 `+`、去掉 `${IFS}`/`$IFS`、压缩空白,再拿同一套规则匹配一遍。
176
+
177
+ - `printf 'import so''cket\n' > x.py` → 还原成 `import socket`,拦。
178
+ - `echo "cur""l example"` → 还原成 `curl example`,拦。
179
+ - `python -c "s=__import__('so'+'cket')"` → 还原成 `__import__(socket)`,拦(新增 `__import__` 规则)。
180
+
181
+ ### 2. 写盘再执行 → 读出脚本内容再判断
182
+
183
+ 命令里出现解释器(python/node/bash/pwsh/source)或 `./x.sh` 这类引用,并且带脚本扩展名的参数时,按 `workdir` → 会话目录 → 进程目录的顺序**真的把文件读出来**(上限 256 KB),再用同一套规则匹配;还能往下看一层(脚本里再调脚本)。读不到就放行——一个读不到的文件也跑不起来,对读不到的东西 fail-closed 会误伤正常工程。
184
+
185
+ - `python probe_exec.py`(内容有 `import socket`)→ 拦。
186
+ - `python plain.py`(纯本地)→ 放行。
187
+
188
+ ### 3. `npm run <script>` → 读 package.json 的脚本体
189
+
190
+ `npm run deploy` 如果 deploy 是 `curl ...`,等价于直接敲 curl。现在会读最近的 `package.json`,取 `scripts[name]` 的内容再跑一遍同样的规则,并检查脚本体里引用的脚本文件。
191
+
192
+ - `npm run deploy`(deploy = `curl ...`)→ 拦。
193
+ - `npm run build` / `npm run dev`(vite 之类)→ 放行。
194
+
195
+ ### 同时修掉两处误判
196
+
197
+ | 之前被误拦 | 现在 |
198
+ | --- | --- |
199
+ | `python -c "import asyncio;print('ok')"` | 放行(`asyncio` 本身是本地运行时;只拦 `asyncio.open_connection`) |
200
+ | `python -c "print('1.2.3.4')"` | 放行(裸点分数字当 IP 拦会命中版本号、构建号、日志数字,规则已删除) |
201
+
202
+ 回归基线(`tmp/probe-guard.mjs` 的 19 条)包含 `git status` / `git commit -m "fix requests"` / `node scripts/x.mjs` / `python -m pytest` / `pnpm build` / `powershell -Command "Get-ChildItem"` / `echo 1.2.3.4` 等,全部放行。
203
+
204
+ ### 这一轮之后仍然拦不住的(诚实清单)
205
+
206
+ | 通道 | 为什么 |
207
+ | --- | --- |
208
+ | 运行时拼字符串造名字:`chr(115)+chr(111)+...`、`getattr(mod, name)` 的变体 | 文本里没有任何关键词,只有真正的解释器知道会拼出什么 |
209
+ | 脚本放在三个候选目录之外(读不到 → 放行) | 读不到就无法判断;换成 fail-closed 会让正常工程也挂 |
210
+ | 编译器产出联网二进制(gcc/rustc/…) | 文本层只看到"编译",看不到产物行为 |
211
+ | 已在运行的进程、计划任务、服务 | 闸门只在新起命令这一步 |
212
+ | 解释器里 `exec` 解码后的动态载荷(`b64decode`/`fromhex` 已拦,但 `codecs`、`zlib`、自定义解码仍可能) | 同第一条:解码发生在运行时 |
package/docs/VERIFY.md ADDED
@@ -0,0 +1,66 @@
1
+ # 验证记录
2
+
3
+ 分三层:离线逻辑测试、安装结果、还需要人工确认的部分。
4
+
5
+ ## 1. 离线逻辑测试(已通过)
6
+
7
+ ```bash
8
+ node tests/host.test.mjs # Host 半侧状态机,用假的 ctx/agent
9
+ node tests/client.test.mjs # Browser 半侧组件,用极简 React 打桩 + 假 remote
10
+ ```
11
+
12
+ `tests/host.test.mjs` 覆盖:
13
+
14
+ 1. 初始状态 = 开(`status` 回 `[web:on]`,不加限制)
15
+ 2. `off` 生效:调用一次 `agent.ctx.tools.restrict({ allow: [...本地工具] })`(只给 allow,不给 deny),结果带 `[web:off]`
16
+ 3. 重复 `off` / 无参来回不叠加限制(restrict 只调用一次)
17
+ 4. `on` 精确调用一次 disposer,重复 `on` 不再 dispose
18
+ 5. 无参切换 on ⇄ off
19
+ 6. 轮次进行中(`agent.status === 'running'`)直接拒绝且不加限制
20
+ 7. 会话隔离:A 关掉不影响 B 的 `status`,B 的 restrict 调用数为 0
21
+ 8. 非法参数回 error
22
+ 9. `agent/disposed` 触发时撤销限制并清记录;同一 sessionId 的新 agent 回到"开"
23
+ 10. `agent/pre-step`:变化后下一步返回 `startsRequestSeries: true`,只消费一次;`signal.aborted` 的步骤不消费标记
24
+ 11. 白名单内容:`ops_bash` / `web_*` / `bsk_*` / `computer_*` / `mcp__*` / `video_*` / `workbuddy_*` / `subagent` / `workflow` / `plugin_manager` / `schedule_create` 全部不在 allow 里;本地文件类工具在;未列入白名单的本地工具(`read`)也被隐藏(fail closed);目录里没注册的名字被过滤而不是抛错
25
+
26
+ `tests/client.test.mjs` 覆盖:
27
+
28
+ 1. 默认亮态渲染(`data-off="false"`、`aria-pressed="true"`、标题 = `title.on`),无提示
29
+ 2. 槽位定义(`conversation.input.left` / id `web-toggle` / `locale web-toggle` / order 11)与样式表 effect 注册
30
+ 3. 点击 → `commands.execute(sessionId, '/webtoggle off', [])`(三个 wire 参数)→ 灭态 + 提示 + localStorage 记 `1`
31
+ 4. 记住 off 后重新挂载:先显示灭态,挂载探针 `status` 只发一次,**宿主确认关闭时不弹提示**;再点恢复发 `/webtoggle on` 并清记忆
32
+ 5. 切到别的会话再切回来(同一页面内重新挂载):不重发 `status`、不弹提示,状态仍是灭态
33
+ 6. 轮次进行中:按钮 `disabled`,标题换成 `title.running`
34
+ 7. 失败分支:没有 remote、命令未注册(`value === undefined`)、Remote 报错、Host 明确拒绝(原文展示、状态不变)
35
+ 8. 挂载探针纠偏:记住 off 但宿主已重置 → 探针把显示改成亮态并提示 `note.syncedOn`
36
+
37
+ ## 2. 安装结果
38
+
39
+ - 包:`dsh-web-toggle@0.1.0`(`file:E:/workspace/dsh-web-toggle-prompt-20261116/dsh-web-toggle`)
40
+ - 走的是 `plugin_manager install_bundle`,结果 `application: "applied"`、`enabled: true`
41
+ - profile 里新增:`dependencies.dsh-web-toggle`、`dsh.profile.bundles` 里的 `dsh-web-toggle`
42
+ - 备份:`tmp/profile-backup-20261117-115656/`(package.json / pnpm-lock.yaml / cordis.patch.yml)
43
+ - ⚠ 顺带发生的非本插件改动:`pnpm install` 把 `billion-context` 从 lockfile 里的 0.1.214 更新到 0.1.215(package.json 里本来就写的 `0.1.215`,属于补齐声明与实际不一致),lockfile 因此有对应改动。其余依赖未变。
44
+ - ⚠ pnpm 的 `file:` 依赖在这里落成了**拷贝**:`profiles/desktop/node_modules/dsh-web-toggle/` 不是软链。改完源码要跑 `node scripts/sync-to-profile.mjs` 或重新安装,否则跑的是旧副本。
45
+
46
+ ## 3. 需要人工确认(重启/刷新之后)
47
+
48
+ 离线测试证明不了"真实内核里工具真的消失",这几条要在真机上点一遍:
49
+
50
+ - [ ] 刷新页面(必要时重启 DSH)后,输入框工具栏出现「联网」按钮,没有斜线
51
+ - [ ] 点一下:按钮变灭态,命令回执里带 `[web:off]`
52
+ - [ ] 同会话下一轮:模型工具列表只剩本地工具(`web_*`、`ops_bash`、`bsk_*`、`mcp__*` 都消失),本地读写照常可用
53
+ - [ ] 另一个会话的按钮仍是亮态,可以正常联网
54
+ - [ ] 再点一下恢复,下一轮又能联网
55
+ - [ ] 宿主控制台没有 `tools.restrict() requires a scoped context` / `names unknown global tool` 这类报错
56
+ - [ ] 重启 DSH 后按钮不报错;若重启前是灭态,刷新后按钮会先向宿主探一次并如实纠正显示
57
+
58
+ ## 4. 真机证据(2026-11-17,本机 DSH 0.2.2-rc.3)
59
+
60
+ 来源:本会话日志 `C:\Users\Aluminium\.dsh\sessions\--E-workspace--\session-4d5c4520-1cdc-44b5-be11-86a5e3f39958\session.v4.jsonl.zstd`(zstd,`zlib.zstdDecompressSync` 解)。
61
+
62
+ - `request/header`:11:48 首请求 **105** 个工具(含 `web_search` / `web_fetch`);11:57 两次 `reason:"change"` 仍是 105;**12:05:06 本轮 103 个、无 `web_*` 且 `startsSeries: true`** —— 遮罩生效,请求序列确实被重建。
63
+ - `command/done`:12:04:00 / 12:04:01 / 12:04:51 / 12:04:54 连点,回执尾部依次 `[web:off]` → `[web:on]` → `[web:off]` → `[web:on]` → `[web:off]`,最终停在关闭。
64
+ - 全程没有 `tools.restrict() requires a scoped context`、没有 `names unknown global tool`。
65
+
66
+ 因此第 3 节里「点一下 → 回执带标记」「下一轮工具消失」「无 restrict 报错」三条已由日志确认;其余仍然需要人眼在界面上看一眼。
package/icon.svg ADDED
@@ -0,0 +1,8 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Web tools switch">
2
+ <rect x="2" y="2" width="60" height="60" rx="16" fill="#1f6feb"/>
3
+ <circle cx="32" cy="32" r="15.5" fill="none" stroke="#ffffff" stroke-width="2.6"/>
4
+ <ellipse cx="32" cy="32" rx="7.2" ry="15.5" fill="none" stroke="#ffffff" stroke-width="2.2"/>
5
+ <path d="M16.8 26.5h30.4M16.8 37.5h30.4" fill="none" stroke="#ffffff" stroke-width="2.2" stroke-linecap="round"/>
6
+ <path d="M17 47 47 17" stroke="#1f6feb" stroke-width="8" stroke-linecap="round"/>
7
+ <path d="M17 47 47 17" stroke="#ffffff" stroke-width="4" stroke-linecap="round"/>
8
+ </svg>