前言¶

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