DeepSeek Harness，一切皆插件
开源 Agent Harness（智能体运行时）——模型、工具、记忆、权限，全部由可替换的插件组成。
本学习站基于 deepseek-ai/deepseek-harness 官方文档与源码整理，含 9 个交互模块。
没有需要打补丁的特权内核。任何一部分——模型适配器、工具注册表、会话日志、甚至驱动循环——都可以从配置层面替换。扩展 dsh 的方式，就是把新插件挂载到其他插件旁边。
注册都是可逆副作用：插件卸载时，它贡献的服务、监听器、工具自动撤销。这也意味着一个提供方换掉，整个产品行为随之改变。
💡 你可以用 dsh --profile web --dump-config 查看自己机器上真正启动的插件树——打印出的任何条目都能被你的 patch 覆盖。
它能做什么
以下能力都来自内置插件组合 dsh-base（每个 profile 的第一层）。
读写文件与代码
read / write / edit / glob / grep 工具，内置 ripgrep，无需另装。
执行命令与终端
bash 工具，支持后台运行；持久 PTY 终端会话（POSIX）。
上网搜索与抓取
web_search / web_fetch，可插拔搜索提供方。
委派子代理
subagent / workflow / ralph：并行子任务、大规模编排、全新 agent 循环。
规划与目标
计划模式、持久目标（goal）、任务清单（todo）、后台任务（jobs）。
自我改装
模型可以通过 cordis_* 工具检查、挂载、卸载它自己的插件——运行时自修改。
项目速览
🕐 时间线
2026 年 8 月开源（v0.1 开发者预览），随后快速迭代；最新提交 2026-08-13。API 仍在演进，会有破坏性变更。
🏗️ 工程规模
49 组 219 个 npm 包（@deepseek-ai/dsh-*）、2 个应用（CLI + Web）、6 个示例组合、Python SDK、原生沙箱、vendor 的 Cordis 源码。
🧪 测试文化
每文件 100% 覆盖率门槛、无密钥快照对拍、真实 API e2e、145+ 个门禁脚本、严格 TypeScript（strict + 无隐式 any）。
🌍 社区
GitHub Discussions、Discord、微信/企微社区；插件仓库打 dsh-plugin 话题便于被发现。
⚡ 与同类对比
公开报道中常与 Claude Code / Cowork 对比。核心差异：插件化程度更深——没有特权内核，从适配器到循环都可替换。
🔑 上手成本
npx @deepseek-ai/dsh web 一条命令启动 Web UI（默认 127.0.0.1:3080），填 API Key 即可对话。
学习路径
7 步从零理解 DeepSeek Harness。每步可勾选，进度自动保存。
核心概念
先记住 5 个词：插件、上下文、服务、事件、effect。其余概念都从它们长出来。点击卡片看细节，输入框可搜索。
架构图解
运行中的 dsh 是一棵插件树，由多层组合叠加而成。点击图中的任意节点，查看它的职责。
点击左侧图中的节点
图例：蓝色 = 入口与应用 · 青色 = 核心服务 · 绿色 = 能力接缝 · 金色 = 数据与持久化。虚线箭头表示「挂载 / 由下而上提供」。
dsh --profile web --dump-config —— 打印出的任何条目都能被自己的 patch 覆盖。一次对话的旅程
你发一句话后，agent 内部发生了什么？一个轮次（turn）排空已接纳的输入，包含零个或多个步骤（step）；一个步骤 = 一次模型请求 + 它调用的工具。点步骤看详解，或按自动播放。
工具执行流水线
一次工具调用从被模型请求到结果回传，会经过这些关口——策略、审批、沙箱、结果改写都不改循环本身，而是挂在这些瀑布事件上。点击每一关展开说明。
代码游乐场
直接改代码，点运行，看真实输出。这是运行在浏览器里的模拟 Cordis 运行时——教学用简化版，行为与真实框架一致。选一个课时开始。
包地图
219 个包太多？按组看。每组一句话职责，点击包卡片看细节与 ctx 键。数据来自 packages/README 与源码。
测验
16 道题，覆盖全部概念。答完看成绩，可反复挑战。
历史最佳：—（保存在本机浏览器）
闪卡
翻转卡片记忆术语。空格 / 回车 / 点击翻面，← → 切换。
资源与速查
命令速查
点复制，直接粘贴到终端。
官方资源
源码、Issue、Discussions 📚官方文档
架构 / 教程 / 子系统 / 目录 📦npm 包
@deepseek-ai/dsh 💬Discord 社区
DeepSeek Harness 官方频道 🧩插件生态
GitHub #dsh-plugin 话题 🔗Cordis
底层插件框架（vendor 引入）
常见问题
本学习站为第三方学习资料，与 DeepSeek 官方无隶属关系。内容基于仓库截至 2026-08-13 的文档与源码整理；项目处于开发者预览阶段，如有出入以官方为准。