前言¶

在 DeepSeek Harness（DSH）里做智能体或长时间盯 Web 界面时，字号和布局密度往往取决于浏览器默认缩放。系统级缩放会连带其它标签页；若应用内没有统一的页面缩放入口，只能靠浏览器菜单或快捷键，和 Harness 自身的设置页也不在同一套交互里。dsh-ctrl-wheel-zoom 是面向 Harness Web GUI 的客户端插件：用熟悉的 Ctrl（macOS 为 ⌘）+ 滚轮或键盘加减号调整整页缩放，并在界面右下角提供缩放芯片，在 Settings → General 增加一行 Page zoom。缩放比例写入浏览器 localStorage，刷新后仍保留；禁用或卸载插件时会移除监听器、样式和已应用的 zoom。

这是什么¶

• 名称：dsh-ctrl-wheel-zoom（仓库 Inoue-Cyrene/dsh-ctrl-wheel-zoom）
• 维护者：Inoue-Cyrene
• 分类：客户端（platform: "web"，无浏览器环境时客户端半部不生效）
• 形态：普通 DSH profile bundle，纯 ESM，无构建步骤、无运行时依赖；当前资料中的版本为 1.0.1，许可证 MIT

插件在文档根元素上使用 CSS zoom 做页面缩放，使布局、文字与固定层一并缩放，行为接近浏览器自带页面缩放，同时保留应用内滚动容器可用性。

核心功能¶

其它行为（资料原文）：

• 缩放级别保存在浏览器 localStorage。
• 插件被禁用或卸载时，会移除所有监听、样式表以及已应用的 zoom。
• 若其它组件已对同一手势调用 preventDefault()（例如内嵌代码编辑器或自带 Ctrl+滚轮缩放的地图），本插件不会抢占该手势。

主机侧 index.js 的 apply() 为空，主要供 bundle 安装与开关；手势、状态、芯片与设置行注册在 client.js。

安装与启用¶

可通过 Harness 智能体安装，或自行调用插件管理器。安装目标可以是绝对路径、.tgz 压缩包，或已发布的包名（见下文 npm 方式）：

plugin_manager  action: install_bundle
                target: <absolute path to this package / a .tgz / a published name>

install_bundle 会把包链入当前 profile（$DSH_PROFILE_DIR），写入 profile 的 bundle 列表，并由 Harness 热应用。若页面此前已打开，刷新一次以加载浏览器侧逻辑。

手动安装时：在 $DSH_PROFILE_DIR/package.json 的 dependencies 与 dsh.profile.bundles 中加入该包，然后重启 Harness。

按名称安装（包已发布到 npm 时，包名为 dsh-ctrl-wheel-zoom）：

plugin_manager  action: install_bundle
                target: dsh-ctrl-wheel-zoom

卸载：

plugin_manager  action: remove_bundle
                target: dsh-ctrl-wheel-zoom

环境要求（README Requirements）：

• 需要 Harness Web GUI。
• 包本身无 dependencies、无构建产物、无 install scripts；react、@deepseek-ai/dsh-client-store 等由 shell 自带模块表提供。
• package.json 中 engines.node 为 >=22（主要约束包元数据环境；客户端半部在浏览器运行）。

典型用法¶

1. 安装并启用 bundle 后，在 Web 界面按住 Ctrl（macOS 为 ⌘），滚动鼠标滚轮，观察页面在指针附近放大或缩小。
2. 需要精细调整时，使用 Ctrl/⌘ + + 或 -，或 Ctrl/⌘ + 0 回到 100%。
3. 缩放偏离 100% 后，查看右下角芯片：点百分比复位，或点 Fit to width 按窗口宽度适配。
4. 打开 Settings → General，用 Page zoom 行的 stepper 与重置按钮与手势保持一致（芯片、设置行与滚轮监听共享同一 store 实例）。

分发给他人时，README 列出三种方式：本地 pnpm pack 得到 dsh-ctrl-wheel-zoom-1.0.0.tgz 后按路径安装；打包未构建的目录 zip/仓库路径安装；或发布到 npm 后按包名 dsh-ctrl-wheel-zoom 安装。DSH 运行时自带 pnpm，打包 tarball 不必预先全局安装 pnpm。

适用场景与注意¶

适合谁

• 经常在 Harness Web UI 上阅读长对话、配置或密集面板，希望用桌面浏览器常见的 Ctrl+滚轮习惯做整页缩放的用户。
• 需要缩放状态在单次浏览器会话外仍可记住（localStorage）的场景。

使用前请知悉

• 插件以当前 DSH 进程及你所安装的 profile bundle 权限运行；安装前请阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。
• 社区目录 SkillHub 插件页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装命令以 README 中的 plugin_manager 为准，不要凭仓库名自行拼接未在文档出现的 CLI。
• 仅 Web 客户端生效；无浏览器时客户端逻辑不运行。

结尾¶

dsh-ctrl-wheel-zoom 把整页缩放、可视反馈和 General 设置行收进一个无构建的 DSH bundle，并避免与已处理 Ctrl+滚轮的内嵌组件抢手势。需要进一步了解实现细节（cordis.patch.yml、client.js 捕获阶段监听等）可直接阅读仓库 README。

• 目录页：https://www.skillhub.cn/plugins/Inoue-Cyrene/dsh-ctrl-wheel-zoom
• GitHub：https://github.com/Inoue-Cyrene/dsh-ctrl-wheel-zoom