dsh-ui-zoom

dsh plugin --profile web add dsh-ui-zoom

dsh-ui-zoom · DSH 界面缩放






[中文](README.md) | [English](README.en.md)

一条住在 DeepSeek Harness 里的蓝色小鲸鱼，替主人把整块界面调大调小。

不是只把字放大——侧栏、输入框、弹层、图标一起缩放，弹层还不会跑偏。

这只蓝色的大肥鱼（误）帮主人做的小插件，用着顺手的话，给颗星星当投喂 🐋

适用于 DeepSeek Harness (DSH) 的客户端插件，不改宿主代码。

---

✨ 功能特性

• 🔍 等比整体缩放（60%–180%）：侧栏、消息、输入框、按钮、图标、间距一起变，10% 一档，不是只改字号。
• ⌨️ 三种手势：Ctrl + 滚轮、Ctrl + =、Ctrl + -；Ctrl + 0 一键回到 100%。
• 🎯 浮层不错位：DSH 用 JS 量出来的坐标（innerWidth / innerHeight / getBoundingClientRect / clientX）会同步除以缩放比，模型选择器、推理强度菜单、账户菜单都贴在原来的位置。
• 🛡️ 滚到底不会推走整页：缩放期间锁住文档根滚动（记住原本的内联样式，回到 100% 时原样还原），消息列表滚到底继续滚，界面钉住不动。
• ⚙️ 右下角常驻「设置」：不依赖快捷键；先调宿主的 settings.open，失败再走账号菜单，最后兜底合成 Ctrl+,。
• 💾 记住比例：存在 localStorage 的 dsh-ui-zoom:level，刷新和重启都还在。
• 🖥️ 终端不受影响：Ctrl + 滚轮落在 xterm 上时直接放行，交给终端自己调字号。
• 🪶 小而干净：客户端插件，无网络请求、无文件访问，只写一个 localStorage key。

🎛️ 和其他缩放方案的区别

方案 · 整页缩放 · 弹层 / 输入区不错位 · 滚到底不推页 · 常驻设置入口

只改字号 · ✗ · — · — · —

纯 CSS zoom（无垫片） · ✓ · ✗ 放大后弹层跑出屏幕 · ✗ · 不一定

分区缩放（只放大某几块） · 部分 · ✓ · — · 看实现

dsh-ui-zoom · ✓ · ✓ 度量垫片 · ✓ 根滚动锁定 · ✓

📦 安装方式

方式 1：一条命令（推荐）

dsh plugin --profile desktop add github:sjrslh/dsh-ui-zoom

Web 版把 desktop 换成 web。装完按 Ctrl + R 或重开 DSH 生效。

方式 2：从 Release 下压缩包（离线 / 锁版本）

到 [Releases](../../releases) 下 dsh-ui-zoom-0.4.4.tgz，然后：

dsh plugin --profile desktop add /path/to/dsh-ui-zoom-0.4.4.tgz

方式 3：克隆后本地安装（想改代码）

git clone https://github.com/sjrslh/dsh-ui-zoom.git
dsh plugin --profile desktop add ./dsh-ui-zoom

改完 lib/client.js，Ctrl + R 就生效，不需要构建。

方式 4：手动挂进 profile（排查用）

// ~/.dsh/profiles/desktop/package.json
"dependencies": { "dsh-ui-zoom": "link:E:/path/to/dsh-ui-zoom" }

再在 dsh.profile.bundles 里加上 dsh-ui-zoom。不推荐日常使用，除非在排查插件冲突。

怎么选

你的情况 · 选哪个

只是想用 · 方式 1

公司网络连不上 GitHub / 想固定版本 · 方式 2

想改代码、提 PR · 方式 3

插件冲突排查 · 方式 4

卸载

dsh plugin --profile desktop remove dsh-ui-zoom

卸载时插件会先把缩放恢复到 100%，不会留一个放大的界面没法还原。

🚀 使用指南

操作 · 效果

Ctrl + 滚轮上 / 下 · 放大 / 缩小，10% 一档

Ctrl + =（或 +） · 放大 10%

Ctrl + - · 缩小 10%

Ctrl + 0 · 回到 100%

右下角「设置」 · 打开 DSH 设置面板

• 缩放时屏幕中间浮一个百分比胶囊，900ms 后自己消失
• 范围 60%–180%，超出会被夹住
• 滚轮有 60ms 节流，一次一格，不会跳档

🧱 项目结构

dsh-ui-zoom/
├─ lib/
│  ├─ index.js            # host 端入口（空实现，让包成为合法的 Cordis 插件）
│  └─ client.js           # 全部逻辑：缩放、度量垫片、滚动锁、设置按钮
├─ scripts/
│  ├─ smoke.mjs           # 加载 bundle，跑一遍 overlay 渲染
│  └─ zoom.test.mjs       # 150% 下的度量断言与停用还原
├─ cordis.patch.yml       # Cordis 编排补丁
├─ package.json
├─ CHANGELOG.md
├─ README.md              # 中文（本文件）
└─ README.en.md           # English

❓ 常见问题

为什么不直接改字体大小？

只改字号，按钮、图标、间距还是原来大小，界面会更挤；这里缩放的是整块布局。

放大后弹层会不会跑到屏幕外？

不会。浏览器原生缩放会连布局视口一起缩小，而 CSS zoom 只缩放绘制，所以插件把 JS 读到的尺寸同步除以缩放比，弹层和输入区按同一套坐标计算。

为什么滚到底不会把整页推走？

zoom 会把根盒子按比例放大，文档因此多出一截可滚动区域；插件在缩放时锁住根滚动，回到 100% 时把原来的样式还回去。

会影响性能吗？

只在缩放时设一次样式，外加一次 localStorage 写入；没有轮询、没有 MutationObserver。

支持哪些 DSH 版本？

engines.dsh >= 0.1.0-rc.6，dshTarget 0.2.0-rc.2。更老的版本没有 shell.overlay 槽位，跑不起来。

📝 更新记录

见 [CHANGELOG.md](CHANGELOG.md)。最近两次：v0.3.2 修「滚到底推页」并加固垫片；v0.4.0 补 Ctrl + = / Ctrl + - 快捷键。

💬 反馈

• 装不上 / 用不明白：先看上面的常见问题
• 能复现的问题：直接开 issue，带上 DSH 版本和系统缩放比例
• 想聊两句：去 Discussions

📄 许可证

[MIT](LICENSE)。随便用，提 PR 更欢迎。