@young1lin/dsh-ui-gitworkbench 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 本文件记录面向使用者的变更。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
+## [0.1.8] - 2026-08-20
+
+紧急修复版：一次点击卡住三秒半，以及 Compare 里看不到内容的文件。
+
+### 性能
+
+- **打开一个长文件不再卡住界面**。并排 diff 此前把整个文件的每一行都铺进 DOM（两列），shiki 还把每一行单独重新分析一遍着色——开销跟**文件长度**成正比，跟你改了多少行毫无关系。实测两个各只改了 1 行的文件：22 行的花 349ms，4000 行的花 3868ms，其中有**连续 3587ms 页面上什么都不动**，DOM 里 8000 个单元格、112000 个 `<span>`。护栏还允许 20000 行的文件进来，那是这个数的五倍。现在只渲染视口内的行（上下用占位撑住，滚动条仍然是**文件**的长度），两遍 shiki 也只在窗口内跑（向上多读 240 行做上下文，从块注释中间开始的切片也能正确着色）。同一个 4000 行文件：**235ms，最长掉帧 89ms，162 个单元格**。判据不是快了多少倍——15000 行现在 327ms，渲染的还是那 162 个单元格，开销与文件长度脱钩了。400 行以下的文件整体渲染，和以前完全一样。
+- **轮询不再传输一份没人要的补丁**。`stats` 每 3 秒（agent 运行时）跑一次，此前每次都对整个工作树跑 `git diff HEAD` 再截断到 40 万字符。在一个 9 万行改动的工作树上实测：`status` 约 110ms、`--numstat` 约 140ms，而 `git diff HEAD` 要 **595ms 并产出 7.43MB，其中 94.6% 被截断丢弃**。文件树和计数只需要前两个，屏幕上那个文件的 diff 本来就是按需拉的。代价是选中文件时多一次往返，所有仓库都如此——这是刻意的选择：一份"小仓库正确、大仓库悄悄截断"的捆绑补丁是两套行为，而那个阈值从外面根本看不见。
+
+### 修复
+
+- **Compare 里新增或修改的文件显示不出内容**（XML 尤其明显，同一个文件在 History 和 Files 里都正常）。Compare 把一整块补丁截断到 40 万字符再按文件切分，截断点之后的文件就没有内容了——而单文件按需拉取这条路，Compare **根本没有走**：`fileDiff` 接不了 ref range，代码里明写着这个限制。现在它能接了（`base...head`，无共同祖先时退回两端点 diff，和 Compare 页签本身一致），且不缓存，因为 ref 是会移动的指针。复现仓库里那个文件：问工作区得到 0 字节，问 `base...head` 得到 220877 字节。
+
+## [0.1.7] - 2026-08-20
+
+### 新增
+
+- **History 页签保留两种排布，由你决定用哪种**，默认是并排三栏。0.1.6 把这个页签改成了上下分，理由是实测的：三栏时提交列表只有约 420px，每条标题都带省略号。但它是拿另一个轴换来的——列表从十三行高变成「差异区上面剩多少」。两边各有代价，所以它该是个选项，不是一个修复。开关在 `Branch` 那一行的右端，两个图标按钮；选择记在浏览器里，重开还在。两种排布**各记各的尺寸**：三栏拖的是宽度，上下分拖的是高度，来回切不会互相冲掉。提交行也跟着变形——并排时是两行（作者与时间在标题上方，因为 340px 一栏塞不下 hash、作者、时间和标题四样），上下分时是一行，按 `git log --oneline` 的顺序。
+
+### 修复
+
+- **提交列表标题栏挤不下时改为换行，不再把搜索框裁在面板边缘**。把那一栏拖窄，标题 + `Filter by` + 搜索框放不下，此前是把搜索框在面板边界处切断——一个露出一半、且没有任何迹象表明还有另一半的控件。
+
 ## [0.1.6] - 2026-08-20
 
 ### 新增

package/CHANGELOG_EN.md

@@ -2,6 +2,30 @@
 
 User-facing changes, newest first. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows SemVer.
 
+## [0.1.8] - 2026-08-20
+
+An urgent fix release: one click that froze the page for three and a half
+seconds, and files that showed nothing on the Compare tab.
+
+### Performance
+
+- **Opening a long file no longer freezes the pane.** The side-by-side diff put every line of the whole file into the DOM in two columns, and Shiki re-lexed every one of those lines individually — a cost proportional to the file's LENGTH, with no relation to how much of it changed. Measured on two files with exactly one changed line each: 22 lines cost 349ms, 4,000 lines cost 3,868ms, including **3,587ms during which nothing on the page moved**, with 8,000 cells and 112,000 `<span>`s in the DOM. The guard admits files up to 20,000 lines, five times that again. Only the rows in view are rendered now (spacers stand in for the rest, so the scrollbar is still the length of the FILE), and both Shiki passes run inside that window, with 240 lines of lead-in so a slice starting inside a block comment still lexes in context. The same 4,000-line file: **235ms, worst frame 89ms, 162 cells.** The number that matters is not the ratio — 15,000 lines now costs 327ms and renders the same 162 cells, so the cost is the viewport's rather than the file's. Files of 400 rows or fewer render whole, exactly as before.
+- **The poll stops shipping a patch nobody asked for.** `stats` runs every 3 seconds while an agent is working, and each time it ran `git diff HEAD` over the whole worktree and clipped the result to 400,000 characters. Measured on a worktree with 90,000 changed lines: `status` ~110ms, `--numstat` ~140ms, and `git diff HEAD` **595ms producing 7.43MB, of which the clip discarded 94.6%**. The tree and the counters need only the first two, and the diff of the file actually on screen was already fetched on demand. The trade is one round trip when a file is selected, on every repository — chosen deliberately, because a bundled patch that is correct only below a size threshold is two behaviours, and the threshold is invisible from outside.
+
+### Fixed
+
+- **Added or modified files showed no content on the Compare tab** (most visibly XML, where the same file read correctly in History and in Files). Compare clips one combined patch at 400,000 characters and splits it per file, so everything past the cut had no content — and the per-file fallback every other tab uses was never taken there: `fileDiff` could not accept a ref range, a limitation the code stated outright. It can now (`base...head`, falling back to the two-tip diff when unrelated histories leave no merge base, exactly as the Compare tab itself does), and deliberately without caching, since a ref name is a moving pointer. On the file in the fixture: asking the working tree returned 0 bytes; asking `base...head` returned 220,877.
+
+## [0.1.7] - 2026-08-20
+
+### Added
+
+- **The History tab keeps both arrangements and you pick**, defaulting to the three columns. 0.1.6 stacked the tab for a measured reason — in three columns the commit list had about 420px and every subject was ellipsised — but it paid for that in the other axis: the list went from thirteen rows tall to whatever is left above the diff. Both cost something, which makes this a choice rather than a fix. The switch is at the end of the `Branch` row, two icon buttons; the choice is remembered per browser. Each arrangement **keeps its own size**: side by side you drag a width, stacked you drag a height, and switching back finds the pane where you left it. The commit row changes shape with it — two lines beside the diff, where a 340px column cannot hold a hash, an author, a date and a subject; one line when it spans the drawer, in `git log --oneline`'s order.
+
+### Fixed
+
+- **The commit list's head wraps instead of clipping its search box at the pane's edge.** Dragged narrow, the pane cannot hold a title, a `Filter by` button and a search box on one line, and what it used to do was cut the search box off at the pane boundary — a control showing half of itself, with nothing to say the other half existed.
+
 ## [0.1.6] - 2026-08-20
 
 ### Added