一、簡介DeepSeek Harness 是什么DeepSeek Harness 是一個在本機運行的工具用來調(diào)用 DeepSeek 的 Agent 服務(wù)。裝好之后你只需要一個 API Key就能在瀏覽器里使用 DeepSeek 的智能體能力不需要自己搭建復(fù)雜的服務(wù)端。本教程的目標(biāo)跟著下面的步驟從零開始完成「注冊平臺 → 創(chuàng)建 Key → 安裝環(huán)境 → 啟動服務(wù) → 開始使用」全流程。所有操作都是復(fù)制粘貼命令零基礎(chǔ)也能完成。 一句話總結(jié)先在 DeepSeek 平臺拿到一把鑰匙API Key再在本機裝一個門Harness鑰匙插進門里就能用了。二、準(zhǔn)備工作開始前先收藏以下兩個網(wǎng)站網(wǎng)站地址用途DeepSeek 開放平臺https://platform.deepseek.com/sign_in注冊賬號、充值、創(chuàng)建 API KeyDeepSeek Harness 項目https://github.com/deepseek-ai/deepseek-harness官方源碼與文檔遇到問題可查 Issues三、整體流程先看全貌再動手注冊登錄DeepSeek 開放平臺并完成充值調(diào)用服務(wù)需要賬戶余額打開API Keys菜單創(chuàng)建 API Key在本機安裝 Node.js 22Windows / macOS 二選一見下文用一條命令啟動 DeepSeek Harness在瀏覽器里填入 API Key開始使用??重點提醒必看API Key 創(chuàng)建成功后只能查看一次頁面之后無法再次顯示。請創(chuàng)建后立刻保存到記事本或密碼管理器萬一丟了只能刪除后重新創(chuàng)建。四、環(huán)境要求安裝 DeepSeek Harness 之前電腦需要先安裝Node.js 22 或更高版本。 如果不想用下面的版本管理器fnm也可以直接到 Node.js 官網(wǎng)nodejs.org下載22.x LTS安裝包雙擊安裝即可效果一樣。下文給出的是更規(guī)范的 fnm 方式便于以后切換版本。五、Windows 系統(tǒng)安裝請右鍵以管理員身份打開 PowerShell依次執(zhí)行以下步驟。1. 一鍵安裝 fnm Node.js 22 國內(nèi)鏡像源winget install Schniz.fnm fnm env--use-on-cd|Out-String|Invoke-Expressionfnm install 22 fnm default 22 npm configsetregistry https://registry.npmmirror.com這段命令做了三件事安裝fnmNode.js 版本管理器用 fnm 安裝并啟用Node.js 22把 npm 源切換為國內(nèi)鏡像后續(xù)下載依賴更快更穩(wěn)2. 驗證是否成功輸出 v22.x.x 即成功node-v npm-v npm config get registrynode -v顯示v22.x.x→ Node.js 安裝成功npm -v顯示版本號 → npm 正常最后一行顯示鏡像地址 → 鏡像配置成功六、macOS 系統(tǒng)安裝打開終端依次執(zhí)行以下步驟。1. 一鍵安裝 fnm Node.js 22 國內(nèi)鏡像源curl-fsSLhttps://fnm.vercel.app/install|bash\exportPATH$HOME/.local/share/fnm:$PATH\eval$(fnmenv--use-on-cd)\fnminstall22\fnm default22\npmconfigsetregistry https://registry.npmmirror.com2. 寫入 shell 配置永久生效echoexport PATH$HOME/.local/share/fnm:$PATH~/.zshrcechoeval $(fnm env --use-on-cd)~/.zshrc寫入后以后每次打開終端都能直接使用fnm、node命令無需重復(fù)配置。3. 驗證是否成功node-vnpm-vnpmconfig get registry看到v22.x.x即安裝成功。七、啟動 DeepSeek HarnessNode.js 裝好后在Windows 的 CMD或macOS 的終端中執(zhí)行npx deepseek-ai/dsh webnpx會自動下載并運行工具不需要手動全局安裝一條命令搞定。啟動成功后在瀏覽器中訪問http://127.0.0.1:3080即可打開 DeepSeek Harness 的網(wǎng)頁界面。八、配置 API Key在瀏覽器中打開http://127.0.0.1:3080進入設(shè)置頁面填入第二步創(chuàng)建的 API Key保存后即可直接調(diào)用 DeepSeek 的接口開始使用九、相關(guān)頁面截圖官網(wǎng)地址注冊、充值、創(chuàng)建 Key 的入口API 頁面工具頁面十、常見問題與注意事項API Key 是敏感信息相當(dāng)于你賬戶的鑰匙不要泄露給他人也不要在公開截圖里露出完整 Key。Key 創(chuàng)建后只能看一次忘記保存只能重新創(chuàng)建建議創(chuàng)建后立刻存入密碼管理器。調(diào)用服務(wù)需要余額建議先小額充值測試確認(rèn)可用后再按需充值。本機服務(wù)只在本機可訪問http://127.0.0.1:3080只有你自己能訪問這是限制也是安全保證。安裝失敗怎么辦先檢查 Node.js 版本是否 22node -v安裝類報錯大多可以在 GitHub 倉庫的 Issues 或搜索引擎中找到答案。不想用 fnm直接安裝 Node.js 官網(wǎng)的 22.x LTS 安裝包同樣可以跳過 fnm 相關(guān)命令即可。