0
DeepSeek Harness 教程目录
本教程面向完全的新手，以参考手册级深度系统讲解 DeepSeek Harness 的内部实现。每篇文章均包含概念介绍、背景铺垫、源码引用、类型定义和运行时行为分析。
文章列表
| # | 文章标题 | 核心内容 |
|---|---|---|
| 1 | 总体架构 | 项目概览、技术栈、包布局、运行时的启动链、核心抽象一览 |
| 2 | 环境与运行 | 开发环境配置、Node.js 版本约束、pnpm 工作区、CLI 入口、Profile 机制 |
| 3 | Cordis 框架基础 | Cordis 是什么、Plugin/Service/Context 模型、ctx.effect() / ctx.on() 注册、Waterfall 语义、生命周期 |
| 4 | 核心与 Agent 循环 | Agent、AgentLoop、FactoryOwnership、Turn 生命周期、Cancel 机制、Scope 模型 |
| 5 | LLM 能力 | LLM 服务定义与消费模型、DeepSeek Provider、Adapter、Router、重试策略、上下文构建 |
| 6 | 工具与数据类能力 | Tool 注册机制、Shell Subprocess FS LSP Web / Skill 等能力插件详解 |
| 7 | Agent 编排 | Subagent 委托、Worker Thread、Workflow、Preset、Preset 编排与调度 |
| 8 | 上下文与人类协作 | 用户交互（Approval/Question）、Sandbox Escalation、Context Guard Plan 机制 |
| 9 | 持久化与数据平面 | Session 生命周期、日志格式与版本管理、持久化后端、查询、Compaction、Python SDK 对接 |
| 10 | 安全沙箱与隔离 | Landlock/Seatbelt/bwrap 沙箱、进程树隔离、权限提升、Guard 配合 |
| 11 | Session 日志深度 | JSONL 格式、SessionSeq、投影增量算法、日志重放与 Fork |
| 12 | Typert 类型图系统 | 类型图生成、运行时类型注册、跨仓库类型发现 |
| 13 | Web Client 架构 | React 组件体系、Slot 机制、投影渲染、WebSocket 通信 |
| 14 | API Gateway 与 SDK | BFF 架构、JSON-RPC 协议、TypeScript/Python SDK 实现 |
| 15 | 凭证与授权 | 凭证接缝、优先级链、OAuth 授权流、密钥轮换 |
| 16 | Webhook 与外部事件 | 签名验证、可信规则、Workspace Session、CI/CD 集成 |
| 17 | Self-Modification 扩展 | 插件自省、动态安装/卸载、热重载、安全边界 |
如何阅读本教程
按顺序阅读：各章之间存在递进关系，前文概念在后文被反复使用
跳读建议：若对 Cordis 框架已有了解，可从第 4 章（Agent 循环）开始
快速参考
DeepSeek-Harness
/
README
0 字
0 行
iliuqi