大数跨境

DeepSeek Harness 使用指南

DeepSeek Harness 使用指南 AI智能创作写作
2026-11-06
16
导读:DeepSeek Harness是 DeepSeek 开源的本地 Agent 运行框架,采用 MIT 协议,基

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 后,请按以下步骤完成配置:

  1. 接入模型:进入“设置 → 模型”,填写 DeepSeek API Key。也支持添加兼容 OpenAI 协议的其他模型,或指向本地部署的模型服务。

  2. 设定工作区:选择本地目录作为工作区,默认仅允许修改该目录内的文件。

  3. 安装插件:进入“设置 → 插件”,根据需求安装 Shell、网页搜索、子 Agent 或语音输入插件;也可通过对话指令让 Agent 自动生成插件。

  4. 发布任务:明确描述目标与要求,例如“读取当前仓库,梳理模块结构并补充 README,严禁改动业务代码”。

工作区权限管理

权限设置仅影响文件写入和命令执行,不干扰模型调用逻辑。

档位

范围

使用时机

ReadOnly

仅读取文件

代码审查、资料查询等无需修改文件的任务

Workspace write

工作区内可读可写

默认档位,适用于大多数常规任务

Full access

可执行系统级命令

仅在安装依赖、修改系统配置时临时开启

注意事项

  • 预览版特性:v0.1 版本的 API 和插件接口可能调整,不建议用于生产环境关键链路。

  • 模型自行接入:Harness 本身不包含模型,用户需提供 API Key 或配置本地模型服务。

  • 最小权限原则:鉴于 Shell 执行和文件写入的高风险,日常建议保持在 Workspace write 档位,Full access 使用后应立即关闭。

  • 数据安全:长任务建议在测试目录先行验证,重要目录务必纳入版本控制;多步任务调用频繁,需注意 API 额度消耗。

【声明】内容源于网络
0
0
AI智能创作写作
1234
内容 556
粉丝 1
AI智能创作写作 1234
总阅读51.4k
粉丝1
内容556