DeepSeek Harness 快速開始：npx @deepseek-ai/dsh web

你真正要跑的指令

Node.js 已在 PATH 之後，公開快速開始是：

npx @deepseek-ai/dsh web

套件名稱寫錯會浪費一下午。Web UI 常見位址是 http://127.0.0.1:3080/。終端機要留著，關掉服務就停。上游文件寫 Node ^22.19.0 或 >=24.0.0。請在同一個 shell 裡跑 node -v 和 npx——nvm 在另一個視窗選的版本幫不上忙。

完整一鍵步驟在 安裝頁。本文是敘事，那一頁才是清單。

分系統，但不假裝我們發安裝程式

• Windows： 裝 LTS（winget 或 nodejs.org），重開終端機，cd 到專案目錄再 npx。PATH 與 WSL 坑見 Windows 上的 DeepSeek Harness。
• macOS： 官方 pkg 或 Homebrew；第一天別開完全磁碟存取——見 macOS 上跑 DeepSeek Harness。
• Linux／WSL： nvm 或發行版 Node 22/24。不要用 root。WSL 工作區放在 Linux 檔案系統，別放 /mnt/c 還指望檔案監看正常。

UI 起來之後

1. 設定 → 模型（預覽版文案會變）。貼上 DeepSeek 平台金鑰。本站不發放金鑰。本機 UI 預設不是 本機推理。
2. 選可丟棄工作區。整個使用者家目錄是錯誤的第一目標。
3. 先發低風險任務：列頂層檔案、用五點摘要 README。看工具呼叫。若開始刪檔或亂 chmod，立刻停。

無頭／CLI 留給以後的 CI——DeepSeek Harness headless、--json 與 --session-id 的操作筆記見 無頭跑 DeepSeek Harness。第一個小時仍留在瀏覽器裡，才能看見 Trajectory 一類軌跡。失敗現象（埠被占、缺 pnpm、鏡像落後）見 疑難排解。同一批失敗的決策樹（Node engines → npx 拉取 → 埠 3080 → 金鑰）見 修好 npx 與埠 3080。

npx 與全域安裝

全域 npm i -g 看起來省事，兩個終端機解析到不同主版本時就會出事。提缺陷時寫清：「rc.N，Node 22.19.0，Windows 11，工作區 D:\\scratch\\demo」。上游無法除錯「它掛了」。

源碼路線是 clone 後 pnpm 建置，給寫 Cordis 外掛的人，不要和 npx 混聊。接著選 執行模式，第一環成功再逛 社群外掛。介面外觀 請放到 Creative，不要第一天塞進 Standard。

寫給會踩坑的同事

把 npx 和原始碼 pnpm 寫在同一則訊息裡，是最常見的混亂。只想看 UI 就走 npx；要改 Cordis 再 clone。工作區選錯比指令寫錯更貴：家目錄一旦被當成根，Trajectory 會出現你不認得的路徑。先停，換可丟棄 clone，再繼續。金鑰只放在執行環境要求的檔案，權限照上游，不要貼進 README「方便大家」。公司 npm 鏡像若落後 rc，改官方 registry 再試，而不是再轉三篇「加速教學」。第一環結束後，用同一句提示詞在 Standard 看工具清單，再決定要不要 社群外掛。外觀先讀說明頁，不要從截圖商店一鍵裝。終端機關掉服務就停，這不是當機，是你把行程殺了。

Node 與 npx 必須同一視窗。預覽 UI 文案會變，設定裡的「模型」可能改名，事實是要貼平台金鑰。本機介面預設仍走雲端提供方。工作區根寫進自己的筆記。失敗先看埠、pnpm、鏡像，再懷疑產品。原始碼安裝是寫外掛的路，不是看一眼 UI 的路。第一環成功前不要開外觀市集。家目錄當根會在 Trajectory 留下陌生路徑，立刻停。