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