滚轮缩放 Inoue-Cyrene/dsh-ctrl-wheel-zoom

Ctrl + Wheel Zoom

按住 Ctrl（macOS 上是 ⌘）滚动鼠标滚轮，就能缩放整个 Harness Web UI。
这是 DeepSeek Harness Web GUI 的页面缩放插件，以普通 DSH 配置档 bundle 的形式分发：无需构建，无运行时依赖，纯 ESM。

功能

| 操作 | 效果 |
| Ctrl / ⌘ + 滚轮 | 以指针为中心缩放页面，范围 50%–200%，每步 10% |
| Ctrl / ⌘ + + / - | 键盘操作，效果相同 |
| Ctrl / ⌘ + 0 | 恢复 100% |
| 缩放标签（右下角） | 缩放级别不是 100% 时出现：点百分比可重置，点 Fit to width 适配窗口 |
| Settings → General | 一行 Page zoom，沿用宿主的步进器样式，带重置按钮 |

选定的缩放级别会记在浏览器里（localStorage）。插件被禁用或卸载时，所有监听器、样式表和已应用的 zoom 属性都会移除。

如果某个手势已被其他组件处理（preventDefault()，比如内嵌代码编辑器或地图自带 Ctrl+滚轮缩放），插件绝不会抢过来。

安装

让 Harness 智能体帮你安装，或者自己调用插件管理器，用绝对路径、tarball 或已发布的包名指定包：

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

install_bundle 会把包链接进当前配置档（$DSH_PROFILE_DIR），加入配置档的 bundle 列表，Harness 随即热应用。已经打开的页面刷新一次，就能加载浏览器端那部分。

想手动安装，就把包加进配置档的依赖，并写入 $DSH_PROFILE_DIR/package.json 里的 dsh.profile.bundles，然后重启 Harness。

卸载

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

要求

- Harness Web GUI（客户端部分声明了 platform: "web"；没有浏览器它不会生效）。
- 别无其他：这个包没有依赖、没有构建产物、没有安装脚本。内置客户端模块（react、@deepseek-ai/dsh-client-store）来自 shell 自己的模块表。

分享与发布

这个包自包含，所以有三种方式交给别人。

1. tarball

pnpm pack # writes dsh-ctrl-wheel-zoom-1.0.0.tgz

把这个 .tgz 发出去，接收方按路径安装：

plugin_manager action: install_bundle
target: <path to dsh-ctrl-wheel-zoom-1.0.0.tgz>

（pnpm pack 会把 tarball 写在 package.json 旁边。DSH 自己的运行时自带 pnpm，所以什么都不用先装。）

2. 目录（zip / 仓库）

把这个文件夹打包成 zip（或推到 Git 仓库），让接收方按路径安装解压后的目录——install_bundle 接受目录，因为没有构建步骤，一个文件夹就够了。

3. npm（按名称安装，人人可用）

这份 manifest 已经可以直接发布：name 是不带作用域的 dsh-ctrl-wheel-zoom，cordis.patch.yml 里那一行写的也是同一个 specifier，而且没有 "private": true。

npm 不再签发长期有效的「classic」token —— 它们已于 2025-12-09 被永久吊销 —— 并且发布需要双因素认证。下面两条路选一条走：

A. A granular access token created with "Bypass two-factor authentication" enabled,
stored once as a credential:
//registry.npmjs.org/:_authToken=npm_... in ~/.npmrc
pnpm publish --no-git-checks

B. Any write token, with a one-time password supplied per publish:
pnpm publish --no-git-checks --otp=<6-digit code>

没有开启 bypass-2FA 的 token 会被拒绝，报错为 403 ... Two-factor authentication or granular access token with bypass 2fa enabled is required to publish packages。先确认 token 到底能做什么，再怪命令：

curl -H "Authorization: Bearer $TOKEN" https://registry.npmjs.org/-/npm/v1/tokens
"bypass_2fa": false → use --otp, or recreate the token with the switch on
"permissions": [{"name":"package","action":"write"}] → publishing is permitted at all

注意 npm 明确的方向：bypass-2FA token 正在走向淘汰（目标时间是 2027 年 1 月），取而代之的是 staged publishing 或 trusted publishing，所以长期自动化的发布以后得靠这两者之一。

每次发布都要让 package.json 里的 name 和 cordis.patch.yml 里的 name: 行保持一致 —— loader 靠这个 specifier 解析那一行。每次发布都要升 version。

之后任何人按名称安装：

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

文件

| 文件 | 作用 |
| index.js | 宿主侧：空的 apply()；这一行存在，是为了让 bundle 能被安装和开关 |
| client.js | 浏览器侧：滚轮/键盘手势、缩放状态、chip 与设置行的注册、样式表 |
| cordis.patch.yml | loader 补丁，用来插入 ctrl-wheel-zoom 那一行 |
| locale/{zh,en}.json | 插件卡片的标题/描述文案；那一行自己的文案在 client.js 里 |
| icon.svg | 插件管理器卡片的图 |

缩放是怎么工作的

缩放就是给 document element 加 CSS zoom。它把布局、文字和固定定位的浮层一起缩放，效果跟浏览器自带的页面缩放完全一样，同时应用自己的滚动容器照常工作 —— transform: scale() 包一层的话，超出的内容没法滚动，而改 font-size 又只能影响文字。

滚轮监听器注册在 window 的捕获阶段，所以它比应用的滚动容器更早看到手势，按住 Ctrl 时能拦住它们不让滚动。当视口本身滚动时，插件会重新锚定，让指针下面的内容始终留在指针下面。
两个 UI 界面读取同一个 store 实例，与手势写入方共享，所以 chip、设置步进器和滚轮监听器对当前档位的判断永远不会不一致。

许可证

MIT — 见 LICENSE。