# 学习路径：从 0 到 1 的 3 天计划

> 承诺兑现：**任何开发者，3 天从零到能开发插件。** 本路径把 9 章拆成 3 天，每天有明确目标与验收标准。

## Day 1：理解 + 跑起来（第 1-2 章）

**目标**：理解 dsh 是什么，能独立启动、对话、配置。

| 时间 | 任务 | 验收 |
|---|---|---|
| 30 分钟 | 读第 1 章（三个直觉 + 能力矩阵） | 能向别人解释"dsh 和 Claude Code 的区别" |
| 30 分钟 | 第 2 章动手：`dsh web` 对话 + headless | 能启动 UI 完成一次对话；能跑一条 headless 命令 |
| 30 分钟 | 配置模型/推理档位 + 排障速查 | 能改 settings.yaml；能解决端口占用 |

**验收**：`dsh --profile headless "你好"` 有回复。

## Day 2：理解骨架 + 第一个插件（第 3-4 章）

**目标**：理解 profile/插件机制，写出第一个能跑的插件。

| 时间 | 任务 | 验收 |
|---|---|---|
| 1 小时 | 第 3 章（profile、挂载、host/client、扩展点、坑） | 能挂载社区插件（Git 面板） |
| 1.5 小时 | 第 4 章抄写示例提速插件：纯函数 + agent/request 注入 | 插件加载无错，日志出现决策输出 |

**验收**：自己的插件在 dsh 里生效（日志证明注入发生）。

## Day 3：实战 + 调优（第 5-6 章）

**目标**：能评估插件质量、调优性能、理解生态玩法。

| 时间 | 任务 | 验收 |
|---|---|---|
| 1 小时 | 第 5 章三个真实 PR（安全红线、沙箱约束、测试方法） | 能说出"写一个 PR 的完整闭环" |
| 1 小时 | 第 6 章性能模型（思考占 90%）+ 档位策略 + 坑 | 能给一个任务选档位、预估瓶颈 |
| 30 分钟 | 第 8-9 章扫读（工具/上下文、MCP/子代理/工作流）+ 术语表 | 知道 dsh 的能力全貌与扩展方向 |

**验收**：能给 dsh 生态贡献一个小改进或写一篇使用心得。

## 之后：按需深入

| 想做什么 | 去读 |
|---|---|
| 接外部工具 | 第 9 章 MCP + 官方 mcp 包文档 |
| 并行任务 | 第 9 章子代理 |
| 确定性流程 | 第 9 章工作流 + 官方 examples |
| 生产部署 | 官方架构文档 + 安全模型（sandbox/权限） |
| 性能极致 | 第 6 章 + 第 4 章示例源码 |
| 生态变现 | 第 7 章 + dsh-plugin topic |

## 学习原则（白皮书全程）

1. **动手 > 阅读**：每章命令都跑一遍，不看会后悔
2. **先复制后理解**：第 4 章完整代码先跑通，再改参数理解机制
3. **单测 + 实机双证据**：开发插件时两个都要过
4. **善用 --dump-config**：疑惑时看合成配置，比猜快