技术分享材料包 HaoyangHan/dsh-tech-sharing

DeepSeek Harness Deepdive

一次技术分享的完整材料包：从提纲、一手取证、讲稿，到三种格式的成品 deck。

主张：DSH 把 Codex 里写死的那部分，做成了你能换的部分。
对开发者友好，只说一半 —— 改起来友好，上手不友好。

成品 deck 的另外三页（P1 开场场景 / P12 六条轴总表 / P15 空根长出的 172 行插件树）：

实际使用时的样子（DSH Desktop 里跑这份 deck）：

三份产物，按场景挑

| 场景 | 用哪份 |
| 现场投屏、要逐步动画 | deck/index.html —— 双击即开，F 全屏、→ 步进、S 看备注 |
| 要改内容 / 发给同事改 | deck/DSH-Deepdive-v4.1.pptx —— 26 页全原生对象，0 张图，每个字都能改 |
| 归档 / 打印 / 发人看 | deck/DSH-Deepdive-v4.1.pdf —— 26 页 |

细节见 deck/README.md。

当前主张（v4.1，用户重新收窄过）

DSH 把 Codex 里写死的那部分，做成了你能换的部分。
对开发者友好，只说一半：改起来友好，上手不友好。代价是它还在 0.x。

全场只回答一个问题：同样是编码 agent harness，DSH 和 Codex 差在哪，你什么时候该选哪个。

⚠️ v4 的原始开场（「改压缩策略在 Codex 里找不到对应配置」）经核实不成立 —— Codex 有 model_auto_compact_token_limit / ..._scope / compact_prompt / experimental_compact_prompt_file。
v4.1 已换成可核实的说法：「能改参数，换不掉实现」。证据见 research/09。

旧版分层结论（v3 时期，保留作对照）

竞争已经从「模型有多强」转向「harness 有多好」。
而且 RAG / harness / 网关根本不在同一层 —— 它们是层层嵌套的插件关系。

第 3 层 网关 / 平台层 OpenClaw ← 官方原话：harness 是「plugins you can swap」 ──────────────────────────────────────────────── 第 2 层 Agent Harness Codex / DSH ← 主战场 ──────────────────────────────────────────────── 第 1 层 检索能力 RAG / Agentic RAG ← harness 内部的一个工具，不是竞品 ──────────────────────────────────────────────── 第 0 层 模型 deepseek-v4-flash / GPT-5.x …

文件导航

dsh-tech-sharing/
├── README.md ← 本文件 ├── HANDOFF.md ← 上一轮会话的交接说明（历史文件） │ ├── outline/ ← 讲什么 / 怎么讲 │ ├── talk-script-v4.1.md ⭐⭐ 当前版讲稿：以用户的 v4 为基础，只修事实不动句子。
│ │ v4 的语言指标已达标；改动集中在 P1 开场前提、 │ │ P5/P7 对比框架、P6 重启说法、P11 模型可换性， │ │ 并补了约 15 分钟的现场演示脚本 │ ├── talk-script-v4.md 用户的版本（DSH vs Codex 逐轴对比，主张收窄到一个真问题） │ ├── talk-script-v3.md 我的前一版 v3.1（分层叙事 + 每个人都别人的插件） │ ├── outline-v2.md ⭐ 内容地图（讲什么事实）；与 v3 冲突时以 v3 为准 │ └── outline-v1.md 初版（平铺五方对比，已被取代，仅作对照） │ ├── research/ ← 证据与调研 │ ├── 06-recheck-numbers.md ⭐ 数字复核记录（含最终口径表） │ ├── 09-v4-verification.md ⭐ v4 核实报告：7 条待办全部查完，4 处事实问题 │ ├── 08-tech-talk-language.md ⭐ 著名 tech talk 语言风格实测（含我们讲稿的差距） │ ├── 07-presentation-skills.md ⭐ 演示/语言类 skill 与插件检索结果 │ ├── 00-local-evidence.md ⭐ 本机 DSH 一手实测（注意 06 的更正） │ ├── 01-dsh-architecture.md ⭐ DSH 架构 / 优势 / 重大变化（主文档） │ ├── 01b-dsh-external-research.md DSH 外部调研（15 行完整版本表） │ ├── 02-rag-vs-agentic-rag.md RAG / Agentic RAG / Harness（42 条引用） │ ├── 03-codex-vs-openclaw.md ⭐ Codex / OpenClaw + 五方对位表 + pi 血缘 │ ├── 03b-codex-openclaw-deepdive.md 同上深潜版（55 条引用） │ ├── 04-plugins-and-deck.md 插件生态 + 幻灯片选型（顶部有复核修正） │ ├── 05-creative-mode-plugin-skill.md ⭐ 创造模式：模型如何规范地写插件 │ └── raw/ │ ├── docs-architecture.md ⭐ 官方架构文档原文（两条主引文的出处） │ ├── dsh-plugin-row-ids.json ⭐ 从本机 patch 抽出的 85+87 个真实插件行 id │ ├── awesome-dsh-plugin-README.md 社区插件精选列表全文（4,578 条） │ ├── awesome-dsh-plugin-README.zh.md 中文版 │ └── dsh-releases.atom 官方发布说明原始 feed │ ├── deck/ ← ⭐ 三种格式的同一份 26 页 deck │ ├── index.html HTML 版（零依赖自包含，带动画，主力演示用） │ ├── styles.css 设计系统 + 全部组件 │ ├── deck.js 导航 / 步进 / 打印 / 越界检查引擎 │ ├── DSH-Deepdive-v4.1.pptx ⭐ 可编辑 PPTX：26 页全原生对象、0 张图、带讲者备注 │ ├── DSH-Deepdive-v4.1.pdf PDF：26 页，由 PPTX 转出 │ ├── README.md ⭐ 怎么放、怎么改、怎么重新生成 │ └── README.md.slidev-plan 最初的 Slidev 选型方案（已不采用，保留作对照） │ ├── tools/ │ └── build_pptx.py PPTX 生成脚本（改内容后重跑即可） │ └── assets/ ← 图像素材（含来源与许可记录） ├── README.md 素材来源与许可 ├── dsh-official.svg DSH 官方 logo（已内联进封面） ├── si-deepseek.svg / si-anthropic.svg / si-claude.svg Simple Icons（CC0） ├── openclaw-banner-dark.png OpenClaw 官方 banner └── preview-v41-.png 四张页面预览图（封面 / P1 场景 / P12 总表 / P15 空根树）

交付清单

| # | 交付物 | 状态 |
| 1 | 40 分钟分享提纲（内容地图） | ✅ outline/outline-v2.md |
| 2 | 逐页讲稿（怎么讲给人听） | ✅ outline/talk-script-v3.md |
| 3 | DSH 一手实测证据 | ✅ research/00（数字见 06 更正） |
| 4 | DSH 架构 / 优势 / 重大变化 | ✅ research/01 + 01b |
| 5 | RAG / Agentic RAG 对比 | ✅ research/02（42 条引用） |
| 6 | Codex / OpenClaw 对比 | ✅ research/03 + 03b |
| 7 | 插件生态 + 模板与动画选型 | ✅ research/04 + 05 |
| 8 | 数字与引文复核 | ✅ research/06 |
| 9 | 演示 / 语言 skill 检索 | ✅ research/07 |
| 9b | 著名 tech talk 语言风格实测 | ✅ research/08（Hickey / Victor 全文量化对比） |
| 9c | 用户 v4 讲稿的事实核实 | ✅ research/09（Codex 配置面 / 插件系统 / 非 DeepSeek 适配器全部实测） |
| 10 | HTML 幻灯片（含关键动画） | ✅ 26 页全部完成（封面 + P1–P25）。逐页截图验证：26 张全部 1600×900、?check=1 零越界。含幕布动画、讲者备注、?print 导出模式 |
| 11 | PDF | ✅ deck/DSH-Deepdive-v4.1.pdf，26 页 1.74 MB（HTML 版另有 ?print 模式可自行导出） |
| 12 | 可编辑 PPTX | ✅ deck/DSH-Deepdive-v4.1.pptx，26 页 / 148 KB / 原生对象零图片 / 26 页讲者备注齐 |

关键数字速查（已按 research/06 更正）

| 数字 | 含义 | 出处 |
| 231 | 旧 profile 锁在 0.1.2-rc.1 的 @deepseek-ai/ 包数 | 本机实测 |
| 289 | 当前 0.2.0-rc.2 npx checkout 的包数 | 本机实测 |
| 20 | 整个 @deepseek-ai/dsh CLI 包的文件数（lib/ 15 个） | 本机实测 |
| 85 / 498 | dsh-base patch 的插件行数 / 文件行数 | 本机实测 |
| 87 / 444 | dsh-web-app patch 的插件行数 / 文件行数 | 本机实测 |
| 172 → 145 | 两层合计行数 → 按 id 去重后的不同 id 数 | 本机实测 |
| 27 | 被后一层重写（同 id）的行数 | 本机实测 |
| 14 | profile package.json 的行数 | 本机实测 |
| 39 | dsh-client-ui-* 前端插件包数 | 本机实测 |
| 103 / 231 | README 中明确出现 "seam" 的包数 | 本机实测 |
| 31 / 60 天 | npm 发布版本数 / 时间跨度 | npm registry |
| 1,847,425 | @deepseek-ai/dsh 月下载量 | npm downloads API |
| 248,422 ★ | deepseek-harness stars | GitHub 搜索 API |
| 18,955 | dsh-plugin topic 下仓库数 | GitHub 搜索 API |
| 4,540 / 4,578 | 精选列表收录数（count.json 时点）／本地快照可数条目 | count.json ＋ 本机实测 |
| 7,819 | 非官方目录 dshbase.com 声称的插件数 | 该站点（非官方，需标注） |
| 391,820 ★ | openclaw/openclaw stars | GitHub 搜索 API |
| 5,400+ | OpenClaw skills 数量（精选列表口径） | awesome-openclaw-skills |
| 128,898 ★ | openai/codex stars | GitHub 搜索 API |
| 4× / 15× | agent / 多智能体 相对 chat 的 token 消耗 | Anthropic 实测 |
| 80% | token 用量单独解释的性能方差占比 | Anthropic（BrowseComp） |

⚠️ 数字都会变。讲稿统一注明「截至 2026 年 10 月中旬」，现场用 ls/curl 复现而不是念 PPT。

三条给讲者的提醒

1. 别把 RAG 讲成失败者。 正确表述是「RAG 没有被淘汰，它被降级成了一个工具」；Anthropic 明确说 Claude Code 仍是混合策略（CLAUDE.md 注入 + glob/grep 即时检索）。
2. 别回避 DSH 的代价。 0.x + rc、231 个包的学习曲线、约 3 周内三次会话格式破坏性迁移、运行时自扩展不是安全边界 —— 主动讲出来反而更可信。
3. 别把 OpenClaw 当竞品。 它的官方 README 明说 harness 是「plugins you can swap」——它比 Codex/DSH 高一层。

本材料的方法论：双轨取证

- 一手实测（research/00）：本机 DSH 运行时、npm registry、GitHub API、raw.githubusercontent、官方发布说明 feed。
所有数字都可用一条 ls/curl 复现。
- 外部引用（01b/02/04）：官方文档、arXiv 论文、Anthropic/Microsoft 工程博客，逐条附链接。
- 标注纪律：全部材料区分 ✅ 已验证 / 🟡 推断 / ⚠️ 未证实。
- 冲突必须显式记录：子代理结论与一手证据冲突时，在文档顶部写「复核修正」（先例见 04、03b、06）。