全局热键唤窗Meredith2328/dsh-hotkey

DshHotkey — Alt+Space 一键唤起 / 最小化 DeepSeek Harness

一个零依赖的 Windows 后台小工具：按 Alt+Space，把承载 DeepSeek Harness 的窗口
从最小化中唤起并置顶；再按一次，把它最小化。

仅限 Windows：依赖 Win32 API（全局热键、窗口管理）和系统自带的 .NET Framework
编译器，不支持 macOS / Linux。

为什么是独立小工具，而不是 skill / MCP / 插件？

- skill 只是一份给 Agent 的指令文本，不能常驻监听按键。
- MCP / Cordis 插件 跑在 Harness 自己的进程或页面里，管不到浏览器窗口的
最小化/恢复，更注册不了操作系统级全局热键。
- 全局热键 + 窗口管理必须由 OS 层的常驻进程来做，所以最合适的形态就是一个
极小的 Windows 可执行程序（C# 编译，无需安装任何运行时）。

安装

cd C:\desktoppp\dshdemo\dsh-hotkey
powershell -ExecutionPolicy Bypass -File .\install.ps1

安装脚本会：编译 exe → 复制到 %LOCALAPPDATA%\DshHotkey\ → 写入 HKCU 开机自启 →
立即启动。之后 Alt+Space 即可切换。

卸载：

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

行为

| 状态 | Alt+Space 效果 |
|---|---|
| Harness 窗口已最小化 | 恢复并置顶聚焦 |
| Harness 窗口可见 | 最小化 |
| 找不到匹配窗口 | 用默认浏览器打开 http://127.0.0.1:64552 |

手动使用

.\DshHotkey.exe -list       # 列出当前所有窗口（进程名 + 标题），确认匹配项
.\DshHotkey.exe -toggle     # 手动执行一次切换（用于测试）
.\DshHotkey.exe -proc "DSH Desktop" -title "DeepSeek Harness" -url "http://127.0.0.1:64552"

日志写在 exe 同目录的 DshHotkey.log，启动和每次切换都有记录。

注意事项

- 目标窗口用进程名 + 标题双重匹配：默认 proc=DSH Desktop（Harness 是
Electron 应用）+ 标题包含 DeepSeek Harness（页面 ）。双重匹配可以
避免 Obsidian 等窗口标题碰巧包含 "DeepSeek Harness" 而误操作。
- 若 Harness 窗口标题临时变化（如无会话时的首页标题就是纯 "DeepSeek Harness"，
有会话时是 "「会话标题」 — DeepSeek Harness"），包含式匹配都能命中。
- 想改用浏览器承载 Harness：把 -proc 设为 chrome 或 msedge 等（或传空串
-proc "" 只按标题匹配）。自定义后需同步修改 HKCU 自启命令里的参数。
- -url 可以是 URL，也可以是 exe 路径——找不到窗口时会启动它。
- Alt+Space 本来用于打开窗口系统菜单；注册全局热键后该组合被本工具接管。
若被其他程序占用，日志会报错误 1409，可修改 DshHotkey.cs 顶部的 MOD_ /
VK_ 常量后重新 build.ps1。