跳到主要内容
路径文档
EnglishGitHub快速上手

学习路径

本教程站内容较多,与其从头读到尾,不如按你的经验水平选一条路径。每层给"读哪些、达到什么"。

🟢 新用户：先能跑起来​

目标:配好 Key、开个对话框、知道发生了什么。

  1. 快速上手：配 Key、开 Web UI、第一次对话
  2. 命令行：dsh web / --profile headless / --dump-config
  3. 配置：profile、patch 层、API Key
  4. DSH 是什么：它到底是个什么东西

✅ 之后你能:配好 key、开 Web UI、看 --dump-config。

🟡 日常使用：用得顺手​

目标:知道它能干多少事、怎么管理权限和隐私。

  1. 内置工具：出厂 21 个工具能干嘛
  2. 权限：preset、ask/never、DSH_PERMISSION_MODE
  3. 数据与隐私：遥测、.anonymous-user-id、会话存储
  4. 多模型路由：provider 怎么配
  5. 子 Agent 与并行：把活派出去
  6. 目标、作业与待办：推进长期要事
  7. 设置与凭据：运行时配置与密钥管理
  8. 会话检索 / 附件：搜历史会话、贴图进会话

✅ 之后你能:管理权限、多 provider、开子 Agent、用 goal 推进长任务。

🔵 开发者：给模型加能力​

目标:能写自己的插件、工具、服务、监听事件、发配置。

  1. 插件解剖：插件是什么、patch 层语义
  2. 第一个插件：hello world
  3. 写一个工具：给模型加工具
  4. 写一个服务：共享逻辑
  5. 监听事件：种 dispatch 模式、事件目录
  6. 配置与发布：ctx.settings + 发布
  7. 技能系统 / MCP 集成：再扩能力
  8. 反馈 / 溢出存储 / E2B 云沙箱：高级能力按需挂载

✅ 之后你能:写插件、加工具、注册命令、接 MCP、发配置。

🟣 架构师：深挖原理​

目标:理解 DSH 怎么把这一切组装起来。

  1. 架构总览：包分组地图
  2. 核心机制全 11 篇:boot-config → context → agent-loop → tools-execution → sandbox-security → session → llm-routing → plugin-anatomy → event-system → web-ui → schedule
  3. 工作流与 Ralph：多 agent 编排
  4. Agent 预设与 Persona：身份与组合
  5. 内置工具：全景

✅ 之后你能:讲清一个 agent 从启动到执行工具的完整链路,并定位"该在哪层扩展"。

💡 提示:所有文档链接都无数字前缀、可回跳;用右侧目录快速定位;"原理课程"适合当参考手册查,不必一口气读完。