生活类比：把 dsh 想象成一座城市。供水、供电、通信、交通分别由不同公司负责，市政府不亲自供水，只做两件事：批准谁可以接入，协调各家一起运转。哪家公司被替换，城市其他部分照常工作。

技术定义：Cordis 是 dsh 的底层插件内核，相当于这座城市的“市政府”。它负责挂载（mount）与卸载（unmount）插件、解析插件之间的依赖，并提供插件彼此协作所需的服务与事件。dsh 不是一套写死的程序，而是构建在 Cordis 之上的一组插件集合。Cordis 提供的是组织机制，不是具体能力——模型、工具、界面都来自插件，而不是来自内核。

因为内核只负责组织，任何能力都不享有特殊地位。这也意味着，dsh 的每次启动都只是把一组插件组合起来，而不是启动一个写死的大程序。记住一句话：Cordis 不生产具体能力，它只负责把能力组织起来。

生活类比：把插件想成电源插座上的电器。插座接口是标准的：插上灯泡是照明，插上电饭煲是做饭。想换功能，拔下来换一个电器即可，插座本身不用改。

技术定义：插件是向共享上下文贡献能力的基本单元，贡献三类东西：服务（其他插件可调用的接口）、类型化事件（可被监听的通知）、可逆效应（加载时产生的注册，卸载时自动回滚）。在 dsh 中，一切能力皆插件：模型适配器、工具注册表、会话日志、沙箱、存储、Agent 循环、界面，无一例外。

你要扩展 dsh，就在其他插件旁边再挂载一个新插件——而不是修改特权核心。这正是“一切皆插件”的含义：能力像积木一样可拆可装。你后续要写的工具、事件监听与 LLM 适配器，也都将是这种插件。

生活类比：想象一间共享办公室。每个插件把工具放到公共工作台上并贴上标签；别的插件需要某种能力时，走到台前按标签取用，不必知道工具原来放在谁的抽屉里。

技术定义：共享上下文（shared context）是插件贡献与获取能力的场所，在代码中以 ctx 为入口。dsh 的每个核心子系统都在 ctx 上挂一个键：ctx.llm（模型消息与流式词汇、适配器接缝）、ctx.tools（作用域工具注册表与受守卫的执行流水线）、ctx.sessions（仅追加的会话事件日志）、ctx.agents（Agent 接口与实时注册表）、ctx.agentLoop（实现 Agent 接口的默认驱动）、ctx.systemPrompt（提示词与工具 schema 装配）。

事件同样挂在共享上下文上：session/event、agent/*、fs/*、tools/*、telemetry/* 是现成的扩展点。现在你只需知道事件是插件协作的通知渠道，具体机制在后续课程展开。

这些键不是装饰：你的插件通过它们与其他插件协作。当你读到 ctx.xxx 这样的写法，含义就是“从共享上下文取一个服务”。

生活类比：把服务想成公共服务台。你要开发票，不需要知道财务部门内部如何运作，只要在“财务服务台”递上单据就能拿到结果。服务把“如何实现”藏在柜台后面，把“如何调用”写在台面上。

技术定义：服务是插件贡献给共享上下文的具名能力，通过 ctx 键对外提供。例如 ctx.sessions 就是 session 子系统对外提供的服务。Cordis 的核心职责之一是解析插件之间的服务依赖：一个插件声明“我需要会话服务”，Cordis 会在挂载它之前把服务准备好。

只要接口不变，服务的实现可以被整体替换——这正是“可替换插件”能落地的机制。比如想换一种持久化方案，就替换提供 ctx.sessions 背后实现的那个插件，调用方不会感知变化。

生活类比：把 Agent 循环想成水泵里的叶轮。它不停做同一件事：吸水、推水，驱动整个系统运转。在 dsh 里，这个不停转动的叶轮不是焊死在泵体上的——它是可以拆下来换掉的零件。

技术定义：Agent 循环是驱动一次 Agent 运行的核心流程：向模型发消息、收到响应、调用工具、把结果交还模型、判断是否继续，直到任务结束。dsh 把“循环”拆成两层插件：core/agent 定义 Agent 接口与实时注册表（ctx.agents），core/agent-loop 提供实现该接口的默认驱动（ctx.agentLoop）。想换循环策略，你替换插件，不碰内核。接口与实现分离，正是“循环可替换”能成立的前提。

模型适配器同理：llm/llm 提供消息与流式词汇，并留出适配器接缝（ctx.llm）。模型、工具、会话、循环——没有哪一样是焊死在程序里的，每一层都可由配置决定。