前言¶
使用 DSH web 時，本地服務啓動和瀏覽器打開通常是兩個步驟：先啓動服務，再等端口可用，最後打開頁面。Ho11ow8/deepseek-harness-shortcut 是一個 Windows 下的 DSH 插件，它在聊天中提供 /desktop-shortcut 命令，生成桌面快捷方式和啓動器。雙擊快捷方式後，它會判斷 DSH 服務是否已運行：已運行則直接打開瀏覽器，未運行則啓動服務並等待端口就緒。
這是什麼¶
Ho11ow8/deepseek-harness-shortcut 由 Ho11ow8 維護，分類爲客戶端，許可證爲 MIT。它用於在 Windows 下爲本地 DSH web UI 創建一鍵啓動或打開的桌面快捷方式。插件以 DSH bundle 形式發佈，安裝後自動激活到 profile。package.json 要求 Node >=18.0.0，並有 peerDependency @deepseek-ai/cordis ^4.0.1。
核心功能¶
- 提供
/desktop-shortcut命令，生成桌面快捷方式和啓動器。 - 智能啓動器會判斷 DSH 服務是否已運行：已運行則直接打開瀏覽器；未運行則啓動服務並等待端口就緒。
- 默認啓動命令爲
npx --yes @deepseek-ai/dsh web，默認等待端口3080最長30秒。 - 支持配置
shortcutName、url、port、iconPath、launcherDir、workdir、command、waitSeconds。 - 零運行時依賴，僅使用
Node >=18內置能力。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:Ho11ow8/deepseek-harness-shortcut
安裝後重啓 dsh web，在聊天中運行：
/desktop-shortcut
插件會在 workspace 生成 start-dsh.bat，並在桌面生成 DeepSeek Harness.lnk。
典型用法¶
下面按常見路徑操作。
生成默認快捷方式¶
運行 /desktop-shortcut 後，桌面出現 DeepSeek Harness.lnk，workspace 中生成 start-dsh.bat。雙擊桌面快捷方式時，插件按當前服務狀態選擇打開瀏覽器或啓動服務。
覆蓋配置¶
通過 profile 的 cordis.patch.yml 可以覆蓋配置。例如：
- id: desktop-shortcut
config:
shortcutName: My Harness
url: 'http://127.0.0.1:8080'
port: 8080
iconPath: 'C:\icons\my.ico'
launcherDir: 'D:\launchers'
workdir: 'D:\DeepseekHarness'
command: 'npx --yes @deepseek-ai/dsh web'
waitSeconds: 45
常用配置項包括：
shortcutName：快捷方式文件名；url：啓動器打開的地址；port：用於判斷服務是否已運行的端口；iconPath：快捷方式圖標路徑；launcherDir：生成start-dsh.bat的目錄；workdir：啓動器工作目錄；command：啓動 DSH 服務的命令；waitSeconds：等待服務就緒的秒數。
更換圖標¶
將 .ico 或 .png 放入 workspace，或在配置中指定 iconPath，然後重新運行：
/desktop-shortcut
圖標修改後，Windows 桌面可能會緩存舊圖標，可能需要刷新桌面。
npm 訪問慢¶
若 npm 訪問慢，可先執行：
npm config set registry https://registry.npmmirror.com
再運行 /desktop-shortcut 或啓動流程。
適用場景與注意¶
這個插件適合在 Windows 下長期使用本地 DSH web UI、需要一個桌面入口的場景。插件以當前 dsh 進程權限運行；安裝前建議查看 GitHub 源碼和許可證。
其他注意點：
- README 限定 Windows 場景。
- 許可證爲 MIT。
package.json要求Node >=18.0.0，並有peerDependency @deepseek-ai/cordis ^4.0.1。
