104 lines
5.2 KiB
Markdown
104 lines
5.2 KiB
Markdown
# Batch A3 Worker A：local folder empty-trash UI smoke
|
||
|
||
> 更新时间：2026-05-22
|
||
> 任务：`task474-local-folder-empty-trash-ui-smoke`
|
||
|
||
## 修改文件
|
||
|
||
| 文件 | 操作 |
|
||
|------|------|
|
||
| `scripts/task474-local-folder-empty-trash-ui-smoke.js` | 新增 |
|
||
| `design/04-tree-domain/process/4-34-filetree-trash-dual-browser-no-refresh-v1.md` | 更新验收矩阵、执行记录、边界和完成标准 |
|
||
| `.codex/reasonix-tasks/results/batch-a3-worker-a-empty-trash.md` | 本文件 |
|
||
|
||
## Smoke 覆盖内容
|
||
|
||
### 测试场景
|
||
|
||
- **临时 local folder root**：创建松散 Markdown 页面 (`docs/test-page.md`) 和非 md 资源 (`docs/resource.txt`)
|
||
- **归档到垃圾箱**：通过 `POST /api/tree/commands` 将两个条目都 `delete` 进入 `.mnote/trash/`
|
||
- **打开 trash 页**：`/trash?sourceKind=local_folder&rootUri=file://...`
|
||
- **清空页面垃圾箱**：
|
||
- 点击 `data-trash-action="local-empty-documents"` 按钮
|
||
- accept `window.confirm('清空后无法恢复，确定继续吗？')`
|
||
- 断言：MD trash row 消失、资源行仍然存在、`trash-index.json` 中 MD entry 删除、trash 文件删除、按钮变为 disabled
|
||
- 导航断言：全程 `framenavigated` delta = 0
|
||
- **清空资源垃圾箱**：
|
||
- 点击 `data-trash-action="local-empty-resources"` 按钮
|
||
- accept confirm dialog
|
||
- 断言：资源 trash row 消失、`trash-index.json` 中资源 entry 删除、trash 文件删除、按钮变为 disabled
|
||
- 导航断言：全程 `framenavigated` delta = 0
|
||
- **最终验证**：`trash-index.json` 为空、原始源文件未恢复
|
||
|
||
### 关键选择器
|
||
|
||
| 元素 | 选择器 |
|
||
|------|--------|
|
||
| Trash workbench | `[data-testid="mnote-trash-workbench"][data-trash-source-kind="local_folder"]` |
|
||
| 清空页面垃圾箱 | `[data-trash-action="local-empty-documents"]` |
|
||
| 清空资源垃圾箱 | `[data-trash-action="local-empty-resources"]` |
|
||
| MD trash row | `article[data-trash-row="local"][data-trash-entry-id="local-md:docs~2Ftest-page.md"]` |
|
||
| Asset trash row | `article[data-trash-row="local"][data-trash-entry-id="local-file:docs/resource.txt"]` |
|
||
| Confirm 文本 | `'清空后无法恢复，确定继续吗？'` |
|
||
|
||
### 数据流
|
||
|
||
```
|
||
postTreeCommand(delete, "local-md:docs~2Ftest-page.md")
|
||
→ tree.resource.archive → 文件移至 .mnote/trash/ → trash-index.json 记录
|
||
postTreeCommand(delete, "local-file:docs/resource.txt")
|
||
→ tree.resource.archive → 文件移至 .mnote/trash/ → trash-index.json 记录
|
||
→ 打开 /trash → 两行可见
|
||
→ 点击 empty-documents → confirm.accept → Promise.all(rows.map purge) → refresh() (fetch+DOMParser)
|
||
→ MD 行消失，按钮 disabled，trash-index 清理，trash 文件删除，framenavigated=0
|
||
→ 点击 empty-resources → confirm.accept → Promise.all(rows.map purge) → refresh()
|
||
→ 资源行消失，按钮 disabled，trash-index 为空，trash 文件删除，framenavigated=0
|
||
```
|
||
|
||
## 验证命令和结果
|
||
|
||
```bash
|
||
# 语法验证
|
||
node --check scripts/task474-local-folder-empty-trash-ui-smoke.js
|
||
# → exit 0
|
||
|
||
# Codex 复核：最新 mnote-web 临时端口 3014 + Chromium 实跑
|
||
MNOTE_WEB_SMOKE_BASE_URL=http://127.0.0.1:3014 \
|
||
PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH=/usr/bin/google-chrome-stable \
|
||
node scripts/task474-local-folder-empty-trash-ui-smoke.js
|
||
# → exit 0
|
||
# → 写入 tmp/task474-local-folder-empty-trash-ui-smoke/result.json
|
||
```
|
||
|
||
Codex 复核结果：
|
||
|
||
- `result.json.ok=true`
|
||
- `emptyDocuments.navDelta=0`
|
||
- `emptyResources.navDelta=0`
|
||
- `emptyDocuments.mdEntryClean=true`
|
||
- `emptyResources.assetEntryClean=true`
|
||
- `steps.length=5`
|
||
|
||
Reasonix Browser Worker 也已独立复测，输出：
|
||
|
||
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/result.json`
|
||
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-empty.png`
|
||
- `tmp/reasonix-batch-a3-browser-task474-empty-trash-2026-05-21/trash-workbench-ui.png`
|
||
|
||
## 更新到 4-34 的内容
|
||
|
||
1. **验收矩阵**：local folder Markdown 和 local folder 非 md 资源两行的 empty-trash 列已从 `❌ 未覆盖` 改为 `✅ task474 UI empty-trash`
|
||
2. **执行记录**：在 3.5 末尾追加 task474 的覆盖说明
|
||
3. **当前边界**：补充 task474 覆盖的 empty-trash 项
|
||
4. **完成标准**：local folder 子项增加 `474`
|
||
|
||
## 未完成项 / 风险
|
||
|
||
| # | 项 | 状态 | 说明 |
|
||
|---|-----|------|------|
|
||
| 1 | bundled Markdown empty-trash | ❌ 未覆盖 | task474 只验证了松散 `.md` 的 empty-trash；bundled Markdown page（目录含 `Page.md`）未覆盖。empty-trash 操作通过 `data-resource-kind="markdown"/"markdown_bundle"` 选择器选择行，理论上 bundled Markdown 也会被选中，但未实地验证 |
|
||
| 2 | 双浏览器 empty-trash 实时性 | ❌ 未验证 | task474 是单浏览器 UI smoke（A 浏览器操作 + 断言）。B 浏览器不刷新可见更新（Convex 双浏览器矩阵）未覆盖。当前 local folder trash 的 `refresh()` 只刷新 A 浏览器自身 DOM，`tree:delta resync_required` 事件不推送跨浏览器 |
|
||
| 3 | 3000 未重新编译 | ✅ 已处理 | Codex 已在最新临时端口 `3014` 实跑通过 |
|
||
| 4 | GitHub 资源空 trash 后按钮状态 | ✅ 已验证 | 脚本断言清空后按钮变为 disabled |
|
||
| 5 | 大文件 empty-trash | ❌ 未验证 | 脚本仅用了几 KB 的小文件；大 trash 数量的 `refresh()` 性能未覆盖 |
|