旧版路径映射
这页用于帮助老用户从旧版 docs 的阅读习惯，过渡到新版开发手册的结构。
同时，这次“路径映射”不只是阅读说明，也包含真实的兼容策略：常见旧路径会继续保留，栏目根路径也会补成兼容入口页，避免搜索引擎和历史外链直接落到空页。
先说结论
- 这次重构优先保留旧 slug
- 高频旧路径仍可直接访问
- 常见栏目根路径也补了兼容入口页，不只靠这张对照表
- 变化主要发生在“它现在属于哪一章、该继续往哪里读”
一级栏目映射
| 旧栏目理解 | 新定位 | 新的阅读逻辑 |
|---|---|---|
| 快速开始 | 开始使用 | 先跑通最小链路 |
| 模型配置 | 核心开发 | 先把请求层打稳 |
| Prompt 管理 | 核心开发 | 作为请求层能力继续保留 |
| 输出控制 | 核心开发 | 作为请求质量核心能力继续保留 |
| 模型返回结果 | 核心开发 | 和输出控制组合阅读 |
| Session / Memo | 核心开发 | 从扩展附属概念提升为核心开发能力 |
| Agent 扩展能力 | 工作流与扩展 | Tools、MCP、KB、FastAPI 都收进这一章 |
| TriggerFlow | 工作流与扩展 | 仍保留原路径，但改成进阶层 |
| Agent Systems Playbook | 案例与实践 | 作为方法模板，而不是核心概念入口 |
| Case Studies | 案例与实践 | 作为完整系统案例 |
| 官方 Skills | Coding Agent / Skills（可选） | 辅助入口，不再是默认起点 |
| 插件开发 | 迁移与高级主题 | 归入高级主题 |
高频旧路径映射
| 旧路径 | 当前状态 | 新定位 |
|---|---|---|
/ | 原位保留 | 开发手册首页 |
/quickstart | 原位保留 | 第一课 |
/agent-docs | 原位保留 | Skills 辅助入口 |
/model-settings | 原位保留 | 核心开发入口 |
/prompt-management/overview | 原位保留 | Prompt 管理入口 |
/output-control/overview | 原位保留 | 输出控制入口 |
/model-response/overview | 原位保留 | 返回结果入口 |
/agent-extensions/session-memo/ | 原位保留 | Session 核心入口 |
/agent-extensions/tools | 原位保留 | Tools 入口 |
/triggerflow/overview | 原位保留 | TriggerFlow 入口 |
/agent-systems/overview | 原位保留 | Recipes / Playbook 入口 |
/case-studies/overview | 原位保留 | 案例入口 |
新增但重要的入口
这些是新版手册新增的理解页，不替代旧路径，而是补足阅读路径：
怎么用这页
- 你如果是老用户，先从本页找到“旧栏目现在算哪一章”
- 你如果在更新书签，优先保留原路径，不必急着全部换掉
- 你如果在给别人发新版阅读路线，优先发新增的学习路径页
下一步去哪
Related Skills（可选）
agently-playbook