前言¶
DeepSeek Harness (DSH) 的字体大小设置仅影响对话正文。如果需要调整整个界面,包括侧边栏、菜单、模态框和图标,目前没有现成方案。dsh-plugin-ui-zoom 通过缩放整个文档根元素,配合宽度补偿,让缩放效果更自然。
插件定位¶
这是一个 DSH 插件,由 1700563146 维护,用于将 DSH Web UI 的整体显示比例在 70% 到 160% 之间缩放。插件通过操作 document.documentElement 的 zoom 属性实现,布局视口、固定定位菜单和覆盖层都会随之变化,而不是使用 transform: scale(),避免固定元素被隔离。
核心功能¶
- 整体缩放范围 70%–160%,涵盖所有 UI 元素
- 缩放快捷键通过 DSH 自身的快捷键中心注册,支持重绑定
- 桌面端使用
Mod+=/Mod+-/Mod+0,Web 端使用Ctrl+Alt+=/Ctrl+Alt+-/Ctrl+Alt+0 - 鼠标滚轮缩放每次 5%,支持触摸板连续滑动累积,不会跳变
- 界面右上角显示当前缩放比例胶囊,点击可重置到 100%
- 缩放比例保存在
localStorage的dsh-ui-zoom键中,不同页面/源会记住各自设置 - 内容宽度补偿:主机限制阅读列宽度为 920px,插件按
1 / zoom缩放该宽度,保持物理宽度不变 - 卸载插件时会清理所有监听器和注册的命令,恢复原始状态
安装与启用¶
在 DSH 的「插件」页面搜索 dsh-plugin-ui-zoom 安装,或使用命令行:
dsh plugin --profile <profile> add dsh-plugin-ui-zoom
安装后重启 dsh web 使快捷键生效。
典型用法¶
- 桌面端缩放:按住
Ctrl/⌘滚动滚轮,或使用快捷键Mod+=/Mod+- - Web 端缩放:按住
Ctrl+Alt滚动滚轮,或使用快捷键Ctrl+Alt+=/Ctrl+Alt+- - 重置到 100%:点击界面右上角的百分比胶囊,或按
Mod+0(桌面)/Ctrl+Alt+0(Web)
快捷键可在 DSH 的键盘快捷键面板(Mod+/)中查看或重新绑定。插件通过 ctx.shortcuts 注册,重复或冲突的绑定会被 DSH 拒绝。
适用场景与注意¶
适合需要频繁调整界面显示比例、在多分辨率屏幕上使用 DSH 的开发者。插件以当前 DSH 进程的权限运行,安装前建议查看源码和许可证。
兼容 DSH 引擎 >=0.2.0-rc.2 <0.3.0-0,需要 @deepseek-ai/cordis ^4.0.1。无构建步骤,无额外运行时依赖。
已知限制:
- 如果手动拖动了对话宽度手柄,主机存储的宽度会覆盖插件的补偿,缩小时列宽会按比例缩小
- Web 端的 Ctrl+wheel 是浏览器页面缩放,无法拦截,必须使用带 Alt 的组合键
- 插件缩放的是文档根元素,因此主机的控制条等元素也会被缩放,与浏览器缩放行为一致
小结¶
dsh-plugin-ui-zoom 提供了一套完整的界面缩放方案,从快捷键到宽度补偿都做了针对性处理,适合需要在不同缩放比例下使用 DSH 的场景。更多细节可参考:
- 插件目录页:https://www.skillhub.cn/plugins/1700563146/dsh-plugin-ui-zoom
- GitHub 仓库:https://github.com/1700563146/dsh-plugin-ui-zoom