写在前面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