` 宿主给的是 `flex: 1 1 auto`，不压住 flex 算法就会把缩小的布局盒重新撑回单元格（缩小档还会被反向压缩），结果是整栏比列宽还宽、顶栏那排按钮被挤到列外裁掉——2026-09-30 实测到的回归。 transform 臂**按栏打标**：只有「机制 = transform **且** 该栏确实不在 100%」的根才会被写上 `data-pane-scaling-transformed`，规则也只认这个标（`[data-pane-scaling-slot][data-pane-scaling-transformed]`）。单位变换 `scale(1)` 没有任何缩放收益，却同样会建立包含块与层叠上下文：真实 Firefox 会话里中栏停在 100%、被写上 `transform: matrix(1,0,0,1,0,0)` 后，会话头右上角的打开右栏按钮和 `对话 / 轨迹` 页签就消失了；只把该根的 `transform` 清成 `none` 即恢复。因此 100% 的栏完全不加 transform。 **打标位置会跳过工具栏**：一个栏的根如果同时含自己的工具栏（会话头，`[data-slot='conversation.header']`）， transform 就打在**工具栏下方的内容**上（`scaledElementFor`），根保持不缩放（transform 臂下由一条 `[data-pane-scaling-slot]{zoom:1}` 统一取消槽位根自己的 `zoom`）。这样： - 会话头在结构上落在 transform 之外——它既不会被 transform 影响，也不需要反向缩放，右上角的按钮与页签因此稳定（此前「transform 覆盖会话栏就会让它们消失」，`scale(1)` 与 `scale(1.1)` 都复现）； - 栏内其余部分（含女仆皮肤画在 `[data-composer-card]::before` 上的九宫格外框）由 transform 绘制， Gecko 下 `border-image` 的错位随之修好； - 工具栏占的高度由引擎实测写入 `--pane-scaling-toolbar-`，内容区按 `calc((100% - toolbar) / zoom)` 排布，视觉上正好接在工具栏下方、铺满剩余高度。实测（真实 GUI，中栏 120%，Firefox + Chromium，两臂）：头部恒为 `1414×40`、右上角按钮恒为 `28×28`； transform 臂下打标元素是 `DIV.SsMvdW_body`（不是根、不是头部），其视觉盒恒为 `280,40,1414,600` 即「工具栏下方、铺满」。机制选择：默认就是引擎探针（`'auto'` 的行为），`localStorage['dsh.plugin-scaling.mechanism']` 可以把任一侧钉死： | 值 | 行为 | | --- | --- | | 未设置（默认） | 引擎探针：Gecko → `transform`，其余 → `zoom` | | `'auto'` | 同默认 | | `'transform'` | 强制走 transform 臂 | | `'zoom'` | 强制走 zoom 臂（即使引擎是 Gecko） | 为什么敢把 Gecko 默认成 transform：真实反馈里「transform 覆盖会话栏 → 会话头控件消失」的触发条件已经定位清楚——单位变换同样会建立包含块与层叠上下文，而只要 transform 覆盖到工具栏就会出问题；现在打标位置跳过工具栏（见上），`scale(1)` 不再打标，栏内其余部分照常。用户在其环境（Firefox、左栏 0.9 / 中栏 1~1.2 / 右栏 1.3、女仆皮肤）实测通过。两条臂在真实 GUI 下几何一致：侧栏 360px、左栏 120% 时，Firefox 修复后与 Chromium 的渲染平均像素差 8/255（修复前 23/255），缎带左右端帽的实绘位置完全对齐。取舍：`transform` 会建立层叠上下文与包含块（`zoom` 不会），栏内 `position: fixed` 后代因此更接近自校准里的 `contained` 分支——判定本来就是探针在该栏内实测出来的；栏级装饰（在缩放根之外，例如女仆皮肤的侧栏金框）不受影响。 ### 每栏选臂：中栏固定 `zoom` 臂不是全局的，而是**按栏**决定（`ZOOM_ARM_SLOTS`）：中栏（会话）固定走 `zoom`，侧栏在 Gecko 上走 `transform`。原因来自实测反馈：真实 Gecko 会话里，transform 臂下在缩放过的**代码块**里拖选，选区会落到好几行外、左右也与鼠标不齐（换成 `zoom` 立刻正常）。`zoom` 让布局、光标映射与绘制处在同一坐标空间，这正是会话栏需要的；而 `transform` 的价值是 `border-image` 九宫格几何，那是侧栏缎带需要的。中栏唯一一处 `border-image` 装饰是皮肤的输入框外框，它在输入框座位上单独补一次变换（见下），所以两边都不损失。引擎按栏打 `data-pane-scaling-zoom-arm`：取消槽位 `zoom` 的那条规则用 `:not([...])` 放行这些栏，会话头的反向缩放也改为按这个标记生效（而不是按全局机制）。 ### 输入框外框：座位自己消 `zoom` 再补变换皮肤的输入框外框是 `[data-composer-card]::before` 上的 `border-image` 九宫格，Gecko 会按**未缩放**的盒子计算几何，于是中栏的 `zoom` 会把它右端帽拉长。中栏又必须留在 `zoom` 臂（见上），所以改由宿主 `[data-composer-seat]` 自己 `zoom: var(--counter)`（抵消继承的缩放）再 `transform: scale(var(--own))`：九宫格几何按 1:1 算一次、再整体按栏的倍数绘制，两个引擎都正确。抵消缩放让座位的内容按 1:1 排版，而 `transform` **不参与布局**：座位的布局盒仍是栏的整宽，缩放却从它左边缘把它画成 `own` 倍宽。于是居中的输入框被整体推开 `(own - 1) / 2 × 栏宽` （真实 GUI、1160px 栏：125% 实测 +143.4px，150% +287.8px，200% +576.0px；缩小档反向偏移， 50% 为 -290.3px），同时给会话滚动区带来同样量级的横向溢出（150% 实测 386px，转写区因此多出一条横向滚动条）。规则因此把画出来的盒子重新对回栏上，`min(1, own)` 一条覆盖两向： | 档位 | 布局宽 | 横向补偿 | 结果 | | --- | --- | --- | --- | | `own > 1` | `min(100%, 100% / own)` | 无 | 缩小布局盒后 `scale(own)` 正好从栏左缘铺满整栏 | | `own < 1` | `100%`（盒子本来就满栏，只有绘制变小） | `(1 - own) / 2` 的 `translateX` | 画出来的盒子居中 | 纵向锚点保持 `top left`（与 `zoom` 的锚点一致），所以这条补偿只动横向：输入框的纵向位置、滚动区高度、会话头都与修复前逐档一致。实测（真实 GUI，1160px 栏，Firefox 132 + Chromium 131，逐档 50 / 100 / 125 / 150 / 200%）：修复后**这条规则造成的偏移归零** —— 卡片中心与栏中心的偏差逐档等于「把这条规则整条中和」时的基线（两种浏览器上逐档残差 ≤0.02px）。Chromium 的基线自身还带 -3.5 ～ -7px 的偏差，那是宿主给滚动条预留 gutter 造成的（100% 档两个臂同为 -3.51px），与本插件无关。滚动区 `scrollWidth - clientWidth` 全部归零（修复前 125 / 150 / 200% 分别为 231 / 386 / 578px）；`cardBottom - scrollportBottom` 与修复前逐档相同，即纵向无回归。缩小档（如 50%）座位盒子按 `own` 倍居中变窄是这套补偿的预期形态：内容同样缩小，栏内可见区仍被子盒覆盖。卡片自身的绘制宽度也逐档回到中和基线（200% 档 1092px）——修复前那一档被同一条规则撑到 1424px，即超出宿主 `--dsh-composer-card-max-width` 在栏内应有的宽度，属于同一处双重缩放的副作用。 ### 终端：缩放后修正指针坐标 xterm.js 把指针位置换算成单元格需要两个量一致：单元格尺寸来自它自己测量元素的**布局**盒（`offsetWidth / 32`），指针位置来自事件的**视觉** `clientX/clientY` 减去 screen 元素的 `getBoundingClientRect()`。任何 CSS 缩放——`zoom` 或 `transform`，加在终端本身还是任意祖先上—— 都会让两者不一致，于是拖选整体偏移**正好一个缩放倍数**的单元格。它导出的 `getDomNodeZoomLevel` 看着像是能处理 `zoom`，但在 `@xterm/xterm@6.0.0` 里**从未被内部调用**。实测（真实 xterm，Firefox + Chromium；`zoom: 1.5` 与 `transform: scale(1.5)` 分别加在 wrapper、 host、终端自身共六种组合）：全部选中同样错误的单元格，换缩放机制也修不好。因此改在插件侧做**指针坐标修正**（`terminal-pointers.ts`）：指针落在被缩放的终端内时，把位置按 `1 / 缩放` 映射回终端自己的坐标空间并重放事件。拦截在 window 捕获阶段完成，重放事件带标记、不会被二次修正；映射锚点是 screen 元素，正是 xterm 相减的那个矩形；`mouseup` 结束这次手势。修正后同一套真实 xterm 测试在两个引擎、两种臂下都选中了正确单元格。终端保持使用当前机制（Gecko 上仍是 transform），不再需要为它单独保留 `zoom` 臂。 ### 会话头保持 100% 中栏顶部那一行（会话标题、视图页签、打开右栏的按钮，即宿主 `[data-slot='conversation.header']` 整块，含其下的页签行）**不跟着中栏缩放**：它是这一栏的工具栏，跟着放大只会挤掉内容。做法是对它做一次反向缩放—— ```css body[data-dsh-plugin-scaling] [data-pane-scaling-slot]:not([data-pane-scaling-transformed]) [data-slot='conversation.header'] { zoom: var(--pane-scaling-counter); } ``` 反向缩放的盒子与内容会互相抵消：头部自身按 1:1 排版（字号、按钮、页签都不变），它在栏里占的高度仍是自然高度（中栏 120% 时实测 39px，未处理前是 48px），下方内容紧接着从那里开始；头部在横向依旧铺满整栏。该规则避开 transform 臂（那一臂缩的是绘制结果，嵌套 `zoom` 会互相打架），因此只有 `zoom` 臂的栏会命中——中栏现在恒走 `zoom`。实测（Firefox / Chromium，中栏 100% / 120% / 150%）：头部恒为 `1414×40`、右上角按钮恒为 `28×28`。 ## 浏览器支持与自校准 - 需要支持 CSS `zoom` 的引擎；不支持时插件**完全不激活**（不写属性、不装监听），并在控制台留一条说明。 - 首次真正改值时会在该栏内插一次不可见探针，实测两件事，然后写 `body[data-pane-scaling-fill]` / `body[data-pane-scaling-fixed]` 让对应补偿规则生效： 1. 内容根外盒是否随缩放一起变大（`fluid` / `compensated`）； 2. 栏内 `position: fixed` 后代是否只被缩放（`scaled`）还是连包含块也变了（`contained`）。 - 校准只跑一次，并会 `console.info('pane scaling: calibration result', …)` 打一条测量载荷；反馈问题时请附上这条日志。 - 探针测不出布局的环境（例如 jsdom）按「不做任何补偿」处理。 ## 手势归属 1. 排除面（`[data-dockkit-float]`、`[data-document-zoom-*]`）→ 一律放行。中栏顶部的会话头（`[data-slot='conversation.header']`）也在此列：它是栏工具栏、本来就不跟着栏缩放，指针落在它上面时把 `Ctrl+滚轮` 交回浏览器做**整页（全局）缩放**——脚本没法驱动浏览器自身的页面缩放，放行是唯一办法。键盘路径沿用既有回退（没有栏在下面时仍作用上次用过的栏），与预览一致。终端不在此列：`Ctrl+滚轮` 落在侧栏终端上时缩放该栏（终端是分栏内容），不再触发浏览器整页缩放。 2. 已标记的内容根 → 用它的槽位（右栏分栏即在此分开）。 3. 栏级装饰等未标记元素 → 所属列；右栏分栏分隔条用「该列最近一次用过的槽位」。 4. 都不匹配 → 放行（浏览器原生缩放）。 `Ctrl+滚轮` 命中时才 `preventDefault()`，但**不** `stopPropagation`；滚轮累计余数在切换槽位或 200ms 空闲后清零。 ## 构建预设来源与许可 `build/tsdown.client.ts` 与 `build/web-platform.ts` 逐字 vendored 自 [`dsh-deep-whale/orca-link/build/`](https://github.com/Small-tailqwq/dsh-deep-whale)（MIT），后者镜像了 [`zhu1090093659/dsh-web-ui`](https://github.com/zhu1090093659/dsh-web-ui) 的共享皮肤工程预设（作者 Solitude）。保留原文件头注释；构建时 tsdown 对 `external` / `noExternal` 的弃用提示来自上游预设，未作改动。 ## 仓库约定 - `lib/` 是提交型产物；`.gitignore` 忽略 `node_modules/`、`*.js.map`、`pnpm-lock.yaml`。 - `pnpm-workspace.yaml` 里 `autoInstallPeers: false`：`@deepseek-ai/dsh` 只是兼容性声明（运行时由 profile 提供），自动安装它会把整个 DSH 应用与一批被 pnpm 拦截的原生构建脚本拖进这个独立插件仓库。 - `.plan/` 是本地计划与调研材料，不随包分发。