DSH 官方有两条文档线:文档站(面向使用者与开发者的教程、参考)和 GitHub 仓库(源码、发布说明、社区)。这一篇是地图——遇到本教程没覆盖的问题时,知道去哪里翻。
官方入口一览
文档站三分区(按需直查)
指南(guide)
| 页面 |
内容 |
| 使用 Web UI |
快速开始:启动、配模型、选工作区、跑任务 |
| 配置模型 |
提供方配置:DeepSeek/目录提供方/自定义端点/图片模态 |
| Python SDK 快速上手 |
SDK 安装、示例、程序内调用 |
开发(develop)
| 分区 |
内容 |
| basic |
第一个插件、插件配置、开发工具、打包安装 |
| cordis-tutorial |
7 篇 Cordis 系列教程(插件/生命周期/服务/事件/配置/组合/进 harness) |
| framework |
插件与生命周期、服务与依赖、事件系统 |
| practice |
能力角色设计、LLM 适配器 |
参考(reference)
| 分区 |
内容 |
| 架构、Agent 生命周期 |
整体设计、轮次与步骤生命周期 |
| 能力 Seams、插件配置目录 |
核心服务接口、全配置目录 |
| Cordis 入门/API |
组合框架概念与 API |
| 工具 Schema 目录、工具执行流水线 |
全工具清单、执行五关卡 |
| cookbook |
实操手册:加包/加工具/加 LLM 适配器/扩展插件形态 |
| subsystems(40+ 篇) |
逐个子系统详解:Skills、Subagent、工作流、同会话目标、沙箱、会话、持久化、审批、计划模式…… |
GitHub 仓库里的补充文档
文档站之外的仓库文档(部分未上站):
README.md / README.zh.md:定位与安装命令原文
docs/glossary.md:术语表
docs/development.md:贡献者开发指南
AGENTS.md:给 agent 的仓库协作规则
examples/:示例(如 mcp-memory)
使用建议
| 需求 |
去哪 |
| 上手操作 |
本教程第 1–2 章 → 官方 guide 区 |
| 概念机制 |
本教程第 3–4 章 → 官方 subsystems 区 |
| 写插件 |
本教程第 5 章 → 官方 develop 区 + cookbook |
| 查参数/清单 |
官方 reference 区(工具目录、配置目录) |
| 报 bug/提问 |
GitHub Discussions |
接下来读什么
← 上一篇:6.2 配置参考:settings.yaml 字段详解 | 下一篇:6.4 术语表 → ↑ 返回 教程总目录