DeepSeek Harness 的定位、插件化架构与 CentOS 部署实测记录。
冷月清谈：
文章重点介绍了 Harness 的插件化架构。其核心理念是“一切皆插件”，模型适配器、工具、会话、沙箱、存储、调度、UI 甚至 Agent Loop 都可被替换或热插拔。相比传统 Agent 框架中核心逻辑不可动、外围能力只能扩展的模式，Harness 依托 Cordis 插件元框架强调依赖管理、生命周期和可逆副作用。
部署部分以 CentOS 虚拟机为例，记录了 Node.js 22、pnpm、dsh CLI、API Key、Web 服务启动等步骤，并提到远程访问 Web UI 时可能遇到 crypto.randomUUID 报错，可通过安装 dsh-lan-access 插件或 SSH 本地端口转发解决。
最后作者用生成 24 点游戏 HTML 页面作为验证场景，展示了 Agent 生成代码、测试、统计 Token 消耗等过程，给出了实际使用 DeepSeek Harness 的初步体验。
本文部分链接为合作推广
怜星夜思：
2、文章里一次生成 24 点小游戏花了 38 万 Tokens，你觉得这种 Agent 编程成本算高吗？
3、如果你要在自己的项目里用 DeepSeek Harness，最想先替换或扩展哪个插件？模型、工具、沙箱还是 UI？
4、远程访问 Web UI 需要装插件或走 SSH 隧道，你觉得这类 Agent 工具默认应该更开放，还是更保守？
原文标题：DeepSeek Harness虚拟机部署体验
原文作者：牧羊人的方向
原文内容
DeepSeek于2026年8月13日开源了生产级Agent运行时框架DeepSeek Harness，本文简要概述什么是DeepSeek Harness，并在CentOS虚拟机环境部署体验。
1、DeepSeek Harness介绍
DeepSeek Harness（命令行简称 dsh）是DeepSeek于2026年8月13日正式发布并开源的首款Agent产品。它不是新的大模型，也不是API客户端，而是智能体运行时框架（Agent Harness）：负责把模型接入文件系统、终端、网页、代码工具和其他Agent，并组织上下文、工具调用与任务执行的整套基础设施。官方给出的设计理念为：
Model + Harness = Agent
简单来说：模型负责思考推理，Harness负责实际执行。它负责把大模型“接”进真实世界的那一层，如读写文件、调用工具、执行命令、控制权限、决定重试还是中止，可以把它理解成AI的“操作系统外壳”。
DeepSeek Harness最核心的设计理念是 “一切皆插件”（everything is a plugin）。整个框架由220+个独立npm包组成，包括模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有Agent能力均由插件组合而成，可自由替换、灵活重组，并且支持运行时热插拔。其理论基础是 DeepSeek 联合北京大学发表的论文《A Programming Paradigm for Spatiotemporal Composability》，解决了传统插件系统"时空不可组合"（无法热卸载、依赖紊乱）的行业痛点。
整套框架是基于Cordis插件元框架打造。Cordis元框架仅承担插件加载、卸载和依赖管理的底层工作。全部业务组件为独立的Cordis插件，开发者无需改动Harness源码本身，就能以插件方式独立选择、替换或扩展其中的任一能力。这种“没有特权组件”的架构意味着产品的每一部分都是插件，包括模型适配器、工具注册表、会话日志，以及agent loop（智能体循环）本身，因此每一部分都可以从配置替换。该架构带来三个优势：
-
完全可定制：企业无需修改核心源码，即可通过插件替换任意模块（如替换沙箱、对接内部权限系统）
-
副作用可撤销：插件卸载后，其注册的服务、事件、资源会完整清理，无残留
-
渐进式扩展：可从最小内核开始，按需加载插件，适配从个人开发到企业级部署的全场景
DSH采用四层插件化架构，自上而下分为接入层、业务插件层、基础能力插件层和核心内核层，底层对接外部依赖。
DSH内置四种预设模式，对应不同插件组合：
-
标准模式：全量工具集，逐轮工具调用，适合通用开发与复杂任务
-
PTC模式：模型生成TypeScript代码批量编排工具调用，低延迟、省Token，适合批量处理
-
极简模式：仅保留Bash +文件编辑，用于大模型编程能力基准测试
-
创造模式：支持热加载插件、自定义Agent预设，用于插件开发与调试
2、与其它主流Agent框架对比
DeepSeek Harness与其他框架最本质的区别在于没有“核心”。主流Agent架构是核心（Agent 循环、上下文管理、执行器）不可动+外挂扩展（MCP工具、Skills、Hooks等只能加不能改）；DeepSeek Harness架构的Cordis则是运行时之上，模型适配器、工具注册表、会话/存储、沙箱/权限、Agent循环、调度、UI全部是插件，将Agent框架当作操作系统内核来做。
Cordis与传统DI容器和轻量钩子方案的关键差异在于可逆副作用。Cordis的插件是带依赖声明、生命周期、可逆副作用的“组件”，插件间可以声明依赖，卸载时能完整逆转副作用。在 DeepSeek Harness中，可以把后端的LLM插件从Model-A无缝替换为Model-B，而依赖它的组件（如Agent Loop）会自动重新连接到新的服务提供者，会话中的对话记录毫发无损。
3、CentOS虚拟机部署指南
|
项目
|
要求
|
|---|---|
|
操作系统
|
Linux；推荐 CentOS 8 Stream / CentOS 9
|
|
Node.js
|
≥ 22.19.0（官方硬性要求，推荐 22 LTS）
|
|
内存/磁盘
|
建议 2C4G 以上；npm 缓存与插件约需 1~2GB
|
|
网络
|
可访问 npm registry、GitHub、api.deepseek.com
|
|
API Key
|
DeepSeek API Key（platform.deepseek.com 申请，sk- 开头）
|
|
端口
|
默认 3080（Web UI）
|
1）步骤一：安装 Node.js
# 安装 NodeSource 的 Node.js 22 源 curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -安装 Node.js
sudo yum install -y nodejs
验证安装
node --version
npm --version
2）步骤二：安装 pnpm（源码部署需要）
npm install -g pnpm
pnpm --version
3）步骤三：安装 DeepSeek Harness
方式 A：npm 一键启动（最快体验） npx @deepseek-ai/dsh web方式 B：全局安装（推荐长期使用）
npm install -g @deepseek-ai/dsh
dsh --version # 验证安装方式 C：源码安装（插件开发/二次开发）
npm install -g pnpm
git clone GitHub - deepseek-ai/deepseek-harness: DeepSeek Harness: Everything is a Plugin. · GitHub
cd deepseek-harness
pnpm install
pnpm run build
方式 D：Python SDK（需 Python ≥ 3.10）
python3 -m pip install deepseek-harness-sdk
使用全局安装# npm install -g @deepseek-ai/dsh
使用全局安装npm install -g @deepseek-ai/dsh
4）步骤四：配置环境变量
echo 'export PATH=/usr/local/node/bin:$PATH' >> ~/.bashrc source ~/.bashrc dsh --version
[root@centos8-tango-01 ~]# dsh --version
0.1.0-rc.6
查看dsh支持命令
# dsh --help Usage: dsh [options] [command] [args...]dsh: boot a DeepSeek Harness profile — an ordered stack of plugin-bundle patch layers under your own overrides.
Arguments:
args arguments for the booted profile’s app (see: dsh --profile <name> --help)Options:
-V, --version output the version number
--profile <name> the profile under $DSH_HOME/profiles to boot
--patch <path> extra patch-list overlay applied after the profile layer (repeatable)
--dump-config print the composed profile tree and exit
--dump-default-config print the profile tree without its user layer or --patch overlays and exitCommands:
web [options] [args…] boot the web profile (alias of --profile web); the web app’s own flags follow
plugin [options] [args…] manage a profile’s plugins by forwarding the remaining arguments to pnpm in the profile directory
Examples:
dsh --profile web boot the web profile (same as: dsh web)
dsh --profile headless “run the tests” answer one task, print the result, and exit
dsh --profile tui --patch ./extra.yml boot a custom profile with one extra overlay
dsh --profile tui --resume <session> arguments after the launcher flags reach the app
dsh --profile web --help the web app’s own flags and help
dsh plugin --profile tui add <package> install a plugin into the tui profile
5）步骤五：配置API key
# 环境变量方式
echo 'export DEEPSEEK_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc
6）启动Web服务进行验证
dsh --profile web --host 0.0.0.0 --port 3080
通过本地电脑访问服务IP和端口
直接访问远端服务会提示“crypto.randomUUID is not a function”。有两种方法可以解决
-
方法1：安装dsh-lan-access插件
# dsh plugin --profile web add dsh-lan-access [WARN] Request took 27553ms: https://registry.npmjs.org/dsh-lan-accessdependencies:
- dsh-lan-access ^0.1.0
Packages: +1
+
[WARN] Request took 28613ms: https://registry.npmjs.org/pnpm
Packages are cloned from the content-addressable store to the virtual store.
Content-addressable store is at: /root/.local/share/pnpm/store/v11
Virtual store is at: node_modules/.pnpm
Progress: resolved 1, reused 0, downloaded 1, added 1, done
Done in 30.6s using pnpm v11.22.0dsh plugin --profile web list
Legend: production dependency, optional only, dev only
dsh-profile-web /root/.dsh/profiles/web (PRIVATE)
│
│ dependencies:
└── dsh-lan-access@0.1.0
1 package
-
方法2：本地电脑执行命令配置ssh通道，可以直接访问到虚拟机服务端的127.0.0.1
ssh -L 3080:127.0.0.1:3080 root@xx.xx.xx.xx
这是SSH 本地端口转发（Local Port Forwarding） 命令，它会建立一个加密的 SSH 隧道，通过自己的电脑访问远程虚拟机上的服务。配置好后访问http://127.0.0.1:3080，出来一个内测声明。
然后选择不同的模式，支持四种模式。
也可以在配置中配置模型，默认是DeepSeek自己的模型
选择一个生成24点游戏的HTML页面进行验证，下方会显示Token的消耗情况。
完成 ✅ 已生成完整、可直接运行的 24 点游戏页面：**`24点游戏.html`**（单文件、无外部依赖，双击用浏览器打开即可玩）。功能清单
随机发牌
- 从完整 52 张扑克牌（4 花色 × A~K）随机抽 4 张，A=1、J=11、Q=12、K=13
- 内置 24 点求解器（穷举所有括号结构 + 有理数求值），默认保证每局有解（可关掉开关体验无解牌局）
- 发牌带逐张翻牌动画，牌面可点击快速输入数值
表达式验证
- 自研分词器 + 递归下降解析器（不用eval），支持+ − × ÷、括号、隐式乘法（如2(3+4)）、一元正负号、全角括号
- 三重校验：语法正确 → 4 张牌必须且只能各用一次（多重集比对）→ 结果等于 24（浮点误差容差）
- 输入时实时预览：显示当前算式结果、是否等于 24、用牌是否相符
- 完整错误提示：非法字符、括号不匹配、除以 0、结果不是 24、用牌不符等
计时 & 计分
- 本局用时（0.1s 精度）+ 总用时计时器
- 计分：基础分 = 12 − 用时/15 秒（最少 1 分）；10 秒内答对 +3 神速奖励；连续答对连击加分（最多 +5）
- 换牌 −2 分、看答案 −1 分（均中断连击）；无解牌局换牌不扣分
- 最佳得分存入 localStorage 持久化；答对/答错有 Web Audio 音效（可静音）其他：手机屏幕键盘式输入面板（高亮当前手牌数值）、桌面实体键盘回车验证、重新开始、玩法说明折叠面板。
质量验证
- 对求解器、解析器、用牌校验跑了 30 项单元测试，全部通过（含8/(3−8/3)=24、5×(5−1/5)=24这类经典难题解，以及各种非法输入的正确报错）
- 页面整体脚本通过node --check语法检查
单个任务消耗Token情况，花了38w Tokens、0.21元。
最后出来的结果如下：
参考资料：
-
官方 GitHub：https://github.com/deepseek-ai/deepseek-harness
-
官方架构文档：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.zh.md
-
官方产品页：http://www.deepseek.com/harness/
-
论文：《A Programming Paradigm for Spatiotemporal Composability》（DeepSeek & 北京大学）