DeepSeek Harness Web UI 無法啟動怎麼辦

如果 npx @deepseek-ai/dsh web 執行後立刻結束、長時間沒有回應，或終端機顯示已啟動但瀏覽器打不開，請依照下列順序排查。先保留終端機的完整輸出；最早出現的錯誤通常比後面的連鎖訊息更有判斷價值。

先確認指令與套件名稱

請完整執行官方套件指令：

npx @deepseek-ai/dsh web

不要替換成名稱相近的社群套件。第一次執行時，npx 可能會詢問是否允許下載，請先確認名稱再繼續。

檢查 Node.js 與 npm

node --version
npm --version

若其中一項指令不存在，請安裝目前的 Node.js LTS。Node 版本過舊時，升級後要重新開啟終端機、再次確認版本，再執行 Harness。

分清楚是下載失敗還是啟動失敗

若錯誤提到套件解析、registry、DNS、憑證或 proxy，問題發生在 Harness 啟動之前。請檢查 npm registry 與目前的網路政策。公司網路的 TLS 檢查也可能阻止下載；應採用組織核准的設定，不要關閉憑證驗證來繞過安全機制。

若套件已下載完成，而且終端機也顯示本機網址，通常代表啟動程式已經正常執行。

開啟終端機顯示的本機網址

目前的 Developer Preview 通常使用 http://127.0.0.1:3080，但仍應以終端機輸出為準。請在執行指令的同一台電腦上開啟該網址。127.0.0.1 只指向目前這台裝置，不會自動開放給其他裝置連線。

排查連接埠衝突

若看到 “address already in use” 或 EADDRINUSE，代表指定連接埠已被其他程序占用。可以先停止先前啟動的 Harness，或確認是哪個本機程序使用該連接埠。不要在不清楚用途時直接強制結束程序。

保持終端機程序執行

關閉終端機或按下 Ctrl+C 都會停止本機服務。若頁面原本能開啟、稍後卻無法存取，請重新執行指令並保持該程序運作。

什麼情況適合回報上游

若在目前的 Node.js 版本上使用正確指令，仍能穩定重現問題，請整理作業系統、Node 版本、執行指令、完整錯誤輸出與最小重現步驟。移除 API 金鑰、本機路徑與儲存庫內容後，再提交至官方 Issue 追蹤頁面。