本站是什么
DeepSeek Harness in Depth 是一个独立的、源代码级的 deepseek-harness 仓库剖析站点——该仓库是 DeepSeek AI 开发的开源 Agent 框架（dsh）。它不是官方文档。上游文档告诉你如何使用某个功能，而本站 告诉你这个功能是由什么构成的。
本站按序章、十章（第一至第十篇）与附录组织。每一章都围绕 packages/、apps/、native/、vendor/ 与 docs/ 下可引用的源文件展开，因此你可以一边阅读一边在自己的仓库检出中对照代码。
如何浏览
侧边栏与篇章计划对应：
| 篇 | 内容 |
|---|---|
| 序章 | 本页 |
| 第一篇 · 全景概览 | dsh 是什么、插件哲学、Monorepo 结构、快速上手 |
| 第二篇 · 架构剖析 | 启动流程、Cordis 扩展系统、Agent 生命周期 |
| 第三篇 · 核心引擎 | Agent 主循环、会话、Scope、系统提示词、模型选择、工具 |
| 第四篇 · 会话与上下文 | 上下文来源、压缩、目标、计划模式、人机交互 |
| 第五篇 · 能力工具箱 | Shell、文件系统、代码运行时、Web/搜索、技能、MCP、LSP 等 |
| 第六篇 · 编排与子代理 | 子代理、工作流与 Ralph、会话查询与日志导出 |
| 第七篇 · 安全与沙箱 | 沙箱架构、Landlock、策略、权限、凭据、守卫 |
| 第八篇 · 模型与平台 | LLM 层、DeepSeek 提供商、API 网关、存储、Hooks、ACP |
| 第九篇 · 前端世界 | 客户端运行时、UI 模块、Web 前端、Schema 表单、本地化 |
| 第十篇 · SDK 与工程化 | SDK 协议/客户端/服务端、Typert、测试、CI、内嵌库 |
| 附录 | 包索引、术语表、官方文档地图 |
请从什么是 DeepSeek Harness？开始，或直接跳到 快速上手先跑起来。
温馨提示
dsh 目前处于开发者预览阶段。上游 README.md 直白地声明：
未来将出现破坏兼容性的变更。
这意味着本站所述 API、配置格式与行为在未来版本中很可能发生变化。本站只对其撰写时所针对的修订版本 负责；如果你对照更新的检出阅读，请预期会有偏差。
许可证
本站基于并引用了 MIT 许可的 deepseek-harness 仓库。本站正文是社区文档，并非 DeepSeek AI 的官方产品。 凡本节引用简短源码的摘录，均出自上游 MIT 许可代码。
延伸阅读
- 什么是 DeepSeek Harness？ —— 本站所要拆解的产品。
- 快速上手 —— 在深入之前先把
dsh跑起来。 package.json—— 承载工作区 glob 与固定版本的根清单。docs/architecture.md—— 作为第二篇种子的上游架构文档。vendor/README.md—— 内嵌 Cordis 框架层的清单。