📚 系列导航：这是 DeepSeek Harness 教程系列第一篇，本篇先讲清产品定位和使用边界；下一篇 DeepSeek Harness 与 Claude Code、Pi 区别说明 会继续拆解完整产品、个人工作台和 Agent 搭建平台的架构差异。
DeepSeek Harness 是什么？先给结论：它是 DeepSeek AI 开发的开源 Agent Harness，用来组合模型、工具、会话、权限策略和用户界面。 它不是一个新模型，也不只是套在 DeepSeek API 外面的聊天页面。
如果把大模型看成发动机，Harness 更像整辆车的底盘和控制系统。发动机负责产生推理结果，Harness 还要决定它能看到哪些文件、可以调用哪些工具、操作前是否需要审批、会话如何保存，以及结果从 Web UI 还是程序接口交给你。
ℹ️ 本系列截图来自开发者预览阶段，界面位置和文案可能继续变化；具体能力以当前安装版本和官方仓库文档为准。
DeepSeek Harness 的产品定位与核心能力
官方把命令名缩写为 dsh，并将项目描述为开源 agent harness。这里的 Harness 可以翻成“智能体运行框架”：它负责把一次模型调用扩展成可持续执行、能调用工具、能记录过程的 Agent 工作循环。
普通聊天页面通常止步于“给出答案”。DeepSeek Harness 还可以让 Agent 读取和编辑工作区文件、运行命令、委派任务并维护计划；具体能执行到什么程度，由当前配置和权限策略决定。会动手不等于可以不检查，文件改动、终端命令和凭证边界仍需要你负责验收。
项目采用 MIT 许可证开放源码。你可以研究实现、参与贡献或在许可证允许的范围内二次开发，但第三方依赖仍有各自的许可证说明，不能只看主仓库的一个许可证文件就忽略依赖边界。
DeepSeek Harness 和 DeepSeek 模型有什么区别
DeepSeek 模型负责接收消息并生成输出；DeepSeek Harness 负责把模型放进一个可执行的工作环境。两者是“能力提供方”和“运行框架”的关系，不是同一个产品的两个名字。
官方 Web UI 默认提供 DeepSeek 模型配置入口，也允许添加其他目录提供方和自定义 OpenAI 兼容端点。因此，理解 DeepSeek Harness 时不要把它锁死成“只能调用一个 DeepSeek 模型”。模型路由只是插件树中的一部分，工具、会话、持久化和审批同样重要。
这也解释了为什么 API 密钥不是安装框架本身的唯一条件：你可以先把程序启动起来，但要真正发送模型请求，还得在界面中配置可用的模型提供方和凭证。
DeepSeek Harness 一切皆插件架构
DeepSeek Harness 的核心设计是“一切皆插件”。模型适配器、工具注册表、会话日志和 Agent 循环都通过 Cordis 插件接入共享上下文，没有一个要求所有扩展都直接修改的“特权内核”。
可以把它理解成一块插线板：每个插件负责一种能力，挂载时注册服务、事件或副作用，卸载时对应注册可以撤销。你要替换模型提供方、增加工具或改变运行入口，优先做的是在正确扩展点接入插件，而不是复制整个 Agent 循环再改一份。
这种设计提升了可替换性，也增加了学习门槛。第一次使用不用先读完所有包；先跑通 Web UI，再去理解 Profile、Bundle、事件和能力接缝，会比一上来扎进 packages/ 更容易形成完整地图。
DeepSeek Harness Web 与 Headless 运行入口
官方发行版提供 web 和 headless 两种 Profile 模板。web 会加入浏览器应用，适合在界面里配置模型、选择工作区、建立会话和查看审批；headless 是不启动服务器的一次性运行方式，更适合脚本和自动化场景。
新手建议先选 Web UI，因为界面会把模型、工作区和审批状态摆在明处。等你已经知道一次任务会经过哪些步骤，再尝试 Headless、Python SDK 或插件开发，排错时更容易判断问题发生在模型、工具还是运行配置。
入口不同不代表核心逻辑完全分裂。它们都是在启动时组合相应插件层，只是最终面向人的交互方式不同。
DeepSeek Harness 适合哪些用户
DeepSeek Harness 更适合三类用户：想研究 Agent 运行机制的开发者、需要组合模型与工具的团队，以及准备开发自定义插件或程序接口的人。只想打开网页问几个问题的用户，普通聊天产品通常更省事。
判断标准可以很具体：如果你需要控制工作区、审批、会话持久化、模型路由或工具执行，Harness 的可组合性才有价值；如果你的需求只是获取文本答案，引入完整运行框架反而会增加配置和维护成本。
还有一条必须提前知道：官方明确把项目标记为开发者预览，并提示未来会出现破坏兼容性的变更。现阶段适合体验、研究和参与开发；若要用于长期项目，需要自己承担升级、回滚、接口变化和安全评估成本。
下一步先跟着 DeepSeek Harness 安装与启动教程 跑通本地服务。官方事实可继续核对 DeepSeek Harness 中文 README 和 官方架构文档。
常见问题
DeepSeek Harness 是 DeepSeek 模型吗？
不是。模型负责生成内容，Harness 负责把模型、工具、会话和权限组合成可执行的 Agent 环境。
DeepSeek Harness 只能连接 DeepSeek API 吗？
不是。官方模型配置支持 DeepSeek，也提供目录提供方和自定义 OpenAI 兼容端点；具体可用范围以当前版本的模型页面和官方文档为准。
现在适合直接用于生产环境吗？
官方仍将其标为开发者预览，并明确提示会有破坏兼容性的变更。生产使用前必须自行评估稳定性、安全、升级和回滚方案。