前言¶
DeepSeek Harness（DSH）的 Web 界面在长时间对话、宽表格或高 DPI 屏上，有时需要整体放大或缩小，而不是只改浏览器默认缩放（可能与 Harness 内嵌滚动区行为不一致）。社区插件 dsh-ctrl-zoom 在客户端侧为整个 Harness Web UI 提供类似浏览器页级缩放的手势：按住 Ctrl（macOS 上为 ⌘）配合滚轮或快捷键调整比例，并在非 100% 时在右下角显示当前级别。下面介绍插件定位、能力与安装用法。
这是什么¶
dsh-ctrl-zoom 是 maintainer jinmuxi1 发布的 DSH profile bundle（纯 ESM，无构建步骤、无运行时依赖），在 SkillHub 插件目录 中归类为客户端。npm 包名与 bundle 标识均为 dsh-ctrl-zoom（当前资料中版本 1.0.0，许可证 MIT）。Host 侧 index.js 的 apply() 为空，主要作用是让插件管理器能安装与切换；缩放逻辑运行在浏览器侧的 client.js。
核心功能¶
官方 README 中列出的交互如下。
| 手势 | 效果 |
|---|---|
Ctrl / ⌘ + 滚轮 |
以 10% 为步进放大或缩小，范围 50%–200% |
Ctrl / ⌘ + + / - |
与滚轮相同的步进缩放 |
Ctrl / ⌘ + 0 |
恢复 100% |
| 右下角比例胶囊 | − / + 步进；点击百分比一键回到 100% |
缩放级别写入浏览器 localStorage，下次打开页面会自动恢复。仅在比例不是 100% 时显示右下角胶囊，默认状态下不占用界面。
实现上对 <html> 使用 CSS zoom，使布局、文字与固定层一起缩放，并保留应用内滚动容器的行为；滚轮监听在 window 捕获阶段调用 preventDefault()，避免与浏览器原生页缩放叠加。若其它组件已处理该手势（event.defaultPrevented，例如内嵌编辑器或地图自带的 Ctrl+滚轮缩放），插件不会抢事件。卸载时通过 ctx.effect 清理胶囊、监听、样式与 zoom 属性。
隐私方面：插件不发起网络请求，仅读写一个 localStorage 键并设置文档元素的 zoom。
安装与启用¶
推荐从 npm 安装（资料原文步骤）。
- 在 DSH 侧边栏打开 Plugins。
- 选择 Add plugin，输入包名并安装：
dsh-ctrl-zoom
也可让 Harness Agent 执行：
plugin_manager action: install_bundle
target: dsh-ctrl-zoom
- 若 Web UI 已在运行，安装后刷新一次页面（
Ctrl/⌘+R）。
从 GitHub 或本地目录、tarball 安装时，同样使用 plugin_manager action: install_bundle，target 为仓库路径或 npm pack 生成的 .tgz 绝对路径；具体命令以 GitHub README 为准。
若曾安装旧包 dsh-ctrl-wheel-zoom，需先移除再装本插件，否则 Web 启动可能失败（旧 bundle 的 client 模块 id 与包名不一致）：
plugin_manager action: remove_bundle
target: dsh-ctrl-wheel-zoom
卸载：
plugin_manager action: remove_bundle
target: dsh-ctrl-zoom
典型用法¶
安装并刷新后，在 Harness Web 界面中：
- 按住 Ctrl（macOS 为 ⌘），向上或向下滚动鼠标滚轮，观察整体界面按 10% 步进在 50%–200% 之间变化。
- 需要精确复位时按 Ctrl+0（或 ⌘+0），或点击右下角胶囊上的百分比。
- 关闭页面再打开，确认比例仍为上次的设置（localStorage 恢复）。
适用场景与注意¶
- 适合：经常在 Harness Web GUI 中工作、希望用熟悉的「Ctrl+滚轮页缩放」习惯统一放大整个界面（含布局与固定层）的用户。
- 兼容性（资料原文）：在 DeepSeek Harness 0.2.1-rc.2 Web GUI（Electron 44）上测试；client 半部需要基于 Chromium 的 Harness shell，非浏览器 Host 下不生效。
- 安全与权限：插件以当前 DSH 进程及 Web 客户端上下文运行；安装前请自行查看 源码与 LICENSE，确认符合你的环境与合规要求。SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-ctrl-zoom 用少量客户端代码为 Harness Web UI 补上 Ctrl/⌘ 滚轮与快捷键页级缩放，并持久化比例、在非默认缩放时提供右下角反馈。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。
