
DeepSeek Harness上线后以“一切皆插件”的理念重新定义AI编程工具目前已开发测试。就在DeepSeek V4 Pro 正式版发布半天后DeepSeek Harness 开发者预览版也来了Github项目地址GitHub - deepseek-ai/deepseek-harness: DeepSeek Harness: Everything is a Plugin. · GitHub仓库已经包含超过 230 个 workspace 成员代码分布在 packages/、apps/、examples/、python/、native/、vendor/、website/ 等区域。文件系统、终端、子进程、PTY、语言服务器、网页访问、技能、子智能体、工作流、计划模式、会话持久化、设置、凭据、遥测几乎每一项能力都有自己的包。项目上线半小时GitHub仓库星标突破一万短短时间内已经冲破3万。很多内测开发者纷纷晒出体验感言与内测合影期待已久的产品终于浮出水面。但上手之后不少人发现它和大众提前猜想的产品形态完全不同这不是一款面向普通用户的CodingAgent而是一套自由度极高的Agent底层开发框架。DeepSeekHarness负责人崔添翼也在社交平台坦诚当前只是预览版本诸多细节仍显粗糙欢迎全球开发者参与测试、提出优化意见。DeepSeek Harness是什么DeepSeek Harness 并非新的 DeepSeek 模型也非一个单纯的 API 客户端。它是一套用来构建、运行和扩展智能体的 SDK 与应用框架默认可以连接 DeepSeek 模型也可方便地自定义连接其它模型让模型读取项目、修改文件、运行命令、管理任务、分配子任务并通过 Web UI、全屏终端、Headless 命令或自动化协议与用户交互。官方给的定位很简单Agent Model Harness模型负责理解需求、分析问题和决定下一步做什么但仅有模型还不能完成一个真实项目。它需要读取文件、修改代码、执行命令、调用工具、保存上下文还要知道任务进行到了哪里。如果把模型理解成Agent的大脑那么Harness更像是它的工作环境给它工具告诉它能访问什么记录它做过什么并让它在多轮任务中持续工作。DeepSeek没有把这些能力全部固定在一套封闭的产品里而是试图将它们拆开。开发者可以替换模型可以增加新的工具也可以重新组合沙箱、存储和界面。官方提供的标准模式、PTC模式、极简模式与创造模式就是针对不同任务组合Agent能力。官方也反复强调一句话Everything is a Plugin至少有三层含义第一层是组装层决定这次启动要装什么基础层dsh-base**DeepSeek Harness 启动时不会加载一份巨大的固定配置它会按顺序叠几层东西Bundle 列表先放进dsh-baseweb或headlessProfile决定产品入口Profile 自己的cordis.patch.yml用户目录里的长期修改本次命令行传入的--patchProfile 决定整个进程有哪些能力Preset 决定某个会话能拿到哪些工具、提示词和工作流第二层是 Cordis 运行层决定插件如何依赖、通信、卸载和清理也叫协议层它的Context可以理解成一个带作用域的服务容器插件从里面拿tools、llm、sessions等服务也把自己提供的能力注册进去一条能力通常会拆成三个角色服务定义约定能力叫什么、数据长什么样Provider真正提供能力例如 DeepSeek 模型适配器Consumer使用能力例如 Agent Loop 请求模型第三层才是用户能看到的 Agent 能力模型、工具、循环、会话、存储、沙箱和 UI 都在这里运行时层DSH负责任务理解、逻辑推理、工具调用决策与结果验证是整个智能体的“大脑”提供稳定的推理上限支撑复杂任务执行。核心构成1. 插件加载与编排系统所有插件通过配置文件声明加载无需硬编码集成支持40类别的官方插件与第三方自定义插件。 提供四种事件分发模式emit异步无等待、waterfall中间件式链式传递、parallel并行执行、serial顺序串行执行适配不同插件的协同场景。 支持依赖注入自动编排插件加载顺序无需手动编写启动逻辑。2.全链路会话管理系统采用追加式日志记录所有执行事件完整留存每一轮模型调用、工具执行、状态变更的全量轨迹原生支持会话断点续跑、任务分支重放、历史执行回溯可随时从任意历史节点重启任务无需从头执行内置会话压缩机制自动裁剪冗余上下文避免长任务下的上下文溢出问题3.沙箱与权限管控系统集成Linux Landlock自限制启动器实现进程级别的资源隔离限制工具的文件系统、网络访问范围支持细粒度权限配置可单独为每个插件、每个工具分配执行权限避免恶意代码执行风险配套Shell执行器、文件系统提供者等基础能力插件默认提供安全隔离的代码运行环境4.多入口运行载体提供CLI命令行入口、Web可视化UI入口、Python SDK入口三种运行模式默认启动后可通过127.0.0.1:3080访问Web管理界面支持与SuperQode等第三方工具集成将DSH的执行进度统一映射到外部编排系统中配套的运行模式三层架构之上还提供四种开箱即用的运行模式适配不同开发场景标准模式提供完整工具集覆盖通用智能体任务PTC模式支持生成代码编排多轮复杂工具调用极简模式仅开放Shell与文件编辑能力用于模型基准测试创意模式支持自定义插件与运行时扩展用于技术实验DeepSeek Harness特点热插拔能力运行过程中可直接替换任意插件的实现无需重启整个Agent进程比如在线切换模型适配器、更新工具逻辑不中断当前正在执行的任务全链路可观测所有插件的执行过程、事件流转、状态变更都可被监控记录便于排查Agent执行失败的根因高度可扩展通过开放扩展点机制可快速接入自定义模型、私有工具、第三方通知服务、编辑器联动等能力比如官方已提供直接在VS Code中打开工作区的配套插件低侵入集成原有DeepSeek Responses API的调用代码几乎无需修改即可直接接入DSH运行时获得完整的会话管理与沙箱能力按照DeepSeek公布的信息开发者无需直接修改DeepSeek Harness源码即可通过插件独立替换或扩展模型、工具、技能等能力并在配置层进行组合。Token节省不DeepSeek Harness 很重视 Token 复用DSH 有三层自动 Token 管控机制配合 PTC 编程工具调用、前缀缓存、工具输出裁剪、上下文自动压缩WebUI/TUI 均可实时看消耗统计。PTCProgrammatic Tool CallingAgent 运行逻辑用 TypeScript 在本地执行中间变量不全部喂给 LLM只把最终结果送入上下文避免多轮工具调用疯狂堆 token。工具返回结果自动裁剪工具输出 8192 字符保留开头 4096 结尾 1024 字符中间替换为省略摘要文件 / 大输出超过50000 字节内容落盘保存对话上下文只放文件路径 简短摘要不把大文本塞进 prompt3.上下文自动压缩窗口水位触发上下文占用达到模型窗口80% 水位下一轮 step 自动触发压缩保留最近 16% 原始对话更早历史做 LLM 摘要压缩防止越跑越长爆窗口压缩失败会降级为简单截断保证任务不崩溃如何安装DeepSeek Harness的安装很简单一行命令搞定1初次安装通过npm运行安装Node.js然后运行npx deepseek-ai/dsh web该命令会启动 Web UI默认地址为http://127.0.0.1:3080从源码运行git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web2Web UI配置Web UI命令会打印其访问地址dsh进程会把调用目录作为默认文件系统位置但新的 Web UI 在添加工作区前不会选中任何工作区。1、配置模型打开设置 → 模型输入 DeepSeek API 密钥并保存。模型路由会立即可用不需要重启服务器。支持自定义配置其他模型请添加新提供方并删除旧提供方。显示名称、基础 URL、协议、凭据和模型仍可编辑。在模型目录中选择获取可用模型可查询表单当前显示的基础 URL 和凭据。选择候选项只会更新草稿保存前不会存储提供方。目录提供方使用已安装目录不发起网络请求。2、选择工作区点击选择工作区添加启动dsh时所在的项目目录然后选中它。选中工作区前会话输入框不可用3UI界面支持WebUI和TUI1、WebUI适合日常开发与图形化操作。启动后在浏览器访问本地地址默认http://127.0.0.1:3080提供工作区管理、可视化配置、轨迹回放Trajectory及 Token 仪表盘等功能交互界面类似 DeepSeek 网页版但增加了本地项目管理能力安装方式 通过npx deepseek-ai/dsh web一键启动界面说明左侧会话 / 工作区列表、设置主面板对话、工具调用卡片、工作目录选择、模型切换、权限控制底部输入框支持挂载本地目录作为 Agent 工作区2、TUI专为终端用户设计提供全屏交互式键盘操作体验。需安装社区插件如dsh-TUI激活支持 ASCII 启动画面、实时状态栏、Tab 自动补全及/model等指令切换适合偏好命令行环境的开发者 。安装方式TUI 需先安装插件并使用dsh --profile tui命令进入终端界面克隆社区插件源码git clone gitgithub.com:ccch1mneyyy/dsh-TUI.git安装插件到 TUI 配置层dsh plugin --profile tui add file:$(pwd)运行dsh --profile tui进入终端界面首次使用前需在配置文件或环境变量中设置DEEPSEEK_API_KEY启动界面会话框界面说明ASCII 像素鲸鱼大 Logo 启动界面全屏终端交互式会话状态栏显示模型、token、effort 等级内置命令/model切换模型、/help帮助Tab 自动补全Esc 返回上一级支持 Plan/Agent/YOLO 三种运行模式文件读写、shell 执行、工具审批弹窗