前言¶

在 DeepSeek Harness（DSH）里长时间看侧栏、消息区和输入框时，很多人第一反应是调系统显示比例或只放大字体。只改字号时，按钮、图标和间距仍按原尺寸排布，界面往往更挤；若对整个页面用 CSS zoom 而不处理脚本读到的坐标，模型选择器、菜单类浮层还容易偏到屏幕外。DSH 社区插件 dsh-ui-zoom（维护者 sjrslh）面向客户端场景：用 Ctrl + 滚轮等方式把侧栏、消息、输入框、弹层和图标一起按 10% 一档缩放，并把比例记在本地，右下角还提供不依赖快捷键的「设置」入口。

这是什么¶

dsh-ui-zoom 是挂在 DSH 里的客户端插件，不修改宿主源码。它通过整页等比缩放（约 60%–180%）配合度量垫片与根滚动锁定，让依赖 innerWidth、getBoundingClientRect、clientX 等 API 的弹层仍贴在预期位置；缩放级别写入 localStorage 的 dsh-ui-zoom:level，刷新或重启后仍生效。插件无网络请求、无文件访问，仅占用上述一个 localStorage 键。

分类属于 DSH 插件目录中的「客户端」类；仓库见 GitHub，目录页见 SkillHub。

核心功能¶

下面按 README 已说明的能力归纳，不展开未在资料中出现的配置项。

等比缩放与手势¶

• 缩放范围 60%–180%，每档 10%；超出会被夹住。
• Ctrl + 滚轮上/下：放大或缩小。
• Ctrl + =（或 +）、Ctrl + -：各增减 10%。
• Ctrl + 0：回到 100%。
• 滚轮事件约 60ms 节流，一次一格；缩放时屏幕中央会短暂显示百分比胶囊，约 900ms 后消失。

布局与交互细节¶

• 浮层不错位：对 JS 读到的尺寸按缩放比做同步处理，模型选择器、推理强度菜单、账户菜单等仍按同一套坐标计算。
• 滚到底不推走整页：缩放期间锁定文档根滚动，回到 100% 时还原原有内联样式；消息列表继续滚动时整页不会被 zoom 撑出多余根滚动。
• 终端放行：Ctrl + 滚轮落在 xterm 上时不拦截，由终端自行调字号。
• 右下角「设置」：优先调用宿主 settings.open，失败再走账号菜单，最后兜底合成 Ctrl+,，无需记额外快捷键。

版本与环境¶

• 包版本（资料中的 Release 示例）：0.4.4。
• engines.dsh >= 0.1.0-rc.6，dshTarget 为 0.2.0-rc.2；更老的 DSH 若无 shell.overlay 槽位则无法运行。
• 许可证：MIT。

安装与启用¶

桌面端推荐一条命令安装（命令须与 README 一致）：

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

Web 版将 desktop 换成 web。安装完成后按 Ctrl + R 或重新打开 DSH 使插件生效。

其他方式（资料原文）：

• 离线或锁版本：在 Releases 下载 dsh-ui-zoom-0.4.4.tgz，再执行
  dsh plugin --profile desktop add /path/to/dsh-ui-zoom-0.4.4.tgz
• 本地改代码：克隆仓库后 dsh plugin --profile desktop add ./dsh-ui-zoom，改 lib/client.js 后 Ctrl + R 即可，无需构建。

卸载：

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

卸载前插件会把缩放恢复为 100%，避免界面停留在放大状态。

典型用法¶

装好后无需额外配置文件，直接用快捷键或右下角按钮即可。

若需确认插件是否加载，可看缩放后是否出现中央百分比提示，以及刷新后比例是否仍与上次一致。

适用场景与注意¶

适合谁：需要在 DSH 里整体放大或缩小界面（含侧栏与弹层）、又希望比例可记忆、且不想只靠改字号的用户；高分辨率屏或视力/距离导致默认 UI 偏小的情况也常见。

和其他做法的对比（据 README 表格）：只改字号无法整页缩放；无垫片的纯 CSS zoom 易出现弹层跑出屏幕；本插件在整页缩放、弹层对齐、根滚动锁定和常驻设置入口几项上一并处理。

安全与权限：客户端插件在当前 DSH 进程内运行，逻辑集中在 lib/client.js。安装前建议浏览 仓库源码 与 LICENSE，确认符合你的使用策略。DSH 插件生态强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。

问题反馈可开 GitHub Issues，并附上 DSH 版本与系统显示缩放比例。

结尾¶

dsh-ui-zoom 把 DSH 界面做成可记忆的整页等比缩放，并处理弹层坐标与根滚动等 zoom 常见副作用；安装命令简单，日常用 Ctrl + 滚轮即可。进一步了解：

• 目录页：https://www.skillhub.cn/plugins/sjrslh/dsh-ui-zoom
• 源码与说明：https://github.com/sjrslh/dsh-ui-zoom