DeepSeek Harness：一行命令搭专属Agent
有幸参与内测，带来最详实的介绍
就在本文发出时，DeepSeek Harness 的开发者预览版上线，并开源
- ✓地址：github.com/deepseek-ai/deepseek-harness
DeepSeek Harness 你可以理解为是 DeepSeek 搞的 Agent 框架，类似 Claude Code，缩写是 dsh，这东西的最伟大之处，是有着极其强大的自定义能力，就比如默认的调用是 /dsh：
但你只要稍微定义个插件，他就是这样了：
对于网页版，但你甚至是 tmd 这样...dsh 打 gal 指日可待
这套插件系统，也正是 DeepSeek Harness 最有料的地方，采用插件式架构，构建一个开放的智能体的框架。在这里，模型、工具、技能、会话、沙箱、存储、循环、调度、UI 等所有 Agent 能力均由插件组合而成，可自由替换、灵活重组
核心理念：一切皆插件
- ✓整个系统设计的第一设计原则是：一切皆插件，everything is a plugin
大多数软件的核心逻辑是写死的，用户只能在预留的少数接口上做有限定制。DeepSeek Harness 则相当开放：无论是模型接入、工具注册表、会话日志、审批策略，甚至驱动智能体运转的主循环本身，这个 harness 的一切，全部都是插件
比如 dsh 默认不带画板，但你给他装上一个画板，就有了
你可以替换任何部分 想换搜索引擎、接自己公司的模型服务、调整审批策略，改个配置就行，不用动框架代码
扩展不用改核心 给系统加功能就是挂一个新插件，卸载时注册的一切自动撤销，不留残余
不同场景可以差异化组装 企业按合规需求裁剪工具集，个人按习惯调整组合，用的是同一套框架
技术上，DeepSeek Harness 基于具有时空可组合性的 Cordis 插件系统构建。Cordis 作为元框架，只负责插件的加载与卸载以及依赖关系，Agent Harness 的所有具体组件都是不同的 Cordis 插件。插件通过服务与事件彼此协作，并可以在配置层自由组合。开发者无需改动 DeepSeek Harness 的源码本身，就能以插件的方式独立选择、替换或扩展其中的任一能力
分层组装：Profile 与 Patch
运行中的 dsh 可以理解为一棵插件树。这棵树由多层配置按固定顺序叠加：组合包（bundle）是官方发布的成套插件配置，Profile是用户机器上的具名组装清单，Patch是用户自己的覆盖层，可以精确定位到任意一个插件条目并替换。上层配置始终覆盖下层
能力接缝
每种能力（执行命令、读写文件、网络访问、模型调用、沙箱隔离等）都拆成三个独立角色：服务定义定义接口规范，提供方负责具体实现，消费方使用这个能力
三者相互独立，模型看到的接口恒不变化
下面的这些，是内测的时候，大家自己搭的 GUI，简直面目全非
- ✓同花顺皮肤
- ✓娘化皮肤
Excel 皮肤...特么离谱
- ✓复古 xp 皮肤
- ✓这些皮肤都是独立的插件
四种随附模式
界面顶部有一个模式选择器。每个模式对应一份Agent Preset（智能体预设），决定当前会话里的智能体由哪些插件组成：它有哪些工具、用什么提示词、以什么方式工作。选一个模式，就是选一套完整配置
标准模式（默认）
这是默认模式，适合最广大的用户，具有功能完整的编程智能体。文件编辑、Shell 命令、文件与网页检索、Skills、计划、目标、子代理和工作流全部包含
PTC 模式
PTC 即程序化工具调用（Programmatic Tool Calling）。拥有标准模式的全部能力，但工具的呈现方式不同：由模型生成一段代码来组合多轮工具调用，而非逐次发起
- ✓打个比方：标准模式下，一个五步任务需要五次「模型调用工具、等结果、再决定下一步」的往返。PTC 模式下，模型把五步写进一段程序，一次执行完
在任务步骤越多、中间数据量越大的情况下，PTC 模式就越快，上下文消耗也更少
极简模式
只有两个工具：一个保持状态的命令行终端，和一个文本编辑工具（str_replace_editor）。系统提示词只有一句话，不加载上下文压缩。适合基准测试、教学演示，或者偏好极简操作的用户
创造模式
用来创建自定义 Agent Preset。可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式。
直接对它提需求就行，比如「创建一个只能读、不能写的代码审查模式」。它会起草配置文件、挂载验证、保存为新 preset，随后出现在模式选择器里
- ✓安全提示：创造模式能执行模型编写的代码并修改运行时，信任等级等同于 shell 访问权限。建议仅在受信任环境中使用
自定义模式
四个随附模式是只读的系统预设，随安装发布。用户可以复制任意预设后修改副本，也可以用创造模式让智能体代为创建。自定义 preset 和随附模式在界面和机制上完全等价
但需要注意：会话一旦产生内容，就不能再切换模式。因为模式决定了工具集，中途切换会导致新工具集无法解释会话历史中的旧工具调用，破坏会话的可复现性
智能体的工作机制
轮次与步骤
智能体干活的过程由两个概念定义。步骤（step）是一次模型请求加上它在这次回复里要求执行的工具调用。轮次（turn）是从接到用户任务开始，到所有事情做完为止的零个或多个步骤。简单任务一步就完，复杂任务在一个轮次内连续执行多个步骤
每个关键位置（步骤开始前、工具执行前后、模型请求发出前）都是可拦截的扩展点。插件可以在这些位置插入审批、改写、记录、拦截逻辑
会话日志
每个会话对应一份仅追加的事件日志。会话中发生的每件事（用户输入、模型输出、每次工具调用及其结果）都按顺序写入日志，只增不改
模型看到的一切，都会写入日志，包括系统提示词、思维链、工具调用与结果、子 Agent 调度，以及每一次上下文注入。在 Trajectory 视图 中，可以按来源查看这些信息。恢复、分叉、检索与回放也都共享同一份事件流
会话日志还支撑了会话恢复（进程重启后从断点继续）、自动标题、上下文压缩（超出窗口时自动压缩早期内容，任务不中断），以及跨会话检索（智能体可以查询自己过去的工作记录）
计划、任务清单与提问
用户可以要求智能体先交一份实施方案，批准了再动手，计划状态和批准动作都记录在日志里
碰到长任务，智能体会自己拆成清单逐项推进，界面实时渲染为可勾选列表。碰到需要用户拍板的事，智能体暂停，抛出带选项的问题，收到回答后继续
依然是内测的时候，大家做的功能插件，用来提升体验：
- ✓进度条插件
小游戏插件...默认收到侧边栏...我特么绷不住了
内置工具集
工具（tool）是智能体干活的具体接口。随附的工具覆盖了日常编程需要的所有操作
文件读写可以读取、精确修改、写入工作区文件，read_image 可以把图片喂给支持视觉输入的模型。文件与内容检索按文件名模式查找文件、按内容全文检索，内置 ripgrep，宿主机不用额外装搜索工具。命令执行执行任意命令行命令，装依赖、跑测试、起服务都行，支持转入后台
持久终端可以打开保持状态的真实终端（PTY），支持持续交互。后台任务管理让后台命令、终端任务、后台子代理统一管理。代码语义查询接入语言服务器（LSP），可以跳转定义、查找引用。网络搜索网页、抓取内容，搜索引擎可以通过配置更换。还有独立文本编辑工具和只读的会话查询工具
三个设计细节值得注意。先读后写：一个独立的策略插件强制要求智能体必须先读过一个文件才能改它，这不是写死在工具里的，而是一个可选装的门禁插件。结果落盘：搜索结果超出上限时，完整列表自动存到磁盘，后续接着读，不会直接截断。通用后台：命令执行、终端会话、子代理都可以转入后台统一管理，先干别的，完了再回来看结果
Code Mode
Code Mode 是 PTC 模式的技术基础
- ✓常规的工具调用是一步一步来的：模型每做一个动作就发一次调用，等结果回来再想下一步。动作越多，来回越多，上下文消耗也越大
Code Mode 把全部工具生成为一套 TypeScript SDK。模型通过 run_code 工具交一段程序，在程序里直接调用各种工具，可以写循环、条件判断、并发执行，还能在中间过滤结果。只有程序最终打印或返回的内容才会进入模型上下文，中间过程不占空间
- ✓举个例子：「统计所有包中的 TODO 标记并汇总排序」，常规方式需要几十次工具往返，Code Mode 下一段程序一次跑完。
- ✓安全性不受影响：程序里每一次工具调用都重新走完整的执行流水线，审批、沙箱、超时、日志记录全部照常生效，并发数量受配置约束
多智能体协作
一个智能体可以把工作分派给多个子智能体，并管理它们的执行过程
子代理有两种形态。subagent是可续跑的后台子代理，默认在后台执行，完成后结果自动送回父级会话，中途还可以给它发消息。subagent_fork是一次性子代理，继承当前上下文启动，做完就结束，适合就近拆分的小活。子代理侧有专属的 report 工具，阶段性成果可以直接投递到父级会话
工作流引擎通过脚本确定性地编排多个子代理。执行顺序、并行关系、结果汇总方式由脚本定义，不靠模型临场发挥。适合迁移、审计、批量改造这类需要固定流程的任务
Ralph 循环是一种循环执行模式：每一轮启动一个全新的子代理执行同一个目标，直到目标达成。每轮不带上一轮的上下文，适合「反复试直到通过」的任务，比如把测试修到全绿
目标管理可以创建、修改、暂停、恢复长期目标。但这些操作需要人类用户的根权限，智能体不能自行创建或变更目标
所有子代理的会话同样全程写入日志，每个子代理的执行过程都可以完整还原
内测的时候，朋友们整了个上下文编辑插件
- ✓消息编辑插件：每条消息可编辑，版本时间线记录每次修改，支持「重试此回合」和后续策略选择
安全与治理
进程沙箱
智能体执行的命令可以运行在沙箱里。沙箱控制进程能读写哪些文件，三大桌面平台各自使用操作系统原生的隔离机制：Linux 用 bwrap / Landlock，macOS 用 Seatbelt，Windows 用 ACL 受限令牌
沙箱分三档：read-only 只能读不能写，workspace-write 可以写工作区目录和指定的临时目录，danger-full-access 不做隔离完全放开。沙箱后端会如实上报自己的隔离执行情况，如果当前系统条件只能覆盖部分承诺，后端报告 partial 而非 full。不虚报安全边界
审批与权限
需要授权的操作（比如改文件、执行有风险的命令），界面会先向用户请求批准，批准了才执行。权限有预置档位，用户可以整体调整宽严程度
守卫
- ✓两个自动纠偏插件：一个检测智能体是不是在做重复无效动作（循环卫生），一个强制中断超时的工具调用（工具超时）
凭据与隐私
密钥不进日志。API Key 等凭据通过独立通道传递，会话日志里只有引用，没有明文。数据默认留在本地。会话日志默认不上传。遥测需要显式开启，用户可以选择只在主动提交反馈时附带日志，也可以选择持续上传匿名化数据
生态兼容
DeepSeek Harness 支持 Model Context Protocol，任何 MCP 服务器（数据库、办公系统、企业内部服务等）都可以接入，接入后的工具和内置工具走同一条流水线，同样受审批和守卫约束
Hooks 桥让已经为 Claude Code 和 Codex 写好的钩子脚本（提交前检查、通知集成之类）可以直接用，不用重写。内置的 ACP 服务端实现，让支持 ACP 的编辑器和客户端可以直接把 DeepSeek Harness 当后端智能体用
Skills是打包好的任务指令和配套资源，智能体按需加载，系统支持自建技能库。定时任务支持延时触发、定时触发、固定间隔重复三种方式。模型接入除 DeepSeek 官方 API 外，支持任意 OpenAI 兼容端点，可以接企业自建的推理服务或其他云服务商，在设置页面填完立刻生效
emmmmm....放个表情包插件吧，没事儿给你晒一个大肥鱼
- ✓用起来就是鲸鱼表情包
- ✓还可以是贴吧老哥
这个插件通过系统提示词让模型标记情绪，宿主端把标记替换成内联表情图片。三档模式（关闭/智能/高频）持久化到本地配置
五种使用方式
Web UI 浏览器打开本地地址即可使用，可以直接进行对话、审批、模式切换、设置**
- ✓**
Headless CLI 无界面执行单个任务，跑完打印结果就退出，适合 CI/CD 和脚本集成
Python SDK 自带打包的运行时，提供高层 turns API 和底层 JSON-RPC 客户端
TypeScript SDK 提供 JSON-RPC 协议、服务器与客户端，适合需要深度集成的团队
ACP 自动化协议服务器，面向编辑器和工具链厂商
面向开发者的扩展能力
DeepSeek Harness 提供完整的插件开发文档，覆盖工具编写、配置、事件与服务、发布全流程
工程约定也有明确要求：注册必须是可逆副作用，配置错误必须在加载时报错而非静默跳过，跨边界标识符必须用品牌类型，随部署变化的参数必须放进配置而非硬编码。这些约定由仓库的自动化门禁强制执行
质量门禁做到了源码目录逐文件 100% 单元测试覆盖率；无 API Key 也能跑的快照回放测试；真实 API 端到端测试；跨文件代码克隆检测；文档与代码同步检查，文档过期直接阻断 CI
- ✓还有一项自我修改能力：开启后，智能体可以检查并热挂载自己运行时的插件。创造模式就是基于这个能力搭建的
快速体验
在已安装 Node.js 开发工具链的系统中，一行命令即可启动 Web UI：
npx @deepseek-ai/dsh web
写在最后
Agent = Model + Harness
模型是 Agent 的灵魂，而 Harness 作为 Agent 的身体，赋予了模型理解环境、使用工具，并在真实场景中持续工作的能力
DeepSeek Harness 目前的 v0.1 版本仍处在面向 Harness 开发者进行测试的阶段，还有许多地方需要持续改进和打磨。预计核心插件以及基础接口都会在接下来的一段时间内快速迭代、持续演化
以上是「DeepSeek Harness：一行命令搭专属Agent」的全部拆解。
我们是海口曦东科技 Nexus-AI 团队——专注把 AI 真正落进企业业务：从诊断、试点到验收陪跑，每一步交付都有书面验收单。
如果你也在研究某个 AI 能力怎么接进自己的业务，欢迎聊聊，我们已经把可落地的第一步整理好了。
