dsh-window-size: Set the startup window size for DSH Desktop Edition

前言

DeepSeek Harness(DSH)桌面版基于 Electron 壳启动。当前实现里,createWindow 将窗口固定为 1280×820,且没有保存或恢复用户手动调整后的窗口 bounds。每次冷启动都会回到同一尺寸,对需要宽屏写代码、或希望窗口略小以便并排其他应用的用户来说,只能每次启动后再拖一遍边框。

社区插件 dsh-window-size(维护者 jue5hen,分类:客户端)在设置面板里保存启动尺寸,并在页面启动阶段按保存值调整窗口,使下次打开即为设定大小。下面介绍其能力、安装方式与使用步骤;事实以 GitHub 仓库 与 SkillHub 目录页 为准。

这是什么

dsh-window-size 是纯 Client 侧 DSH 插件:Host 半边仅向启动注入表推送内联脚本,Client 半边提供「窗口大小」设置页与预设管理。数据只写入本机 localStorage,不上传、不修改 DSH 安装目录,也不依赖其他插件。

运行时要求 engines.dsh 为 ^0.2.1-rc.5;README 注明已在 DSH 0.2.1-rc.5 上实测。版本不满足时,宿主会在 pnpm 之前拒绝安装,并给出兼容性豁免入口。

核心功能

经 README 核实,插件提供以下能力:

  1. 启动默认尺寸:保存后立即应用到当前窗口,并在下次启动时自动生效。
  2. 比例预设:4:3、16:9、16:10 各一大一小,共 6 个内置尺寸;超出当前屏幕可用区域的预设会自动禁用。
  3. 自定义预设:任意合法宽高可保存为预设,最多 12 个,可删除,跨重启保留。
  4. 实时当前尺寸:面板显示当前窗口内容区大小,随手动缩放更新。
  5. 保存并应用 / 恢复默认:立即调整当前窗口;「恢复默认」只清除启动尺寸,窗口回到应用默认 1280×820,自定义预设仍保留。
  6. 仅桌面版生效:在浏览器中打开 DSH 时,面板只读并提示该功能仅用于桌面应用。

实现上,注入脚本在窗口显示前从 localStorage 读取配置,校验后调用 window.resizeTo 并居中;设置的是内容区(innerWidth / innerHeight),与 BrowserWindow({ width: 1280, height: 820 }) 语义一致。Windows 上外框通常比内容区宽约 16 px、高约 8 px。尺寸与预设键名为 dsh-window-size:v2;旧版 v1 在启动时仍会读取,首次保存时迁移到 v2。合法范围:最小 520×600,最大为屏幕可用区减边框,硬上限 10000。插件不会持久化窗口位置,启动时居中显示。

安装与启用

前置条件:DSH 桌面版(Electron 壳),运行时满足上述 engines.dsh 要求。

从 npm 安装(推荐)

包发布在 npm,安装拉取预构建产物,不克隆仓库、不执行构建脚本。

  1. 在 DSH 会话里安装(省略版本号即取最新发布版;资料示例为 1.0.2):
plugin_manager install_bundle dsh-window-size@1.0.2
  1. 完全退出并重启 DSH(含托盘进程)。首次安装或升级后必须重启才能加载新的 Client 模块。

也可在桌面版 设置 → 插件 中搜索 dsh-window-size 安装;若已安装 dshmarket 等市场插件,可在站内商店搜同名包。

Web 档案(dsh web)可用 CLI:

dsh plugin add dsh-window-size

默认档案;需要时可加 --profile <name>。

从源码安装(开发)

开发场景可克隆仓库后用 file: 路径安装;资料要求将路径换成本机绝对路径,安装后同样需要完全退出并重启。file: 安装会把整个检出目录链入档案,与 npm 安装只落地包内文件的行为不同。正文任务要求不展开 clone 步骤,细节见仓库 README。

典型用法

经过安装并重启后:

  1. 打开 左下角账号菜单 → 设置 → 窗口大小。
  2. 选择内置预设,或直接输入宽度、高度,点击 保存并应用。
  3. 需要复用的尺寸可 保存为预设;预设右侧 × 可删除。
  4. 点击 恢复默认:清除启动尺寸,窗口回到 1280×820,自定义预设保留。

若改了尺寸但重启后无变化,常见原因是未完全退出(仅关到托盘不算重启),或安装/升级后未重启。

适用场景与注意

适合谁:长期使用 DSH 桌面版、希望固定启动窗口比例或像素尺寸的用户;需要 16:9 宽屏或较小窗口并排其他工具时,预设比每次手动拖拽更省事。

兼容性(资料原文):已在 Windows 11、DSH 0.2.1-rc.5、Electron 44.7.0 上验证;macOS / Linux 桌面版理论上可用但未实测。已知限制:冷启动极早期第一帧仍可能短暂显示默认尺寸,彻底消除需改 Electron 壳。

安全与权限:插件以当前 DSH 进程权限运行,只写自身 localStorage 键、注册一个设置页。安装前建议查看 源码 与 MIT 许可证。DSH 生态强调「一切皆插件」;SkillHub 等为社区目录,与 DeepSeek / 幻方无官方从属关系。

结尾

dsh-window-size 补上了桌面版「记住启动窗口大小」这一缺口:预设、自定义与立即应用都在设置页完成,对 Host 侵入小。当前发布版本 1.0.2,许可证 MIT。

  • 目录页:https://www.skillhub.cn/plugins/jue5hen/dsh-window-size
  • GitHub:https://github.com/jue5hen/dsh-window-size
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye