部署 DeepSeek Harness 前必须纠正一个认知偏差:它不是体积庞大的离线模型权重文件,而是让大模型具备终端执行、代码分析与文件读写能力的 智能体运行框架。它本身充当调度与执行中枢,思考大脑则完全依赖后端挂载的模型推理服务。
底层运行环境对版本限制极严。本机必须预装 Node.js 且版本不得低于22.19.0,建议直接使用24版本。过低的运行时会在编译或调用底层终端原生模块时直接抛出异常崩溃,没有任何妥协空间。
日常快速验证无需繁琐配置,直接在目标目录敲下 npx @deepseek-ai/dsh web 即可拉起服务。系统会自动拉取依赖并在本地回环地址的 3080端口 启动网页控制台。若追求长期环境稳定,应当使用 npm install -g @deepseek-ai/dsh 完成全局固化,后续只需执行 dsh web 即可瞬间启动。

需要深度二开或自定义插件时,必须转向 源码编译。克隆代码仓库后,通过启用Corepack的 pnpm 执行依赖安装。随后依次运行打包构建与启动指令,框架会基于微内核插件机制加载所有工具,无需反复重启即可支持扩展能力的动态挂载。
服务启动后的核心动作是接入模型算力。你可以直接在网页界面的设置中填入 API密钥 走云端链路,也可对接本机运行的 Ollama 或 vLLM 推理引擎,将基础请求地址指向本地兼容端点。配置本地引擎后,整套智能体便能在断网状态下实现完全自主闭环。
许多新手常遇到对话无法发送的假死问题,根源在于未显式绑定 工作区目录。框架的安全策略极其严密,未明确划定具体项目路径作为领地前,内置的规划循环会强制拒绝执行任何任务。
安全红线绝不能踩。框架赋予了模型真实的 终端命令执行 与 文件读写权限,严禁在系统根目录或存有高危凭证的家目录下直接启动。该程序默认没有任何用户鉴权体系,不可随意绑定外网地址裸奔,跨设备调用必须在外层强行加挂带有认证机制的反向代理。