前言¶
DeepSeek Harness(DSH)的 Web 形态通常需要在本地启动 dsh web,再手动访问本地地址。对于经常在 Windows 上使用 DSH Web 的开发者来说,这会增加命令、路径和 URL 的来回切换。
dsh-desktop-shortcut 要解决的问题很具体:给 DSH Web 提供一个可双击的桌面入口,同时在 Web UI 中加入一个日常刷新按钮。
这是什么¶
dsh-desktop-shortcut 是一个 DSH 插件,由 fuyue521 维护,许可证为 MIT。
它的一句话定位是:创建一个 Windows 桌面快捷方式,用于启动并打开 dsh web。插件同时会在 DSH Web UI 中加入一个可拖拽的刷新按钮。
插件声明的运行环境如下:
peerDependencies: @deepseek-ai/cordis ^4.0.1
engines: node >=18
核心功能¶
插件已核实的功能包括:
- One-click Windows desktop shortcut
- Double-click the shortcut to start
dsh weband open the browser - Draggable floating refresh button in the Web UI
- Refresh button shows a spinning animation and green “Refresh success” feedback
- When AI is replying, shows red “AI is replying” and disables refresh
- Configurable browser:
auto/edge/chrome - Custom shortcut name, icon, and launch arguments
安装与启用¶
使用前需要满足以下前提:
- Windows
- Node.js / pnpm / dsh CLI 已安装
- DeepSeek Harness(
dsh web)可在本地运行
先安装 pnpm:
npm install -g pnpm
然后安装插件。下面使用 README 推荐的 npm 安装命令:
dsh plugin --profile web add dsh-desktop-shortcut
最后启动 DSH Web:
dsh web
启动后,桌面会自动生成一个 DeepSeek Harness 快捷方式。
典型用法¶
日常流程可以按下面步骤操作:
1、安装插件。
2、启动 dsh web。
3、在桌面找到 DeepSeek Harness 快捷方式。
4、双击图标打开 DSH Web。
默认地址是:
http://127.0.0.1:3080
如果需要指定浏览器,可以在 cordis.patch.yml 中配置。例如使用 chrome:
- id: desktop-shortcut
config:
browser: chrome
已核实的浏览器可选值包括 auto、edge 和 chrome。
适用场景与注意¶
适合在 Windows 上本地运行 DSH Web、希望减少手动命令操作的用户。
使用时需要留意:
- 插件以当前
dsh进程权限运行,安装前建议检查源码与许可证。 - 如果双击快捷方式后页面打不开,先确认
dsh web已运行,并检查地址是否为http://127.0.0.1:3080。 - 刷新按钮在 AI 回复期间会禁用,并显示红色 “AI is replying”。
- 关闭 Harness 浏览器窗口后,如果服务仍未停止,需要手动关闭命令行窗口。
结尾¶
dsh-desktop-shortcut 的价值比较收敛:它主要是给本地 DSH Web 提供一个桌面入口,并补充一个 Web UI 刷新按钮。DSH 社区目录是独立站点,与 DeepSeek / 幻方无官方从属关系,本插件可作为社区插件安装使用。
- GitHub:https://github.com/fuyue521/dsh-desktop-shortcut
- 社区目录:未提供已核实的具体 URL