dsh-window-size
简体中文 · English
记住 DeepSeek Harness 桌面版的窗口尺寸：重启后自动恢复、默认水平垂直居中，并且可以在设置页里直接改，不用手动拖窗口。
- 首次启动：没有记录时使用 1440 × 900，并居中。
- 每次手动调整：自动记录，下次启动恢复。
- 默认居中：每次启动都把窗口放在当前显示器工作区正中；可在设置页关闭，改为沿用上次位置。
- 不会记错：最大化、最小化、隐藏状态一律不记录，避免下次以超大尺寸打开；恢复时会按当前显示器工作区收缩，换显示器也能用。
- 设置页：
设置 → 窗口尺寸可手动设定尺寸、记住当前尺寸、立即居中、恢复默认。 - 在非桌面版 Host（
dsh命令行、服务器）上仍可加载，但设置页会提示不可用。
为什么必须做成 Host 插件
桌面版创建主窗口时把尺寸写死为 1280 × 820，也不持久化任何窗口状态。渲染端改不了它：在 Electron 里，window.resizeTo() 会被路由到 WebContentsDelegate::SetContentsBounds，Electron 只把它转发成 content-bounds-updated 事件，并不会真的改变 BrowserWindow 的大小。
所以真正干活的是 Host 进程：它通过 koffi（@deepseek-ai/dsh-desktop-host 本来就依赖它）调用 FindWindowExW / GetWindowRect / GetDpiForWindow / SetWindowPos，并且抢在窗口显示前完成设置，避免先闪一下旧尺寸。
设置页
设置 → 窗口尺寸 是一个 settings.section 条目。页面上会显示当前窗口尺寸、已记录尺寸和上次动作（含时间），并提供：
| 控件 | 作用 |
|---|---|
| 宽度 / 高度 + 应用并记住 | 立刻改变窗口尺寸并保存 |
| 记住当前尺寸 | 把你现在手动拖出来的尺寸存下来 |
| 重新应用 | 用记录值再应用一次（含当前居中设置） |
| 恢复默认 | 回到配置的默认 1440 × 900 |
| 启动时居中 开关 | 决定恢复时是否居中 |
| 立即居中 | 只居中，不改尺寸 |
| 启用尺寸记忆 开关 | 关闭后既不恢复也不记录 |
页面本身不碰窗口，它通过包私有 RPC 通道 /dsh-window-size 调用 Host 端，Host 端用与启动恢复同一个控制器来执行。
安装
直接从 GitHub 安装（插件管理器里填写）：
github:home-i/dsh-window-size#v1.1.2
也可以在桌面版 插件 页里从本地目录安装。本地开发还可以把包链接进桌面版 profile：
// ~/.dsh/profiles/desktop/package.json
{
"dependencies": {
"dsh-window-size": "link:/path/to/dsh-window-size"
},
"dsh": {
"profile": {
"bundles": ["...", "dsh-window-size"]
}
}
}
下次启动即生效，之后改动源码也不需要重装。
> 不要把这个 link: 换成手工建的 Windows junction 再执行 pnpm install：pnpm 安装时会移除该条目，而 Windows 会顺着 junction 进入目标目录，导致源码目录被清空。
配置
Loader 行里配置首次启动的默认值：
# cordis.patch.yml
- insert:
- id: dsh-window-size
name: dsh-window-size
config:
width: 1440 # 首次启动宽度，CSS 像素
height: 900 # 首次启动高度，CSS 像素
center: true # 每次恢复都居中
enabled: true # 是否启用恢复与记录
尺寸单位是 CSS 像素；宽高最小被限制为 520 × 600，恢复时还会被当前显示器工作区限制。
状态文件
记录放在 harness home 下，跟随 profile 而不是 Electron 的 userData：
~/.dsh/dsh-window-size/window-size.json
{
"size": { "width": 1440, "height": 900 },
"center": true,
"enabled": true,
"last": { "action": "restore", "source": "remembered", "at": 0 },
"updatedAt": 0
}
last 记录最近一次动作（restore、resize、apply、remember、center、center-on、center-off、enabled、disabled），包含实际达成的尺寸、DPI 缩放和窗口标题——设置页显示的就是它，出问题时也靠它定位。删除这个文件即回到配置默认值。旧版（只有 size + last）的记录会自动升级：尺寸保留，新开关取配置默认。
RPC 约定
Host 在 Web carrier 上注册前缀路由，每个请求都先过 connection.admit，因此只有本 Host 的已认证页面能操作窗口：
POST /dsh-window-size/
content-type: application/json
{ "type": "client-request", "rpcId": "…", "method": "", "payload": … }
端点：status、apply（{width,height}）、reapply、reset、center、remember、set-center（true|false）、set-enabled（true|false）。返回使用 Connection 的 server-response 信封；业务失败以 HTTP 200 + { ok: false, error: { code, message, details } } 返回，而路由不存在、非 POST、认证失败分别是 404 / 405 / 401。
文件
| 文件 | 作用 |
|---|---|
index.js |
Host 插件入口；启动控制器与 RPC，并负责释放 |
window-memory.js |
控制器：查找窗口、恢复、居中、跟踪缩放、处理页面动作 |
rpc.js |
前缀路由注册、认证、信封解析、端点分发 |
win32.js |
koffi 绑定、DPI、显示器工作区、窗口查找 |
state.js |
harness home 下的原子 JSON 记录 |
client.js |
设置页（settings.section），中英双语 |
cordis.patch.yml |
bundle 层插入的 Loader 行 |
环境要求
- Windows 10/11 x64 或 arm64。
- DeepSeek Harness 桌面版（Electron shell 的 Host 进程）。窗口 API 是 Win32 的，其它环境不生效。
常见问题
包管理器操作时报 dsh: cannot resolve profile bundle "dsh-window-size"：说明 manifest 里列了这个 bundle，但 node_modules/dsh-window-size 不存在、或其链接目标里没有 package.json。插件管理器的 reconcile 阶段对所有已列依赖都会严格解析、没有兜底（而启动时只是跳过并报告），补回链接或重装 bundle 即可恢复。
设置页显示不可用：当前 Host 不是桌面版，或 koffi / user32 加载失败；具体原因会显示在提示下方。
窗口恢复后的尺寸不对：查看状态文件里的 last，它记录了请求值、实际达成值、DPI 缩放与窗口标题。
许可证
MIT © home-i
English version →
