DeepSeek Harness（dsh）知识库内容目录。每个 wiki 页面按类型列出，附一行摘要。 阅读此文件以快速定位相关页面。 Last updated: 2026-08-17 | Total pages: 16 分析基线：deepseek-harness master @ 2026-08-13（developer preview, 0.1.0-rc.5）
总览与架构
- overview — dsh 是什么：DeepSeek 开源 agent harness，一切皆插件，developer preview，快速运行与看点
- architecture — Cordis 基座、profile/bundle 层叠、host/client 双侧、module graph 分层、26 个 capability seams、turn 事件流、12 条关键不变量
- cordis — 底层插件框架：五个核心思想、Context/Service/Events/Fiber/Registry、状态机与 HMR、源码级 vendoring 与 18 条 local modifications
- monorepo — 221 个 npm 包的分组清单（49 group：core/llm/shell/fs/sandbox/session/subagent/workflow/client-ui-* 等）
Agent 运行时
- agent-lifecycle — step/turn/round、AgentHandle 所有权、inbox（followup/steer/inject）、单 turn 执行序列与事件挂点、context 扩展包
- session-model — append-only SessionEvent log 为单一事实来源、surface 与 deriveMessages、request/header 快照、projection/query/title、格式立场
- orchestration — Todo/Plan mode/Goal/Workflow 四者对比、Ralph loop、subagent 六 provider（可驱动 Claude Code/Codex）、continuable 与 Activation
- context-management — compaction（锁与 surface replace）、token-meter、spill、jobs 后台运行时、schedule session-local 提醒
工具与安全
- tool-system — 51 个内置工具清单（24 个包条目）、10 阶段执行管线（三个 waterfall + monotonic guards）、Code Mode/code-runtime、config-catalog
- security-sandbox — approval fail-closed 一次性审批、permission presets、sandbox seam 与 bwrap/Landlock/Seatbelt/Windows ACL 后端、landlock-run 原生启动器、credentials 引用/值分离
开发与使用
- extension-development — 插件最小形态、写 tool/LLM adapter 的硬性契约、Skills 发现优先级、MCP client 桥与 ACP server、examples 清单、bundle/profile 发布
- user-guide — Web UI 使用流程、三类 provider 配置、CLI 命令、Python SDK（subprocess + JSON-RPC，无需系统 Node）
- engineering — host/client 双面构建与 typert、vitest 六层矩阵（per-file 100% coverage）、run-gates CI、AGENTS.md 纪律、7 条防御式模式、双语 i18n 机制
参考
- glossary — 术语表（seam/profile/scope/turn/step/round/goal/Ralph/activation/surface 等）
Notes（第三方文献）
- ship-of-theseus-rsi — 社区深度分析《DeepSeek Harness、忒修斯之船与 RSI 递归自进化》读记：以忒修斯之船框定 DSH 的命题（运行中换板不停航）、三大设计思路、四种官方 Preset（标准/PTC/极简/创造）、Cordis 论文三问（时间/空间可组合性 + Confluence）、可观测性与 Prompt Caching 两个工程亮点
- harness-engineering — Lilian Weng《Harness Engineering for Self-Improvement》（2026-07）整理：harness 通用概念、三大设计模式、自进化研究地图（ACE/MCE/Meta-Harness/ADAS/AFlow/STOP/Self-Harness/AHE/DGM 等），及与 dsh 机制的对照（对照部分为本 wiki 分析；原文讨论通用 harness 而非 dsh 本身）