前言¶

DeepSeek Harness 桌面版在启动时通常会将主窗口重置为默认大小。为了解决这个问题，dsh-window-state 插件负责记住主窗口的尺寸、位置与最大化状态。下面介绍这款插件的安装与使用方法。

插件介绍¶

dsh-window-state 是一个 DeepSeek Harness 桌面版插件，由开发者 muqing-kg 维护，采用 MIT 许可证。它通过 Win32 接口自动保存并恢复主窗口的几何状态。

核心功能¶

1. 状态记忆：记住主窗口的尺寸、位置与最大化状态。
2. 自动恢复：下次启动时自动恢复上次的窗口状态。
3. 安全隔离：只操作宿主自己的窗口，通过进程路径校验防止误操作。
4. 定期检查：每 2 秒自动检查并记录窗口状态变化。
5. 平台限制：仅支持 Windows 平台，依赖 user32.dll。

安装与启用¶

安装后需重启 DSH 才能生效。

dsh plugin --profile desktop add github:muqing-kg/dsh-window-state

使用说明¶

安装后无需配置。退出 DSH 时会自动保存当前窗口状态。

1. 调整主窗口至理想尺寸、位置或最大化。
2. 退出 DSH。
3. 下次启动 DSH 时，窗口将自动恢复至上次的状态。

如需重置，删除状态文件：

Remove-Item "$env:USERPROFILE\.dsh\window-state.json"

状态文件¶

状态文件默认保存在 $DSH_HOME/window-state.json（即 ~/.dsh/window-state.json）。

{
  "schema": 1,
  "x": 234,
  "y": 234,
  "width": 1920,
  "height": 1023,
  "maximized": false,
  "savedAt": "2026-09-29T12:00:00.000Z"
}

注意事项¶

• 平台限制：仅限 Windows 平台，macOS 与 Linux 不支持。
• 启动闪现：窗口启动时会有默认尺寸的短暂闪现。
• 全屏与崩溃：不跟踪全屏状态；强杀或崩溃可能导致最后状态丢失。
• 贴靠行为：不改变 Windows 的贴靠行为。

总结¶

dsh-window-state 解决了 DSH 桌面版窗口状态记忆的问题。对于需要在固定布局下工作的用户，安装后可直接使用。

GitHub 仓库：https://github.com/muqing-kg/dsh-window-state