@leiyi-works/dsh-session-tmpdir 0.10.3 → 0.10.5
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/README.md +275 -268
- package/index.js +2974 -2912
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,268 +1,275 @@
|
|
|
1
|
-
# Task Temp Folder(session-task-tmpdir)v0.9.0
|
|
2
|
-
|
|
3
|
-
给每个 DSH 会话一个**任务临时目录**,并在**会话被删除 7 天后**自动清掉对应目录:
|
|
4
|
-
|
|
5
|
-
```
|
|
6
|
-
<会话工作目录>/_tmp/<会话标题>/
|
|
7
|
-
```
|
|
8
|
-
|
|
9
|
-
同时守住工作区根目录:**临时文件只能进 `_tmp/`;长期文件必须用户点头后才能落盘**。
|
|
10
|
-
|
|
11
|
-
v0.9 起按「中间产物/长期产物」划分落盘规则(方案 3):**在 `_tmp` 之外新建文件 → 先问用户(文件级审批,`mode=dir` 可批整个目录);改写已存在的文件 → 直接放行**。白名单持久保存,并在左侧菜单「临时目录」面板里展示、可移除。
|
|
12
|
-
|
|
13
|
-
v0.7 起,这条规则不再只靠 `write`/`edit`/`pwsh`/`bash` 四个工具名:**publish 交付复制、python/node 等代码执行工具、以及任何在 schema 里声明了路径参数的写类工具都会被纳入检查**,工作区之外的落点也一并纳入。
|
|
14
|
-
|
|
15
|
-
## 一句话规则(v0.9)
|
|
16
|
-
|
|
17
|
-
- 中间产物(下载文件、中间数据、截图、调试日志、一次性稿)→ `_tmp/<会话标题>/`,**不问用户**,直接写;
|
|
18
|
-
- 长期产物(跨会话复用/存档/交付成品)→ **新建文件前**先问用户(选择题);用户同意 → `longterm_approve` 默认按**单个文件**登记(`mode: 'dir'` 才登记整个目录)后写入;用户否定 → **退回 `_tmp`**;
|
|
19
|
-
- **改写已存在的文件**(含覆盖/追加/原地重算)→ 视为改写,**直接放行**,不弹窗(`allowOverwrite: false` 可改回"改写也要审批");
|
|
20
|
-
- 未经同意的**新建**落点(包括在工作区根新建条目、`publish` 到未登记目录、`ffmpeg`/`pandoc` 等程序写盘、python 写盘、工作区外任意新文件)→ 在**工具层直接拒绝**,并给出纠正提示。
|
|
21
|
-
|
|
22
|
-
## 功能介绍
|
|
23
|
-
|
|
24
|
-
| 功能 | 行为 |
|
|
25
|
-
|---|---|
|
|
26
|
-
| **任务临时目录** | 每个会话在**自己的工作目录**下得到 `_tmp/<会话标题>/`;换工作区也各自生效 |
|
|
27
|
-
| **改名同步** | 会话标题就是任务名;改名时目录**自动重命名**(连同里面的文件) |
|
|
28
|
-
| **重启可认领** | 目录内 `.dsh-task.json` 记录 session id;重启后靠标记文件对上 |
|
|
29
|
-
| **写入即认领(v0.8)** | 用普通 `write`/shell 在临时根下自起目录名时,guard 顺手补写当前会话的标记,不再产生“永远不清理”的无主目录 |
|
|
30
|
-
| **取路径工具** | `task_tmpdir` 返回**当时**的准确路径(自动创建、跟随改名),可选 `sub` 建子目录 |
|
|
31
|
-
| **长期落点审批** | `longterm_approve` 登记"本次会话已获用户同意的长期目录"(工作区内、工作区外都行),登记后该目录可写 |
|
|
32
|
-
| **工作区拦截** | guard 覆盖 `write`/`edit` + `pwsh`/`bash`:未审批的 `_tmp` 之外落点一律拒绝 |
|
|
33
|
-
| **写入通道覆盖(v0.7)** | publish 交付复制、python/node 代码写盘、schema 带路径参数的未知工具统一走同一判定 |
|
|
34
|
-
| **工作区外判定(v0.7)** | 工作区外除 DSH 主目录/缓存/系统临时目录外一律视为长期落点,未登记即拒绝 |
|
|
35
|
-
| **孤儿目录清理** | 会话被删除后,临时目录保留 7 天再删;会话还在的目录永不删 |
|
|
36
|
-
| **手动清理** | `tmp_cleanup` 立刻跑一轮清理(`dryRun: true` 只报告) |
|
|
37
|
-
|
|
38
|
-
## 配置(cordis.patch.yml 的 config)
|
|
39
|
-
|
|
40
|
-
| 字段 | 默认 | 说明 |
|
|
41
|
-
|---|---|---|
|
|
42
|
-
| `rootDirName` | `_tmp` | 临时目录根名(相对会话工作目录) |
|
|
43
|
-
| `includeSubagents` | `false` | 是否给子代理会话也建目录 |
|
|
44
|
-
| `
|
|
45
|
-
| `
|
|
46
|
-
| `
|
|
47
|
-
| `
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
54
|
-
| `
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
61
|
-
| `
|
|
62
|
-
| `
|
|
63
|
-
| `
|
|
64
|
-
| `
|
|
65
|
-
| `
|
|
66
|
-
| `
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
| `
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
|
106
|
-
|
|
|
107
|
-
|
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
111
|
-
|
|
|
112
|
-
|
|
|
113
|
-
|
|
|
114
|
-
|
|
|
115
|
-
|
|
|
116
|
-
|
|
|
117
|
-
|
|
|
118
|
-
|
|
|
119
|
-
|
|
|
120
|
-
|
|
|
121
|
-
|
|
|
122
|
-
|
|
|
123
|
-
|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
127
|
-
|
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
|
|
|
131
|
-
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
-
|
|
139
|
-
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
node --
|
|
161
|
-
node test
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
-
|
|
240
|
-
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
-
|
|
259
|
-
-
|
|
260
|
-
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
1
|
+
# Task Temp Folder(session-task-tmpdir)v0.9.0
|
|
2
|
+
|
|
3
|
+
给每个 DSH 会话一个**任务临时目录**,并在**会话被删除 7 天后**自动清掉对应目录:
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
<会话工作目录>/_tmp/<会话标题>/
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
同时守住工作区根目录:**临时文件只能进 `_tmp/`;长期文件必须用户点头后才能落盘**。
|
|
10
|
+
|
|
11
|
+
v0.9 起按「中间产物/长期产物」划分落盘规则(方案 3):**在 `_tmp` 之外新建文件 → 先问用户(文件级审批,`mode=dir` 可批整个目录);改写已存在的文件 → 直接放行**。白名单持久保存,并在左侧菜单「临时目录」面板里展示、可移除。
|
|
12
|
+
|
|
13
|
+
v0.7 起,这条规则不再只靠 `write`/`edit`/`pwsh`/`bash` 四个工具名:**publish 交付复制、python/node 等代码执行工具、以及任何在 schema 里声明了路径参数的写类工具都会被纳入检查**,工作区之外的落点也一并纳入。
|
|
14
|
+
|
|
15
|
+
## 一句话规则(v0.9)
|
|
16
|
+
|
|
17
|
+
- 中间产物(下载文件、中间数据、截图、调试日志、一次性稿)→ `_tmp/<会话标题>/`,**不问用户**,直接写;
|
|
18
|
+
- 长期产物(跨会话复用/存档/交付成品)→ **新建文件前**先问用户(选择题);用户同意 → `longterm_approve` 默认按**单个文件**登记(`mode: 'dir'` 才登记整个目录)后写入;用户否定 → **退回 `_tmp`**;
|
|
19
|
+
- **改写已存在的文件**(含覆盖/追加/原地重算)→ 视为改写,**直接放行**,不弹窗(`allowOverwrite: false` 可改回"改写也要审批");
|
|
20
|
+
- 未经同意的**新建**落点(包括在工作区根新建条目、`publish` 到未登记目录、`ffmpeg`/`pandoc` 等程序写盘、python 写盘、工作区外任意新文件)→ 在**工具层直接拒绝**,并给出纠正提示。
|
|
21
|
+
|
|
22
|
+
## 功能介绍
|
|
23
|
+
|
|
24
|
+
| 功能 | 行为 |
|
|
25
|
+
|---|---|
|
|
26
|
+
| **任务临时目录** | 每个会话在**自己的工作目录**下得到 `_tmp/<会话标题>/`;换工作区也各自生效 |
|
|
27
|
+
| **改名同步** | 会话标题就是任务名;改名时目录**自动重命名**(连同里面的文件) |
|
|
28
|
+
| **重启可认领** | 目录内 `.dsh-task.json` 记录 session id;重启后靠标记文件对上 |
|
|
29
|
+
| **写入即认领(v0.8)** | 用普通 `write`/shell 在临时根下自起目录名时,guard 顺手补写当前会话的标记,不再产生“永远不清理”的无主目录 |
|
|
30
|
+
| **取路径工具** | `task_tmpdir` 返回**当时**的准确路径(自动创建、跟随改名),可选 `sub` 建子目录 |
|
|
31
|
+
| **长期落点审批** | `longterm_approve` 登记"本次会话已获用户同意的长期目录"(工作区内、工作区外都行),登记后该目录可写 |
|
|
32
|
+
| **工作区拦截** | guard 覆盖 `write`/`edit` + `pwsh`/`bash`:未审批的 `_tmp` 之外落点一律拒绝 |
|
|
33
|
+
| **写入通道覆盖(v0.7)** | publish 交付复制、python/node 代码写盘、schema 带路径参数的未知工具统一走同一判定 |
|
|
34
|
+
| **工作区外判定(v0.7)** | 工作区外除 DSH 主目录/缓存/系统临时目录外一律视为长期落点,未登记即拒绝 |
|
|
35
|
+
| **孤儿目录清理** | 会话被删除后,临时目录保留 7 天再删;会话还在的目录永不删 |
|
|
36
|
+
| **手动清理** | `tmp_cleanup` 立刻跑一轮清理(`dryRun: true` 只报告) |
|
|
37
|
+
|
|
38
|
+
## 配置(cordis.patch.yml 的 config)
|
|
39
|
+
|
|
40
|
+
| 字段 | 默认 | 说明 |
|
|
41
|
+
|---|---|---|
|
|
42
|
+
| `rootDirName` | `_tmp` | 临时目录根名(相对会话工作目录) |
|
|
43
|
+
| `includeSubagents` | `false` | 是否给子代理会话也建目录 |
|
|
44
|
+
| `promptMode` | `compact` | 每步注入的规则详略:`compact` 精简中文(约 400 字符)/ `full` 原完整说明(约 3,700 字符)/ `off` 不注入(guard 仍生效) |
|
|
45
|
+
| `maxNameLength` | `60` | 目录名最大长度 |
|
|
46
|
+
| `orphanCleanupDays` | `7` | 会话被删除后保留多少天再清理;`0` = 关闭清理 |
|
|
47
|
+
| `cleanupIntervalHours` | `24` | 清理扫描间隔(小时) |
|
|
48
|
+
| `cleanupDryRun` | `false` | 只打印"会标记/会删哪些"、不动手 |
|
|
49
|
+
| `guardWorkspaceRoot` | `true` | v1 临时文件规则总开关(根目录临时命名、`_tmp/` 根文件) |
|
|
50
|
+
| `requireApprovalOutsideTmp` | `true` | 长期落点审批总开关(`false` 时 v0.5 + v0.7 全部通道的落点判定一并关闭,只留 v1 临时文件规则) |
|
|
51
|
+
| `allowOverwrite` | `true` | **v0.9(方案3)**:已存在的文件视为"改写",直接放行;`false` = 改写也要审批 |
|
|
52
|
+
| `allowRootPatterns` | `['dsh-*']` | 无需审批的根目录名(glob,`*`/`?`) |
|
|
53
|
+
| `allowRootFiles` | `['.dsh-standing-rules.md']` | 无需审批的工作区根文件 |
|
|
54
|
+
| `commandGuard` | `deny` | pwsh/bash 命令守卫:`deny` / `warn`(只记日志)/ `off` |
|
|
55
|
+
| `guardOutsideWorkspace` | `deny` | v0.7 工作区外写入:`deny` / `warn` / `off` |
|
|
56
|
+
| `publishGuard` | `deny` | v0.7 `publish` 交付复制目标检查:`deny` / `warn` / `off` |
|
|
57
|
+
| `guardCodeTools` | `true` | v0.7 静态扫描 `python`/`node` 等代码执行工具里的写文件语句 |
|
|
58
|
+
| `guardUnknownTools` | `true` | v0.7 对"没按名字识别、但 schema 带路径参数"的写类工具做兜底检查 |
|
|
59
|
+
| `outsideAllow` | 内置 | v0.7 追加"无需审批即可写"的工作区外目录(绝对路径或 glob,`**` 跨层;纯目录条目不含子项,用 `/**` 覆盖子文件) |
|
|
60
|
+
| `publishBaseDir` | 无(= 会话 cwd) | v0.7 相对 `publish` 目标的解析基准(例如鸿蒙上实际交付根是 `Download/` 的父目录时填它) |
|
|
61
|
+
| `writeToolNames` | 内置 | v0.7 追加写工具名(`write`/`edit` 已内置) |
|
|
62
|
+
| `publishToolNames` | 内置 | v0.7 追加交付工具名(`publish`/`present` 已内置,`present` 只展示不复制) |
|
|
63
|
+
| `codeToolNames` | 内置 | v0.7 追加代码执行工具名(`python`/`node` 等已内置) |
|
|
64
|
+
| `attachmentCleanup` | `true` | v0.6 附件回收总开关(会话删除后回收其附件) |
|
|
65
|
+
| `attachmentCleanupDays` | 同 `orphanCleanupDays` | 会话删除后多少天回收其附件;`0` = 只扫地孤儿 |
|
|
66
|
+
| `attachmentSweepOrphans` | `true` | 是否同时清扫"无人引用且够旧"的历史孤儿附件 |
|
|
67
|
+
| `attachmentsDir` | `<DSH_HOME>/attachments` | 附件仓库根目录(一般不用改) |
|
|
68
|
+
|
|
69
|
+
## 长期文件审批流程
|
|
70
|
+
|
|
71
|
+
1. 模型判断某文件需要长期保存,且不在任务指定位置;
|
|
72
|
+
2. 模型调用 `ask_user_question` 给用户选择题(标签只写 **A 不长期保存** / **B 工作区根目录保存**,细节放选项 description 小字;选 B 时模型自行起目录名、不再跟用户确认;其他位置由用户直接在输入框里写路径);
|
|
73
|
+
3. 用户选长期 + 给路径 → 模型调 `longterm_approve({ path, reason, basis })` 登记:**默认 `mode: 'file'` 只批准这一个文件**;用户明确要"整个目录都行"时才用 `mode: 'dir'`。工作区外路径也能登记(例如鸿蒙的 `Download/<包名>/`),但不能登记磁盘根目录、用户主目录本身或层级过浅的目录;
|
|
74
|
+
4. 之后 `write`/`edit`、shell 命令、`publish` 交付、python 等代码工具才能**新建**该位置的文件;用户否定 → 模型改用 `task_tmpdir` 写 `_tmp`。**改写已存在文件不需要登记**(`allowOverwrite`)。
|
|
75
|
+
|
|
76
|
+
白名单**持久保存**在 `<DSH_HOME>/data/session-tmpdir-approvals.json`:同一会话重启后继续有效;会话被删除的条目由清理任务回收。左侧菜单「临时目录」面板只做展示与「移除」(移除后该文件下次新建会重新走审批),不提供手动添加(添加只能来自对话里的用户同意)。
|
|
77
|
+
|
|
78
|
+
## guard 行为边界(v0.9)
|
|
79
|
+
|
|
80
|
+
判定顺序:`_tmp` 段(只在**工作区内或系统临时目录**里算临时区)→ 已审批文件/目录 → **已存在文件(改写放行,`allowOverwrite`)** → 白名单;其余按"新建产物"处理:工作区内 → 拒绝并提示先问;工作区外 → 按外部落点处理。
|
|
81
|
+
|
|
82
|
+
| 通道 | 判定方式 | 说明 |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| `write` / `edit` | 完整判定 | 新建工作区根条目、未审批位置、工作区外新文件 → 拒绝;目标已存在 → 放行(改写) |
|
|
85
|
+
| `pwsh` / `bash` | 命令文本启发式 | 含创建动词(`New-Item`/`cp`/`mv`/`sed`/`tee`…)、重定向(`>`/`>>`)或 **v0.9 写程序**(`ffmpeg`/`pandoc`/`Export-Csv`/`WriteAllText`/`Start-Process`…)时,扫描命令里的绝对路径(Windows 盘符;HarmonyOS/POSIX `/` 开头,先剥掉 `scheme://` URL);**已存在的路径按改写放行**,不存在且未审批 → 拒绝 |
|
|
86
|
+
| `publish` | 复制目标判定 | 只检查 `target`/`destination`/`to`/`output`/`save_path` 等(`source` 是读侧,不拦);目标不存在且未审批 → 拒绝并提示先问用户 |
|
|
87
|
+
| `present` | 不拦 | 只声明已有文件为交付物,不复制、不落盘 |
|
|
88
|
+
| `python` / `node` 等 | 静态扫描 | 写信号(`open(...,'w')`、`write_text`、`shutil.copy`、`json.dump`、`Image.save`…)与同语句路径字面量(含 `sub/x.md` 这类相对路径)配对;动态拼路径拦不到(默认边界) |
|
|
89
|
+
| 其它工具 | schema 兜底 | 工具名/描述含写语义(write/save/export/render/copy/install…)且**顶层**参数值像路径时,**与 `write`/`edit` 同一套规则**(v0.9 去掉了"工作区子目录放行"的例外):已存在 → 放行,新建未审批 → 拒绝 |
|
|
90
|
+
|
|
91
|
+
**不误伤的设计**(v0.7 审查后加固):只读工具名(`read*`/`list*`/`get*`/`show*`/`view*`/`check*`/`status*`/`query*`/`search*`/`find*`/`glob`/`grep`/`count*`/`stat*`)一律跳过;本插件自己的 `task_tmpdir`/`longterm_approve`/`tmp_cleanup` 永远放行;schema 里声明为 `enum` 的参数、`@e3`/`#submit` 这类选择器、`this_session`/`new_once` 这类枚举值、`@scope/pkg` 包名和 URL 都不算路径;嵌套对象里的同名参数(`expect[].target`、workflow `args.files`)不算写目标。
|
|
92
|
+
|
|
93
|
+
工作区外"天然允许"范围(无需审批,`outsideAllow` 可追加):`<DSH_HOME>`(`~/.dsh`,含插件/密钥/配置)、`~/.cache`、`~/.npm`、`~/.config`、`~/.local/share`、`~/.flova`、系统临时目录;POSIX 设备上另有 `/tmp`、`/var/tmp`、`/dev/shm`、`/run/user`、`/data/local/tmp`、`/storage/emulated/0/Android/data`。`/dev/null`、`NUL`、`$null` 之类伪路径直接放行。
|
|
94
|
+
|
|
95
|
+
拦不到(fail-open,**不是安全边界**):变量/动态拼接的路径、脚本内部逻辑、外部程序、GUI 操作、绕过工具的 fs 调用;`warn` 模式只记日志不拦(`guardOutsideWorkspace`/`publishGuard`/`commandGuard` 的 `warn` 在四个通道统一生效)。
|
|
96
|
+
|
|
97
|
+
其它:**工作区内**的规则只在会话工作目录 = 已注册工作区根时生效(会话 `cd` 到子目录时不把项目顶层文件当成"工作区根新建条目");**工作区外**的判定不受 cwd 限制,`cd` 到子目录也照拦(v0.7 修复);guard 是**全局**的——队友/子代理/定时任务会话同样受约束。
|
|
98
|
+
|
|
99
|
+
## 回归测试(v0.7)
|
|
100
|
+
|
|
101
|
+
`test/guard.test.mjs`(38 条纯函数用例)覆盖反馈里给的绕过场景 + 独立审查发现的问题:
|
|
102
|
+
|
|
103
|
+
| # | 用例 | 期望 |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| 1 | `write` → `_tmp/<标题>/x.md` | 允许 |
|
|
106
|
+
| 2 | `write` → `<cwd>/x.md` | 拒绝 + A/B 提示 |
|
|
107
|
+
| 3 | `write` → `<cwd>/<未批准目录>/x.md` | 拒绝 |
|
|
108
|
+
| 4 | `write` → 工作区外(`Download/…`) | 拒绝 |
|
|
109
|
+
| 5 | `publish` → `Download/<包名>/x.md`(未登记) | 拒绝 |
|
|
110
|
+
| 6 | `present` → 工作区外已有文件 | 允许(只展示) |
|
|
111
|
+
| 7 | `python`:`open('/storage/…/工作区根/x.md','w')` | 拒绝 |
|
|
112
|
+
| 8 | `python`:`open('…/_tmp/…/x.md','w')` | 允许 |
|
|
113
|
+
| 9 | `bash -c 'echo hi > /storage/…/工作区根/x.md'`(POSIX) | 拒绝 |
|
|
114
|
+
| 10 | `cp a.md /storage/…/Download/x.md`(POSIX) | 拒绝 |
|
|
115
|
+
| 11 | 未识别工具 `output` → 工作区根 / 工作区外 | 拒绝 |
|
|
116
|
+
| 12 | 未识别工具 `output` → 未批准子目录 | 允许(降误伤) |
|
|
117
|
+
| 13 | `longterm_approve` 登记工作区外目录后再写 | 允许 |
|
|
118
|
+
| 14 | `longterm_approve` 登记磁盘根 / `_tmp` | 抛错 |
|
|
119
|
+
| 15 | `schedule_create` / `bsk_interact` 的 `target` 是枚举/选择器 | 不算写目标(允许) |
|
|
120
|
+
| 16 | `plugin_manager` 的 `target` 是包名/entry id | 不算写目标(允许) |
|
|
121
|
+
| 17 | `workflow` 的 `args.files`(嵌套) | 不算写目标(允许) |
|
|
122
|
+
| 18 | `read_image`(描述含"不要 install/create") | 只读,跳过 |
|
|
123
|
+
| 19 | 本插件自己的 `task_tmpdir`/`longterm_approve`/`tmp_cleanup` | 永远放行 |
|
|
124
|
+
| 20 | `echo hi >> …`、`2>> …` | 拒绝(`>>` 正确解析) |
|
|
125
|
+
| 21 | `> NUL`、`> $null`、`Write-Host "1 > 0"` | 放行(伪路径/引号内文本) |
|
|
126
|
+
| 22 | `curl https://…`、`git clone https://…` | 放行(URL 不是盘符路径) |
|
|
127
|
+
| 23 | 重定向到**已存在**的长期文件 | 仍拒绝(覆盖属长期写入) |
|
|
128
|
+
| 24 | 工作区外 `Desktop/_tmp/x.md` | 拒绝(`_tmp` 段只在工作区内算临时) |
|
|
129
|
+
| 25 | `python`:`open('sub/x.md','w')`(相对) | 拒绝 |
|
|
130
|
+
| 26 | `res.write('ok')` + `'/api/v1/items'` | 放行(不再误伤流写入) |
|
|
131
|
+
| 27 | `guardOutsideWorkspace: warn` 下 shell/code | 放行(只记日志) |
|
|
132
|
+
| 28 | 子目录 cwd(`skipInside`) | 工作区内放宽、工作区外仍拒绝 |
|
|
133
|
+
|
|
134
|
+
`test/integration.test.mjs`(14 条)用 stub Host 上下文真正跑注册进 `ctx.tools.guard` 的回调:`write`/`publish`/`present`/`python`/未知工具/`pwsh`、`longterm_approve` 登记后解锁、拒绝根目录与 `_tmp`、审查回归(审批工具不被自锁、标准工具不误伤、子目录 cwd 仍拦工作区外、`>>` 覆盖已存在文件、不存在文件路径登记其目录)。另可跑 `node test/live-matrix.mjs`(需要 `test/live-tools.json`)把当前 profile 的全部 live 工具灌进 guard 做误伤矩阵。
|
|
135
|
+
|
|
136
|
+
## 自动清理规则(安全边界)
|
|
137
|
+
|
|
138
|
+
- 判定依据是「会话是否还存在」:先看活跃会话(`ctx.sessions`),再看已持久化会话(`sessionPersistence.list()`,取不到时回退扫描 `~/.dsh/sessions`)。
|
|
139
|
+
- 会话还在 → 目录保留;会话已删除 → 首次扫描标记孤儿(`orphanedAt`),满 `orphanCleanupDays` 天后下一次扫描删除。
|
|
140
|
+
- **只处理带本插件标记的目录**(`.dsh-task.json` 且含 sessionId);手工放进 `_tmp` 的其他目录不碰。
|
|
141
|
+
- 启动后约 60 秒跑第一次,之后按 `cleanupIntervalHours` 周期跑;`orphanCleanupDays: 0` 关闭清理。
|
|
142
|
+
- 删除是**整目录递归删除**,不备份;想先观察就把 `cleanupDryRun: true` 开着跑一轮。
|
|
143
|
+
|
|
144
|
+
## 附件回收规则(v0.6)
|
|
145
|
+
|
|
146
|
+
Host 的附件仓库(`~/.dsh/attachments`)按内容 hash 存储、**自身没有任何回收机制**:删掉会话只删日志,图片会永远留在磁盘上。本插件把附件也接进同一条 7 天清理链路:
|
|
147
|
+
|
|
148
|
+
1. 每轮清理时,通过 `sessionPersistence` 读取**每个已存会话**的事件,收集 `attachmentId`(`sha256:<hash>`),写进台账 `~/.dsh/data/session-tmpdir-attachments.json`;
|
|
149
|
+
2. 台账按 `revision` 缓存——会话没变就不重读,稳态开销几乎为零;
|
|
150
|
+
3. 会话消失 → 台账记 `orphanedAt`;满 `attachmentCleanupDays` 天后,删除**只被该会话引用**的 blob;
|
|
151
|
+
4. 任何时候只要还有别的存活会话引用同一个 hash,就跳过(同一张图被多个会话用过的安全阀);
|
|
152
|
+
5. `attachmentSweepOrphans` 开启时,额外清扫「无任何会话引用 + 文件本身够旧」的历史孤儿(覆盖本功能上线前就残留的那批);
|
|
153
|
+
6. 最近 1 小时内写入的 blob 一律不碰;每次删除追加到 `~/.dsh/data/session-tmpdir-attachments-gc.jsonl`(hash / 大小 / 时间 / 原因),可审计。
|
|
154
|
+
|
|
155
|
+
`tmp_cleanup` 的返回里多一个 `attachments` 字段(删除数、释放 MB、待回收会话数、跳过数);`dryRun: true` 只统计不动手。
|
|
156
|
+
|
|
157
|
+
## 开发
|
|
158
|
+
|
|
159
|
+
```powershell
|
|
160
|
+
node --check index.js
|
|
161
|
+
node --test "test/*.test.mjs" # 38 条纯函数用例 + 14 条集成用例(stub Host 上下文)
|
|
162
|
+
node test/live-matrix.mjs # 可选:本机 live 工具误伤矩阵(需 test/live-tools.json)
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
> POSIX 路径语义(`/storage/...`、大小写敏感)在 Windows 上只能验证解析器分支;真机行为请以 HarmonyOS Host 上的实际调用为准。
|
|
166
|
+
|
|
167
|
+
v0.5 变更(2026-11-07):新增长期落点审批(`longterm_approve` + guard v2),覆盖 pwsh/bash 命令;修复 v1 只拦"临时命名文件"导致根目录被会话自建文件夹的问题。
|
|
168
|
+
|
|
169
|
+
v0.5.2 变更(2026-11-12):长期落点选择题的选项顺序调整——A 改为"不长期保存,放 `_tmp/<会话标题>/`(临时)",C 改为"长期保存到本次任务指定的目录";B(新建归档目录)不变。落盘规则本身无变化。
|
|
170
|
+
|
|
171
|
+
v0.5.3 变更(2026-11-12):B/C 选项文案按实际使用重写,消除语义重叠——B 改为"工作区根目录保存"(长期保存到会话工作区根目录下,一般新建一个目录,如 `归档/<主题>/`);C 改为"存到指定位置(写明路径)",并明确选 C 但未给路径时模型必须先向用户确认,不得自行猜路径。规则与 guard 未改。
|
|
172
|
+
|
|
173
|
+
v0.5.4 变更(2026-11-12):按实际弹窗效果精简选项——删掉 C("存到指定位置"与输入框重复,用户改成在自由输入框写路径即可,模型收到非 A/B 答案时按指定位置处理,路径不清先追问);B 去掉括号说明,只留"工作区根目录保存"。规则与 guard 未改。
|
|
174
|
+
|
|
175
|
+
v0.5.5 变更(2026-11-12):选项标签统一写短(A 只写"不长期保存",路径等说明移到选项 `description` 小字),并要求不许把路径细节塞进标签;避免长标签把 GUI 里的描述小字顶到下一行造成排版不一致。规则与 guard 未改。
|
|
176
|
+
|
|
177
|
+
v0.5.6 变更(2026-11-12):选 B(工作区根目录保存)时不再要用户确认目录名——模型自行起一个清楚的目录名、`longterm_approve` 登记后直接写,跟 DSH 平时自己命名落盘一样;B 的小字改为"目录名自动起"。规则与 guard 未改。
|
|
178
|
+
|
|
179
|
+
v0.5.7 变更(2026-11-12):微调选项小字——A 的说明改为"随会话删除后 N 天清理"(N 取 `orphanCleanupDays`,默认 7,不再写死"随会话删除清理");B 的说明删掉"目录名自动起"字样,只留"长期保存到会话工作区根目录下"(自动起名行为本身不变)。规则与 guard 未改。
|
|
180
|
+
|
|
181
|
+
v0.6.0 变更(2026-11-13):新增**附件回收**——7 天清理会话目录时,一并回收该会话的附件 blob(台账 + 引用二次校验 + 扫描历史孤儿 + 审计日志),解决 `~/.dsh/attachments` 只增不减的问题。通过 `sessionPersistence` 读事件,不依赖日志格式、不自带 zstd 解码;`tmp_cleanup` 增加 `attachments` 参数与 `attachments` 输出字段。临时目录规则与 guard 未改。
|
|
182
|
+
|
|
183
|
+
v0.7.0 变更(2026-11-15):按 HarmonyOS DSHM 真机反馈(桌面文件「临时目录插件-长期文件规则绕过分析.md」)补齐写入通道覆盖——原来 guard 只认硬编码的 `write`/`edit`/`pwsh`/`bash` 工具名、只认 `file_path`/`path` 参数、只判工作区内部、shell 只认 Windows 盘符路径,导致 `publish` 交付复制、`python` 写盘等通道静默绕过。本次改动:
|
|
184
|
+
|
|
185
|
+
1. **按能力识别工具**(`toolWritePlan`):写工具 / shell / 代码执行 / 交付(`publish`;`present` 只展示)/ 未知写类工具五类通道,未知工具从 schema 的路径参数识别,新增工具不再漏;
|
|
186
|
+
2. **工作区外也判**:除 DSH 主目录、缓存、系统临时目录和已登记目录外,工作区外写入一律视为长期落点(`guardOutsideWorkspace`,可 `warn`/`off`);
|
|
187
|
+
3. **`publish` 纳入判定**:复制目标(`target`/`destination`/`to`/`output`)未登记即拒绝,`source` 不拦;`present` 只展示不拦;
|
|
188
|
+
4. **`python`/`node` 静态扫描**:写信号 + 同语句路径字面量配对判定,动态拼接路径声明为已知边界;
|
|
189
|
+
5. **shell 平台适配**:HarmonyOS/POSIX 下解析 `/` 开头绝对路径与 `cp`/`mv`/`sed`/`tee` 等命令,`>` 重定向单独视为创建;
|
|
190
|
+
6. **`longterm_approve` 支持工作区外目录**(鸿蒙 `Download/<包名>/` 等),拒绝磁盘根目录/主目录/层级过浅目录;
|
|
191
|
+
7. 提示文本同步说明覆盖通道与 fail-open 边界;新增 38 条纯函数 + 14 条集成回归测试。
|
|
192
|
+
|
|
193
|
+
**独立审查后加固(同发 0.7.0)**:`longterm_approve`/`task_tmpdir`/`tmp_cleanup` 永远不被自己的 guard 判定(否则审批通道自锁);未知工具通道只看顶层参数,跳过 enum、选择器、包名和 URL(否则 `schedule_create`/`bsk_interact`/`plugin_manager` 必被误拒);只读工具名白名单(`read_image` 等);`>>` 重定向正确解析、`NUL`/`$null`/引号内文本不误判、Windows 路径扫描先剥 URL;工作区外 `_tmp` 段不再算临时区;工作区外判定不再随 cwd 关闭;重定向到已存在长期文件仍拒绝;`longterm_approve` 传入不存在的文件路径时登记其目录、并拒绝登记工作区根本身;`toolWritePlan` 判定改用实际参数值,POSIX 大小写/分隔符语义按平台区分。审查时用本机 59 个 live 工具矩阵验证:53 个工具零误伤,仅真实写类工具(`write`/`edit`/`pwsh`)和参数值确实是路径的兜底工具被判定。
|
|
194
|
+
|
|
195
|
+
v0.8.0 变更(2026-11-16):**写入即认领**(claim-on-write)。此前只有 `task_tmpdir` 会写 `.dsh-task.json`;模型若用普通 `write` 或 `pwsh New-Item` 在临时根下自起目录名,目录没有标记,按“手工目录不碰”原则永远不会被清理(本机实测积累 8 个、77 MB)。现在 guard 在**放行后**把写入目标里 `<临时根>/<目录>/…` 的直接子目录补写标记(含当前会话 id 与标题),覆盖 `write`/`edit`、`publish` 复制目标、`python`/`node` 代码里的静态路径、shell 命令的绝对路径与相对 `_tmp/…` 引用、未知写类工具的路径参数;目录不存在时先创建(写入本来就会创建,提前一步无副作用)。**放行/拒绝判定、清理宽限期与既有 marker 格式均未改变**;无标记目录一旦被认领,就按原规则在会话删除 7 天后清理。新增 `tmpClaimDirsForTargets` / `relativeTmpTargets` / `claimTmpDirsSync` 三个导出函数,便于单元测试。
|
|
196
|
+
|
|
197
|
+
v0.9.0 变更(2026-11-16):**中间产物/长期产物划分(方案 3)+ 白名单面板**。
|
|
198
|
+
|
|
199
|
+
1. **新建才问、改写放行**:`_tmp` 之外**新建文件**必须先经用户同意;目标**已存在**(普通文件)视为改写,直接放行(新配置 `allowOverwrite`,默认 `true`,设为 `false` 可要求改写也审批)。指令重定向、`Set-Content` 覆盖已有文件、`office_recalculate` 原地改写都按这条走。
|
|
200
|
+
2. **审批粒度改为文件级**:`longterm_approve` 默认 `mode: 'file'`(登记精确文件路径);用户明确要"整个目录都行"时才 `mode: 'dir'`。旧目录登记语义保留。
|
|
201
|
+
3. **未知工具统一规则**:去掉"工作区子目录放行"的例外,未知写类工具与 `write`/`edit` 判同一套(新建未审批 → 拒绝;已存在 → 放行)。
|
|
202
|
+
4. **程序级漏网补齐**:`CREATE_VERB_PATTERN` 之外新增 `WRITE_PROGRAM_PATTERN`——`ffmpeg`、`pandoc`、`soffice`/`libreoffice`、`wkhtmltopdf`、`magick`、`convert`、`gs`、`Export-Csv`/`Export-Clixml`/`Export-Pdf`、`[IO.File]::WriteAllText` 系列、`Start-Process` 等都会触发路径扫描,不再整条命令绕过。
|
|
203
|
+
5. **白名单持久化 + 面板**:新增 `<DSH_HOME>/data/session-tmpdir-approvals.json`(含 sessionId / path / kind / 时间),同一会话重启后继续有效;会话删除的条目由清理任务回收。左侧菜单新增「临时目录」入口,面板表格展示白名单(路径 / 文件或目录 / 同意时间 / 来源会话)并可「移除」;移除后该文件下次新建会重新走审批。
|
|
204
|
+
6. 宿主接口:`GET /__dsh-session-tmpdir/state`、`POST /__dsh-session-tmpdir/revoke`;新增 `client.js`(左侧菜单 + 面板)与 `dsh.client` 客户端配置。
|
|
205
|
+
|
|
206
|
+
**仍拦不到(fail-open)**:变量/动态拼接路径、脚本内部写盘、GUI/外部程序产物——这部分任何工具层插件都无法保证,只能靠对话规则或后续"工作区巡查"兜底。
|
|
207
|
+
|
|
208
|
+
v0.9.1 变更(2026-11-16):左侧菜单「临时目录」图标从彩色 emoji 换成**单色线框文件夹 SVG**(`currentColor` 描边、24 viewBox、无填充),与「云端同步」「隐私模式」等菜单的图标风格一致;尺寸跟随 `sidebar.panellist` 传入的 `size`(默认 18)。功能无变化。
|
|
209
|
+
|
|
210
|
+
v0.9.2 变更(2026-11-16):图标再改为**沙漏**(单色线框),因为文件夹线框和「AI视频」「会话相关」等收纳夹图标撞形;沙漏表达“临时/到期清理”的语义,18px 下两笔可辨,与左栏现有图标形状都不重复。功能无变化。
|
|
211
|
+
|
|
212
|
+
v0.9.3 变更(2026-11-16):面板体验与条目回收。
|
|
213
|
+
|
|
214
|
+
1. **左侧菜单改为打开右侧边栏标签页**(与「常驻钥则」一致):点击「临时目录」行时先回到会话、再打开原生右侧标签页;右侧栏不可用时自动回退全页面板。
|
|
215
|
+
2. **5 秒自动刷新**:仅面板页面可见时轮询 `GET /state`(静默刷新、不闪 loading);页面隐藏时暂停,切回来立即刷新一次;保留「刷新」按钮。
|
|
216
|
+
3. **目标不存在的条目自动回收**:`GET /state` 时检查每条路径,文件/目录已删除 → 条目自动删除并落盘。保护:刚批准但还没写入的条目(从未见过存在且批准不到 30 分钟)不会被误删;一旦见过目标存在,之后消失即删。面板同时显示「目标不存在」状态(回收前的短暂窗口)。
|
|
217
|
+
|
|
218
|
+
v0.9.4 变更(2026-11-16):**命令守卫减少误拦**(不影响正常任务)。
|
|
219
|
+
|
|
220
|
+
1. **按语句分段判定**:`pwsh`/`bash` 命令先按 `;`、`&&`、`||`、`|`、换行拆段,只检查"这一段里真的有写动作"的绝对路径。此前整条命令共用一个判定:同一条命令里既有写动作、又有只读检查(例如 `Invoke-RestMethod …; Test-Path C:\不存在的路径`),只读路径会被误当成新建产物而拦截。
|
|
221
|
+
2. **下载类命令只在带输出参数时才算写**:`Invoke-WebRequest`/`Invoke-RestMethod` 需带 `-OutFile`/`-OutFileList`,`curl` 需带 `-o`/`--output`/`-O`,`wget` 需带 `-O`/`--output-document`;不带输出参数时按只读处理,不再扫描路径。
|
|
222
|
+
3. 行为回归:`ffmpeg`/`pandoc`/`Export-*`/`[IO.File]::WriteAllText` 等程序级写盘、`New-Item`/`Set-Content`/重定向/管道写文件仍照旧判定;已存在文件仍按"改写放行"。
|
|
223
|
+
|
|
224
|
+
v0.9.5 变更(2026-11-16):**复制/移动类命令不再判源路径**。`Copy-Item`、`Move-Item`、`cp`、`mv`、`rsync`、`scp`、`robocopy`、`xcopy`、`Expand-Archive`、`Compress-Archive` 的源参数是"读",只有目标才是写落点:有 `-Destination`/`-DestinationPath`/`-Dest`/`-Target` 时只判该目标,否则位置参数形式下判**最后一个路径**(目标),其余按源跳过。这样"源文件缺失 + 检查/写入已存在目标"的命令不会再被误拦;目标新建未审批仍照常拦截。
|
|
225
|
+
|
|
226
|
+
v0.9.6 变更(2026-11-16):**`Start-Process` 不再默认算写命令**。它只是启动外部程序,参数里的路径通常是程序要打开的文件(读)。现在只有带 `-RedirectStandardOutput` / `-RedirectStandardError`(真正写文件)时才参与路径判定;`Start-Process notepad C:\缺失.txt` 这类不再误拦。
|
|
227
|
+
|
|
228
|
+
v0.9.7 变更(2026-11-16):白名单曾改为按机器名分文件(`session-tmpdir-approvals-<机器名>.json`),意图是避免跨机同步互相覆盖。**该前提判断有误**,见 0.9.8。
|
|
229
|
+
|
|
230
|
+
v0.9.8 变更(2026-11-16):**白名单恢复通用文件名**。核对云端同步源码(`sync.js`:`data/session-tmpdir-*` 直接跳过)后确认:白名单文件本来就**不参与云端同步**,因此不会跨机覆盖、也不会每台机器多出别的机器的文件。改回固定路径 `<DSH_HOME>/data/session-tmpdir-approvals.json`(每台机器只有这一个文件);0.9.7 的按机器名文件只作为**读取回退**,写入统一回到通用文件。白名单语义:本机有效、同机重启后保留、跨机不共享(本来也不同步)。
|
|
231
|
+
|
|
232
|
+
v0.9.9 变更(2026-11-16):**白名单改为跨机同步(用户要求)**。
|
|
233
|
+
|
|
234
|
+
1. **存储位置**:`<DSH_HOME>/data/tmpdir-guard/approvals.json`。该路径**不在**云端同步的排除名单里(排除的是 `data/session-tmpdir-*`),所以会随 `~/.dsh` 一起同步到其他机器。旧的两个本机文件(通用名 / 0.9.7 按机器名)只作为**读取迁移来源**。
|
|
235
|
+
2. **条目带来源机器** `originMachine`;每台机器只自动回收**自己创建**的条目:
|
|
236
|
+
- 本机条目:目标文件曾存在、后来消失 → 回收;刚批准还没写入的(<30 分钟)保留;
|
|
237
|
+
- 其他机器的条目:本机看不到路径是正常的,**不会误删**;只有「从未被任何机器见过 + 超过 7 天」才回收。
|
|
238
|
+
3. **合并与墓碑**:保存时先读文件再合并(按 `id` 取较新 `approvedAt`),删除写墓碑(30 天过期),所以:
|
|
239
|
+
- 一台机新增的批准会同步到其他机器(面板可见,带机器标记);
|
|
240
|
+
- 一台机删除的批准不会被另一台机同步“复活”;
|
|
241
|
+
- 云端落在“加载之后、保存之前”也不会覆盖掉另一台机的条目。
|
|
242
|
+
4. 面板显示每条来源机器;移除任何机器的条目都写墓碑,其他机器同步后会一起消失。
|
|
243
|
+
|
|
244
|
+
v0.9.10 变更(2026-11-16):**面板默认只显示当前机器的白名单**。跨机同步来的其他机器条目仍保留在白名单文件里(继续参与合并、墓碑与回收判定),但界面默认只展示当前机器条目,避免出现用不上的别机路径;条目上的机器标记随之去掉。顶部小字改为带标签的说明:`改写放行`(已存在文件是否免审批)、`临时根`(`_tmp/`)、`白名单文件`(同步文件的绝对路径)。
|
|
245
|
+
|
|
246
|
+
v0.9.11 变更(2026-11-16):**修复 0.9.10 客户端语法错误**(`client.js` 少一个括号,面板无法加载)。面板渲染重写为更简单的数组结构(同样的功能:右侧边栏标签页、5 秒自动刷新、当前机器白名单展示/移除、目标不存在标记)。
|
|
247
|
+
|
|
248
|
+
v0.9.12 变更(2026-11-16):文案澄清——面板**默认只显示当前机器的白名单**(不是“机器隔离”)。界面过滤只是显示策略;白名单判定仍按绝对路径,其他机器同步来的条目如果路径在本机存在,仍然会生效。
|
|
249
|
+
|
|
250
|
+
v0.10.0 变更(2026-11-16):**白名单条目的路径可移植 + 全机队统一展示**(“N 台机器像一个 DSH”)。
|
|
251
|
+
|
|
252
|
+
1. **可移植路径**:home 下的目标在写入时存成 `~/...`(例如 `~/Desktop/x.exe`);读取/匹配/回收时按**当前机器**的 home 展开。工作区等不在 home 下的路径仍存绝对路径(各机一致即可共享)。
|
|
253
|
+
2. **一次批准、多机生效**:A 机批准 `~/Desktop/x.exe` → 同步后 B 机展开成 `C:\Users\<B用户名>\Desktop\x.exe`,同样免审批(前提是该逻辑位置在 B 机也有意义)。
|
|
254
|
+
3. **界面去掉机器过滤**:面板显示整份共享白名单(不是“本机专属”);**本机没有的路径**标记「本机无此路径」(可能存在于其他机器),不会因此自动删除;可移植路径额外标「可移植」。
|
|
255
|
+
4. 旧条目(绝对路径、home 下)在加载时自动归一为 `~/...` 并落盘;墓碑/合并/按机器回收逻辑不变。
|
|
256
|
+
5. 仍无法自动统一:盘符/工作区路径不同、机器独有路径——这类按各自绝对路径判定。
|
|
257
|
+
|
|
258
|
+
v0.10.1 / v0.10.2 变更(2026-11-16):**解释器命令段落不再误判路径**。`node`/`python`/`perl`/`ruby` 出现在命令里时,以前会把整段命令的绝对路径都当成写目标(例如 `node -e "…打印一个不存在的示例路径…"` 被误拦)。现在:
|
|
259
|
+
- 只调用解释器、且同一段里没有重定向/其它写动词/写程序/下载写入时 → 改用代码静态扫描判定(只认“写文件语句 + 附近路径字面量”),字符串里的示例路径不再误伤;
|
|
260
|
+
- `node -e "…writeFileSync('D:/新文件'…)"`、`python -c "open(…,'w')"` 等真实写盘仍照常拦截;写 `_tmp` 放行。
|
|
261
|
+
- 0.10.2 修正了 `$node` 变量形式(前一个字符是 `$`)的识别盲区。
|
|
262
|
+
|
|
263
|
+
v0.10.1 已发布的包存在该盲区,请使用 **0.10.2**。
|
|
264
|
+
|
|
265
|
+
v0.10.3 变更(2026-11-16):
|
|
266
|
+
|
|
267
|
+
1. **重复条目去重**:同「会话 + 类型(文件/目录)+ 展开后的目标路径」只保留一条(取较新的 `approvedAt`,`lastSeenAt` 取最大)。在加载、合并、保存三处都会去重,解决同一路径在多台机器各自批准后出现多条的情况。
|
|
268
|
+
2. **墓碑 TTL 30 天 → 180 天**:降低“某台机器离线较久、回来同步时找不到墓碑导致已删条目复活”的概率(180 天内同步过就不会复活;超过仍是“重新问一次审批”,不会误放行)。
|
|
269
|
+
3. 修复:0.10.0 起条目存的是可移植路径,但 `longterm_approve` 的重复检查仍在用“存储路径 vs 绝对路径”比较,永远不相等 → 同一个路径重复批准会不断追加。改为展开后再比较。
|
|
270
|
+
|
|
271
|
+
## v0.10.5 变更(2026-11-17):注入瘦身
|
|
272
|
+
|
|
273
|
+
- 每步注入的固定说明(约 3,700 字符)改为可配置 `promptMode`,默认 `compact`(约 400 字符中文要点:`_tmp/<会话标题>/`、先调 `task_tmpdir`、长期文件先问、被 guard 拒绝就换 task_tmpdir、白名单面板)。
|
|
274
|
+
- `full` 恢复原完整说明(允许清单、白名单跨机同步细节等);`off` 完全不注入。
|
|
275
|
+
- guard 逻辑、审批流程、清理规则全部不变——`compact`/`off` 下越界写入仍会被拒绝,错误信息本身会引导改用 `task_tmpdir`。
|