fix: v0.2.6 主进程异步收尾与边角防护 - 保存报告异步写盘、拖拽解码handler异步化、空白粘贴拦截、超多行卡顿预警、清理mac无效签名配置、文档与测试同步
This commit is contained in:
@@ -15,7 +15,7 @@ DiffLens 是一款跨平台桌面文本对比工具，帮助你快速定位两
|
||||
- **智能编码识别**：自动探测 UTF-8 / UTF-16 / GBK（含 BOM），中文文档不乱码
|
||||
- **忽略选项**：支持“忽略行首尾空白”“忽略大小写”，适配弱差异场景
|
||||
- **手动粘贴对比**：无需文件，直接粘贴两侧文本即可开始对比
|
||||
- **大文件防护**：超过 10MB 的文件自动拦截并提示，避免界面卡死
|
||||
- **大文件防护**：超过 10MB 的文件自动拦截并提示；行数过多时给出滚动卡顿预警
|
||||
- **二进制文件预警**：疑似二进制内容给出乱码提示，避免误读为差异
|
||||
- **差异统计徽章**：实时统计新增 / 删除 / 修改行数
|
||||
- **导出一键报告**：将对比结果导出为 HTML / 纯文本 / Markdown 三种格式，便于分享与归档
|
||||
@@ -90,7 +90,7 @@ src/
|
||||
- 作者：thzxx
|
||||
- 组织：MetonaTeam
|
||||
- 许可证：MIT License（见 [LICENSE](./LICENSE)）
|
||||
- 版本：0.2.5
|
||||
- 版本：0.2.6
|
||||
|
||||
---
|
||||
|
||||
|
||||
+5
-3
@@ -20,7 +20,7 @@ z = 补丁版本号（Patch）
|
||||
> **`x` 永远是 `0`，永远不要提升到 `1.0.0`。**
|
||||
> 版本迭代**只允许修改 `y` 和 `z`**，`x` 保持 `0` 不变。
|
||||
|
||||
当前基线版本：**`0.2.5`**
|
||||
当前基线版本：**`0.2.6`**
|
||||
|
||||
---
|
||||
|
||||
@@ -61,8 +61,9 @@ z = 补丁版本号（Patch）
|
||||
0.2.2 ← 体验打磨（已发布）：拖拽处处可用 · 手动粘贴对比 · 导出后一键定位 · 报告/可读性增强 · 仅限文本文件
|
||||
0.2.3 ← 安装器优化（已发布）：NSIS 向导式安装，支持手动选择安装目录
|
||||
0.2.4 ← 健壮性与体验打磨（已发布）：读取容错与 10MB 大文件防护 · 横向滚动同步 · 下拉点击外部/Esc 关闭 · 二进制误判预警
|
||||
0.2.5 ← 一致性与边角修复（当前）：右键菜单边缘防溢出 · 粘贴入口 10MB 防护 · 拖拽读取失败提示 · 多文件拖拽提示 · 剪贴板统一走主进程 · 主进程异步读取
|
||||
0.3.0 ← 新增功能
|
||||
0.2.5 ← 一致性与边角修复（已发布）：右键菜单边缘防溢出 · 粘贴入口 10MB 防护 · 拖拽读取失败提示 · 多文件拖拽提示 · 剪贴板统一走主进程 · 主进程异步读取
|
||||
0.2.6 ← 主进程异步收尾与边角防护（当前）：保存报告异步写盘 · 拖拽解码 handler 异步化 · 空白粘贴拦截 · 超多行卡顿预警 · 清理 mac 无效签名配置 · 文档与测试同步
|
||||
0.3.0 ← 新增功能（候选：虚拟滚动 · 仅看差异过滤 · 差异导航快捷键 · 交换左右侧 · 忽略空行 · 主进程解码 worker 化）
|
||||
...
|
||||
0.y.z ← 长期停留，永不进入 1.x
|
||||
```
|
||||
@@ -149,6 +150,7 @@ npm run build:win # Windows NSIS 安装包（在 Windows 上）
|
||||
| --- | --- |
|
||||
| `package.json` | `version`（唯一版本来源）、`name`、`productName` 保持 DiffLens |
|
||||
| `electron-builder.yml` | `productName` / `executableName` / `artifactName` 保持 DiffLens |
|
||||
| `README.md` | 特性描述与发布版本号随版本同步 |
|
||||
| 本文件 | 第 3 节演进记录同步补写 |
|
||||
|
||||
> 版本号**只以 `package.json` 的 `version` 为唯一来源**，其余打包产物名由它派生。
|
||||
|
||||
+15
-7
@@ -41,14 +41,22 @@
|
||||
## 4. 目录结构
|
||||
|
||||
```
|
||||
vitest.config.ts # Vitest 配置（jsdom + 测试范围）
|
||||
vitest.config.ts # Vitest 配置（jsdom + 测试范围 + 覆盖率 80% 硬门禁）
|
||||
src/renderer/src/
|
||||
├── test/setup.ts # 全局 setup：jest-dom 匹配器 + 自动 cleanup
|
||||
├── test/
|
||||
│ └── setup.ts # 全局 setup：jest-dom 匹配器 + 自动 cleanup
|
||||
├── diff/
|
||||
│ ├── diffEngine.test.ts # diff 引擎单元测试
|
||||
│ └── report.test.ts # 报告生成测试
|
||||
│ ├── report.test.ts # 报告生成测试
|
||||
│ └── textUtils.test.ts # 文本扩展名与行数统计测试
|
||||
├── components/
|
||||
│ ├── ContextMenu.test.tsx # 右键菜单（含边缘防溢出）
|
||||
│ ├── DiffView.test.tsx # 对比视图（渲染/滚动同步/右键/拖放）
|
||||
│ ├── TextInputModal.test.tsx # 粘贴文本弹窗
|
||||
│ └── Toolbar.test.tsx # 工具栏（选项/导航/导出菜单）
|
||||
└── __tests__/
|
||||
└── App.test.tsx # 应用冒烟测试
|
||||
├── App.test.tsx # 应用集成级测试（加载/拖拽/粘贴/导出/容错）
|
||||
└── main.test.ts # 入口挂载冒烟测试
|
||||
```
|
||||
|
||||
> 约定：测试文件与被测文件同目录（`*.test.ts(x)`），或集中放各模块下 `__tests__`。
|
||||
@@ -105,10 +113,10 @@ npm run build
|
||||
|
||||
| 模块 | 目标 |
|
||||
| --- | --- |
|
||||
| 逻辑层（diff / report） | ≥ 80% 行覆盖（当前以核心用例保证关键路径） |
|
||||
| 组件层（App） | 覆盖主流程空态与关键交互 |
|
||||
| 逻辑层（diff / report / textUtils） | 行覆盖 ≥ 80% |
|
||||
| 组件层（components / App） | 覆盖主流程空态与关键交互 |
|
||||
|
||||
> 具体门槛随各模块成熟度逐步收紧；当前先保证**关键路径断言完整**。
|
||||
> 80% 四项阈值（statements / branches / functions / lines）已写入 `vitest.config.ts` 的 `coverage.thresholds`，作为 CI 硬门禁强制执行，未达标即测试失败。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -44,7 +44,6 @@ mac:
|
||||
- target: dmg
|
||||
arch:
|
||||
- arm64
|
||||
entitlementsInherit: build/entitlements.mac.plist
|
||||
|
||||
linux:
|
||||
icon: assets/logo.png
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "DiffLens",
|
||||
"version": "0.2.5",
|
||||
"version": "0.2.6",
|
||||
"description": "DiffLens — 精美酷炫的文本对比桌面应用",
|
||||
"author": "thzxx",
|
||||
"license": "MIT",
|
||||
|
||||
+3
-2
@@ -115,7 +115,7 @@ ipcMain.handle('file:open', async (_event, side: 'left' | 'right' | null) => {
|
||||
})
|
||||
|
||||
/** IPC: 解码拖拽传入的原始字节（复用编码探测逻辑） */
|
||||
ipcMain.handle('file:decode-buffer', (_event, buffer: ArrayBuffer) => {
|
||||
ipcMain.handle('file:decode-buffer', async (_event, buffer: ArrayBuffer) => {
|
||||
return decodeText(Buffer.from(buffer))
|
||||
})
|
||||
|
||||
@@ -131,7 +131,8 @@ ipcMain.handle('file:save-report', async (_event, content: string, defaultName:
|
||||
]
|
||||
})
|
||||
if (result.canceled || !result.filePath) return { ok: false, path: null }
|
||||
fs.writeFileSync(result.filePath, content, 'utf-8')
|
||||
// 异步写盘，避免大报告（MB 级 HTML）同步写入时阻塞主进程事件循环
|
||||
await fs.promises.writeFile(result.filePath, content, 'utf-8')
|
||||
return { ok: true, path: result.filePath }
|
||||
})
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ import Toolbar from './components/Toolbar'
|
||||
import ContextMenu, { type ContextMenuItem } from './components/ContextMenu'
|
||||
import TextInputModal from './components/TextInputModal'
|
||||
import { buildReport, REPORT_EXT, type ReportFormat, type ReportContext } from './diff/report'
|
||||
import { isTextFile } from './diff/textUtils'
|
||||
import { isTextFile, countLines, HEAVY_LINES } from './diff/textUtils'
|
||||
import { useDismiss } from './hooks/useDismiss'
|
||||
import type { PaneMeta } from './components/DiffView'
|
||||
import type { SideCell } from './diff/diffEngine'
|
||||
@@ -119,6 +119,15 @@ export default function App(): ReactElement {
|
||||
}
|
||||
}, [])
|
||||
|
||||
// 超多行预警：行数超过阈值时提示滚动可能卡顿（不阻断加载）
|
||||
const warnHeavyLines = useCallback(
|
||||
(text: string): void => {
|
||||
const lines = countLines(text)
|
||||
if (lines > HEAVY_LINES) showToast(`行数较多（${lines} 行），滚动可能出现卡顿`)
|
||||
},
|
||||
[showToast]
|
||||
)
|
||||
|
||||
const openPane = useCallback(
|
||||
async (side: 'left' | 'right') => {
|
||||
let data: Awaited<ReturnType<typeof window.api.openFile>>
|
||||
@@ -138,6 +147,7 @@ export default function App(): ReactElement {
|
||||
return
|
||||
}
|
||||
if (data.binary) showToast(`疑似二进制文件，内容可能乱码：${data.name}`)
|
||||
warnHeavyLines(data.text)
|
||||
const pane: PaneState = {
|
||||
meta: { name: data.name, encoding: data.encoding },
|
||||
path: data.path,
|
||||
@@ -146,7 +156,7 @@ export default function App(): ReactElement {
|
||||
if (side === 'left') setPaneL(pane)
|
||||
else setPaneR(pane)
|
||||
},
|
||||
[showToast]
|
||||
[showToast, warnHeavyLines]
|
||||
)
|
||||
|
||||
const dropPane = useCallback(
|
||||
@@ -181,11 +191,12 @@ export default function App(): ReactElement {
|
||||
text = fallback
|
||||
}
|
||||
if (binary) showToast(`疑似二进制文件，内容可能乱码：${file.name}`)
|
||||
warnHeavyLines(text)
|
||||
const pane: PaneState = { meta: { name: file.name, encoding }, path: '', text }
|
||||
if (side === 'left') setPaneL(pane)
|
||||
else setPaneR(pane)
|
||||
},
|
||||
[showToast]
|
||||
[showToast, warnHeavyLines]
|
||||
)
|
||||
|
||||
const diff: DiffResult = useMemo(() => {
|
||||
@@ -276,17 +287,23 @@ export default function App(): ReactElement {
|
||||
|
||||
const confirmPaste = useCallback(
|
||||
(side: 'left' | 'right', text: string) => {
|
||||
// 空白内容拦截：进入对比只会得到空面板与"完全一致"的误导性结果
|
||||
if (text.trim() === '') {
|
||||
showToast('内容为空，请先输入或粘贴文本')
|
||||
return
|
||||
}
|
||||
// 与文件入口的 10MB 字节上限保持对称：超限拒绝且不关闭弹窗，保留内容供编辑
|
||||
if (new TextEncoder().encode(text).length > MAX_FILE_SIZE) {
|
||||
showToast('粘贴内容超过 10MB，暂不支持对比')
|
||||
return
|
||||
}
|
||||
warnHeavyLines(text)
|
||||
const pane: PaneState = { meta: { name: '手动文本', encoding: '文本' }, path: '', text }
|
||||
if (side === 'left') setPaneL(pane)
|
||||
else setPaneR(pane)
|
||||
setPasteSide(null)
|
||||
},
|
||||
[showToast]
|
||||
[showToast, warnHeavyLines]
|
||||
)
|
||||
|
||||
const leftMeta = paneL?.meta ?? null
|
||||
|
||||
@@ -415,4 +415,17 @@ describe('App - 手动粘贴文本', () => {
|
||||
expect(screen.getByText('开始对比')).toBeInTheDocument()
|
||||
expect(screen.queryByText('导出报告')).not.toBeInTheDocument()
|
||||
})
|
||||
|
||||
it('粘贴空白内容被拒绝且弹窗保持打开', () => {
|
||||
render(<App />)
|
||||
fireEvent.click(screen.getByText('粘贴文本'))
|
||||
fireEvent.click(screen.getByText('粘贴到左侧'))
|
||||
fireEvent.change(screen.getByPlaceholderText(/粘贴或输入/), {
|
||||
target: { value: ' \n ' }
|
||||
})
|
||||
fireEvent.click(screen.getByText('开始对比'))
|
||||
expect(screen.getByText(/内容为空/)).toBeInTheDocument()
|
||||
expect(screen.getByText('开始对比')).toBeInTheDocument()
|
||||
expect(screen.queryByText('导出报告')).not.toBeInTheDocument()
|
||||
})
|
||||
})
|
||||
@@ -67,6 +67,32 @@ describe('computeDiff - 词级修改', () => {
|
||||
})
|
||||
})
|
||||
|
||||
describe('computeDiff - 多块修改与不配对增删', () => {
|
||||
it('多个独立修改块各自配对为 modified', () => {
|
||||
const { rows, summary } = computeDiff('a\nX\nb\nY\nc', 'a\nZ\nb\nW\nc')
|
||||
expect(summary.modified).toBe(2)
|
||||
const mods = rows.filter((r) => r.rowKind === 'modified')
|
||||
expect(mods[0].left.text).toBe('X')
|
||||
expect(mods[0].right.text).toBe('Z')
|
||||
expect(mods[1].left.text).toBe('Y')
|
||||
expect(mods[1].right.text).toBe('W')
|
||||
})
|
||||
|
||||
it('删除多于新增时多余删除行降级为 removed', () => {
|
||||
const { summary } = computeDiff('l1\nl2\nl3\nl4', 'l1\nl9\nl4')
|
||||
// l2 与 l9 配对为修改，l3 无新增可配对 → removed
|
||||
expect(summary.modified).toBe(1)
|
||||
expect(summary.deleted).toBe(1)
|
||||
})
|
||||
|
||||
it('新增多于删除时多余新增行保持 added', () => {
|
||||
const { rows, summary } = computeDiff('a\nc', 'a\nb1\nb2\nc')
|
||||
expect(summary.inserted).toBe(2)
|
||||
const added = rows.filter((r) => r.rowKind === 'added')
|
||||
expect(added.map((r) => r.right.text)).toEqual(['b1', 'b2'])
|
||||
})
|
||||
})
|
||||
|
||||
describe('computeDiff - 忽略选项', () => {
|
||||
it('忽略大小写', () => {
|
||||
const { summary } = computeDiff('Alpha', 'alpha', { ignoreCase: true })
|
||||
@@ -78,6 +104,11 @@ describe('computeDiff - 忽略选项', () => {
|
||||
expect(summary.changedLines).toBe(0)
|
||||
})
|
||||
|
||||
it('空白与大小写忽略选项组合生效', () => {
|
||||
const { summary } = computeDiff(' Alpha ', 'alpha', { trimWhitespace: true, ignoreCase: true })
|
||||
expect(summary.changedLines).toBe(0)
|
||||
})
|
||||
|
||||
it('未开启忽略时同一纯净差异仍被识别', () => {
|
||||
const { summary } = computeDiff(' value ', 'value')
|
||||
expect(summary.changedLines).toBeGreaterThan(0)
|
||||
|
||||
@@ -68,8 +68,8 @@ function wordSegments(leftText: string, rightText: string): { left: Seg[]; right
|
||||
return { left, right }
|
||||
}
|
||||
|
||||
/** 按行切分；空字符串返回空数组。结尾换行符不产生一个额外空行 */
|
||||
function splitLines(text: string): string[] {
|
||||
/** 按行切分；空字符串返回空数组。结尾换行符不产生一个额外空行（导出供行数统计复用，保持切分规则一致） */
|
||||
export function splitLines(text: string): string[] {
|
||||
if (text === '') return []
|
||||
const lines = text.split(/\r?\n/)
|
||||
if (lines[lines.length - 1] === '') lines.pop()
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { describe, it, expect } from 'vitest'
|
||||
import { TEXT_EXTENSIONS, isTextFile } from './textUtils'
|
||||
import { TEXT_EXTENSIONS, isTextFile, HEAVY_LINES, countLines } from './textUtils'
|
||||
|
||||
describe('textUtils', () => {
|
||||
it('常见文本扩展名放行', () => {
|
||||
@@ -31,3 +31,25 @@ describe('textUtils', () => {
|
||||
expect(TEXT_EXTENSIONS).toContain('txt')
|
||||
})
|
||||
})
|
||||
|
||||
describe('countLines / HEAVY_LINES', () => {
|
||||
it('空文本为 0 行', () => {
|
||||
expect(countLines('')).toBe(0)
|
||||
})
|
||||
|
||||
it('无结尾换行按实际行数', () => {
|
||||
expect(countLines('a\nb\nc')).toBe(3)
|
||||
})
|
||||
|
||||
it('结尾换行不产生额外空行（与 diff 引擎切分一致）', () => {
|
||||
expect(countLines('a\nb\n')).toBe(2)
|
||||
})
|
||||
|
||||
it('CRLF 换行同样切分', () => {
|
||||
expect(countLines('a\r\nb')).toBe(2)
|
||||
})
|
||||
|
||||
it('超多行预警阈值为 50000', () => {
|
||||
expect(HEAVY_LINES).toBe(50000)
|
||||
})
|
||||
})
|
||||
@@ -1,3 +1,5 @@
|
||||
import { splitLines } from './diffEngine'
|
||||
|
||||
/** 允许打开/拖拽的文本类扩展名（小写，不含点） */
|
||||
export const TEXT_EXTENSIONS: string[] = [
|
||||
'txt',
|
||||
@@ -72,3 +74,11 @@ export function isTextFile(name: string): boolean {
|
||||
const ext = name.slice(dot + 1).toLowerCase()
|
||||
return TEXT_EXTENSIONS.includes(ext)
|
||||
}
|
||||
|
||||
/** 超多行预警阈值：超过该行数时提示滚动可能卡顿（虚拟滚动落地前的过渡防护） */
|
||||
export const HEAVY_LINES = 50000
|
||||
|
||||
/** 统计文本行数，切分规则与 diff 引擎一致（结尾换行不计数） */
|
||||
export function countLines(text: string): number {
|
||||
return splitLines(text).length
|
||||
}
|
||||
Reference in New Issue
Block a user