74 lines
2.7 KiB
Markdown
74 lines
2.7 KiB
Markdown
|
# Reasonix Batch E / Worker B：3-20 document conflict diff DOM helper 候选
|
|||
|
|
|
|||
|
|
Project root：`/mnt/Data1T/mnote-worktrees/0525-e-worker-b-3-20-conflict-diff-dom`
|
|||
|
|
|
|||
|
|
## 目标
|
|||
|
|
|
|||
|
|
在独立 worktree 中产出候选 patch，把 document conflict panel 中 diff / merge 区域的纯 DOM 构建和按钮 wiring 从 `web_shell.rs` inline script 外置到 `document-conflict-panel-runtime.js`。`web_shell.rs` 仍负责读取磁盘版本、计算 plain text、状态切换和持久化业务逻辑。
|
|||
|
|
|
|||
|
|
优先新增 runtime helper：
|
|||
|
|
|
|||
|
|
- `populateSessionConflictDiffPanel(panel, context, deps)` 或等价命名
|
|||
|
|
|
|||
|
|
其中 `context` 至少包含：
|
|||
|
|
|
|||
|
|
- `currentText`
|
|||
|
|
- `diskText`
|
|||
|
|
- 可选 empty 文案
|
|||
|
|
|
|||
|
|
`deps` 注入：
|
|||
|
|
|
|||
|
|
- `onUseCurrent`
|
|||
|
|
- `onUseDisk`
|
|||
|
|
- `onSaveMerge`
|
|||
|
|
|
|||
|
|
## 允许修改
|
|||
|
|
|
|||
|
|
- `rust/crates/mnote-web/browser/document-conflict-panel-runtime.js`
|
|||
|
|
- `rust/crates/mnote-web/src/routes/web_shell.rs`
|
|||
|
|
|
|||
|
|
必要时只更新同文件内字符串断言测试。
|
|||
|
|
|
|||
|
|
## 禁止事项
|
|||
|
|
|
|||
|
|
- 不修改 `rust/crates/mnote-web/browser/local-upload-runtime.js` 或 `layout.rs`，避免和当前 3-20 local upload 候选冲突。
|
|||
|
|
- 不修改 editor island / leptos-tiptap 代码。
|
|||
|
|
- 不迁 `acceptDiskVersion`、`keepCurrentEditorVersion`、`writeMergedConflictResult`、`fetchLatestSessionAggregate`、`fetchLatestResourceSnapshot` 等业务逻辑。
|
|||
|
|
- 不改变按钮 data-testid、面板结构语义、错误处理和 fallback 行为。
|
|||
|
|
- 不修改 AGENTS、design、bugs 或 git 状态。
|
|||
|
|
- 不提交 git。
|
|||
|
|
|
|||
|
|
## 实现要求
|
|||
|
|
|
|||
|
|
- `openConflictDiffPanel(session, panel)` 仍负责：
|
|||
|
|
- 显示 loading。
|
|||
|
|
- fetch 最新 session/resource snapshot。
|
|||
|
|
- 计算 `latestText` 与 `sessionPlainText(session)`。
|
|||
|
|
- 捕获错误并显示错误。
|
|||
|
|
- runtime helper 只负责在已有 `diffPanel` 中创建 current/disk/merge DOM，并绑定 use current / use disk / save merge 回调。
|
|||
|
|
- runtime 不可直接访问 session fetch / persist / status 业务函数。
|
|||
|
|
- inline fallback 必须完整保留；runtime 不存在时当前行为不变。
|
|||
|
|
|
|||
|
|
## 验收命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
node --check rust/crates/mnote-web/browser/document-conflict-panel-runtime.js
|
|||
|
|
cargo fmt --manifest-path rust/Cargo.toml --all --check
|
|||
|
|
cargo check --manifest-path rust/Cargo.toml -p mnote-web
|
|||
|
|
cargo test --manifest-path rust/Cargo.toml -p mnote-web document_conflict_panel_runtime_contains_dom_helpers -- --test-threads=1
|
|||
|
|
cargo test --manifest-path rust/Cargo.toml -p mnote-web mnote_browser_runtime_assets_are_explicitly_mounted -- --test-threads=1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
如果能定位现有 secondary pane conflict smoke，可额外运行；不要新增大范围浏览器用例。
|
|||
|
|
|
|||
|
|
## 输出要求
|
|||
|
|
|
|||
|
|
handoff 必须列出：
|
|||
|
|
|
|||
|
|
- 修改文件。
|
|||
|
|
- 外置 DOM helper 的职责和 deps 清单。
|
|||
|
|
- fallback 是否保留。
|
|||
|
|
- 验收命令和结果。
|
|||
|
|
- 未覆盖风险。
|
|||
|
|
- `git diff --stat`。
|