前言¶
在 DeepSeek Harness(DSH)里长时间用 Web UI 或桌面客户端时,系统或浏览器默认字号未必合适:窗口偏小会显得挤,高分辨率屏上又可能偏小。浏览器自带页面缩放可以凑合,但和 DSH 自身布局、多 profile 配置不一定一致;桌面端也没有统一的「界面比例」入口。下面介绍的 dsh-ui-scale 是社区插件,在 DSH 设置里提供 50% 到 200% 的界面缩放,并写入 profile 配置,重启后仍生效。
这是什么¶
dsh-ui-scale(维护者 juliankang4)属于 DSH 插件目录中的客户端类插件。它针对 DeepSeek Harness 的 Web UI(dsh web)与 Desktop 应用,在同一套设置项下调整整个窗口内界面元素的显示比例,而不是只改某一页 CSS。
社区插件目录托管在独立站点(如 SkillHub 上的条目),与 DeepSeek / 幻方无官方从属关系;安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。插件在当前 dsh 进程的权限下运行,与其它 DSH 插件相同,启用前请确认你信任该来源。
核心功能¶
缩放范围与持久化¶
- 界面比例可在 50% 至 200% 之间设置,配置字段为整数百分比,默认 100。
- 数值保存在 profile 配置中,重启后仍保留;主窗口出现前即应用缩放。
web与desktop两个 profile 各自独立保存;同一 profile 下登录的浏览器会共享该值。
缩放覆盖范围¶
窗口内可见内容整体参与缩放:侧栏、会话区、输入区、各页面、Settings 与其它对话框,以及附着在其上的菜单、工具提示与弹出层。布局行为接近浏览器 zoom:例如高缩放、小窗口时左侧栏会收起,分栏仍按窗口比例分配,拖拽分隔条时指针与布局一致。
Desktop 应用里原生菜单与窗口控件保持系统默认尺寸,不随插件缩放。
桌面窗口位置与大小¶
启用插件后,Desktop 会在启动时恢复上次关闭时的窗口大小与位置(插件未启用时则每次使用相同默认尺寸)。窗口不会被放大到超出屏幕;若上次位置在副屏,则会在主屏以保存的尺寸打开。全屏状态不会写入恢复逻辑。
实现边界(Limits)¶
插件通过 CSS zoom 并对页面测量值做换算(元素位置与尺寸、视口、指针、部分 media query 与 viewport 单位等)。以下情况 README 中明确说明未完全换算或仍用真实窗口尺寸:
- 部分通过脚本动态插入、Shadow DOM、MathML 等路径写入的
vw/vh规则可能未换算,个别元素可能超出窗口视觉范围。 IntersectionObserver矩形与触摸坐标仍基于真实窗口尺寸。- 同一步脚本里刚写入的内联 viewport 尺寸,当步可能仍读到未换算值,下一步才一致。
- 页面上其它脚本(含其它插件)一般读到换算后的值;Desktop 账户 Usage / Top up 区域为例外,仍按窗口像素定位。
- 已打开的 PDF 在改缩放后可能保持改前清晰度,需重新加载、再次打开或在预览里 zoom 后才更新。
在浏览器中,浏览器自带缩放与插件缩放会相乘。
安装与启用¶
Web(profile web)¶
在资料给出的命令下为 web profile 添加插件:
dsh plugin --profile web add dsh-ui-scale
Desktop¶
在 Desktop 应用中打开 Plugins,选择 Add plugin,输入 dsh-ui-scale 并安装。
典型用法¶
安装后打开 Settings > General > Interface scale,可用三种方式设比例:
- 拖动滑块:以 5% 为步进,松手后生效。
- 输入百分比:在输入框填数字后按 Enter 或点击其它区域;会四舍五入为整数,低于 50 或高于 200 会钳制到边界。
- 点预设:100、110、125、150、175、200%。
若需直接改 profile 配置,可在该 profile 的 cordis.patch.yml 中写入(与 README 示例一致):
- id: ui-scale
name: dsh-ui-scale
config:
scale: 125
| 字段 | 默认值 | 说明 |
|---|---|---|
scale |
100 |
界面缩放百分比,50–200 的整数 |
版本说明(来自 README):在 dsh 0.2.0 中,从另一台计算机打开的页面可以临时改缩放且仅影响该页,直到刷新;该版本不会把这类页面的设置写回持久配置。更高版本行为以你实际使用的 dsh 发行说明为准。上游 README 记载在 dsh 0.2.1-rc.2(Web Chrome + macOS Desktop)与 dsh 0.2.0-rc.2(Web Chrome)下做过验证;插件包版本为 0.1.5。
适用场景与注意¶
- 适合:需要在固定 DSH 环境内统一界面比例的用户;高 DPI 或小笔记本窗口下希望放大侧栏与会话区;Desktop 用户希望记住窗口大小与位置。
- 注意:插件改动的是客户端展示与部分测量语义,与其它依赖像素或视口尺寸的插件叠加时,应留意 Limits 一节中的例外;启用前阅读源码。目录页星标等元数据以社区站点为准(当前条目为 0 star,不代表质量结论)。
结尾¶
dsh-ui-scale 把 DSH Web 与 Desktop 的界面缩放收到 Settings 与 profile 配置里,范围 50%–200%,并扩展 Desktop 窗口几何记忆。若要安装或贡献代码,可访问目录页 https://www.skillhub.cn/plugins/juliankang4/dsh-ui-scale 与仓库 https://github.com/juliankang4/dsh-ui-scale。