寫(xiě)在前面8月13日DeepSeek Harness 團(tuán)隊(duì)正式對(duì)外發(fā)布了其 Agent 運(yùn)行框架 Deepseek Harness 開(kāi)發(fā)者預(yù)覽版提供 Web 交互界面可連接云端模型完成代碼生成、文件編輯、命令執(zhí)行和問(wèn)題修復(fù)等任務(wù)。文本將詳細(xì)講解在 Spacemit K3 芯片上安裝并運(yùn)行deepseek-ai/dsh0.1.0-rc.6并完成 Web 服務(wù)啟動(dòng)。驗(yàn)證環(huán)境項(xiàng)目驗(yàn)證值開(kāi)發(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一、安裝依賴(lài)打開(kāi) K3 終端依次輸入下面的命令以安裝系統(tǒng)依賴(lài)sudoaptupdatesudoaptinstall-ynpmbubblewrap build-essential python3完成依賴(lài)安裝后可通過(guò)以上指令確認(rèn) Node.js 版本node-v顯示版本應(yīng)為 22.19.0 或更高的 22.x 版本也可以使用 Node.js 24 或更高版本本文實(shí)測(cè)為 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)下載完整依賴(lài)樹(shù)并編譯少量原生模塊預(yù)計(jì)耗時(shí)較長(zhǎng) ( 預(yù)估在 20 min 以上)實(shí)際時(shí)間取決于網(wǎng)絡(luò)、存儲(chǔ)和緩存狀態(tài)請(qǐng)耐心等待 。三、啟動(dòng) DSH Web 服務(wù)安裝完成后可以通過(guò)以下指令啟動(dòng) Web 服務(wù)確認(rèn)當(dāng)前安裝的 DeepSeek Harness 可以在 K3 上正常運(yùn)行node--expose-internals$HOME/deepseek-harness-k3/node_modules/.bin/dshweb若終端出現(xiàn)以下日志說(shuō)明 Web 服務(wù)已經(jīng)啟動(dòng)了這時(shí)就可以在瀏覽器中打開(kāi)對(duì)應(yīng)的地址。dsh web: http://127.0.0.1:3080瀏覽器訪(fǎng)問(wèn)http://127.0.0.1:3080四、(可選) 創(chuàng)建用戶(hù)級(jí)快捷指令若您希望將上個(gè)步驟中 Deepseek Harness 的啟動(dòng)指令創(chuàng)建為用戶(hù)級(jí)快捷指令以方便后續(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)該顯示對(duì)應(yīng)的版本名。0.1.0-rc.6附錄 - 常見(jiàn)問(wèn)題1. npm 安裝很久沒(méi)有結(jié)束rc.6 依賴(lài)較多冷緩存安裝可能持續(xù)較長(zhǎng)時(shí)間。日志仍在更新時(shí)可以繼續(xù)等待若長(zhǎng)時(shí)間停留在依賴(lài)解析階段再檢查 npm 日志末尾。不要僅因暫時(shí)沒(méi)有新輸出就中斷安裝。2. 頁(yè)面打不開(kāi)首先確認(rèn)啟動(dòng)終端是否仍在運(yùn)行。如果需要檢查端口可以在 K3 終端執(zhí)行下面的命令。ss-lntpHsport :3080遠(yuǎn)程訪(fǎng)問(wèn)時(shí)SSH 隧道必須保持運(yùn)行。3. 頁(yè)面能打開(kāi)但模型沒(méi)有回復(fù)Web 頁(yè)面能夠打開(kāi)只能說(shuō)明前端服務(wù)正常。如果模型沒(méi)有回復(fù)應(yīng)依次檢查 DeepSeek API Key、當(dāng)前選擇的模型和 K3 網(wǎng)絡(luò)連接。如果配置了自定義提供方還需核對(duì) Base URL 和協(xié)議。4. 安裝插件后頁(yè)面要求重啟本文采用前臺(tái)運(yùn)行方式。插件要求重啟時(shí)應(yīng)回到啟動(dòng) DSH 的終端按CtrlC退出后再執(zhí)行下面的命令。dsh web