前言¶
DeepSeek Harness（DSH）桌面端若希望每次登錄 Windows 後自動打開，常見做法是手動往註冊表 Run 項或「啓動」文件夾裏寫一條啓動命令。路徑隨安裝位置變化，改開關時還要記註冊表鍵名或 .cmd 位置，和 DSH 設置界面也脫節。
dsh-harness-autostart 是社區維護的 DSH 客戶端插件（維護者 lolitakawayi），在 Settings → General 增加「Autostart」開關，並註冊 dsh_autostart 工具，供模型查詢、啓用或關閉自啓動項。兩種入口共用同一套宿主邏輯，狀態一致。僅支持 Windows；其他平臺上開關爲禁用，工具返回 unsupported-platform。
這是什麼¶
插件 bundle 名 dsh-harness-autostart，在 cordis.patch.yml 中的條目 id 爲 dsh-autostart。當前 npm 包版本 1.0.0，許可證 MIT。分類屬於客戶端側 UI 與本地 HTTP 路由注入，依賴 Cordis 與 DSH 客戶端設置 General 等 peer 包（見倉庫 package.json）。
卸載插件時會刪除已寫入的自啓動項，README 說明不會留下殘留。
寫入方式與路徑檢測¶
默認配置 method: run-key，在當前用戶 Run 鍵下寫入字符串值，不需要管理員權限：
HKCU\Software\Microsoft\Windows\CurrentVersion\Run
DeepSeekHarness REG_SZ "D:\ProgramData\dsh\DeepSeek Harness.exe"
示例中的 exe 路徑僅爲說明格式；實際路徑由插件檢測，而非寫死。檢測順序爲：環境變量 DSH_DESKTOP_EXE；若當前進程可執行文件不是 node.exe 則用該路徑；否則使用默認安裝路徑。可在配置裏設置 executable 覆蓋。
method: startup-folder 則在 %APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\<entryName>.cmd 寫入啓動腳本，適合需要在登錄後延遲幾秒再打開應用的場景（配合 delaySeconds）。
核心功能¶
設置頁開關¶
安裝完成後，Settings → General 在「Performance usage」下方增加一行 Autostart。
- 控件爲
role="switch"，帶aria-checked；可用 Tab 聚焦後按空格切換。 - 切換後立即寫入或刪除自啓動項，無需刷新頁面或再調模型。
- 行內展示當前狀態、寫入方式（method）、條目名稱（entryName）以及解析後的可執行文件路徑。
瀏覽器端（client.js）只負責渲染；註冊表與文件寫入均在宿主 index.js 完成。讀寫通過同源 fetch 訪問宿主註冊的本地 HTTP 路由：
GET /dsh-autostart-8f3c/statusPOST /dsh-autostart-8f3c/enablePOST /dsh-autostart-8f3c/disable
三者均返回 JSON。
dsh_autostart 工具¶
插件註冊工具 dsh_autostart，參數爲單個 action：
| action | 作用 |
|---|---|
status |
返回當前狀態、寫入方式、條目名、解析後的 executable，以及註冊表或文件中實際存在的值/路徑 |
enable |
寫入自啓動項 |
disable |
刪除自啓動項 |
開關與工具調用同一宿主函數，不會出現一邊開、一邊關的不一致。
安裝與啓用¶
在 DSH 內通過插件管理器從 npm 安裝：
plugin_manager action=install_bundle target=dsh-harness-autostart
從本地目錄安裝時：
plugin_manager action=install_bundle target=<absolute path to this directory>
安裝後重啓或按 DSH 慣例加載 bundle，即可在 General 中看到 Autostart。默認配置 autoEnable: true 時，插件加載時會寫入自啓動項；若只希望保留開關和工具、不自動改系統，將 autoEnable 設爲 false。
配置¶
修改 cordis.patch.yml 裏 dsh-autostart 條目的 config 塊後，重啓 DSH 生效。
| key | 默認值 | 含義 |
|---|---|---|
autoEnable |
true |
插件加載時是否寫入自啓動項 |
method |
run-key |
run-key 寫 Run 鍵；startup-folder 寫啓動文件夾 .cmd |
entryName |
DeepSeekHarness |
Run 值名或 Startup 下文件名，淨化爲 [A-Za-z0-9_.-] |
executable |
'' |
空則自動檢測 |
args |
[] |
傳給應用的額外參數 |
delaySeconds |
0 |
登錄後等待秒數；非零時在 Run 鍵方式用 cmd /c start 包裝，或在 .cmd 中加 timeout |
卸載與手動清理¶
plugin_manager action=remove_bundle target=dsh-harness-autostart
卸載會刪除自啓動項。若異常殘留，可手動刪除 Run 值（條目名默認 DeepSeekHarness）：
reg delete "HKCU\Software\Microsoft\Windows\CurrentVersion\Run" /v DeepSeekHarness /f
適用場景與注意¶
適合在 Windows 上長期開機使用 DSH 桌面端、又希望用圖形開關或模型工具統一管理自啓動的用戶。插件以 當前 DSH 進程權限 寫 HKCU 或當前用戶 Startup 目錄，不涉及提升權限；安裝前仍建議閱讀倉庫源碼與 MIT 許可證，確認寫入路徑與 executable 檢測邏輯符合你的環境。
DSH 生態強調「一切皆插件」；社區目錄頁與 GitHub 倉庫由維護者發佈，與 DeepSeek / 幻方無官方從屬關係，本文不以「官方應用商店」表述。
