dsh-approval-popup 0.0.0-stage → 1.1.2

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 dsh-approval-popup contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,117 @@
1
- # Temporary Holding Version
1
+ # dsh-approval-popup
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ DeepSeek Harness 权限提升(sandbox escalation)审批的双界面插件,**仅支持 Windows**:
4
+
5
+ - **应用内弹窗**:全局层,任何对话的审批都会显示在 DSH 页面中央,带**会话标题**、工作区、发起工具、申请说明。
6
+ - **Windows 系统弹窗**:只在页面不可见/软件最小化时额外弹出原生 WinForms 窗口,标题栏带会话标题;同样可直接「允许一次 / 拒绝」。应用在前台时不会再同时弹系统窗口。
7
+
8
+ 两边回答的是**同一个**待审批请求:先答者生效,另一边在下次轮询时自动关闭,不会重复审批。
9
+
10
+ ## 高危请求
11
+
12
+ 删除文件、修改系统文件、注册表等高风险操作会进入**高危模式**:
13
+
14
+ - 系统弹窗:圆角浅红背景 + 顶部红色强调条,带「高危请求」徽标;
15
+ - 应用内弹窗:保留普通弹窗样式,去掉红边框,背景改为**半透明鲜红色**(`rgba(230,0,18,.82)`),带「高危请求」徽标;
16
+ - **常规请求支持键盘**:应用内和系统弹窗都可用 ←/→ 在「拒绝 / 允许一次」之间切换,Enter 按下当前选中按钮;
17
+ - **高危请求禁用键盘决定**:系统弹窗吞掉 Enter/Space/←/→,Allow 按钮退出 Tab 顺序;应用内弹窗在捕获阶段吞掉 Enter/Space/←/→,因此不会再误触聚焦的「拒绝」;Allow 按钮也不能 Tab 聚焦;
18
+ - 只能**用鼠标明确点击**「允许一次」才会批准;拒绝也建议用鼠标点击按钮;
19
+ - 应用内申请说明区:**常规请求为深色底 + 白色文字**;**高危请求为浅色底 + 黑色文字**。
20
+
21
+ 高危判定**以实际工具调用参数为准**:宿主按审批请求的 `callId` 回溯会话里的 `tool/call` 事件,读取真实 `command` / `path` 等参数。
22
+
23
+ 对 PowerShell 命令(`pwsh` / `powershell`)使用**真实 PowerShell AST 做语义分析**:
24
+
25
+ - 解析所有 `CommandAst`,识别 `Remove-Item`、`Clear-Content`、`Format-Volume` 等破坏性 cmdlet;
26
+ - 解析别名(`ri`、`rm`、`del`、`erase`、`rd` 等)到真实命令;
27
+ - 检查 `copy/move/rename/new/set-content` 等修改命令的目标是否为 `HKLM:`、`HKCU:`、`System32`、`Windows`、`Program Files`、`ProgramData` 等受保护位置;
28
+ - 检查嵌套的 `cmd /c del`、`powershell -Command ...`;
29
+ - 检查 `[System.IO.File]::Delete(...)`、`[Microsoft.Win32.Registry]...SetValue(...)` 等 .NET 方法调用;
30
+ - `Invoke-Expression` / `iex` 动态执行直接判高危。
31
+
32
+ 其他 shell(bash)和结构化工具仍使用命令/参数关键词匹配;AST 分析失败时才退回关键词匹配。语义分析仍不能覆盖运行时拼接、编码混淆或脚本内部再删除的情况。
33
+
34
+ ## 设置
35
+
36
+ 在 **设置 → 权限审批** 中:
37
+
38
+ - **启用高危识别**:总开关;关闭后不再分析命令,所有请求都按常规弹窗处理。下方识别类型通过缩进和左侧竖线明确从属于该开关,关闭时整体置灰。
39
+ - 六类可按需开关:
40
+ - 删除文件;
41
+ - 注册表修改;
42
+ - 系统文件;
43
+ - 权限与 ACL;
44
+ - 磁盘 / 启动 / 服务;
45
+ - 动态执行(`Invoke-Expression` / `iex`)。
46
+ - **常规请求颜色**:深海蓝、晴空蓝、翡翠绿、琥珀黄;应用内和系统弹窗同步使用。
47
+ - **高危请求颜色**:固定警示红;设置中保留红色选色框并标注“默认”,但不可修改。
48
+ - 设置保存到 `$DSH_HOME/dsh-approval-popup/settings.json`,每次审批时读取,**修改后立即生效**,无需重启。
49
+ - 关闭某一类后,AST 分析中该类命中会被过滤;其他类别仍按各自开关判定。
50
+ - 总开关关闭时不会启动 PowerShell AST 分析,审批延迟更低。
51
+
52
+ ## 架构
53
+
54
+ ```
55
+ approval/request
56
+ │
57
+ ▼
58
+ 宿主插件(唯一 owner)── 原生 Windows 对话框
59
+ │ /dsh-approval-popup/poll
60
+ │ /dsh-approval-popup/answer
61
+ ▼
62
+ 浏览器全局层(shell.overlay)── 应用内 Modal
63
+ ```
64
+
65
+ - 宿主拦截 `approval/request`,保存待审批项,不再转发给内置审批面板。
66
+ - 浏览器每 700ms 轮询 `/poll`,上报页面是否可见/聚焦。
67
+ - 宿主判断:页面不可见/软件最小化 → 打开系统弹窗;应用在前台时只保留应用内弹窗。
68
+ - 会话标题与工作区从 `session_projcache` 的 `rows.title.val` / `identity.cwd` 读取,缺失时才回退到会话 ID / 进程工作目录。
69
+ - 系统弹窗结果直接结算待审批项;浏览器下一次轮询拿到空结果后关闭应用内弹窗。
70
+ - 应用内弹窗直接 `/answer`;宿主随后关闭系统弹窗。
71
+ - 4 秒内没有浏览器轮询(浏览器关闭/未加载)时,宿主自动打开系统弹窗。
72
+
73
+ ## 安全与误触
74
+
75
+ - 系统窗口没有 `AcceptButton`/`CancelButton`;只有两个按钮的 `Click` 事件能写结果;初始焦点在「拒绝」。
76
+ - 应用内弹窗没有关闭 X;遮罩、Esc 都不回答请求;只有「允许一次 / 拒绝」按钮生效;初始焦点在「拒绝」。
77
+ - 桥接路由仅接受 loopback 请求(`127.0.0.1` / `::1`),仅接受 POST JSON。
78
+ - 宿主会为每次 PowerShell 审批启动一次 `powershell.exe` 做 AST 分析,但**不会执行被审批的命令**;分析超时/失败会回退到关键词匹配。
79
+ - 设置写入 `$DSH_HOME/dsh-approval-popup/settings.json`;不会读写凭据。
80
+ - 审批结果仍由 `dsh-user-approval` 写入会话审计日志。
81
+
82
+ ## 安装
83
+
84
+ 从 npm / 插件市场安装:
85
+
86
+ ```powershell
87
+ dsh plugin --profile web add dsh-approval-popup
88
+ ```
89
+
90
+ Desktop 用户直接在 **设置 → 插件** 中安装;profile 名不是 `web` 时替换为实际名称。
91
+
92
+ 仓库内开发安装(npm 发布包不含 `scripts/`):
93
+
94
+ ```powershell
95
+ node .\scripts\install.mjs
96
+ ```
97
+
98
+ 脚本会创建 profile 的 junction,写入 `dependencies` 和 `dsh.profile.bundles`,并备份原 `package.json`。
99
+
100
+ 安装/更新后必须让宿主重新加载该插件:插件页关闭再启用,或完全重启 DeepSeek Harness;随后刷新 Web 页面。
101
+
102
+ ## 自检
103
+
104
+ ```powershell
105
+ node --check .\lib\index.js
106
+ node --check .\client\client.js
107
+ node .\test\host.test.mjs
108
+ node .\test\client.test.mjs
109
+ powershell.exe -NoProfile -Command "$null = [scriptblock]::Create((Get-Content -Raw .\lib\dialog.ps1))"
110
+ ```
111
+
112
+ ## 限制
113
+
114
+ - 系统弹窗仅 Windows。
115
+ - 桥接依赖 DSH Web 服务与 loopback 访问;局域网/远程访问时只走应用内弹窗。
116
+ - 对话标题/工作区取自宿主会话对象;缺失时回退到会话 ID 与进程工作目录。
117
+ - 当前按时间顺序一次处理一个待审批项。