寫在前面8月13日DeepSeek Harness 團(tuán)隊正式對外發(fā)布了其 Agent 運(yùn)行框架 Deepseek Harness 開發(fā)者預(yù)覽版提供 Web 交互界面可連接云端模型完成代碼生成、文件編輯、命令執(zhí)行和問題修復(fù)等任務(wù)。文本將詳細(xì)講解在 Spacemit K3 芯片上安裝并運(yùn)行deepseek-ai/dsh0.1.0-rc.6并完成 Web 服務(wù)啟動。驗證環(huán)境項目驗證值開發(fā)板K3 Pico ITX系統(tǒng)Bianbu 4.0-rc3 LXQt架構(gòu)RISC-V 64Node.jsv22.22.0npm9.2.0DeepSeek Harnessdeepseek-ai/dsh0.1.0-rc.6一、安裝依賴打開 K3 終端依次輸入下面的命令以安裝系統(tǒng)依賴sudoaptupdatesudoaptinstall-ynpmbubblewrap build-essential python3完成依賴安裝后可通過以上指令確認(rèn) Node.js 版本node-v顯示版本應(yīng)為 22.19.0 或更高的 22.x 版本也可以使用 Node.js 24 或更高版本本文實測為 22.22.0。二、安裝 DeepSeek Harness創(chuàng)建獨(dú)立的安裝目錄mkdir-p$HOME/deepseek-harness-k3進(jìn)入到已創(chuàng)建的安裝目錄cd$HOME/deepseek-harness-k3執(zhí)行安裝npminstall--save-exact deepseek-ai/dsh0.1.0-rc.6首次安裝需要聯(lián)網(wǎng)下載完整依賴樹并編譯少量原生模塊預(yù)計耗時較長 ( 預(yù)估在 20 min 以上)實際時間取決于網(wǎng)絡(luò)、存儲和緩存狀態(tài)請耐心等待 。三、啟動 DSH Web 服務(wù)安裝完成后可以通過以下指令啟動 Web 服務(wù)確認(rèn)當(dāng)前安裝的 DeepSeek Harness 可以在 K3 上正常運(yùn)行node--expose-internals$HOME/deepseek-harness-k3/node_modules/.bin/dshweb若終端出現(xiàn)以下日志說明 Web 服務(wù)已經(jīng)啟動了這時就可以在瀏覽器中打開對應(yīng)的地址。dsh web: http://127.0.0.1:3080瀏覽器訪問http://127.0.0.1:3080四、(可選) 創(chuàng)建用戶級快捷指令若您希望將上個步驟中 Deepseek Harness 的啟動指令創(chuàng)建為用戶級快捷指令以方便后續(xù)快速啟用可參照附錄章節(jié)進(jìn)行配置。在終端復(fù)制并執(zhí)行下面的整段命令mkdir-p$HOME/.local/binprintf%s\n\#!/bin/sh\set -eu\entry$HOME/deepseek-harness-k3/node_modules/deepseek-ai/dsh/lib/bin.js\test -r $entry || { echo dsh: missing $entry 2; exit 127; }\exec node --expose-internals $entry $\$HOME/.local/bin/dshchmod755$HOME/.local/bin/dshexportPATH$HOME/.local/bin:$PATH執(zhí)行后可在終端執(zhí)行以下指令確認(rèn)版本和路徑都正確command-vdsh dsh--version預(yù)期版本輸出如下。注如果安裝的是更新的版本比如v0.1.0-rc.8這里就應(yīng)該顯示對應(yīng)的版本名。0.1.0-rc.6附錄 - 常見問題1. npm 安裝很久沒有結(jié)束rc.6 依賴較多冷緩存安裝可能持續(xù)較長時間。日志仍在更新時可以繼續(xù)等待若長時間停留在依賴解析階段再檢查 npm 日志末尾。不要僅因暫時沒有新輸出就中斷安裝。2. 頁面打不開首先確認(rèn)啟動終端是否仍在運(yùn)行。如果需要檢查端口可以在 K3 終端執(zhí)行下面的命令。ss-lntpHsport :3080遠(yuǎn)程訪問時SSH 隧道必須保持運(yùn)行。3. 頁面能打開但模型沒有回復(fù)Web 頁面能夠打開只能說明前端服務(wù)正常。如果模型沒有回復(fù)應(yīng)依次檢查 DeepSeek API Key、當(dāng)前選擇的模型和 K3 網(wǎng)絡(luò)連接。如果配置了自定義提供方還需核對 Base URL 和協(xié)議。4. 安裝插件后頁面要求重啟本文采用前臺運(yùn)行方式。插件要求重啟時應(yīng)回到啟動 DSH 的終端按CtrlC退出后再執(zhí)行下面的命令。dsh web