前言¶
在 macOS 上做智能体或插件开发时,DeepSeek Harness(DSH)往往已经在本机跑着,但要把问题发给当前会话,仍得先切到 DSH 窗口再输入。若你正在浏览器、IDE 或别的应用里,这条路径会打断当前上下文。社区插件 dsh-global-launcher 用系统级快捷键弹出一条小输入栏,在任意前台应用里打完字即可提交到 DSH,必要时还可附带截图或当前窗口文本。下面按定位、能力、安装与用法说明,事实均来自插件 README 与 package 元数据。
这是什么¶
dsh-global-launcher 由 william-jin-cmu(William Jin)维护,归类为 DSH 客户端 插件;在 SkillHub 目录页可见,当前 GitHub 星标为 0。一句话:在 Mac 上通过全局热键打开小型 prompt 栏,将输入(及可选截图、窗口文本)交给 DeepSeek Harness 开启或续写会话。仅支持 macOS(package 中 os 为 darwin)。
核心功能¶
全局热键与输入栏¶
DSH 进程运行期间,热键在系统任意界面生效。默认行为如下(可在配置中改名或关闭部分项):
| 按键 | 作用 |
|---|---|
⇧⌘Space |
打开输入栏 |
⌥⌘Space |
先进入截图选择,再打开输入栏并附带图片 |
Return |
发送;发送成功后栏会关闭,仅失败时再次弹出 |
Shift+Return |
换行 |
Tab |
在新会话与最近一次会话之间切换 |
⌘1 |
附加或移除整屏截图 |
⌘2 |
附加或移除你刚才所在窗口的文本 |
Esc |
关闭输入栏 |
栏底可选择:New / Last(新会话或继续最近会话)、Workspace 与 model(新会话用;若已安装 dsh-native-runtimes,模型列表会出现 Claude Code、Codex 等)、Create more(发送后栏保持打开以便连续输入)、Open DSH(发送后是否把 DSH 提到前台并展示会话)。上述选择会写入 $DSH_HOME/global-launcher/state.json。
不支持图像的模型会收到不带截图的纯文本 prompt。
配置项¶
| Setting | 默认值 | 含义 |
|---|---|---|
hotkey |
shift+cmd+space |
打开输入栏 |
contextHotkey |
option+cmd+space |
先截图再开栏;设为空可关闭 |
contextChars |
6000 |
附加窗口文本的上限字符数 |
excludeApps |
密码管理类应用 | 其窗口文本永不附加(按 Bundle ID) |
workspace |
空 | 新会话默认工作区;空则用最近一次工作区 |
desktopApps |
com.deepseek.harness |
发送后可将这些 Bundle ID 前缀的 DSH 桌面应用置前 |
HTTP 接口¶
可通过脚本等价于在栏内输入并发送:
POST /api/global-launcher/launch
请求体字段包括:text,以及可选的 screenshot、context、pid、target、workspaceId、model、openMain。
安装与启用¶
环境要求:DSH >=0.2.1-rc.5 且 <0.3.0;Node.js 22.19 或更高。插件版本 0.1.0,许可证 MIT。
命令行(web profile)安装:
dsh plugin --profile web add dsh-global-launcher
桌面端可在 Plugins > Add plugin 中填写插件名 dsh-global-launcher。
安装后,截图与读取窗口文本依赖 macOS 对 DSH 所在宿主应用 的 Screen Recording 与 Accessibility 授权。系统默认把 ⌥⌘Space 绑给「显示 Finder 搜索窗口」,可在 系统设置 > 键盘 > 键盘快捷键 > Spotlight 中关闭,或修改插件中的 contextHotkey。
典型用法¶
- 保持 DSH 运行,在任意应用中按
⇧⌘Space,在栏内输入问题后按Return发送。 - 需要带界面上下文时:按
⌥⌘Space选区域截图后输入;或在栏打开后用⌘1/⌘2切换整屏截图与前台窗口文本。 - 用
Tab在新建会话与上次会话间切换;在栏底选定 workspace、model,并视习惯打开 Create more 或 Open DSH。 - 自动化场景对本地 DSH 调用
POST /api/global-launcher/launch,传入text及需要的可选字段。
从源码打包(维护者流程,非终端用户必做步骤):
pnpm install
pnpm run pack # 产出 dist/、bin/ 与 dsh-global-launcher-0.1.0.tgz
适用场景与注意¶
适合经常在 Mac 多应用间切换、又希望随手把问题丢给 DSH(含截图或窗口摘录)的开发者。插件逻辑随 当前 DSH 进程 运行,安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证;SkillHub 为社区目录,与 DeepSeek / 幻方无官方从属关系,并非官方应用商店。
仅限 macOS;热键仅在 DSH 已启动时有效。权限、Spotlight 快捷键冲突与模型是否支持图像,会直接影响截图是否随 prompt 送出。