DeepSeek Harness 下載安裝教學(Windows/Mac 桌面版)
今晚有兩個人想下載 DeepSeek Harness。第一個打開終端機,敲一條命令,兩分鐘後已經在幹活了。第二個到處找安裝包,官網翻遍找不到 .exe,於是斷定這東西還在內測。同一款軟體,兩種截然相反的結局——差別只在於知不知道該走哪扇門。
這兩扇門本文都給。命令列不嚇人的,官方安裝真的只有一條命令;非雙擊不可的,社群桌面版真實存在、確實好用——但它不是 DeepSeek 的產品,這一點比聽起來重要。下面從下載到跑起第一個任務,Windows 和 Mac 全覆蓋。
先說結論:DeepSeek Harness 去哪下載?
官方沒有安裝包。DeepSeek Harness 以開源專案形式發布,官方「下載」實際上是兩件事:裝 Node.js,然後跑一條 npx 命令——命令會自動拉取程式包,把智能體以本地 Web UI 的形式啟動在你瀏覽器裡。沒有應用商店,沒有 .exe,沒有帶藍鯨圖示的 .dmg。
非要安裝包的,社群幫你解決了——但有幾個必須說清的但書。
| 官方(npx) | 社群桌面版 | |
|---|---|---|
| 來源 | DeepSeek 官方(deepseek.com/harness) | 第三方開發者 |
| 形態 | 一條命令 → 本地 Web UI(127.0.0.1:3080) | Electron 應用,雙擊安裝 |
| 要裝 Node.js | 要 | 不要,已內建 |
| 平台 | Windows、macOS,Node 能跑就行 | 以 Windows 10/11 為主,有 Mac 版本 |
| 授權 | MIT | 各專案不同(如 BSD-3) |
| 信任基準 | 官方發布 | 原始碼自己審 |
選擇很簡單。終端機用得順手?走官方——比讀完上面這張表還快。命令列過敏?社群版把同一個官方引擎包進了一個能雙擊的視窗。兩條路終點相同。
方法一:官方安裝(npx)
把官方路徑想成一包掛耳咖啡:咖啡粉已稱好、濾袋已掛好,熱水一沖就能喝。但你得先有燒水壺——這裡的燒水壺就是 Node.js。
第一步:安裝 Node.js(燒水壺)
去 nodejs.org 下載 LTS 版。Windows 是 .msi,跟裝一般軟體一樣下一步到底;macOS 是 .pkg,用 Homebrew 的話 brew install node 也行。
一句誠實提醒:官方 README 只寫了「Install Node.js」,沒有標註最低版本,所以「建議 LTS」是穩妥推薦而非文件要求。如果你機器上還跑著好幾年前的老 Node 然後各種報錯,第一個該懷疑的就是它。
第二步:一條命令啟動(熱水)
開個新終端機,執行:
npx @deepseek-ai/dsh web首次執行會下載程式包——這才是 DeepSeek Harness 真正的「下載」動作,而且全自動。我第一次跑時,它正好填滿一個燒水的間隙——水開了,位址也出來了。稍等片刻,命令印出位址 http://127.0.0.1:3080,並自動在瀏覽器開啟。
兩個值得記住的變體:
- SSH 或無桌面環境下,它只印出 URL,不開任何東西。
- 加
--no-open,則完全不碰你的瀏覽器。
瀏覽器裡看到的介面,本質是你剛啟動的一個本地小伺服器。用起來很像桌面軟體——設定面板、工作區選擇一應俱全——但底下是官方引擎跑在你機器上,透過 localhost 跟瀏覽器對話。
愛折騰的人還可以原始碼執行:git clone 官方儲存庫,pnpm install、pnpm run build、pnpm dsh web。對其他人來說,npx 已經替你把這些活全幹了。
第三步:填 API key,選工作區
介面在能思考之前只缺一把鑰匙。打開 Settings → Models,貼上你的 DeepSeek API key——在 platform.deepseek.com 儲值少量餘額後建立,API key 申請教學有完整步驟——儲存即可,不用重啟,立即生效。
然後選一個工作區資料夾。智能體將在這個目錄裡讀檔案、改程式、跑命令,所以第一次實驗選個可拋棄的目錄,別拿最寶貝的專案開刀。丟給它一個小任務,看它幹活。安裝到此全部完成。
方法二:社群桌面版
同一杯咖啡的便利超商瓶裝版:配方相同,瓶子是別人裝的,扭蓋即飲。
最有名的專案是一個開源 Electron 用戶端(GitHub 上的 ningbainb/deepseek-harness-desktop,8 月騰訊雲開發者社群有評測)。思路很直接——桌面應用在你機器上啟動官方 @deepseek-ai/dsh 引擎,把它的 Web UI 裝進一個正經視窗裡,啟動、更新、底層管線都由外殼負責。BSD-3 授權,Windows 10/11 x64 安裝包,全部內建:不用 Node.js、不用 pnpm、終端機一次都不用開。
而且它不止於「包殼」。評測亮點包括:帶狀態流和 cron 排程的任務看板、分支與提交視覺化的 Git 圖譜、支援預覽/diff/暫存的檔案面板、可搜尋的技能庫、推理強度調節滑桿,以及透過 ChatGPT 登入接入 Codex 模型的連接器。專案跑得很快——首個版本與官方開源同一天(8 月 13 日)發布,兩天後 GitHub star 破 4000,目前穩定版 2.6.0。
接下來是真正重要的部分。這不是 DeepSeek 的產品。你還會撞見的其他封裝也一樣——微軟商店的「小白專用」安裝版、dshdesktop.com、宣稱支援 Mac 的 denys.cn 建置版。安裝包會在你機器上執行程式碼,裡面還放著你的 API key,所以對所有第三方專案規則相同:讀儲存庫、看更新是否活躍、自己拿主意。我裝任何第三方封裝前的固定儀式是翻一遍它的 issue 清單——棄坑和惡意行為都會在那裡早早露臉。本文連到 GitHub 儲存庫而不給任何下載站,理由正在於此——能讀到原始碼的東西,勝過一個黑盒二進位檔。
macOS 使用者怎麼辦?
Mac 使用者走官方路徑完全不變——Node.js 有 macOS 安裝包,npx @deepseek-ai/dsh web 行為一模一樣。瀏覽器開啟,介面出現,結束。
社群桌面版的選擇面窄一些。多數專案盯著 Windows 10/11,至少有一個社群版本宣稱支援 macOS——但那是社群說法,我們沒驗證過。給 Mac 下載任何東西之前,先去具體專案的 releases 頁看有沒有貨真價實的 .dmg 檔案——README 裡的一句宣稱,價值恰好等於它最近一次提交的日期。
常見安裝問題
四個卡點反覆出現,而四個的解法都很樸素。
npx 下載巨慢或失敗。 那是程式套件庫或網路的問題,不是 DeepSeek Harness 本身。換更快的 npm 鏡像源,或避開尖峰重試,通常都能解決——Node 生態的標準操作。
3080 連接埠被占用了。 機器上有別的程式佔了這個埠,那就讓 dsh 換一個:--port 加一個你選的埠號即可。啟動器的參數放在前面,位於子命令自己的參數之前。
首次執行被 profile 繞暈。 Harness 把設定放在 profile 裡——想像遊戲的存檔位。web 和 headless 兩個 profile 在首次啟動時自動初始化,就像新遊戲自動建好第一個存檔。其他 profile 需要時用 dsh plugin 手動建立。如果 Web UI 正常起來了、你也沒碰過 profile,說明一切本來就正常。
老 Node 上怪報錯。 README 沒鎖版本,但很老的 Node 能讓現代工具鏈以各種創意方式壞掉。升級到目前 LTS 解決的疑難雜症,比這裡任何其他單一招數都多。
常見問題
有官方的 DeepSeek Harness 下載頁嗎?官方入口是 deepseek.com/harness——頁面上「Try it now」按鈕就是那條 npx 命令本身。官方開發者文件有同樣的步驟。官方 .exe 或 .dmg 不存在。
DeepSeek Harness 下載使用免費嗎?框架本身 MIT 開源,永久免費。模型按 token 計費,走你設定的廠商——這筆帳怎麼算、和包月訂閱比哪個划算,Coding Plan 詳解裡攤開了講。
安裝需要內測資格嗎?不需要。封閉內測在 2026 年 8 月 13 日專案全球開源那天就結束了,現在任何人都能直接裝。完整時間線在內測與公測指南裡。
手機上能用嗎?不能。Harness 是一個本地執行環境,要改檔案、執行命令——這是桌面和伺服器的主場。DeepSeek 的手機 App 是聊天產品,完全兩回事。
選適合你的那扇門。官方 npx 下載花你一條命令加一把燒水壺,社群桌面版花你一次安全審查。不管哪條路,五分鐘內都能跑起來。