Skip to content

A local-first multi-agent app development platform, built on PenguinHarness

docs(changelog): 5.51 的中英对照按本仓写法补齐(上一笔提交的是上游原文)

lmliheng2ef1052a72ad
diff --git a/changelog/unreleased/2026-10-27-dock-composer-overlap.md b/changelog/unreleased/2026-10-27-dock-composer-overlap.md
index f9e74ad8..55f52588 100644
--- a/changelog/unreleased/2026-10-27-dock-composer-overlap.md
+++ b/changelog/unreleased/2026-10-27-dock-composer-overlap.md
@@ -1,12 +1,51 @@
# The bottom dock no longer covers the composer
-- **Date:** 2026-10-25
+- **Date:** 2026-10-27
- **Type:** fix
- **Scope:** `web`
-- **PR:** [#1325](https://github.com/Prism-Shadow/penguin-harness/pull/1325)
+- **Breaking:** no
-[中文版](2026-10-25-dock-composer-overlap.zh.md)
+[中文](2026-10-27-dock-composer-overlap.zh.md)
-At its largest docked size the bottom dock, and the merged dock below the narrow breakpoint, now stops above the composer. It used to reach 85% of the chat column, toolbar included, which on most windows left the composer too little room: the composer slid under the dock and could not be clicked, and with a wallpaper the two showed through each other.
+At its largest docked size the bottom dock, and the merged dock below the narrow breakpoint, now
+stops above the composer. It used to reach 85% of the chat column, toolbar included, which on most
+windows left the composer too little room: the composer slid under the dock and could not be
+clicked, and with a wallpaper the two showed through each other.
-The docked maximum leaves the composer its full height and a strip of messages above it, tall enough for the launcher ball with its caption and for the back-to-bottom button. When the composer grows (more lines, attachments, a notice) or the window gets shorter, the dock gives way at once and comes back when the room returns; the stored height stays as it was. In a very short window the message strip gives way first, then the dock's own minimum height, and the composer never does. A boundary drag stops at the new maximum, stores the height the dock shows, and still snaps into fullscreen when pulled past it. Fullscreen still covers the composer.
+The docked maximum leaves the composer its full height and a strip of messages above it, tall
+enough for the launcher ball with its caption and for the back-to-bottom button. When the composer
+grows (more lines, attachments, a notice) or the window gets shorter, the dock gives way at once
+and comes back when the room returns; the stored height stays as it was. In a very short window
+the message strip gives way first, then the dock's own minimum height, and the composer never
+does. A boundary drag stops at the new maximum, stores the height the dock shows, and still snaps
+into fullscreen when pulled past it. Fullscreen still covers the composer.
+
+## Details
+
+- `packages/web/src/features/dock/bottom-dock-size.ts` (new, pure): the rule itself —
+ `bottomDockMaxHeight` is what the area below the toolbar leaves once the composer and a message
+ strip (`CONVERSATION_MIN_HEIGHT_PX`, the launcher's own shortest-body figure) have their room,
+ still capped by the stored ratio's `DOCK_RATIO_MAX`; `bottomDockHeight` clamps a stored ratio to
+ it. The size constants moved here, and `dock-state.ts` imports `DOCK_RATIO_MAX` back.
+- `packages/web/src/features/dock/composer-height.ts` (new): a tiny store fed by a
+ `ResizeObserver` ref, so the dock, its drag clamp and the drag overlay's landing preview read the
+ same composer height; the last measurement outlives a remount, so a dock at its ceiling does not
+ jump up and back down when a conversation switch rebuilds the composer.
+- `packages/web/src/features/dock/dock-panel.tsx`: measures the column and the area
+ (`[data-dock-host]` / `[data-dock-area]`), draws with the new function, and gives way in the same
+ commit (through the existing `snap` path) when the ceiling drops below the dock, instead of
+ through the layout motion.
+- `packages/web/src/features/dock/dock-drag.tsx`: the landing preview uses the same function.
+- `packages/web/src/features/chat/chat-page.tsx`: the composer box carries the measuring ref. This
+ tree's composer is a plain `<div>` — upstream hands the ref to its wallpaper surface, which this
+ tree does not have.
+- `packages/web/e2e/dock.spec.mjs`: "sizes and the arrangement survive a reload" runs at
+ 1280×1100; at the default 1280×720 the bottom dock's default height is already at the ceiling, so
+ its upward drag has no room to grow.
+- Ported from upstream `bf3395ff` (#1325), applied as its own change rather than merged; its
+ source-reading case in `test/bottom-dock-size.test.ts` was adjusted to this tree's composer box.
+
+## Compatibility
+
+- No dependency, stored-data, package-name or config change. A stored ratio (up to 0.85) renders
+ at the new ceiling; the next drag stores the height the dock shows.
diff --git a/changelog/unreleased/2026-10-27-dock-composer-overlap.zh.md b/changelog/unreleased/2026-10-27-dock-composer-overlap.zh.md
index 3f2e0c1d..6611a8b1 100644
--- a/changelog/unreleased/2026-10-27-dock-composer-overlap.zh.md
+++ b/changelog/unreleased/2026-10-27-dock-composer-overlap.zh.md
@@ -1,12 +1,43 @@
# 底部停靠栏不再盖住输入区
-- **Date:** 2026-10-25
+- **Date:** 2026-10-27
- **Type:** fix
- **Scope:** `web`
-- **PR:** [#1325](https://github.com/Prism-Shadow/penguin-harness/pull/1325)
+- **Breaking:** no
-[English](2026-10-25-dock-composer-overlap.md)
+[English](2026-10-27-dock-composer-overlap.md)
-底部停靠栏(以及窄屏下合并成的底部停靠面)在停靠状态下拉到最大时,现在停在输入区上方。此前它最高可占对话列(含工具行)的 85%,多数窗口里留给输入区的高度不够:输入区被压到停靠栏下面、点不到,设了壁纸时两者还会互相透出来。
+底部停靠栏(以及窄屏下合并成的底部停靠面)在停靠状态下拉到最大时,现在停在输入区上方。此前它最高
+可占对话列(含工具行)的 85%,多数窗口里留给输入区的高度不够:输入区被压到停靠栏下面、点不到,设了
+壁纸时两者还会互相透出来。
-停靠状态的最大高度给输入区留出完整高度,并在其上留一条消息带,容得下快捷方式悬浮球及其小字和回到底部按钮。输入区变高(多行输入、附件、提示条)或窗口变矮时,停靠栏即时让出,空间回来后再恢复,记住的高度不变。窗口很矮时先让出消息带,再让出停靠栏自身的最小高度,输入区始终完整。拖动边界停在新的最大值,记住的是停靠栏显示出来的高度,越过最大值照旧跳变为全屏。全屏仍然盖住输入区。
+停靠状态的最大高度给输入区留出完整高度,并在其上留一条消息带,容得下快捷方式悬浮球及其小字和回到底部
+按钮。输入区变高(多行输入、附件、提示条)或窗口变矮时,停靠栏即时让出,空间回来后再恢复,记住的高度
+不变。窗口很矮时先让出消息带,再让出停靠栏自身的最小高度,输入区始终完整。拖动边界停在新的最大值,
+记住的是停靠栏显示出来的高度,越过最大值照旧跳变为全屏。全屏仍然盖住输入区。
+
+## 细节
+
+- `packages/web/src/features/dock/bottom-dock-size.ts`(新增,纯逻辑):规则本身 ——
+ `bottomDockMaxHeight` 是工具行以下那片区域扣掉输入区与一条消息带
+ (`CONVERSATION_MIN_HEIGHT_PX`,取悬浮球自己「最短的完整身子」那个数)之后剩下的高度,仍受所存比例
+ 的 `DOCK_RATIO_MAX` 封顶;`bottomDockHeight` 把所存比例夹到它以内。尺寸常量一并搬到这里,
+ `dock-state.ts` 反过来从这里取 `DOCK_RATIO_MAX`。
+- `packages/web/src/features/dock/composer-height.ts`(新增):一个 `ResizeObserver` 喂的小 store,
+ 让停靠栏、它的拖动夹取与拖动浮层的落点预览读同一个输入区高度;最后一次测量在重挂载后仍然留着,
+ 切会话时重建输入区不会让已经到顶的停靠栏先跳上去再落下来。
+- `packages/web/src/features/dock/dock-panel.tsx`:量出对话列与那片区域(`[data-dock-host]` /
+ `[data-dock-area]`),用新函数决定画多高;上限跌破停靠栏高度时在同一个提交里让出(走既有的
+ `snap` 路径),不经过主题的布局动画。
+- `packages/web/src/features/dock/dock-drag.tsx`:落点预览用同一个函数。
+- `packages/web/src/features/chat/chat-page.tsx`:输入区那个框挂上测量 ref。本树的输入区是一个普通
+ `<div>` —— 上游把 ref 交给它的壁纸面,而本树没有那个组件。
+- `packages/web/e2e/dock.spec.mjs`:「尺寸与排布在刷新后仍在」这条改在 1280×1100 下跑;默认的
+ 1280×720 下底部停靠栏的默认高度已经到了新上限,那条往上拖的用例就没有生长空间了。
+- 移植自上游 `bf3395ff`(#1325),照改动落、不是合分支;`test/bottom-dock-size.test.ts` 里那条读源码
+ 的用例按本树的输入区结构改了一处。
+
+## 兼容性
+
+- 不改依赖、不改已存数据、不改包名与配置格式。已存的比例(最高 0.85)直接按新上限画出来,下一次拖动
+ 记住的是停靠栏显示出来的高度。