DeepSeek Harness

DeepSeek Harness 教程

DeepSeek Harness 教程目录按学习顺序整理产品定位、与 Claude Code 和 Pi 的区别、从零快速上手、安装启动、Web UI、模型配置、Agent 预设、Code Mode、多智能体、安全权限、插件架构、社区插件推荐和 Python SDK。

overview 入门

更新于 2026-08-14

基础入门

DeepSeek Harness 是什么：开源 Agent 运行框架入门 DeepSeek Harness 是 DeepSeek AI 开发的开源 Agent Harness，用插件组合模型、工具、会话、权限和界面，而不是一个固定模型或普通聊天页面。本篇拆清产品定位、一切皆插件的架构思路、Web 与 Headless 两种入口、适用人群和开发者预览风险，帮你在安装前判断是否值得上手。

DeepSeek Harness 与 Claude Code、Pi 架构区别 DeepSeek Harness 与 Claude Code、Pi 的核心区别不在模型，而在产品边界、默认决策、扩展深度与安全责任。本篇按七个维度解释完整 Coding Agent、极简个人工作台和插件化 Agent 平台的差异，结合界面、模型接入与维护成本说明适用目标，帮助你判断是否需要用 DSH 搭建 Agent。

DeepSeek Harness 快速上手教程：从安装到第一个任务 DeepSeek Harness 快速上手教程带你从理解 Model + Harness 和插件架构开始，完成 Web UI 启动、API 配置、工作区选择、标准与 PTC 等四种模式判断、第一个任务和轨迹检查；同时说明创造模式、社区插件与安全边界，配合本地截图、命令、预期结果和常见问题一步步验证。

DeepSeek Harness 安装与启动教程 DeepSeek Harness 安装与启动可以选择 npx 快速运行 Web UI，或克隆官方仓库后用 pnpm 构建源码。本篇分别讲清 Node.js、Git 与 Corepack 准备，给出可复制命令、默认访问地址、成功验证和常见失败排查，并说明源码开发当前支持的 Node.js 版本边界与开发者预览风险。

DeepSeek Harness Web UI 第一个任务教程 DeepSeek Harness Web UI 第一个任务需要先启动服务，再在设置中保存模型凭证、添加并选择工作区，最后创建会话发送可验收指令。本篇按官方流程讲清模型配置立即生效、工作区与启动目录的关系、审批提示和任务结果检查，帮助你从空白界面跑通一次完整 Agent 工作循环，附任务验收与常见问题。

配置与使用

DeepSeek Harness 模型与 API 配置教程 DeepSeek Harness 模型配置支持官方 DeepSeek、目录提供方和自定义 OpenAI 兼容端点。本篇讲清 API 密钥保存位置、Provider ID、Base URL、协议与模型填写方法，并排查 MISSING_CREDENTIAL、UNKNOWN_MODEL、401 和图片输入被拒绝等问题。

DeepSeek Harness Agent 预设模式选择教程 DeepSeek Harness Agent 预设决定每个会话可用的工具、提示词、Skills 与协作能力。本篇对比标准、PTC、极简和创造模式，讲清新会话如何选择、为什么已有内容后不能切换，以及复制预设、创建专用 Agent 和区分 Profile 的方法，帮助你按任务复杂度选对运行组合，避开常见误区。

DeepSeek Harness 内置工具与 Code Mode 教程 DeepSeek Harness 内置工具覆盖文件读写、代码搜索、Shell、持久终端、LSP、网页访问、计划和后台任务，PTC 预设还会通过 Code Mode 让模型用程序组合多次调用。本篇讲清原生工具与 run_code 的区别、执行流水线、上下文占用、安全审批和适用任务，帮助你选择可验证的执行方式。

协作与安全

DeepSeek Harness 多智能体协作与安全教程 DeepSeek Harness 多智能体协作支持可续跑 subagent、一次性 subagent_fork、workflow 和 Ralph 循环。本篇讲清子任务拆分、跟踪、汇总与验收方法，并说明 workspace-write、read-only、danger-full-access、一次性审批、凭据和遥测边界。

架构与开发

DeepSeek Harness 插件架构与运行原理 DeepSeek Harness 采用 Cordis 驱动的一切皆插件架构，模型适配器、工具、会话日志和 Agent Loop 都能从配置组合或替换。本篇拆解 Profile、Bundle、核心包、轮次与步骤、持久会话事件和能力接缝，帮助插件开发者判断新行为应该挂在哪个扩展点，而不是直接修改运行循环。

DeepSeek Harness 插件推荐与安装教程 DeepSeek Harness 插件推荐与安装教程，精选文件引用、任务完成通知、会话回退、交互式可视化、对话分享和自定义工具等社区插件，逐一说明适用场景、功能限制、Profile 选择、安装命令、重启验证、升级与卸载方法，并提醒安装第三方代码前检查仓库来源、固定版本、构建脚本、兼容要求和权限边界。

DeepSeek Harness Python SDK 使用教程 DeepSeek Harness Python SDK 可以在程序中启动运行时，通过 DeepSeekHarness API 发起 Agent 任务。本篇覆盖平台要求、虚拟环境安装、凭证、工作区与会话目录、代码调用和 JSONL 日志验证，并说明 danger-full-access 与 Shell 的安全边界。