窗口尺寸锁定 Koewen/dsh-window-size-lock

dsh-window-size-lock

DeepSeek Harness（DSH）宿主插件，记住主窗口的尺寸和位置：每次启动都还原这两项，锁住它们不被默认布局覆盖，并跨会话持久保存。

功能

1. 启动时还原 —— DSH 主窗口一出现，立刻应用上次保存的矩形（x、y、width、height），并在短暂宽限期内反复重申，这样 DSH 默认的 1280×820 布局和 Windows 默认的窗口摆放都占不到上风。窗口每次重开都往右下角挪，就是这一步挡住的。
2. 调整时采纳 —— 你拖动窗口边缘或角，新尺寸稳定下来后，自动存为新的锁定值。
3. 最大化安全 —— 最大化（双击全屏）的窗口永远不会被记录。窗口处于缩放状态时，所有尺寸记录暂停；还原后，重新应用保存的非全屏尺寸。最小化的窗口同样冻结（这类窗口会报出经典的屏幕外矩形 -32000,-32000），无边框全屏（F11 那种）也一样——它不是 WS_MAXIMIZE，靠显示器覆盖启发式判断。
4. 持久化 —— 矩形存在 %APPDATA%\@deepseek-ai\dsh-desktop\window-size-lock.json，格式为 {x, y, width, height}，重启后依然有效。v1.3.0 写的文件（只有尺寸）仍能读取；升级后第一次稳定读取时学到位置。

出厂默认尺寸（1280×820）永远不会被采纳为锁定值，所以默认布局即使晚一步重置，也无法悄悄覆盖你保存的尺寸。

安装

用 DSH 插件命令行安装（把 exe 路径换成你的 DSH 安装位置）：

set ELECTRON_RUN_AS_NODE=1
"D:\WorkStation\DeepSeek Harness\DeepSeek Harness.exe" --expose-internals ^
"D:\WorkStation\DeepSeek Harness\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh-desktop-host\lib\cli.js" ^
plugin --profile desktop add https://github.com/Koewen/dsh-window-size-lock

然后重启 DeepSeek Harness。（命令行会跑 pnpm，自动安装插件的 koffi 依赖。）

配置

编辑 cordis.patch.yml 里的 config: 块，然后重装或重启：

| 键 | 默认值 | 含义 |
| enabled | true | 总开关。false = DSH 默认行为，不锁定。 |
| pollMs | 500 | 监视循环间隔，单位毫秒。 |
| graceMs | 3000 | 窗口出现后，保存的矩形要重申多久。如果 DSH 在 3 秒之后才重新应用自己的布局，就调大（比如 6000）。 |
| adoptFactoryDefault | false | 允许把 1280×820（DSH 出厂默认）采纳为尺寸锁定。位置不受这个开关影响，始终采纳。 |
| persistPosition | true | 同时记住并还原窗口原点。false 则回到 v1.3.0 的行为（只记尺寸）。 |

重置

删除已保存的 rect 文件，然后重启 DSH：

del "%APPDATA%\@deepseek-ai\dsh-desktop\window-size-lock.json"

工作原理

DSH 宿主插件运行在普通 Node 子进程里（用 ELECTRON_RUN_AS_NODE=1 启动），所以拿不到 Electron API。这个插件改从操作系统获取窗口句柄：

- 与主窗口运行在同一个交互式桌面会话中；
- 是 Electron 主进程的直接子进程，所以 process.ppid 正是持有主窗口的 PID。

插件通过 koffi（已作为依赖打包）绑定 user32.dll，按 Z 序查找父 PID 名下最大的可见顶层窗口，再按 pollMs 间隔用 MoveWindow / GetWindowRect 应用和观测尺寸。

限制

Electron 在 Chromium 消息层强制了最小窗口尺寸（约 520×600）。任何外部调用方都无法把窗口缩到这条下限以下——这个插件只在允许范围内锁定尺寸。

DPI：插件启动时会请求 per-monitor DPI awareness v2（尽力而为），这样坐标就是物理像素。如果宿主进程在这次调用之前已经固定了 DPI 上下文，混合 DPI 的多显示器环境恢复尺寸时可能出现缩放偏移。

兼容性

基于 DeepSeek Harness 0.2.1-rc.3 构建并测试。可选的 peerDependencies 按这个确切版本声明，以便通过兼容性检查。

测试

test/wsl-edge-tests.mjs 用测试进程里创建的真实 Win32 窗口（ownerPid: process.pid）驱动真实插件，配合隔离的 APPDATA 和消息泵，让最小化/最大化状态是真实的：

node test/wsl-edge-tests.mjs # 21 checks, exit code 1 on any failure

覆盖：接管、仅移动、仅缩放、最小化（-32000 的 rect 绝不能记录）、最大化、保存的原点位于屏幕外、旧版仅存尺寸的存储、persistPosition:false、拖动（拖动过程中不接管）、关闭后重开、多窗口（最大者胜出）、存储损坏、dispose、显示器遮挡冻结、出厂默认尺寸，以及 v1.3.0 → v1.4.0 升级路径。

更新日志

v1.4.0 — 同时记住位置

修复「窗口重开时略微偏右下」：旧代码只恢复保存的尺寸，并把窗口当前的原点传给 MoveWindow，所以位置从未持久化，每次启动都回落到 Windows 的默认摆放（逐级向右下偏移）。

- 保存/恢复 {x, y, width, height}；保存的原点若已不与任何显示器相交（显示器被拔掉），就忽略它，而不是把窗口拖到屏幕外；
- 位置和尺寸独立接管：出厂默认的 1280×820 保护只拦截尺寸接管，所以从不调整窗口大小的用户仍能保存位置；
- 仅存尺寸的 v1.3.0 存储会就地升级——原点在第一次稳定读取时学到（以前 lastApplied 会把它永久吞掉）；
- 诊断：窗口超出显示器时告警，冻结原因在启动、no window found for pid 警告、DPI 感知级别。