你可以将 DeepSeek Harness 理解为 DeepSeek 推出的智能体（Agent）开发框架，定位对标 Claude Code，简称 dsh。这套框架最核心的亮点，在于极强的自定义拓展能力。框架默认交互指令为 /dsh； 只需简单编写自定义插件，交互形态便能彻底改变。 依托网页端载体，理论上还能够拓展更多玩法，借助 dsh 运行文字冒险游戏在未来完全有望实现。
插件架构正是 DeepSeek Harness 的核心竞争力。整套系统采用插件化设计，搭建起一套开放式智能体框架。模型接入、工具能力、任务技能、会话管理、沙箱环境、数据存储、任务调度、前端界面等构成智能体的全部能力单元，全都由插件组合实现，支持自由替换、灵活重组。
核心设计思想：一切皆插件
整套系统首要设计准则：一切皆插件（everything is a plugin）
市面上绝大多数同类软件，核心逻辑固化，用户仅能在预设少量接口中完成有限定制。DeepSeek Harness 走向高度开放路线：模型对接方案、工具注册表、会话日志、操作审批策略，甚至驱动智能体持续运行的主循环，Harness 体系内所有组件，全部以插件形式存在。
技术层面，DeepSeek Harness 搭建在具备时空可组合特性的 Cordis 插件元框架之上。Cordis 只负责插件加载、卸载与依赖调度，DeepSeek Harness 所有功能组件均为独立 Cordis 插件。插件依靠服务通信与事件机制协同工作，并且能够在配置层自由搭配。开发者无需修改 DeepSeek Harness 源代码，仅凭插件就能独立选用、替换、拓展任意一项功能。
分层配置体系：Profile 与 Patch
运行状态下的 dsh 可以视作一棵插件树，多层配置按照固定优先级依次叠加： 组合包（bundle）：官方打包发布的成套插件配置； Profile：本地设备上自定义的插件组装方案； Patch：用户专属覆盖层，能够精准定位任意插件条目并进行替换。上层配置优先级高于下层。
能力解耦架构
每一类功能（命令执行、文件读写、网络访问、模型调用、沙箱隔离等）被拆分为三大独立模块： 服务定义：划定统一接口标准； 提供方：实现具体功能逻辑； 消费方：调用对应能力。
三者完全解耦，模型感知到的调用接口永久保持稳定。
在内测阶段，社区参与者基于框架开发出多款风格迥异的图形交互界面：同花顺主题界面、二次元美化界面、Excel风格面板、经典Windows XP复古界面等等，观感差别极大。而所有界面主题，全部都是独立插件。
智能体运行原理
轮次与步骤
两个核心概念定义智能体完整工作流程： 步骤（step）：单次模型请求 + 本轮响应中触发的全部工具调用； 轮次（turn）：从接收用户需求到任务全部结束，包含一轮或多轮步骤。简单任务单步完成，复杂任务会在一个轮次内连续执行多组步骤。
所有关键节点（步骤启动前、工具执行前后、发起模型请求前）都预留可拦截拓展接口。插件能够在此植入审批校验、内容改写、日志记录、指令拦截等自定义逻辑。
会话日志
每一场会话对应一份仅追加写入的事件日志。会话内所有行为（用户输入、模型回复、每一次工具调用及返回结果）按时序持续记录，只新增、不覆盖修改。
模型接收的全部信息都会存入日志，涵盖系统提示词、思维链路、工具调用数据、子智能体调度信息以及每一轮上下文内容注入。借助轨迹视图（Trajectory）能够按来源分类查看全部记录；会话恢复、分支新建、信息检索、任务回放均复用同一套事件数据流。
会话日志同时支撑断点续跑（程序重启后从上次位置继续执行）、会话自动命名、上下文压缩（上下文超限后自动精简早期内容，任务不会中断）、跨会话历史检索（智能体调取过往工作记录）。
任务规划、清单与交互式问询
你可以要求智能体先输出完整执行方案，经过确认后再正式开展工作；计划状态与人机审批记录都会写入日志。 面对大型任务，智能体会自动拆解为待办清单分步执行，界面实时渲染可勾选任务列表。遇到需要人工决策的场景，智能体暂停运行，弹出带选项的问询，收到答复后继续推进。
内测期间社区还开发了大量功能性插件提升使用体验，例如任务进度条插件、侧边栏休闲小游戏插件等。
内置工具合集
工具（tool）是智能体完成任务的基础接口。内置工具覆盖软件开发场景绝大多数操作： 文件读写：读取、精准修改、写入工作目录文件；read_image 支持向视觉大模型传入图片； 文件检索：支持按文件名匹配、全文内容检索，内置ripgrep，宿主机无需额外安装检索工具； 命令执行：运行各类终端指令，安装依赖、执行测试、启动服务均可实现，支持后台运行； 持久终端：提供具备状态保持能力的交互式PTY终端； 后台任务管理：统一管控后台指令、终端会话、子智能体； 代码语义查询：对接LSP语言服务器，支持跳转定义、查找引用； 网页搜索与内容抓取：搜索引擎支持通过配置自由替换； 配套独立文本编辑器、只读会话查询工具。
三项精巧设计值得关注：
- 先读后写：可选插件策略，强制智能体修改文件前必须先行读取文件内容，不属于工具内置硬限制，可以自由启停；
- 结果落盘：检索结果超出展示上限时，完整数据自动保存至本地磁盘，支持后续读取，不会直接截断；
- 通用后台：命令、终端会话、子智能体均可转入后台统一调度，支持并行处理多项事务。
Code Mode：PTC模式底层支撑
传统工具调用采用串行模式：模型完成一次动作发起调用，等待结果返回再规划下一步。操作越多，往返交互越频繁，持续消耗上下文空间。
Code Mode 将全部工具封装为一套 TypeScript SDK。模型调用 run_code 工具提交一段程序，在代码内自由调用各类工具，支持循环、条件分支、并发执行、结果筛选。只有程序最终输出内容送入模型上下文，中间运行过程不占用token。
安全性不受削弱：程序内每一次工具调用依旧完整走完审批、沙箱隔离、超时管控、日志记录全链路，并发上限受配置约束。
多智能体协同机制
主智能体能够拆分任务分配给多个子智能体，并统筹调度执行流程。
子智能体分为两种形态： subagent：可断点续跑的后台子智能体，默认后台运行，完成后自动向父会话回传结果，运行期间支持接收新消息； subagent_fork：一次性临时子智能体，继承当前上下文启动，任务结束自动销毁，适合拆分小型就近任务。 子智能体配备专属report工具，能够将阶段性成果实时推送至父会话。
工作流引擎依靠脚本确定性编排多个子智能体，执行顺序、并行逻辑、结果汇总规则由脚本定义，不依赖模型临时决策。适合代码迁移、审计、批量重构这类流程固定的任务。
Ralph循环模式：循环启动全新子智能体执行同一目标直至任务完成；每一轮不会继承上一轮上下文，适合反复调试直至达标场景（例如修复测试用例实现全量通过）。
目标管理支持新建、修改、暂停、恢复长期任务，但相关操作需要人类最高权限，智能体无法自主新增或变更目标。 所有子智能体运行过程同样完整留存日志，执行链路能够完整回溯。
内测社区还产出上下文编辑插件：单条消息支持修改，完整记录修改时间线，支持单回合重试以及切换后续执行策略。
安全与权限管控
进程沙箱
智能体执行指令可运行在隔离沙箱环境。沙箱管控进程文件读写权限，三大桌面系统采用原生隔离方案：Linux 使用 bwrap / Landlock，macOS 依托 Seatbelt，Windows 通过受限ACL令牌实现。
沙箱提供三档权限： read-only：仅允许读取，禁止写入； workspace-write：仅可写入工作目录与指定临时文件夹； danger-full-access：无隔离，完全放开权限。
沙箱后端会如实上报实际隔离能力，若当前系统只能实现部分隔离，将标记为partial，不会虚假宣传安全边界。
审批与权限体系
存在风险的操作（文件修改、高危命令执行）会先弹窗向用户申请授权，确认通过后才会执行。权限提供预设档位，用户可以统一调整严格程度。
自动防护插件（守卫）
两套内置纠偏插件：循环检测器识别智能体无效重复操作；超时控制器强制终止长时间卡死的工具调用。
凭据与隐私保护
密钥不会写入会话日志。API Key等凭证经由独立通道传输，日志内仅保留引用标识，不存在明文密钥。数据默认保存在本地，会话日志不会自动上传。遥测功能需要手动开启；用户可选择仅主动反馈时附带日志，或是持续上传匿名化数据。
生态兼容性
DeepSeek Harness 原生支持 Model Context Protocol，任意MCP服务（数据库、办公系统、企业内部业务服务等）均可接入。接入后的外部工具和内置工具遵循同一套运行流程，同样受到审批与防护机制约束。
Hooks桥实现兼容：原本为Claude Code、Codex开发的钩子脚本（提交校验、消息通知集成等）能够直接复用，无需重新开发。内置ACP服务端，支持ACP协议的编辑器、客户端可直接将DeepSeek Harness作为后端智能体服务。
Skills是打包封装的任务指令与配套资源，智能体按需加载，支持自建技能库。系统支持三类定时任务：延时触发、定点触发、周期循环。 模型接入层面，除DeepSeek官方接口外，兼容所有OpenAI规范推理端点，可以对接企业私有化推理服务或者其他厂商大模型，在设置界面填入地址即可启用。
社区还开发了表情包插件：依靠系统提示词让模型标记文本情绪，客户端识别标记后渲染内嵌表情图片，分为关闭、智能匹配、高频展示三档，配置持久化保存在本地。
五种使用途径
- Web UI：浏览器访问本地地址直接使用，支持对话交互、操作审批、模式切换、参数配置；
- Headless CLI：无图形界面执行单次任务，输出结果后退出，适配CI/CD流水线与脚本调用；
- Python SDK：内置运行环境，提供高层轮次API与底层JSON-RPC客户端；
- TypeScript SDK：封装JSON-RPC协议、服务端与客户端，适合深度定制开发的团队；
- ACP自动化协议服务端：面向编辑器厂商与各类工具链开发者。
面向开发者的拓展能力
DeepSeek Harness 配套完整插件开发文档，覆盖工具开发、配置编写、事件与服务开发、插件发布全流程。
项目拥有清晰工程规范：插件注册逻辑必须支持逆向清理；配置错误在加载阶段直接报错，不静默失效；跨模块标识采用强类型区分；部署相关参数统一写入配置，禁止硬编码。整套规范由仓库自动化流程强制校验。
项目设立严格质量门禁：源码文件实现100%单元测试覆盖；支持无密钥快照回放测试；真实接口端到端测试；代码重复检测；文档与代码一致性校验，文档滞后将阻断CI流程。
框架还支持自修改能力：开启后智能体能够检测、热加载运行时插件，创造模式正是基于这项能力搭建。
快速上手体验
系统预先装好Node.js开发环境后，执行一行命令即可拉起Web界面： npx @deepseek-ai/dsh web