LEARN · FIELD MANUAL 01
DeepSeek Harness 教程
DeepSeek Harness（开源智能体框架，命令为 dsh）怎么装、怎么跑、怎么用到真实工作里——这里按可以逐步完成的顺序学，不需要先理解底层架构。
BASELINE · DSH 0.1.1-rc.2 · NODE.JS ^22.19.0 || >=24.0.0
直接答案
DeepSeek Harness 怎么用，按「先跑起来、完成第一次真实任务、学会日常使用、再决定扩展方式」四步学；12 篇教程按此排列，遇到问题随时进入故障排除，不必从头读完。LEARNING ROUTE · 01—12
学习路线
12 篇教程按学习路径排列。不需要一次看完：边用边学，遇到什么问题就看对应那篇。各篇尚未统一标记为 DSHOPC 已实测，需要真实环境结论时进入 Lab。
START HERE
先跑起来
安装、启动，并完成第一次真实任务- DeepSeek Harness 新手入门：开始使用前先看这篇第一次接触 DeepSeek Harness？这篇先讲清它是什么、和模型及智能体的关系、使用前要准备什么，以及新手最合适的学习顺序。
- DeepSeek Harness 安装与启动教程从零安装并启动 DeepSeek Harness，检查 Node.js 环境，使用官方 npx 命令运行 Web UI，并判断启动是否真正成功。
- DeepSeek Harness 第一次使用：从启动到完成第一个智能体任务DeepSeek Harness 启动后怎么用？本教程带你配置一个可用模型、选择测试工作区、使用标准模式，并通过真实工具调用完成第一次可验证的智能体任务。
DAILY USE
日常使用
配置模型、理解界面与 Agent 预设- DeepSeek Harness 模型配置教程：DeepSeek、OpenAI 与自定义 API配置 DeepSeek Harness 模型提供方，使用 DeepSeek、OpenAI 或自定义 API 地址，理解 API 密钥、Provider ID、模型目录与兼容参数，并验证模型与智能体链路。
- DeepSeek Harness Web UI 使用指南系统了解 DeepSeek Harness Web UI：工作区、会话、模型、Agent 预设、权限、工具调用、轨迹、上下文压缩、分叉和归档等日常操作。
- DeepSeek Harness Agent 预设怎么选？标准模式、PTC 模式、极简模式与创造模式详解了解 DeepSeek Harness 四种内置 Agent 预设：标准模式、PTC 模式、极简模式和创造模式，理解它们的能力差异、生命周期与适用场景。
EXTEND
扩展能力
选择并使用 Profile、Plugin、Skill 与 MCP- 插件、技能和 MCP 有什么区别？DeepSeek Harness 扩展能力选择指南DeepSeek Harness 需要扩展能力时，到底应该用插件、技能还是 MCP？从用户需求出发理解三者区别、技术关系、适用场景和组合方式。
- DeepSeek Harness Profile 是什么？新手使用指南用中文理解 DeepSeek Harness profile：它与 web 模式、组合包、插件、Agent 预设和工作区有什么区别，如何查看当前组合，以及什么时候需要接触 profile。
- DeepSeek Harness 插件教程：安装、更新、卸载与恢复学会在 DeepSeek Harness 中安装和管理插件，理解 profile、组合包、dsh.bundle、pnpm、Git 安装与 allowBuilds，并用五层验证判断插件是否真的可用。
- DeepSeek Harness 技能教程：创建、发现与使用学会在 DeepSeek Harness 中创建和使用 skill（技能），理解 SKILL.md、项目级与用户级技能、发现优先级、自动选择、/name 显式调用以及正确的验证方法。
- DeepSeek Harness MCP 教程：连接外部工具学会在 DeepSeek Harness 中连接 MCP Server，理解 stdio 与 streamable-http、MCP Client 插件、工具命名、超时与重连，并通过真实工具调用验证连接是否可用。
RECOVERY
随时恢复
从症状出发，按层级定位并恢复SCOPE BOUNDARY
Learn 只解决怎么用
同一个问题在不同栏目有不同的答案。Learn 回答「怎么用」；为什么这样运行、能扩展什么、到底能不能用，分别去对应栏目。
- B1ARCHITECTURE为什么这样运行想理解 Cordis、Agent Loop、工具流水线等底层原理时进入。Learn 只讲到够你正确使用和排错，原理本身在 Architecture。
- B2ECOSYSTEM能扩展什么找插件、技能、MCP Server 和第三方项目：它们解决什么问题、适合谁、怎么安装、有什么替代品、现在还能不能用。
- B3LAB到底能不能用某插件当前版本能不能装、某 MCP 是否稳定、某模型工具调用是否兼容。存在代码不等于功能正常，实测结论以 Lab 为准。
- B4RECOVERY HUB出问题了，随时从这里恢复故障排除不是最后一课：遇到任何问题都可以直接进入，按故障层级回答「第一步检查什么」，而不是一上来重装一切。
EVIDENCE
证据与边界
本页包含：dshopc-analysis
DSHOPC 分析未实测
栏目边界与学习路线
DeepSeek Harness 怎么用，按「先跑起来、完成第一次真实任务、学会日常使用、再决定扩展方式」四步学；12 篇教程按此排列，遇到问题随时进入故障排除，不必从头读完。
- 适用版本
- DeepSeek Harness Developer Preview；具体内容以页面标注为准