feat: v0.4.0 差异计算 worker 化 - 大文件 diff 移入 Worker 后台计算不阻塞界面、输入去抖与过期任务丢弃（终止重建实现取消）、小输入同步快路径、无 Worker 环境回退、计算中遮罩与导出禁用

docs/应用开发与版本迭代规范.md

@@ -20,7 +20,7 @@ z = 补丁版本号（Patch）
 > **`x` 永远是 `0`，永远不要提升到 `1.0.0`。**
 > 版本迭代**只允许修改 `y` 和 `z`**，`x` 保持 `0` 不变。
 
-当前基线版本：**`0.3.2`**
+当前基线版本：**`0.4.0`**
 
 ---
 
@@ -65,8 +65,9 @@ z = 补丁版本号（Patch）
 0.2.6   ← 主进程异步收尾与边角防护（已发布）：保存报告异步写盘 · 拖拽解码 handler 异步化 · 空白粘贴拦截 · 超多行卡顿预警 · 清理 mac 无效签名配置 · 文档与测试同步
 0.3.0   ← 大文件性能与差异导航增强（已发布）：自研虚拟滚动 · 仅看差异过滤（折叠提示行） · F7/Shift+F7 导航快捷键 · 交换左右侧 · 忽略空行
 0.3.1   ← 稳健性与测试补强（已发布）：超长单行词级 diff 防护 · 打开对话框补“所有文件”筛选 · 虚拟滚动 minWidth 测试覆盖 · 滚动同步去锁化重构
-0.3.2   ← 报告对齐与性能收尾（当前）：纯文本报告行号右对齐 · 超长行列宽封顶防卡顿 · 对话框与拖拽扩展名清单对齐 · 右键菜单打开时导航快捷键守卫 · 清理导出死属性
-0.4.0   ← 新增功能（候选：主进程解码 worker 化 · 渲染进程 diff 计算 worker 化 · Playwright E2E · 文件夹对比）
+0.3.2   ← 报告对齐与性能收尾（已发布）：纯文本报告行号右对齐 · 超长行列宽封顶防卡顿 · 对话框与拖拽扩展名清单对齐 · 右键菜单打开时导航快捷键守卫 · 清理导出死属性
+0.4.0   ← 差异计算 worker 化（当前）：大文件 diff 移入 Worker 后台计算不阻塞界面 · 输入去抖与过期任务丢弃（终止重建实现取消） · 小输入同步快路径 · 无 Worker 环境回退 · 计算中遮罩与导出禁用
+0.5.0   ← 新增功能（候选：主进程解码 worker 化 · Playwright E2E · 文件夹对比）
 ...
 0.y.z   ← 长期停留，永不进入 1.x
 ```

docs/测试策略与方案.md

@@ -47,15 +47,22 @@ src/renderer/src/
 │   └── setup.ts                      # 全局 setup：jest-dom 匹配器 + 自动 cleanup
 ├── diff/
 │   ├── diffEngine.test.ts            # diff 引擎单元测试
+│   ├── diffWorker.ts                 # diff 计算 Web Worker（内联打包，覆盖率排除，逻辑由 diffEngine 覆盖）
+│   ├── createDiffWorker.test.ts      # worker 工厂（环境回退/实例化）
+│   ├── createDiffWorker.ts           # worker 工厂：环境不支持时返回 null 由调用方回退
 │   ├── report.test.ts                # 报告生成测试
 │   └── textUtils.test.ts             # 文本扩展名与行数统计测试
+├── hooks/
+│   ├── useDiff.test.ts               # worker 化计算 hook（快路径/去抖/过期丢弃/回退/卸载清理）
+│   ├── useDiff.ts
+│   └── useDismiss.ts
 ├── components/
 │   ├── ContextMenu.test.tsx          # 右键菜单（含边缘防溢出）
 │   ├── DiffView.test.tsx             # 对比视图（渲染/滚动同步/右键/拖放）
 │   ├── TextInputModal.test.tsx       # 粘贴文本弹窗
-│   └── Toolbar.test.tsx              # 工具栏（选项/导航/导出菜单）
+│   └── Toolbar.test.tsx              # 工具栏（选项/导航/导出菜单/计算中禁用）
 └── __tests__/
-    ├── App.test.tsx                  # 应用集成级测试（加载/拖拽/粘贴/导出/容错）
+    ├── App.test.tsx                  # 应用集成级测试（加载/拖拽/粘贴/导出/容错/大输入回退）
     └── main.test.ts                  # 入口挂载冒烟测试
 ```
 
@@ -98,6 +105,15 @@ src/renderer/src/
 - 仅看差异视图：未更改行折叠、折叠提示出现、关闭后恢复
 - F7 / Shift+F7 导航快捷键；粘贴弹窗打开时快捷键不抢占
 - 交换左右侧后面板文件互换
+- 大输入（超快路径阈值）在无 Worker 环境回退同步计算，无计算中遮罩
+
+### 5.6 diff 计算 worker 化（`useDiff.ts` / `createDiffWorker.ts`）
+- 快路径：两侧总行数不超过 2000 时同步计算，不创建 worker，结果与 computeDiff 一致
+- 重路径：进入 computing 且 diff 置空；200ms 去抖后才派发 worker；响应按 jobId 匹配，错误/过期 jobId 被丢弃
+- 输入变更：旧 worker 终止重建（等价取消）；去抖期内变更则旧任务未派发即取消（零浪费计算）
+- worker 不可用（环境缺失/工厂返回 null）：主线程同步回退
+- 卸载：终止 worker 并清理去抖定时器
+- 工厂：无 Worker 环境返回 null；可用环境返回实例
 
 ---