前言¶
DeepSeek Harness（DSH）通過 Cordis 插件擴展 Web 界面與 Host 能力。日常用 @deepseek-ai/dsh 時，版本往往分散在終端裏的 npm、全局安裝目錄和仍在內存裏跑的老進程之間；裝完新版若不重啓，頁面表現和磁盤上的包很容易對不上。社區插件 dsh-update-center（GitHub：Yara2090/dsh-update-center）在 Web 設置面板增加「更新與版本」頁，把當前版本、註冊表新版本、一鍵安裝、插件完整性自檢與修復，以及停止服務收進同一處。
這是什麼¶
dsh-update-center 由維護者 Yara2090 發佈，在 SkillHub 目錄中歸類爲客戶端插件。它是 DSH Cordis 的 Host + Client 雙半邊實現：純 JavaScript、ESM、無構建步驟、無運行時依賴；瀏覽器半邊只從宿主模塊表引入 react。
一句話定位：給 DeepSeek Harness Web GUI 提供「Updates & Version」設置頁——讀取本機 @deepseek-ai/dsh 版本、按可選通道查詢 npm 註冊表、將新版本裝到同一全局前綴，並對插件自身做完整性檢查與可安全執行的一鍵修復。
核心功能¶
版本與更新¶
- 同時展示「已安裝」與「最新」版本，可在穩定版 / 預覽版通道間切換。
- 支持「立即檢查」「立即更新」；默認約每 6 小時自動檢測新版本（可在頁面上改頻率與開關）。
- 裝到磁盤但未重啓時，頁面會並列「已安裝」與「運行中」版本，避免誤以爲已生效。
- 定位不到安裝版本或註冊表未返回所選標籤時，顯示明確狀態或錯誤，而不是誤報「已是最新」；本機跑預發佈版且註冊表
latest更舊時，判定爲「無更新」（不自動降級）。
安裝進度¶
一鍵更新走全局安裝命令；進度條爲不確定態（npm 不提供總量），頁面展示真實信號：已用時長、已取包數，以及在 npm 場景下基於緩存目錄統計的下載字節與速率；長時間無輸出時會說明 npm 在管道模式下可能靜默，而不是假裝正常。
完整性檢查與一鍵修復¶
進入頁面時會自動跑一次只讀自檢，共 10 項，覆蓋插件文件、清單、源碼依賴、瀏覽器半邊、profile 註冊與 node_modules 鏈接、偏好 JSON、DSH 主目錄可寫、Node ≥ 20、能否定位全局 @deepseek-ai/dsh。其中 profile 註冊、鏈接、偏好文件、主目錄等項支持「一鍵修復」：修復前寫同名 .bak 備份，只補缺失、不刪用戶已有內容。
自動檢測與自動安裝¶
頁面上可開關自動檢測，頻率可選 1 / 6 / 12 / 24 小時；自動安裝默認關閉，開啓時會有風險提示。
運行控制¶
提供「停止 Harness」（需兩次確認）。頁面說明：關閉瀏覽器標籤不會停止服務。停止動作調用 <DSH_HOME> 下安裝器放置的 stop-deepseek-harness.ps1，與桌面快捷方式行爲一致；安裝進行中會拒絕停止（HTTP 409）。
安全邊界¶
會改寫全局 npm 包的路由僅接受迴環地址，非迴環請求返回 403。
安裝與啓用¶
前提：Node ≥ 20，且已安裝 DeepSeek Harness。插件當前資料中的包版本爲 1.6.4，許可證 MIT。
方式一：手動加入 web profile¶
先把插件目錄放到本機路徑（例如 C:\dsh\dsh-update-center），再執行：
dsh plugin --profile web add "file:C:\dsh\dsh-update-center"
接着編輯 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 中增加一行：
"@local/dsh-update-center"
dsh plugin add 只裝依賴，不會自動寫入 bundle 列表；缺少這一步時，設置裏不會出現「更新與版本」。最後重啓 Harness，打開 設置 → 更新與版本（導航順序在「模型」之後、「插件」之前）。
方式二：在 Harness 對話中安裝¶
在 Harness 對話框發送：
把 https://github.com/Yara2090/dsh-update-center 裝成插件
由 DSH 完成克隆、裝依賴並寫入 profile 的 bundle 列表；按提示重啓一次即可。
常見問題¶
| 現象 | 處理 |
|---|---|
| 設置裏找不到「更新與版本」 | 檢查 dsh.profile.bundles 是否包含 @local/dsh-update-center |
| 卡片報錯 | 使用「一鍵修復」；無法自動修的部分會給出說明 |
| 遠程機器瀏覽器打不開相關能力 | 寫磁盤與敏感路由僅對本機迴環開放 |
提示找不到 dsh |
先執行 npm i -g @deepseek-ai/dsh |
典型用法¶
- 安裝並寫入 bundle 後重啓，進入 設置 → 更新與版本。
- 在「版本信息」卡片選擇更新通道，點「立即檢查」確認最新版；需要時點「立即更新」，觀察安裝卡片中的命令、實時輸出與進度信號。
- 更新完成後若「運行中」仍爲舊版，按頁面提示重啓 Harness 後再確認。
- 若頁面異常或插件未加載，在「完整性檢查」中查看 10 項結果，必要時點「一鍵修復」。
- 在「自動檢測」中按需開啓週期檢測；僅在理解風險後開啓自動安裝。
- 需要停服務時，在「運行控制」中兩次確認「停止 Harness」，並按浮層提示關閉標籤頁（瀏覽器可能需手動
Ctrl+W）。
偏好寫入 <DSH_HOME>/dsh-update-center.json（通道、自動檢測、自動安裝、頻率等）。
卸載¶
- 從
~/.dsh/profiles/web/package.json的dsh.profile.bundles刪除"@local/dsh-update-center"。 - 執行
dsh plugin --profile web remove @local/dsh-update-center。 - 重啓 Harness。
<DSH_HOME>/dsh-update-center.json 可保留或刪除。插件不改 Harness 核心文件；若使用過「一鍵修復」，可能動過 profile 清單、鏈接與偏好文件，且留有 .bak 備份。
適用場景與注意¶
適合在本機長期使用 DSH、希望用 Web 界面統一查看版本、更新 @deepseek-ai/dsh、排查 web profile 插件鏈接與 bundle 註冊問題的開發者。
插件 Host 半邊以當前 DSH 進程權限運行，一鍵更新會執行全局包管理器安裝；安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，並在可信環境使用。SkillHub 上的 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文介紹的是社區維護的客戶端插件（倉庫星標數在目錄線索中爲 0，以各站點實時顯示爲準）。
結尾¶
dsh-update-center 把 DSH 的版本信息、註冊表檢測、全局安裝、插件自檢修復和服務停止集中到設置頁「更新與版本」，減少在終端與桌面快捷方式之間來回切換。進一步瞭解與提交問題見 GitHub：Yara2090/dsh-update-center，插件索引見 SkillHub 目錄頁。
