全局界面缩放 DC-507/dsh-zoom

dsh-zoom

为 DeepSeek Harness 网页客户端提供全局 UI 缩放：用键盘缩放整个界面 —— 侧边栏、菜单、设置、浮层和对话。

非官方社区插件。与 DeepSeek 无隶属关系，未获其认可，也非其发布。

为什么需要它

DeepSeek Harness 只提供一个排版设置 ui-theme.fontSize，它只影响对话正文。侧边栏标签、菜单和设置界面都是固定像素尺寸，应用也没有页面缩放：菜单里没有 View/zoom 相关角色，代码里也没有暴露 setZoomLevel/zoomFactor。所以开箱即用时 Cmd + = 毫无反应。这个插件补上了这一点。

安装

在应用内 —— 侧边栏 → Plugins → Add plugin，然后输入：

github:DC-507/dsh-zoom

Host 会读取这个 spec，确认包是 bundle，然后安装。安装完成后选择 Enable now。（之后可能会发布 npm 版本；那样更短的 dsh-zoom spec 也能用。）

在终端里（自带命令行）：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:DC-507/dsh-zoom

重启是激活它最稳妥的方式；开了 HMR 的配置档通常自己就会重新组合。

快捷键

| 快捷键 | 操作 |
| Cmd/Ctrl + =（也支持 Cmd/Ctrl + Shift + =，即 +） | 放大一档 |
| Cmd/Ctrl + - | 缩小一档 |
| Cmd/Ctrl + 0 | 回到 100% |

档位：80 · 90 · 100 · 110 · 125 · 150 · 175 · 200 %。缩放级别持久化在 localStorage（dsh-zoom:level），下次启动时恢复。要写脚本或调试，页面暴露了 __dshZoom.get()、__dshZoom.set(1.25)、__dshZoom.step(±1) 和 __dshZoom.reset()。

工作原理

- 缩放用的是 document.documentElement.style.zoom —— Chromium 标准化的 CSS zoom 属性。它必须落在根元素上：缩放外层容器会让应用框架塌掉（#root 高度量出来是 0），还会冒出横向滚动条。
- 因为 CSS zoom 不会重新缩放视口单位，插件还注入了一小段 !important 补丁，处理少数残留的 max-height: calc(100vh …) / 100dvh 浮层钳制（菜单滚动区域、风险确认对话框、toast、图片灯箱）。这些规则用哈希类名定位，所以每条都只在运行中的构建里存在时才应用；换到别的构建，补丁就是空的，核心缩放不受影响。
- 快捷键是 window 上捕获阶段的 keydown 监听器。shell 自己在捕获阶段往 document 上派发快捷键，所以 window 监听器先跑；这个组合键会被 preventDefault + stopImmediatePropagation 吃掉，编辑器、终端和输入框都看不到它。
- 持久化用 localStorage，在桌面 shell 的 dsh-app://app 源上是真实且持久的（注册为 standard + secure，默认会话，无 CSP）。

已知限制

- 画布类面板（xterm 终端、Monaco 编辑器、PDF/表格预览）按未缩放尺寸栅格化，倍率一高就有点糊。每次变化都会派发 resize，让它们重新测量。
- 焦点在侧栏浏览器/预览的 <webview> 或 iframe 里时，快捷键不生效——先点一下主窗口。
- macOS 红绿灯按窗口点定位，不参与缩放。超过 125% 时检查顶部条和窗口拖拽区。
- 在普通浏览器里（不是桌面外壳），Cmd + = 是浏览器自带的缩放；本插件会调用 preventDefault，所以页面缩放被插件的 CSS 缩放顶掉。
- 应用自带 immediately: true 预取，模块在启动时就加载；像本插件这样的插件，遇到把每个哈希类名都改掉的构建版本，没有发版就没法适配。

兼容性

在 macOS 上针对 DeepSeek Harness 0.2.0-rc.2（Electron 44 / Chromium 152）测试。它故意不声明 @deepseek-ai/dsh* 对等依赖：宿主侧只是一个空的 apply()，浏览器侧只用标准 DOM API，所以没什么需要按版本卡。视口单位补丁是唯一跟构建版本相关的部分，失效时退化为空操作。

开发

npm test # smoke test: DOM stub, no dependencies

backup/、launch-big.sh 和 rollback.sh 是本地开发辅助文件，files 已把它们排除在发布的 tarball 之外。

想对着已安装的实例迭代：

dsh plugin --profile desktop add "link:$PWD" # symlinked install, edits are live after a reload
dsh plugin --profile desktop remove dsh-zoom

许可证

MIT——见 LICENSE。

dsh-zoom（中文）

DeepSeek Harness Web 客户端的整体界面缩放插件：侧栏、菜单、设置、浮层、对话一起放大，用快捷键控制。

非官方社区插件，与 DeepSeek 无隶属关系。

为什么需要它

DSH 只提供一个排版设置 ui-theme.fontSize，而且只影响对话正文；侧栏、菜单、设置页都是固定像素，应用本身也没有页面缩放（菜单里没有 View/缩放角色，代码里没有 setZoomLevel/zoomFactor），所以 Cmd + = 默认没有任何反应。

安装

应用内：侧栏 插件 → Add plugin，填 github:DC-507/dsh-zoom，装完点 Enable now。命令行同样可以：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:DC-507/dsh-zoom

| 快捷键 | 动作 |
| Cmd/Ctrl + =（或 Cmd+Shift+=） | 放大一档 |
| Cmd/Ctrl + - | 缩小一档 |
| Cmd/Ctrl + 0 | 回到 100% |

档位 80/90/100/110/125/150/175/200%，存在 localStorage，重启保留。

实现要点

缩放用标准 CSS zoom 挂在 上；挂包裹元素会把 #root 压成 0 高度并出现横向滚动条。由于 CSS zoom 不缩放视口单位，插件会为少数 100vh/100dvh 浮层钳制规则注入带 !important 的补丁，且这些规则按类名哈希存在才注入，换版本后自动变成空补丁而不影响主体。快捷键走 window 捕获阶段，早于外壳在 document 上的派发器。

已知限制

画布类面板（终端、Monaco、PDF/表格预览）高倍率下略糊；焦点在侧栏 <webview>/iframe 里时快捷键不生效；macOS 红绿灯不参与缩放，125% 以上请留意顶栏拖拽区；在普通浏览器里会顶掉浏览器自带的页面缩放。

许可证

MIT，见 LICENSE。