DeepSeek Harness 是 DeepSeek 推出的开源本地 Agent 运行框架(公开预览版 v0.1),采用 MIT 协议。该框架基于 Cordis 插件架构,核心逻辑在于将模型推理结果转化为对本地环境的实际操作,如读写文件、执行命令、调用工具及拆解多步任务。其模型、工具、界面、存储和调度均以插件形式实现,支持灵活替换且无需修改源码。
定位与核心能力
Harness 充当模型与实际执行环境之间的桥梁:模型提供意图,Harness 将其转化为具体动作,并将执行结果反馈给模型,形成闭环。更换不同的 Harness 可改变模型的任务范围,而更换模型则影响任务完成质量。
主要具备以下六大能力:
文件与命令管控:在指定工作区内进行文件读写及 Shell 命令执行,严格限制越权操作。
多步任务执行:将复杂目标拆解为可验证的步骤,根据上一步结果动态调整后续行动,支持失败回退与重试。
子 Agent 协同:支持并行任务分配给子 Agent,由主 Agent 负责汇总结果与校验。
精细化权限控制:基于工作区限定读写范围,最低可设置为只读模式。
会话持久化:上下文与执行记录本地存储,支持中断后继续任务。
插件化扩展:工具、模型、界面等组件均可替换,支持在对话中动态生成新插件。
支持三种运行形态:桌面客户端(Windows/macOS)、Web UI 及 CLI。
适用场景
该框架适用于需要连续操作本地文件或执行系统命令的场景;仅需问答或文本生成的任务使用普通对话即可。
场景 |
具体任务 |
前置条件 |
|---|---|---|
代码开发 |
读取仓库结构、定位 Bug、修改代码、运行测试回归 |
工作区指向代码仓库,安装 Shell 插件 |
日常办公 |
批量整理文件、表格数据汇总、文档起草 |
授予文件读写权限;处理 PPT/表格需对应插件 |
资料研究 |
联网检索信息、事实核查、输出带来源结论 |
安装网页搜索插件 |
批量任务 |
脚本处理大量文件、后台长时间运行任务 |
配置 Shell 及持久会话功能 |
自定义扩展 |
安装第三方插件或在对话中生成新插件 |
熟悉插件配置规范 |
安装与配置指南
环境要求
命令行方式需 Node.js 22.19.0 及以上版本,或 Node.js 24 及以上版本。
首次配置流程
启动 Web UI 后,请按以下步骤完成配置:
工作区权限管理
权限设置仅影响文件写入和命令执行,不干扰模型调用逻辑。
档位 |
范围 |
使用时机 |
|---|---|---|
ReadOnly |
仅读取文件 |
代码审查、资料查询等无需修改文件的任务 |
Workspace write |
工作区内可读可写 |
默认档位,适用于大多数常规任务 |
Full access |
可执行系统级命令 |
仅在安装依赖、修改系统配置时临时开启 |
注意事项
预览版特性:v0.1 版本的 API 和插件接口可能调整,不建议用于生产环境关键链路。
模型自行接入:Harness 本身不包含模型,用户需提供 API Key 或配置本地模型服务。
最小权限原则:鉴于 Shell 执行和文件写入的高风险,日常建议保持在 Workspace write 档位,Full access 使用后应立即关闭。
数据安全:长任务建议在测试目录先行验证,重要目录务必纳入版本控制;多步任务调用频繁,需注意 API 额度消耗。

