DeepSeek · 插件化 Agent 运行框架
DeepSeek Harness 使用攻略
除了换模型，也可以重新组织模型周围的工具、会话和执行环境。
DeepSeek Harness 是 DeepSeek 官方开源的 Agent 运行框架，使用 Cordis 插件体系。它不是 DeepSeek 聊天网页的别名，也不是新的模型名称；适合希望理解、扩展或定制 Agent 执行过程的开发者。
首次体验约 15 分钟资料核验 含安全检查
本轮资料更新
插件化 Harness · 开发者预览
- 官方采用 Everything is a Plugin 架构，把模型、工具与界面放在可扩展的运行环境中。
- 当前 Web UI 可即时保存模型配置；选择工作目录后才能开启会话，预览版本需关注兼容性。
01 · 快速上手
从第一次启动，到完成一个真实任务
01
在独立项目目录启动
安装 Node.js 后运行 npx @deepseek-ai/dsh web，使用终端实际打印的本地地址。
02
配置模型并选择目录
在 Settings → Models 配置模型，再通过 Choose workspace 选定项目；未选目录时无法发起任务。
03
用小任务检查工具链
先生成包结构和入口说明，确认文件读取与命令权限，再尝试插件或代码修改。
建议从这个任务开始
请只读分析这个项目，列出主要包、入口和测试命令。每个判断附文件路径；不要安装依赖、修改文件或启动后台服务。
先用小样本验证结果，再扩大任务范围。
02 · 基础配置
上手设置与任务模板
界面操作，不是配置文件语法 · Web UI 设置清单
Settings → Models：配置可用模型服务
Choose workspace：仅选择本次项目目录
首次任务：读取 README，梳理包结构和测试入口
验收：列出读取的文件，不修改代码
升级：记录版本，核对官方预览版兼容性说明命令按当前官方资料整理；选择适合自己系统的安装方式，执行前核对版本与工作目录。
03 · 实用技巧
真正拉开效果差距的使用习惯
技巧 01
模型与 Harness 分开评估
固定同一任务与模型，再比较工具执行、恢复能力和日志；不要把变化都归因于模型。
技巧 02
逐个接入插件
每次只增加一个插件，先验证职责与权限，再组合成完整流程。
技巧 03
保留可复现环境
记录包版本、插件和模型配置，便于在预览版升级后定位回归。
可直接复用的任务模板
请只读分析这个项目，列出主要包、入口和测试命令。每个判断附文件路径；不要安装依赖、修改文件或启动后台服务。
04 · 安全边界
明确使用与执行边界
执行前检查
- 本地 Web UI 不直接暴露到公网
- 插件逐个审查后再启用
- 模型密钥只在本机可信设置中配置
05 · 学习资源
继续深入
官方资料用于确认安装、命令和权限；社区资料用于补充中文经验与案例。涉及版本的内容请以官方为准。