dsh-aftermath 0.0.0-stage → 0.6.4
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/GUIDE.md +277 -0
- package/LICENSE +21 -0
- package/README.md +220 -2
- package/assets/icon-128.png +0 -0
- package/assets/icon-256.png +0 -0
- package/assets/icon-512.png +0 -0
- package/assets/icon-96.png +0 -0
- package/assets/icon-e-dark.html +26 -0
- package/assets/icon-e-light.html +26 -0
- package/assets/icon-light-512.png +0 -0
- package/assets/icon-light-96.png +0 -0
- package/cordis.patch.yml +3 -0
- package/lib/attribution.js +641 -0
- package/lib/client.js +894 -0
- package/lib/command-registration.js +21 -0
- package/lib/commands.js +379 -0
- package/lib/config.js +237 -0
- package/lib/diff.js +231 -0
- package/lib/index.js +603 -0
- package/lib/panel.js +126 -0
- package/lib/report.js +428 -0
- package/lib/scan.js +186 -0
- package/lib/schema.js +196 -0
- package/lib/store.js +188 -0
- package/lib/symptoms.js +148 -0
- package/lib/version.js +22 -0
- package/package.json +72 -4
package/GUIDE.md
ADDED
|
@@ -0,0 +1,277 @@
|
|
|
1
|
+
# 新手使用指南(照着做就行)
|
|
2
|
+
|
|
3
|
+
这份指南假设你**没看过后台日志、也不打算学**。只要会打字就能用。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## 0. 它到底干什么
|
|
8
|
+
|
|
9
|
+
一句话:**它帮你在事后回答“我的文件是怎么变成现在这样的”。**
|
|
10
|
+
|
|
11
|
+
场景:桌面图标突然全变白、某个文件找不到了、下载文件夹少了东西——你看日志看不出名堂,
|
|
12
|
+
因为 AI 干活的记录是「我执行了 rm 命令」这种,不是「桌面的 A.lnk 在 12:05 被删了」。
|
|
13
|
+
|
|
14
|
+
这个插件在每一轮对话开始和结束时,各给指定目录拍一张“名单”(只有文件名、大小、修改时间),
|
|
15
|
+
比一比就知道这一轮谁被新建、谁被删除、谁被改了,然后尽量指出是哪一次操作干的。
|
|
16
|
+
|
|
17
|
+
它**不读你的文件内容**,也**不会自己动手恢复任何东西**。
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## 1. 装上(只需一次)
|
|
22
|
+
|
|
23
|
+
1. 打开 DSH → 左侧 **Plugins**(插件)
|
|
24
|
+
2. 右上 **添加插件 / Add plugin** → 选 **本地目录**
|
|
25
|
+
3. 选到 `D:\dsh-workspace\aftermath`
|
|
26
|
+
4. 装好后**重启一次 DSH**
|
|
27
|
+
5. 回到 Plugins → 点开 **dsh-aftermath** → 能看到一张「文件变更记录」卡片,说明装好了
|
|
28
|
+
|
|
29
|
+
同一个页面上方的标签栏里还会多出一个 **「变更记录」**——以后查东西点它就行。
|
|
30
|
+
|
|
31
|
+
卡片里默认已经盯着三个地方,不用你填:
|
|
32
|
+
|
|
33
|
+
- `desktop` → `C:\Users\你\Desktop`
|
|
34
|
+
- `downloads` → `C:\Users\你\Downloads`
|
|
35
|
+
- `documents` → `C:\Users\你\Documents`
|
|
36
|
+
|
|
37
|
+
**当前对话的工作目录也会自动算进来**(你在 `D:\项目` 里干活,它就顺带盯上那个目录)。
|
|
38
|
+
|
|
39
|
+
不确定盯上了哪些?在对话里打:
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
/aftermath roots
|
|
43
|
+
/aftermath roots --suggest
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
第二条会列出常用目录里哪些已经盯上(`[已加]`)、哪些还没(`[未加]`),末尾还给一段可以直接粘进配置的 yml。
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 2. 第一次用:什么都不用做
|
|
51
|
+
|
|
52
|
+
它装好就开始记了。你照常用 AI 干活,它自己在每一轮结束时记账。
|
|
53
|
+
|
|
54
|
+
想确认它在记,要么等一轮对话结束,要么直接问:
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
/aftermath status
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
看到「今天已记录:N 轮」就说明在跑。
|
|
61
|
+
|
|
62
|
+
> 如果显示「今天已记录:0 轮」,八成是这一轮还没结束。**一轮 = 你发一句话到 AI 答完**。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 3. 出事了:三步走
|
|
67
|
+
|
|
68
|
+
### 第 0 步(可选,最省事):去 Plugins 页直接看
|
|
69
|
+
|
|
70
|
+
Plugins 页面**上方的标签栏**里点「变更记录」(在「已安装」旁边):
|
|
71
|
+
|
|
72
|
+
- 一行一轮:`16:24 #50 新建 1 · 修改 4`
|
|
73
|
+
- 点开一行,逐条列出删了/改了哪个文件、归因是「确定 / 很可能 / 时间窗内」
|
|
74
|
+
- 黄字那一行表示「这一轮观测目录内没变化,但执行过写操作」——东西可能改在别处
|
|
75
|
+
- 这里不需要开对话,新窗口也能看;右上角「刷新」重新读一遍
|
|
76
|
+
|
|
77
|
+
### 第 1 步:想看更细,再打命令
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
/aftermath report --since 2h
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 第 2 步:读结论(不用抠细节)
|
|
84
|
+
|
|
85
|
+
报告里会有一段 `## 你看到的现象可能对应`,直接告诉你是哪一类事故、下一步查什么。
|
|
86
|
+
比如图标变白时你会看到:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
### 桌面的文件 / 文件夹不见了
|
|
90
|
+
- 先看回收站:Explorer 地址栏输入 shell:RecycleBinFolder
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### 第 3 步:想知道具体是哪个文件、哪次操作
|
|
94
|
+
|
|
95
|
+
看中间的表格:
|
|
96
|
+
|
|
97
|
+
| 变更 | 条目 | 大小 | 时间 | 归因 | 依据 |
|
|
98
|
+
| --- | --- | --- | --- | --- | --- |
|
|
99
|
+
| 删除 | 微信.lnk | 1.2 KB | 14:32:11 | ✔确定 | bash · Remove-Item |
|
|
100
|
+
| 修改 | 报告.docx | 42 KB | 14:33:02 | ◐很可能 | bash · Copy-Item (basename) |
|
|
101
|
+
|
|
102
|
+
**归因**这一列是重点,见下一节。
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 4. 四个符号怎么读(最重要的一节)
|
|
107
|
+
|
|
108
|
+
| 符号 | 说法 | 人话 |
|
|
109
|
+
| --- | --- | --- |
|
|
110
|
+
| ✔ 确定 | 铁证 | 那次操作的命令里**明明白白写着这个文件的路径**,抵赖不掉 |
|
|
111
|
+
| ◐ 很可能 | 高度怀疑 | 那次操作在处理这个**目录**,或者这一轮只有它提到了这个文件名 |
|
|
112
|
+
| ○ 时间窗内 | 只能说“那会儿” | 只看得出改动发生在**某次操作进行的那几秒**里,或这一轮里的某个时刻 |
|
|
113
|
+
| ? 无法归因 | 查不出 | 那一轮没有任何“可能写文件”的操作,或者根本没记录到调用 |
|
|
114
|
+
|
|
115
|
+
两条必须知道的规矩:
|
|
116
|
+
|
|
117
|
+
1. **◐ 和 ○ 都是推测,不是定论。** 报告不会把它们说成“确定”。
|
|
118
|
+
2. **同一回合内建了又删,不会留记录。** 它记的是「这一轮结束时,跟这一轮开始时比,少了什么、多了什么」。
|
|
119
|
+
所以“建了个测试文件马上删掉”这种,查不到——这不是 bug。
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 5. 命令速查(只有 6 条)
|
|
124
|
+
|
|
125
|
+
| 你想干嘛 | 打这个 |
|
|
126
|
+
| --- | --- |
|
|
127
|
+
| 查最近 1 轮 | `/aftermath report` |
|
|
128
|
+
| 查最近 5 轮 | `/aftermath report --last 5` |
|
|
129
|
+
| 查最近两小时 | `/aftermath report --since 2h` |
|
|
130
|
+
| 只查桌面 | `/aftermath report --since 1d --root desktop` |
|
|
131
|
+
| 存一份报告文件 | `/aftermath report --since 2h --save` |
|
|
132
|
+
| 马上扫一次(不等到回合结束) | `/aftermath scan` |
|
|
133
|
+
| 看它在盯哪些目录 | `/aftermath roots` |
|
|
134
|
+
| 看它在不在跑、配置对不对 | `/aftermath status` |
|
|
135
|
+
| 设置页出问题时自检 | `/aftermath doctor` |
|
|
136
|
+
|
|
137
|
+
`--since` 后面可以写 `30m`(30 分钟)、`2h`(2 小时)、`3d`(3 天)。
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 6. 完整演练(5 分钟,建议真的做一遍)
|
|
142
|
+
|
|
143
|
+
**第 1 步**:让 AI 在桌面建个文件,并且**别删**:
|
|
144
|
+
|
|
145
|
+
> 帮我在桌面创建一个空文件,名字叫 test-aftermath.txt,建好就停。
|
|
146
|
+
|
|
147
|
+
**第 2 步**:等这一轮答完,然后:
|
|
148
|
+
|
|
149
|
+
```
|
|
150
|
+
/aftermath report --last 1
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
应该看到:
|
|
154
|
+
|
|
155
|
+
```
|
|
156
|
+
| 新建 | test-aftermath.txt | 0 B | 14:40:02 | ✔确定 | bash · redirect (exact-path) |
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
**第 3 步**:再让 AI 删掉它:
|
|
160
|
+
|
|
161
|
+
> 把桌面那个 test-aftermath.txt 删了。
|
|
162
|
+
|
|
163
|
+
**第 4 步**:新一轮答完后再查:
|
|
164
|
+
|
|
165
|
+
```
|
|
166
|
+
/aftermath report --last 1
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
应该看到一条「删除」。删除没法从 mtime 推时间,所以多半是 `◐很可能` 或 `○时间窗内`,
|
|
170
|
+
这是设计如此,不是出错。
|
|
171
|
+
|
|
172
|
+
**第 5 步**:清场——上面两个动作已经把文件建了又删,桌面回到原样。
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## 7. 设置怎么改(Plugins 页那张卡片)
|
|
177
|
+
|
|
178
|
+
| 情况 | 改哪个 |
|
|
179
|
+
| --- | --- |
|
|
180
|
+
| 想连项目文件夹一起盯 | 卡片里 **要盯着哪些地方?** 加一行绝对路径,例如 `D:\项目` |
|
|
181
|
+
| 桌面东西太多、报告太吵 | 展开「高级设置」→ **往子文件夹里看几层** 改成 `1` |
|
|
182
|
+
| 只想留最近三天的记录 | 展开「高级设置」→ **记录留几天** 改 `3` |
|
|
183
|
+
| 不想让别人看到你的用户名 | **路径打码** 开着(默认开),报告里 `C:\Users\你` → `~` |
|
|
184
|
+
| 暂时不想记了 | **总开关** 关掉(立刻生效,旧记录还在) |
|
|
185
|
+
|
|
186
|
+
改完点 **保存**。保存失败会告诉你哪个字段不行(比如深度超过 6)。
|
|
187
|
+
|
|
188
|
+
总开关是**立刻生效**的,不用点保存;其余字段要点保存。
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
## 8. 常见问题
|
|
193
|
+
|
|
194
|
+
**Q:报告说「这段时间没有记录到文件变更」,但我明明改了文件?**
|
|
195
|
+
A:三种可能——① 那一轮确实啥都没留下(建了又删);② 改的文件不在观测目录里(看 `/aftermath roots` 和下一节);
|
|
196
|
+
③ 那一轮扫描时目录读不到(报告里会写「跳过的根」)。
|
|
197
|
+
|
|
198
|
+
**Q:为什么删掉的东西只能是「很可能」?**
|
|
199
|
+
A:删除这个动作本身不留修改时间,插件只能靠“那几秒里有谁在删东西”推。想提高准确度,看「依据」列里的命令原文。
|
|
200
|
+
|
|
201
|
+
**Q:能帮我恢复文件吗?**
|
|
202
|
+
A:不能,也不打算做。它只查账。恢复请用回收站(`shell:RecycleBinFolder`)或你自己的备份。
|
|
203
|
+
|
|
204
|
+
**Q:我的文件内容会被上传吗?**
|
|
205
|
+
A:不会。只记路径、大小、修改时间;报告默认还会把用户名打码。全部数据只存在本机
|
|
206
|
+
`C:\Users\你\.dsh\state\aftermath\`。
|
|
207
|
+
|
|
208
|
+
**Q:占多大空间?**
|
|
209
|
+
A:一轮一条记录、只记变更。日常用一天几十 KB,保留 7 天通常在几 MB 以内。
|
|
210
|
+
|
|
211
|
+
**Q:插件好像没在跑?**
|
|
212
|
+
A:`/aftermath status` 第一行会写「已启用 / 已停用」;`/aftermath doctor` 检查设置页是否正常。
|
|
213
|
+
|
|
214
|
+
**Q:怎么彻底删掉?**
|
|
215
|
+
A:Plugins → dsh-aftermath → 卸载;再删掉 `C:\Users\你\.dsh\state\aftermath\` 这个目录即可。
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
## 9. 东西不在观测目录里,怎么办?
|
|
220
|
+
|
|
221
|
+
插件只看你点名的目录(默认桌面 + 下载)。别的路径它没看过,所以**不会知道那里变了什么**。
|
|
222
|
+
不过它留了两条间接线索,出现在报告里:
|
|
223
|
+
|
|
224
|
+
**线索一:根内没变化,但它确实动过手**
|
|
225
|
+
|
|
226
|
+
```
|
|
227
|
+
观测范围内没有文件变更(~\Desktop)。
|
|
228
|
+
|
|
229
|
+
不过这一轮执行过 1 条写操作;观测根内没有变化,意味着改动可能落在根外。命令原文:
|
|
230
|
+
|
|
231
|
+
- `bash` printf hi > "D:/项目/note.txt"
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
历史表里也会显示成 `0(写过 1 条命令,根外?)`。也就是说,你至少能知道“这一轮不是什么都没干”。
|
|
235
|
+
|
|
236
|
+
**线索二:命令里提到过哪些根外路径**
|
|
237
|
+
|
|
238
|
+
报告里会多一节:
|
|
239
|
+
|
|
240
|
+
```
|
|
241
|
+
## 命令提到、但不在观测根内的路径
|
|
242
|
+
- `D:\项目\report-backup.md` · bash · cp
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
⚠️ 这一节只是**从命令文本里抄出来的路径**,插件没有去看这些文件的磁盘状态。
|
|
246
|
+
命令里没提到的路径,它依然一无所知。
|
|
247
|
+
|
|
248
|
+
**想真正看住某个目录**:在卡片「要盯着哪些地方?」里加一行(比如 `D:\项目`),保存后立即生效。
|
|
249
|
+
注意别加 `C:\` 或 `AppData`——那样每轮扫描要几万条,报告也没法看。
|
|
250
|
+
|
|
251
|
+
**这一轮已经过去了怎么办**:插件的记录补不回来,但系统自己有账可查:
|
|
252
|
+
|
|
253
|
+
| 想知道 | 办法 |
|
|
254
|
+
| --- | --- |
|
|
255
|
+
| 文件是删了还是移走了 | 管理员运行 `fsutil usn readjournal C: csv`(NTFS 变更日志,滚得快,越早查越好) |
|
|
256
|
+
| 某目录最近动过什么 | `Get-ChildItem 'D:\项目' -Recurse -File \| Where LastWriteTime -gt (Get-Date).AddHours(-2)`;或 Everything 按 `dm:last2hours` |
|
|
257
|
+
| 删除的能不能捞回来 | 回收站:Explorer 地址栏输入 `shell:RecycleBinFolder` |
|
|
258
|
+
| 有没有卷影副本 | 管理员运行 `vssadmin list shadows` |
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
262
|
+
## 10. 懒得记命令?直接跟 AI 说
|
|
263
|
+
|
|
264
|
+
```
|
|
265
|
+
帮我查一下桌面前两个小时的文件变化
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
AI 会自己调用插件的查询工具,把结果翻译成人话给你——你不用记那 6 条命令。
|
|
269
|
+
|
|
270
|
+
(前提是这一轮它能调到 `aftermath_history` 工具;调不到就直接用 `/aftermath report --since 2h`。)
|
|
271
|
+
|
|
272
|
+
---
|
|
273
|
+
|
|
274
|
+
## 11. 一句话总结
|
|
275
|
+
|
|
276
|
+
**装好别管它。出了事就打 `/aftermath report --since 2h`,先看结论段,再看归因列,
|
|
277
|
+
拿不准就承认「不确定」——它不是算命,是查账。**
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 2-qing
|
|
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,221 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-aftermath
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+

|
|
4
|
+
|
|
5
|
+
记录每轮对话里观测目录的文件变更:哪些被新建、删除、修改,大概是哪次工具调用改的。出问题时用它倒查。
|
|
6
|
+
|
|
7
|
+
DSH 插件。零依赖,不联网,不读文件内容。
|
|
8
|
+
|
|
9
|
+
> 不想看技术细节:直接看 [GUIDE.md](GUIDE.md),照着做就行。
|
|
10
|
+
|
|
11
|
+
## 用法
|
|
12
|
+
|
|
13
|
+
装好后自动记录,不用管。查看有三种方式:
|
|
14
|
+
|
|
15
|
+
1. Plugins 页顶部标签栏点「变更记录」:最近 8 轮,点开看逐条变更与归因。不依赖对话,新开的窗口也能看。
|
|
16
|
+
2. 跟 agent 说一句「桌面图标怎么全白了」,它会调 `aftermath_history` 查。
|
|
17
|
+
3. 自己输 `/aftermath report --last 1` 看明细。
|
|
18
|
+
|
|
19
|
+
记录存在 `$DSH_HOME/state/aftermath/`。
|
|
20
|
+
|
|
21
|
+
## 「变更记录」标签页
|
|
22
|
+
|
|
23
|
+
- 每轮一行:`16:24 #50 新建 1 · 修改 4`,点开看逐条 `✔ 新建 ~\Desktop\a.txt 确定`;
|
|
24
|
+
- 观测目录内没变化但执行过写操作的那轮,显示黄色提示「可能改在别处」;
|
|
25
|
+
- 底部单列「命令提到、但不在观测目录内的路径」;
|
|
26
|
+
- 右上角「刷新」重读,数据与 `/aftermath report` 是同一份。
|
|
27
|
+
|
|
28
|
+
数据走插件注册的只读路由 `GET /aftermath/recent`(同源、只接 GET/HEAD、`cache-control: no-store`),所以不需要会话。没用详情页卡片的原因:`plugins.bundle.config` 槽位固定渲染在插件描述与 README 之后,放不下整页列表,所以用 `plugins.tab` 做独立标签页。
|
|
29
|
+
|
|
30
|
+
## 工作方式
|
|
31
|
+
|
|
32
|
+
很多事故不是 `write`/`edit` 工具造成的,而是 agent 跑了条 `pwsh`/`bash` 命令直接改磁盘,工具调用层的 hook 看不到。所以观测放在文件系统层:
|
|
33
|
+
|
|
34
|
+
- 每轮开始和结束各对观测目录做一次快照(桌面 48 条实测约 0.3 ms),做差得到变更列表;
|
|
35
|
+
- 记下每次工具调用的起止时刻(`tool/call` 与 `tool/result` 各带一个时间);
|
|
36
|
+
- 用同一轮的调用证据给每条变更标归因,分四档:
|
|
37
|
+
|
|
38
|
+
| 档位 | 判据 |
|
|
39
|
+
| --- | --- |
|
|
40
|
+
| ✔ 确定 | 命令里出现该文件的绝对路径 |
|
|
41
|
+
| ◐ 很可能 | 命令在处理这个目录,或本轮只有它提到这个文件名 |
|
|
42
|
+
| ○ 时间窗内 | 改动 mtime 落在某次调用的起止区间内 |
|
|
43
|
+
| ? 无法归因 | 没有证据;报告附该轮命令原文,自己判断 |
|
|
44
|
+
|
|
45
|
+
「时间窗内」分两级:先比单次调用自己的区间(窄,几乎不会错配到别的调用);全不命中才退回整轮宽窗,那时只说明「这一轮里有人动过」。表格里分别写成 `○区间内` 和 `○时间窗内`,依据列写明是哪一级(`call-interval` / `turn-window`)。
|
|
46
|
+
|
|
47
|
+
观测根之外的线索:
|
|
48
|
+
|
|
49
|
+
- 根内没变化但执行过写操作时,留一条只含命令摘要的轻记录(`kind: quiet`),历史表里显示 `0(写过 N 条命令,根外?)`;
|
|
50
|
+
- 调用里出现过的绝对路径存进记录,报告单列「命令提到、但不在观测根内的路径」。不扫盘,只说命令提到过;
|
|
51
|
+
- 不想要轻记录,把 `recordQuietTurns` 设为 `false`。
|
|
52
|
+
|
|
53
|
+
判「写操作」的规则:
|
|
54
|
+
|
|
55
|
+
- 重定向落盘算写(`>` / `>>` / `2>` / `Out-File` 都认),目标路径计入证据;引号里的 `>` 是文本,不算;
|
|
56
|
+
- `/c/Users/...` 这类 Git Bash 路径翻成 `C:\Users\...` 再比对;
|
|
57
|
+
- `powershell -c "Get-Content x"` 是读、`powershell -c "Remove-Item x"` 是写:先看里面的动词,都对不上(如 `node build.js`)才保守算写;
|
|
58
|
+
- 只从命令参数和路径参数取证据,`content` / `prompt` 这类载荷文本不参与——否则某个工具的正文里碰巧写了 `Out-File` 和一条桌面路径,那个文件就会被误标成「确定」(真机记录里抓到过这种误判)。
|
|
59
|
+
|
|
60
|
+
只读命令提到路径不算证据;某个根这轮没扫全时整根跳过,不会把没扫到的报成删除。
|
|
61
|
+
|
|
62
|
+
报告示例:
|
|
63
|
+
|
|
64
|
+
```
|
|
65
|
+
第 12 轮 · 2026-11-17 20:41 · 会话 #7
|
|
66
|
+
共 4 处变更:删除 3 · 修改 1
|
|
67
|
+
归因:✔确定 2 · ◐很可能 1 · ○时间窗内 1 · ?无法归因 0
|
|
68
|
+
|
|
69
|
+
| 变更 | 条目 | 大小 | mtime | 归因 | 依据 |
|
|
70
|
+
| --- | --- | --- | --- | --- | --- |
|
|
71
|
+
| 删除 | Desktop\微信.lnk | 1.2 KB | 删除前 20:41:03 | ✔ 确定 | 命令里出现该绝对路径(bash) |
|
|
72
|
+
| 删除 | Desktop\QQ.lnk | 1.1 KB | 删除前 20:41:03 | ◐ 很可能 | 该调用在处理 Desktop\ 下的文件 |
|
|
73
|
+
| 修改 | Desktop\desktop.ini | 218 B | 20:41:04 | ○ 区间内 | 落在 bash 这次调用的起止区间内 |
|
|
74
|
+
|
|
75
|
+
## 报告健康度
|
|
76
|
+
- 快照耗时:本轮结束这次扫描 1 ms,覆盖 2 个根 / 446 个条目
|
|
77
|
+
- 归因分布:✔确定 2(50%) · ◐很可能 1(25%) · ○时间窗内 1(25%) · ?无法归因 0(0%)
|
|
78
|
+
- 时间证据:1 处 mtime 落在某次调用的起止区间内,0 处只落在整轮宽窗
|
|
79
|
+
- 调用区间:5 次调用、3 次写操作,3/3 拿到起止时刻(容差 1500 ms)
|
|
80
|
+
|
|
81
|
+
可能的症状:桌面图标变白/空白
|
|
82
|
+
1) 检查快捷方式是否失效:powershell -c "..."
|
|
83
|
+
2) 刷新图标缓存:ie4uinit.exe -show
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
末尾「报告健康度」是这份记录自己的可信度:扫描耗时、覆盖条目数、四档各占多少、几次调用拿到了起止时刻、有没有被条数上限截断。
|
|
87
|
+
|
|
88
|
+
## 相比直接翻日志
|
|
89
|
+
|
|
90
|
+
会话日志记的是「发出了什么命令」,这个插件记的是「磁盘上留下了什么」,两份不重复:
|
|
91
|
+
|
|
92
|
+
| | 翻会话日志 | dsh-aftermath |
|
|
93
|
+
| --- | --- | --- |
|
|
94
|
+
| 内容 | 意图层:工具名、参数、命令原文、返回值 | 结果层:哪个文件被建/删/改、大小与 mtime |
|
|
95
|
+
| 要回答「这轮改了哪些文件」 | 得自己把命令逐条读一遍,再脑内模拟 `rm -rf`、`git checkout`、脚本内部调用的效果 | 直接给变更表,四类分好 |
|
|
96
|
+
| 命令失败了会怎样 | 日志里照样有那条命令和报错,容易当成「干过这件事」 | 磁盘没有变化,就不会出现在变更表里 |
|
|
97
|
+
| 覆盖范围 | `write`/`edit`、`bash`、`pwsh`、子代理、后台进程散在不同 step,得自己拼 | 只看磁盘结果,谁干的都要过这道账 |
|
|
98
|
+
| 判断是哪次调用造成的 | 日志时间戳是事件时刻,文件 mtime 是磁盘时刻,人工对时容易错 | 调用区间配对,依据列写明是哪一级 |
|
|
99
|
+
| 事后还查得到吗 | 长会话会被压缩/裁剪,早期工具输出可能已不在上下文里 | 独立 NDJSON 存档,`--since 2h` 一条命令,还能 grep / jq |
|
|
100
|
+
| 跨会话 | 每次对话各看各的 | 记录按日存、带会话短标,可横向对比 |
|
|
101
|
+
|
|
102
|
+
归因同样只能从工具调用文本取证据,和日志同源。差别是报告把事实(磁盘变更)和推测(归因档位)分开标注,标 `?` 就是没证据。
|
|
103
|
+
|
|
104
|
+
## 安装
|
|
105
|
+
|
|
106
|
+
**Plugins → Add plugin → 选这个目录**。要求 DSH `>=0.2.2-0 <0.3.0`、Node `>=22.12.0`。
|
|
107
|
+
|
|
108
|
+
## 设置
|
|
109
|
+
|
|
110
|
+
Plugins 页打开 dsh-aftermath 的详情,卡片里能改:总开关、观测目录(一行一个)、递归深度、保留天数、路径打码。总开关点一下即时写入;其余几项改完点保存。保存是逐字段写入的:某个字段被宿主拒绝就停在那一条并显示失败。保存后立即生效,不用重启。
|
|
111
|
+
|
|
112
|
+
卡片只剩总开关、没有其它字段时,多半是没加载到设置 schema(`link:` 安装、插件目录和依赖不在同一个盘时常见)。先跑 `/aftermath doctor`,它会打印 Config 是否导出、schema 从哪加载、宿主给本插件建的命名空间在不在;每次启动也会把同一份自检写到 `$DSH_HOME/state/aftermath/settings-probe.json`。这种情况先用下面的 yml 改配置。
|
|
113
|
+
|
|
114
|
+
## 配置(yml)
|
|
115
|
+
|
|
116
|
+
在 profile 的 `cordis.patch.yml` 里写 config,全部有默认值:
|
|
117
|
+
|
|
118
|
+
```yaml
|
|
119
|
+
- id: dsh-aftermath
|
|
120
|
+
config:
|
|
121
|
+
roots: [desktop, downloads, documents] # 内置标识或绝对路径,支持 "id=路径"
|
|
122
|
+
depth: 2 # 0 = 只看根目录这一层
|
|
123
|
+
exclude: ['node_modules', '~$*']
|
|
124
|
+
extraRoots: ['D:\项目']
|
|
125
|
+
retentionDays: 7
|
|
126
|
+
maskHome: true # 报告里把家目录打码成 ~
|
|
127
|
+
intervalSlackMs: 1500 # 调用区间归因的容差(毫秒),0 = 严丝合缝
|
|
128
|
+
followCwd: true # 当前会话的工作目录自动算进观测根(大目录只看顶层)
|
|
129
|
+
recordQuietTurns: true # 根内没变化、但执行过写操作时,也记一条只有命令摘要的轻记录
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
内置标识:`desktop`、`downloads`、`documents`、`pictures`、`music`、`videos`,依次探测 `%USERPROFILE%\<名>`、`OneDrive\<名>`、中文名(`桌面`/`下载`)。
|
|
133
|
+
|
|
134
|
+
Windows 上桌面被 OneDrive 重定向很常见。插件不读注册表,路径靠别名探测加显式配置,跑 `/aftermath roots` 确认实际观测的目录对不对。
|
|
135
|
+
|
|
136
|
+
## 默认排除表
|
|
137
|
+
|
|
138
|
+
下面这些名字默认不扫(`exclude` 里写的是名字或通配,不是路径;大小写不敏感):
|
|
139
|
+
|
|
140
|
+
| 条目 | 为什么排除 |
|
|
141
|
+
| --- | --- |
|
|
142
|
+
| `node_modules` | 依赖目录,动辄几万个文件;删了重装即可 |
|
|
143
|
+
| `.git` `.svn` `.vs` | 版本库与 IDE 的内部目录,改动不反映你自己的文件 |
|
|
144
|
+
| `~$*` | Office 打开文档时生成的锁文件,开合一次就变,天天报一堆「新建/删除」 |
|
|
145
|
+
| `Thumbs.db` `desktop.ini` `.DS_Store` | 系统/访达的缩略图与文件夹配置,被反复重写 |
|
|
146
|
+
| `$RECYCLE.BIN` | 回收站:删掉的文件会落到这里,扫进来会把「删除」再报一遍 |
|
|
147
|
+
| `System Volume Information` | 卷影副本等系统信息 |
|
|
148
|
+
| `dist` `build` `.next` `.turbo` `coverage` | 构建产物与覆盖率报告,文件多、删了能重新生成 |
|
|
149
|
+
| `__pycache__` `.venv` `venv` `.mypy_cache` `.pytest_cache` | Python 缓存与虚拟环境 |
|
|
150
|
+
| `target` | Rust / Maven 的构建目录 |
|
|
151
|
+
|
|
152
|
+
默认值是为了让报告可读:不排除的话,`cwd` 自动跟随一旦落在大仓库上,一轮扫描会从几十毫秒涨到几百毫秒,报告里还会塞满构建产物。
|
|
153
|
+
|
|
154
|
+
两种改法:
|
|
155
|
+
|
|
156
|
+
- 想加:把新名字写进 `exclude` 数组(yml 里这个数组是**整体替换**,不是追加)
|
|
157
|
+
- 想减:某个目录叫 `build` 但里面确实有你心疼的文件,把它从数组里去掉
|
|
158
|
+
|
|
159
|
+
被排除的目录**不进快照、也不进报告**——排除的语义是「当它不存在」,不是「看到但不记」。
|
|
160
|
+
|
|
161
|
+
## 命令
|
|
162
|
+
|
|
163
|
+
| 命令 | 作用 |
|
|
164
|
+
| --- | --- |
|
|
165
|
+
| `/aftermath report [--last N] [--since 2h] [--root desktop] [--save]` | 变更明细与归因 |
|
|
166
|
+
| `/aftermath scan [--keep]` | 立刻扫描,与上次基线对比 |
|
|
167
|
+
| `/aftermath roots` | 打印解析出的观测根 |
|
|
168
|
+
| `/aftermath roots --suggest` | 列出常用目录哪些已经盯上、哪些还没,并给出可直接粘的 yml |
|
|
169
|
+
| `/aftermath roots --add <路径>` / `--remove <路径>` | 预览加/减之后会变成什么样子,并给出可粘贴的 yml(不替你改配置) |
|
|
170
|
+
| `/aftermath status` | 配置、存档位置、记录条数 |
|
|
171
|
+
| `/aftermath doctor` | 自检:设置命名空间是否就绪、schema 从哪加载 |
|
|
172
|
+
| `/aftermath help` | 帮助 |
|
|
173
|
+
|
|
174
|
+
`--save` 把完整报告写到 `$DSH_HOME/state/aftermath/reports/`。
|
|
175
|
+
|
|
176
|
+
## 给 agent 的工具
|
|
177
|
+
|
|
178
|
+
`aftermath_history`(只读,参数 `since` / `root` / `limit`)。装上之后 agent 可以自己查「上一轮删了什么」,不用你翻日志。
|
|
179
|
+
|
|
180
|
+
## 存档与隐私
|
|
181
|
+
|
|
182
|
+
```
|
|
183
|
+
$DSH_HOME/state/aftermath/
|
|
184
|
+
├── baseline.json 最近一次快照(空闲期对比用)
|
|
185
|
+
├── turns/2026-11-17.ndjson 逐轮变更记录
|
|
186
|
+
└── reports/ --save 的报告
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
只记路径、大小、mtime,不读文件内容、不存正文;命令原文只保留 ≤180 字符的片段用于归因说明,命令里出现的绝对路径最多留 12 条(每条 ≤320 字符)。命令摘要落盘前会跑一遍脱敏,把 `Authorization:` / `Bearer` / `password=` / `--token=` / `ghp_` / `AKIA` / `sk-` 这类常见密钥模式的值打码成 `[redacted]`——这是卫生措施,不是安全边界,会话日志里本来就有完整命令。不启子进程,不联网,恢复命令只打印不执行。记录按 `retentionDays` 自动清理。
|
|
190
|
+
|
|
191
|
+
记录格式 `v: 2`。每条带 `kind`:`changes`(有变更)或 `quiet`(根内无变化但执行过写操作,只含命令摘要,不含变更表)。
|
|
192
|
+
|
|
193
|
+
### 声明了哪些能力
|
|
194
|
+
|
|
195
|
+
`dsh.capabilities` 声明 `fs:read`、`tools:register`、`network:ingress`;`dsh.labels` 声明 `remote-access`。
|
|
196
|
+
|
|
197
|
+
`network:ingress` 对应标签页那条只读路由:插件在运行时通过 `ctx.inject(['webServer'])` 动态注册 `GET /aftermath/recent`,dsh-standards 的静态检查看不到动态注册,会报一条 `C-11.5` 警告,属预期,声明是真实的。路由只接 GET/HEAD,只返回已落盘的记录(路径已按 `maskHome` 打码),没有写入或删除接口。
|
|
198
|
+
|
|
199
|
+
静态检查还会报一条 `C-11.2`(发现了 egress 触发点却未声明 `network:egress`):它把客户端 `fetch('/aftermath/recent')` 当成了出网请求,但那是一次同源请求——GUI 和服务跑在同一个 loopback 端口,面板取的是本机自己注册的路由,不发往任何外部地址,所以不声明 `network:egress` 是对的。
|
|
200
|
+
|
|
201
|
+
## 已知限制
|
|
202
|
+
|
|
203
|
+
- 只覆盖配置的根和深度,根之外看不到磁盘状态;根外只能靠「命令文本提到过哪些路径」间接提示,命令没提到的就无从得知。
|
|
204
|
+
- 观测根没扫全(条目超上限、子目录读不到)时,那个根整根跳过,报告开头直接写「本轮观测不完整」,不会把没扫到的算成删除;这轮也不更新基线。
|
|
205
|
+
- `moved` 是启发式判断(同名 + 同大小 + mtime 相近),报告里会标注。
|
|
206
|
+
- 归因是证据强度分级,标 `?` 就是没有证据。
|
|
207
|
+
- 调用区间依赖宿主给出 `tool/result`:命令用 `Start-Process` 或 `&` 拉起后台进程时,改动会发生在区间结束之后,只能落到宽窗。
|
|
208
|
+
- 跨进程、跨会话的手动改动只能落进「时间窗内」或「无法归因」。
|
|
209
|
+
- 不自动还原:只存路径不存内容,还原是 rollback 类插件的事。
|
|
210
|
+
|
|
211
|
+
## 开发
|
|
212
|
+
|
|
213
|
+
```bash
|
|
214
|
+
npm test # 142 个测试
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
零运行时依赖,只用 `node:` 内置模块。观测走 `ctx.on('session/event')`,`inject: ['tools']` 仅用于注册 `aftermath_history`。
|
|
218
|
+
|
|
219
|
+
## License
|
|
220
|
+
|
|
221
|
+
MIT
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html><head><meta charset="utf-8"><style>
|
|
3
|
+
html,body{margin:0;padding:0;background:transparent}
|
|
4
|
+
svg{display:block;width:100%;height:100%}
|
|
5
|
+
</style></head><body>
|
|
6
|
+
<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg">
|
|
7
|
+
<defs>
|
|
8
|
+
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
|
|
9
|
+
<stop offset="0" stop-color="#1b2130"/><stop offset="1" stop-color="#11151d"/>
|
|
10
|
+
</linearGradient>
|
|
11
|
+
</defs>
|
|
12
|
+
<rect x="0" y="0" width="512" height="512" rx="112" fill="url(#bg)"/>
|
|
13
|
+
|
|
14
|
+
<polyline points="96,330 168,250 232,286 296,196" fill="none" stroke="#aeb8cf"
|
|
15
|
+
stroke-width="30" stroke-linecap="round" stroke-linejoin="round"/>
|
|
16
|
+
<line x1="308" y1="188" x2="412" y2="148" stroke="#ff7a6b" stroke-width="30"
|
|
17
|
+
stroke-linecap="round" stroke-dasharray="30 26"/>
|
|
18
|
+
<circle cx="296" cy="196" r="34" fill="#ffb454"/>
|
|
19
|
+
<circle cx="296" cy="196" r="13" fill="#11151d"/>
|
|
20
|
+
|
|
21
|
+
<line x1="96" y1="398" x2="416" y2="398" stroke="#39445c" stroke-width="12" stroke-linecap="round"/>
|
|
22
|
+
<circle cx="96" cy="398" r="16" fill="#5c6884"/>
|
|
23
|
+
<circle cx="256" cy="398" r="16" fill="#5c6884"/>
|
|
24
|
+
<circle cx="416" cy="398" r="16" fill="#5c6884"/>
|
|
25
|
+
</svg>
|
|
26
|
+
</body></html>
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html><head><meta charset="utf-8"><style>
|
|
3
|
+
html,body{margin:0;padding:0;background:transparent}
|
|
4
|
+
svg{display:block;width:100%;height:100%}
|
|
5
|
+
</style></head><body>
|
|
6
|
+
<svg viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg">
|
|
7
|
+
<defs>
|
|
8
|
+
<linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
|
|
9
|
+
<stop offset="0" stop-color="#ffffff"/><stop offset="1" stop-color="#e8edf7"/>
|
|
10
|
+
</linearGradient>
|
|
11
|
+
</defs>
|
|
12
|
+
<rect x="0" y="0" width="512" height="512" rx="112" fill="url(#bg)"/>
|
|
13
|
+
|
|
14
|
+
<polyline points="96,330 168,250 232,286 296,196" fill="none" stroke="#39445c"
|
|
15
|
+
stroke-width="30" stroke-linecap="round" stroke-linejoin="round"/>
|
|
16
|
+
<line x1="308" y1="188" x2="412" y2="148" stroke="#e5484d" stroke-width="30"
|
|
17
|
+
stroke-linecap="round" stroke-dasharray="30 26"/>
|
|
18
|
+
<circle cx="296" cy="196" r="34" fill="#f08c1a"/>
|
|
19
|
+
<circle cx="296" cy="196" r="13" fill="#ffffff"/>
|
|
20
|
+
|
|
21
|
+
<line x1="96" y1="398" x2="416" y2="398" stroke="#c3cbdb" stroke-width="12" stroke-linecap="round"/>
|
|
22
|
+
<circle cx="96" cy="398" r="16" fill="#9aa5bb"/>
|
|
23
|
+
<circle cx="256" cy="398" r="16" fill="#9aa5bb"/>
|
|
24
|
+
<circle cx="416" cy="398" r="16" fill="#9aa5bb"/>
|
|
25
|
+
</svg>
|
|
26
|
+
</body></html>
|
|
Binary file
|
|
Binary file
|
package/cordis.patch.yml
ADDED