AI 教程 › 基础教程

DeepSeek Harness 教程

DeepSeek Harness 的概念、安装、各种模式和实际任务，21 篇。

作者 stormzhang，转载自开源项目 stormzhang/ai-coding-guide（MIT 许可）。

从第 1 篇开始 →

认识 DeepSeek Harness5 篇

  1. 01DeepSeek Harness 是什么DeepSeek Harness 的产品定位、核心职责、插件化架构和 Developer Preview 边界，帮助初学者分清模型、聊天产品、IDE 与 Agent Harness，并判断自己是否值得学习这套开源框架。
  2. 02Agent = Model + Harness 到底是什么意思拆解模型、Harness 与 Agent Loop 的完整分工，解释一次编码任务如何经过模型请求、工具执行、结果回灌、会话记录和安全把关，建立后续理解 DeepSeek Harness 的核心认知框架。
  3. 03DeepSeek Harness、Claude Code、Codex、OpenCode 怎么选同日在线复核四家官方资料，从定位、模型绑定、架构开放性、权限安全、获取方式五个维度对比 DeepSeek Harness、Claude Code、Codex、OpenCode，给出按人划分的选型决策路径。
  4. 04模型、Agent、Harness、IDE 之间是什么关系用同一条任务链讲清模型、Agent、Harness、IDE、Provider 与执行环境分别负责什么、怎样连接，以及更换其中一层会改变哪些能力，帮助初学者建立可用于排错和选型的系统地图。
  5. 05DeepSeek 模型目录、API Key、价格与调用方式集中核对 DeepSeek V4 三个当前 API 模型、1M 上下文、峰谷价格、API Key 安全边界与 Harness 固定版本调用方式，并区分官方服务上限、Harness 默认值和真实账号待验证项。

安装与第一次使用10 篇

  1. 06环境准备：Node.js、工作区与 API Key从零检查 DeepSeek Harness 固定版本需要的 Node.js、npm、操作系统、浏览器、网络、工作区和 API Key 条件，并用跨平台命令完成安装前自检，提前排除版本与目录问题。
  2. 07用 `npx` 启动 Harness使用固定 npm 版本从项目目录启动 DeepSeek Harness Web UI，验证版本、端口、首页、停止方式和回环网络边界，并掌握端口冲突、缓存、SSH 与启动失败的排查方法。
  3. 08Web UI 界面与工作区从第一次打开 DeepSeek Harness Web UI 开始，讲清工作区添加、选择、持久记录、Session 归属、启动目录和安全边界，并用 Host 与 RPC 证据排查页面连接问题。
  4. 09配置 DeepSeek 官方 Provider 与默认模型在 DeepSeek Harness Web UI 中安全配置官方 Provider、只写 API Key 与默认模型，分清目录可见和真实可用，并通过最小只读 Agent Turn、错误码与 Trajectory 验收连接。
  5. 10配置第三方与自定义 Provider本篇将解释 DeepSeek Harness 的第三方 Provider、自定义兼容服务和协议差异，给出最小配置与验证方法，并明确官方目录、可配置选项和已激活服务不是同一概念。
  6. 11跑通第一个代码任务本篇将使用真实 Provider 在临时 Git 仓库完成第一个代码任务，覆盖描述目标、观察工具调用、检查文件修改、运行验证和保留证据的完整闭环。
  7. 12查看文件修改、命令执行与审批本篇将用可复现任务观察 Harness 如何读写文件、执行 Shell、发起审批和回灌工具结果，并分别覆盖无审批、拒绝、单次允许和执行失败路径。
  8. 13Session 与 Trajectory 轨迹本篇将解释 Session、Trajectory 与持久化记录的关系，演示如何查看任务轨迹、重启后恢复会话，并明确正常退出证据不能外推到崩溃、Fork 与 Replay。
  9. 14从源码安装与本地开发本篇从零完成 DeepSeek Harness 固定版本的源码安装、冻结依赖、类型检查、两种构建、CLI 与 Web 启动，并说明 postinstall、副作用和 React 类型污染排查。
  10. 15升级、降级、卸载与安装排错本篇讲清 DeepSeek Harness 的 npm 版本、内部依赖图、Git tag 与状态格式，给出可回滚升级、可靠降级、按安装方式卸载和缓存、构建、启动排错流程。

运行模式与工作流6 篇

  1. 16怎么给 Harness 下达任务本篇将用真实 Provider 对照含糊指令与可执行任务，说明如何交代目标、上下文、边界和成功标准，让 Harness 能持续推进并交付可验证结果。
  2. 17Standard Mode：完整编码 Agent本篇将验证 Standard Mode 的定位、默认工具和适用任务，使用固定版本记录真实工具暴露与运行过程，并为后续四模式对比建立同一任务基线。
  3. 18PTC 模式（Code Mode）：让模型用代码编排工具本篇将解释 UI 中的 PTC 模式与 Code Mode 的对应关系，验证 run_code 工具如何编排多步操作，并与 Standard 的连续原生工具调用做同任务对比。
  4. 19Minimal Mode：最小工具集与模型评测本篇将说明 Minimal Mode 为什么只保留最小工具集、适合验证什么问题以及不能代表什么，并用固定任务记录 bash 与文件编辑工具的真实执行边界。
  5. 20Creator／创造模式：让 Harness 帮你开发 Harness本篇将说明 Creator／创造模式与 cordis Preset ID 的对应关系，验证它比 Standard 多出的扩展工具，并界定开发插件、配置和 Harness 能力时的适用范围。
  6. 21四种模式应该怎么选本篇将用同一任务比较 Standard、PTC、Minimal 与 Creator 四种模式的工具、过程、成本和结果，给出基于任务类型而不是模式名称的选择方法。