DeepSeek Harness（dsh）总览
是什么
DeepSeek Harness（CLI 名 dsh）是 DeepSeek AI 开源的 agent harness（智能体框架/运行壳）——即围绕 LLM 构建 agent 产品所需的完整基础设施：agent loop、会话持久化、工具系统、权限审批、沙箱、Web UI、SDK。定位上对标 Claude Code / Codex CLI 这类 coding agent 的”底座”，但明确做成可组装的开源 harness。
- GitHub: https://github.com/deepseek-ai/deepseek-harness
- 核心理念：everything is a plugin（一切皆插件）——model adapter、tool registry、session log、甚至 agent loop 本身都是插件，全部可从配置中替换。没有特权核心。
- 框架基座：vendored 的 Cordis（见 cordis），设计参见论文 A Programming Paradigm for Spatiotemporal Composability。
- 许可：MIT；语言：TypeScript（pnpm monorepo）+ 少量 Python SDK + Rust/native（landlock-run）。
当前状态
- Developer preview，版本
0.1.0-rc.x，官方明确警告”将出现破坏兼容的变更”。 - 分析基线：master @ 2026-08-13（merge PR #2519
feat/npm-public，即刚完成 npm 公开发布改造）。 - 规模：约 7400 文件；221 个 npm 包（
@deepseek-ai/dsh-*），49 个 group；Node 要求^22.19 || >=24。
快速运行
# npm 方式（默认启动 Web UI，http://127.0.0.1:3080）
npx @deepseek-ai/dsh web
# 源码方式
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness && pnpm install && pnpm run build
pnpm dsh web主包：@deepseek-ai/dsh（apps/cli），Web 前端 @deepseek-ai/dsh-web-frontend（apps/web）。
一图看懂组成
| 层 | 内容 | 详见 |
|---|---|---|
| 框架层 | vendored Cordis（Context/Service/Events/Fiber） | cordis |
| 组合层 | profile / bundle / patch 叠加出插件树 | architecture |
| 核心脊柱 | session log、system-prompt、tools、agent、agent-loop | architecture、agent-lifecycle |
| 能力域 | 26 个 capability seams（fs/shell/llm/sandbox/jobs…） | architecture |
| 工具与安全 | 内置工具集、执行管线、审批、landlock 沙箱 | tool-system、security-sandbox |
| 扩展面 | tool/LLM adapter/package 开发、MCP/ACP | extension-development |
| 用户面 | Web UI、CLI、Python SDK、provider 配置 | user-guide |
| 工程面 | host/client 双面构建、vitest 矩阵、CI gates | engineering |
值得注意的点
- 包粒度即插件粒度：每个能力都是独立 npm 包（如
dsh-tool-bash、dsh-llm-deepseek、dsh-client-ui-conversation），221 包全部 publishable。 - 可委托外部 agent 当 subagent：内置
subagent-claude-code、subagent-codex、subagent-acpprovider——dsh 可以把 Claude Code / Codex 作为子代理驱动。 - 兼容 Claude Code / Codex 的 hooks 协议（
dsh-hooks-claude-code、dsh-hooks-codex）。 - LLM adapter 有
llm-pi-ai（基于 pi-ai 库），以及llm-deepseek、llm-retry。 - Ralph loop：内置
tool-ralph，实现”不可变目标 + 每轮全新 agent”的循环策略（见 agent-lifecycle）。 - 文档工程极强：大量
gen-*/verify-*脚本保证文档（tool catalog、module graph、事件矩阵）从源码生成且 CI 校验新鲜度；双语（.md + .zh.md）逐字节对齐。
生态与社区
- 插件发现：GitHub topic
dsh-plugin；Discord 社区；中文有企微群 + 问卷。 - 反馈走 GitHub Discussions。
相关页面
- architecture — 一切皆插件、profile/bundle、host/client、capability seams
- monorepo — 221 个包的分组清单