前言¶
在 Windows 上日常使用 DeepSeek Harness 桌面應用時，希望登錄後自動啓動客戶端，常見做法是手動往「啓動」文件夾放快捷方式，或自己在註冊表 Run 項裏寫路徑。路徑一旦重裝或升級變化，條目就會失效；若在任務管理器裏禁用過啓動項，狀態和設置界面也未必一致。
下面介紹社區插件 dsh-desktop-autostart-win（維護者 nanwu98，分類：客戶端）。它在 DSH 設置裏增加一頁 Startup / 開機自啓，用一個開關維護當前用戶下的啓動項，並自動探測已安裝的桌面端 .exe，不把路徑重複存進插件配置。
這是什麼¶
插件全名：dsh-desktop-autostart-win。作用範圍是 DeepSeek Harness 桌面應用在 Windows 10/11 上的登錄後自啓：設置裏一個開關，對應 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 裏的一條 per-user 記錄；頁面展示的狀態以 Windows 實際會執行的爲準。
發行在 GitHub，無 npm 包。許可證 MIT。當前 package 版本爲 1.0.0。DSH 側要求 >=0.2.2-rc.1 且 <0.3.0，且 bundle 僅支持 win32（非 Windows 安裝會被拒絕，而不是顯示無效開關）。
核心功能¶
設置頁與開關行爲¶
安裝後可在 設置 → 開機自啓 操作：
| 開關 | 效果 |
|---|---|
| On | 在 HKCU\...\Run 寫入 DeepSeek Harness = "<desktop app>.exe"，並清除任務管理器裏此前的「已禁用」記錄，使用戶登錄後 Windows 會啓動該應用。 |
| Off | 刪除該註冊表值，應用不再自動啓動。 |
插件配置裏不重複保存啓動狀態；唯一持久狀態就是上述 Run 項，因此頁面反映的是系統真實行爲。
自動查找桌面端可執行文件¶
不硬編碼安裝路徑。按順序嘗試，遇到第一個存在的可執行文件即停止：
| 來源 | 讀取內容 |
|---|---|
| 正在運行的桌面應用 | Host 爲桌面應用時，使用 process.execPath |
| App Paths | HKCU/HKLM 下 App Paths\DeepSeek Harness.exe（含 64/32 位視圖） |
| 安裝目錄 | %LOCALAPPDATA%\Programs、%ProgramFiles%、%ProgramFiles(x86)% 及常見產品文件夾名 |
| 卸載註冊表 | HKCU/HKLM 卸載項中的 DisplayIcon、InstallLocation、UninstallString |
僅接受真實 .exe，會拒絕 node.exe、electron.exe 和卸載程序。設置頁會顯示匹配來源；未找到時下次打開頁面會重試（結果緩存一分鐘）。因此在純 dsh CLI 會話裏開關仍可用：CLI 雖是 node.exe，仍可從註冊表等解析出桌面端路徑。
與任務管理器啓動項的關係¶
Windows 是否運行啓動項，同時受 Run 鍵和任務管理器「啓動」批准記錄影響。插件寫入 Run 項，並在打開開關時清除對應的 StartupApproved 記錄，使曾在 任務管理器 → 啓動 裏被禁用的項在重新打開開關後恢復。若項仍存在但被禁用，頁面會如實提示，而不會顯示爲已開啓。
無需管理員權限：讀寫均在當前用戶 HKCU，不寫機器級配置。
權限與隱私¶
讀取：用於定位應用與展示狀態——Run、Explorer\StartupApproved\Run、App Paths、卸載相關字段（顯示名、圖標、安裝目錄、卸載命令等）。
寫入：僅在使用開關時——增刪 Run 下的 DeepSeek Harness 值，並在開啓時刪除匹配的 StartupApproved 項。
插件不髮網絡請求、不寫文件、不採集遙測。檢測到的路徑與註冊表狀態僅返回給本機設置頁（路由拒絕非 loopback 訪問，除布爾開關外只讀）。
安裝與啓用¶
環境：DSH 0.2.2-rc.1 或更新的 0.2.x、Windows 10/11、Node.js 22+（隨 DSH 捆綁）。下面命令中的 desktop 請換成你實際啓動 DSH 使用的 profile。
從 GitHub 安裝（本機需 Git，DSH 會用 git ls-remote 校驗倉庫）：
dsh plugin --profile desktop add github:nanwu98/dsh-desktop-autostart-win
固定到 release v1.0.0：
dsh plugin --profile desktop add github:nanwu98/dsh-desktop-autostart-win#v1.0.0
無 Git 時可用 release 壓縮包：
dsh plugin --profile desktop add https://github.com/nanwu98/dsh-desktop-autostart-win/releases/download/v1.0.0/dsh-desktop-autostart-win-1.0.0.tgz
也可在 DSH 插件 → 添加插件 中粘貼倉庫 URL 或 tarball URL（僅包名對 registry 包有效）。若頁面提示重啓 DSH，重啓後打開 設置 → 開機自啓。
在 插件 → 發現 中可增加索引源以便 Discover 發現本包（需當前 DSH 版本啓用實驗性 plugin-market bundle），例如 jsDelivr：
https://cdn.jsdelivr.net/gh/nanwu98/dsh-desktop-autostart-win@main/index.json
典型用法¶
- 按上一節任選一種方式安裝插件。
- 打開 設置 → 開機自啓，確認頁面顯示的桌面端路徑與匹配來源是否符合預期。
- 打開開關：下次 Windows 用戶登錄後應自動啓動 DeepSeek Harness 桌面應用。
- 不再需要自啓時，將開關關閉；若準備移除插件，建議先關開關再卸載 bundle（見下節）。
卸載 bundle：
dsh plugin --profile desktop remove dsh-desktop-autostart-win
移除插件會刪掉路由與設置頁，不會自動清除已寫入的 Run 啓動項；若需徹底取消自啓，應先關開關或手動清理 Run 項。
適用場景與注意¶
適合誰： 在 Windows 上固定使用 DeepSeek Harness 桌面端、希望登錄即啓動、又希望路徑隨安裝方式自動更新的 DSH 用戶。
平臺： 僅 Windows；Linux/macOS 用戶不應安裝此 bundle。
DSH 與插件權限： 插件隨當前 DSH 進程運行，註冊表操作以該用戶上下文執行；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認行爲符合本機策略。
與其它做法的區別： 本插件管理的是 per-user Run 鍵，而非「啓動」文件夾；與同名稱其它插件無隸屬關係，選型時以 README 說明爲準。
DeepSeek Harness 生態強調「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-desktop-autostart-win 把 Windows 登錄自啓收斂爲一個設置開關、一條 HKCU\Run 記錄和一套可解釋的桌面端探測邏輯，並區分任務管理器禁用狀態，適合需要穩定、可覈對開機行爲的桌面 DSH 場景。
- 目錄頁：https://www.skillhub.cn/plugins/nanwu98/dsh-desktop-autostart-win
- 源碼與文檔：https://github.com/nanwu98/dsh-desktop-autostart-win
