DSH 常見錯誤與修復實操：裝不起來、啟動崩潰、更新出錯對照排查
以「你看到的錯誤」對照排查 DeepSeek Harness：npm.ps1 被執行策略攔下、npx 首次啟動乾等、外掛衝突觸發啟動修復對話框、更新出包後的版本核對——每一步都附真實錄影截圖，指令與官方 Discussions 核對過。
最近更新: 2026-10-09
這頁照錯誤實際出現的方式組織：以現象為綱，不做錯誤代碼大全。三段真實錄影驅動全文——一段 Windows 安裝撞上經典的 npm.ps1 攔截，一段 macOS 桌面版因兩個外掛相撞拒絕啟動，一段 Windows 更新後出包。每一節先給你「壞掉的樣子」，再示範正在被執行的修復。
範圍說明：Windows 沙箱權限類錯誤（0xC0000142、Win32 5）是另一族問題，在專門的排查手冊裡承接： 故障排查手冊
症狀 → 先查什麼 → 怎麼修
| 你看到的 | 先查 | 解法 |
|---|---|---|
| 裝到一半紅字滿屏：npm.ps1 cannot be loaded… PSSecurityException | PowerShell 執行策略是不是預設的 Restricted | 放行指令碼後驗證（步驟 1） |
| npx @deepseek-ai/dsh web 首次執行幾分鐘沒動靜 | 是在下載相依套件還是真的卡死 | 換鏡像站 + 詳細日誌（步驟 2） |
| 一啟動就彈出「發現導致啟動失敗的外掛」 | 對話框點名的外掛與衝突元件 | 在修復對話框裡移除肇事外掛（步驟 4） |
| 更新之後外掛集體不對勁、版本對不上 | dsh --version 實際回報的版本號 | 鎖定版本重裝再驗收（步驟 6） |
對症修復步驟
症狀一 · 裝不起來（安裝失敗）
- 1
放行 PowerShell 的指令碼執行策略
Windows 上第一次裝 dsh，最常見的紅字是 npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system，後面跟著 PSSecurityException 和 UnauthorizedAccess。這不是 DeepSeek Harness 壞了，是 PowerShell 預設的 Restricted 策略禁止執行任何指令碼。以系統管理員身分開啟 PowerShell，執行 set-ExecutionPolicy RemoteSigned 並輸入 Y，再用 get-ExecutionPolicy 確認輸出 RemoteSigned；node -v 和 npm -v 各回傳一個版本號，環境就通了。
$set-ExecutionPolicy RemoteSigned$get-ExecutionPolicy$node -v$npm -v
最典型的攔截現場：npm.ps1 被執行策略拒於門外，記事本教學寫明原因和 RemoteSigned 解法。到影片 7:00 觀看 - 2
下載卡住：換鏡像站、開啟詳細日誌
Node.js 裝好後如果 npm install 長時間停在同一行，多半是到 npm 官方源的網路太慢。錄影裡的做法是改用 npmmirror 鏡像站安裝：npm install -g --registry=https://registry.npmmirror.com @deepseek-ai/dsh；再用 npx --verbose @deepseek-ai/dsh web 啟動，詳細日誌能看到正在抓哪些套件。官方 Discussions 也記錄過 Windows 首次執行 8 分鐘零回應的情況（#176）——慢不等於死，別急著關視窗。
$npm install -g --registry=https://registry.npmmirror.com @deepseek-ai/dsh$npx --verbose @deepseek-ai/dsh web
首次啟動會先徵求同意：在 Ok to proceed? 後輸入 y，npx 抓完 dsh 套件才會啟動網頁介面。到影片 11:40 觀看 - 3
認明啟動成功的訊號
輸入 npx @deepseek-ai/dsh web 後按 Enter。首次執行會先問 Ok to proceed? (y)，輸入 y 等它裝完 dsh 套件。只有終端機印出 dsh web: http://127.0.0.1:3080/…（帶 token）並提示 opening the default browser，才算啟動成功；瀏覽器沒自動彈出，就手動開啟這個網址。
$npx @deepseek-ai/dsh web
症狀二 · 一啟動就崩（外掛衝突）
- 4
在啟動修復對話框裡指認肇事外掛
桌面版彈出「发现导致启动失败的插件」，代表某個外掛在註冊階段把 Harness 擋死了——錄影裡的原因是「外掛註冊了重複的服務元件」：session-reference 元件被重複定義，外掛之間存在載入衝突，對話框直接點名 dsh-tui。官方 Discussions 裡有同款案例：@deepseek-ai/dsh-session-reference 在 Harness 升級後註冊失敗，web 直接起不來（#7872）。放心點「卸载此插件并继续检测」——對話框自己寫明：工作區、會話、模型設定和其他外掛不會被刪除。
外掛衝突把啟動擋死：修復對話框點名被重複註冊的 session-reference 元件和肇事者 dsh-tui。到影片 0:05 觀看 - 5
等重新檢測跑完再重啟
點擊「卸载此插件并继续检测」後，按鈕變成「正在处理并重新检测…」，dsh 會移除衝突外掛並重掃啟動項。讓這次重掃跑完、確認對話框不再出現，再重啟 dsh。之後還想用這個外掛，先到外掛市場看它有沒有推出支援目前 Harness 版本的新版，再裝回來。
修復進行中：點下移除後按鈕進入「正在處理並重新檢測」狀態，重掃結束衝突才算清掉。到影片 1:45 觀看
症狀三 · 更新之後不對勁（版本錯亂）
- 6
先問版本，再鎖定版本重裝
更新後外掛集體異常，第一件事是 dsh --version 確認真正裝上的版本。社群多次踩到 npm 的 latest 標籤指向舊構建（#7872、#5813），所以錄影和 Discussions 的標準自救一致：鎖定版本重裝 npm install -g @deepseek-ai/dsh@<version>，精確到修補號，不要 @latest。升級潮後外掛集體失聯的報告編號是 #8145，舊外掛在新 Harness 上回報格式錯誤是 #8432——先移除不相容的外掛，等它推出支援新版。
$dsh --version$npm install -g @deepseek-ai/dsh@<version>
重裝之前先問版本：dsh --version 回報 0.1.5-rc.2，告訴你這次出包的更新實際留下了哪個構建。到影片 2:00 觀看 - 7
回瀏覽器做最後驗收
鎖定版本重裝完成後重新執行 npx @deepseek-ai/dsh web，等終端機給出新的 127.0.0.1:3080 網址並開啟：工作台能載入、模型下拉掛上 DeepSeek 模型，這一輪更新風波就算告一段落。下次大版本升級前先備份 dsh 設定，壞版本隨時可回退——回退細節見排查手冊。
修復完成後的驗收畫面：工作台算繪出提示框，模型一欄已掛上 DeepSeek-V4.1-Flash。到影片 16:20 觀看
常見問題
這三類錯誤之後，大家問得最多的幾件事。
報 npm.ps1 cannot be loaded 是 DeepSeek Harness 壞了嗎？
不是。這是 Windows PowerShell 預設的 Restricted 執行策略在攔截所有指令碼，Node.js 自帶的 npm.ps1 也跑不了。按步驟 1 用系統管理員 PowerShell 執行一次 set-ExecutionPolicy RemoteSigned 即可繼續安裝。RemoteSigned 只要求下載來的指令碼需有簽章，是微軟文件建議的開發機設定，裝完不用改回去。
npx @deepseek-ai/dsh web 卡住沒輸出，是死了嗎？
大概率還在下載。首次執行要抓完整的 dsh 套件和相依套件，官方 Discussions 記錄過 Windows 首次執行 8 分多鐘零進度回應的案例（#176）。網路不好就按步驟 2 換 npmmirror 鏡像站並加 --verbose 看進度。真的出問題時終端機會印出明確的紅字，到時再照錯誤內容處理。
啟動修復對話框移除外掛，會丟我的會話和設定嗎？
不會。對話框寫得很清楚：工作區、會話、模型設定和其他外掛不會被刪除，它只移除點名的肇事外掛然後重掃。真正會動到資料的是手動清空 dsh 主目錄這類操作，沒備份別做。
更新後外掛全掛了，該等官方修復還是回退版本？
先 dsh --version 確認版本。官方 Discussions 裡有升級潮後外掛集體失聯（#8145）、舊外掛在新版 Harness 上格式不相容（#8432）的回報，也出現過 latest 標籤指向舊構建的先例（#7872、#5813）——被標籤錯位波及的機器鎖定版本重裝立刻恢復。想長期鎖版本或整體回退，照排查手冊的版本回退小節操作。
這頁的錯誤和 Windows 沙箱權限錯誤（0xC0000142 / Win32 5）是同一回事嗎？
不是——它們是另一族錯誤，而且官方討論 #9280 已經定位到根因：打包版桌面應用裡 process.execPath 指向無主控台的 Electron GUI 二進位，由它拉起沙箱的 ACL runner 子程序；子程序沒有主控台可繼承，DLL 初始化隨之失敗，報 0xC0000142。對應的修復是 console 雙模式建置——正常啟動時是 GUI，被父程序拉起時走 console。社群排障索引帖 #9195 按故障點給症狀路由，排查手冊的 Windows sandbox 一節有逐步處理方案。
回合失敗，報「this turn failed api key is invalid」是什麼意思？
這是請求已經到達模型端點、但 API key 被拒——中文介面會把它顯示為「本輪執行失敗 api key is invalid」，中英混排就是這句話的原樣。先檢查 API key 設定：dsh 模型設定裡填的 key、以及它依賴的環境變數，都必須對應一個有效且未刪除的 key。改好設定後重新啟動 dsh 讓新值生效，再重試這一回合。
相關攻略
照你的錯誤最終指向，接著讀這幾篇。
故障排查手冊
沙箱權限錯誤、cordis.patch.yml 衝突、profile 不生效與版本回退的深度手冊，本頁的錯誤追到底都會落到這裡。
閱讀教學DSH Web UI 從啟動到手機
dsh web 一條指令啟動網頁版，摸透 3080 工作台、斜線技能與模型設定，再用 dsh-web 生態系把手機接進來——9 步實測截圖
閱讀教學dsh-pocket：把 DSH 放進口袋
電腦跑 dsh web，手機掃 QR Code 即同步畫面：區域網路直連或 Cloudflare 免費隧道，輸出即時同步、手機可反向操作——7 張逐格核對截圖。
閱讀教學遠端與手機存取合集
dsh-web、dsh-pocket、Agents-Anywhere、dsh-mobile——精選遠端用戶端一次收齊。
閱讀教學手機遠端存取 DSH（ngrok 通道）
把同一個 3080 網頁版透過免費通道公開，在外網瀏覽器裡也能指揮家裡的 Agent。
閱讀教學Windows 安裝教學
從 Node.js 到 dsh web 跑通的完整 Windows 安裝路徑，環境先做對，錯誤少一半。
閱讀教學macOS 安裝教學
在 Mac 上從終端機設定到首次啟動，乾淨裝好 DeepSeek Harness。
閱讀教學外掛更新指南
什麼時候跟 latest、什麼時候鎖版本的升級節奏，從源頭減少步驟 6 的症狀。
閱讀教學外掛移除指南
乾淨移除外掛並還原 profile——步驟 4 啟動修復對話框的手動版。
閱讀教學影片來源
本頁截圖裁切自三位 UP 主的公開教學錄影；畫面裡每個修復步驟都由 UP 主實際執行，並與官方 Discussions 的對應回報交叉核對。深連結直達對應秒數。