示例索引
为新建 @deepseek-ai/dsh-<name> 包提供的逐文件清单。本清单以 bash 和适配器这两个包为模板进行验证；如果清单与模板有出入，请在此修正。
面向模型的工具必须满足哪些约定，均以本文为准。如需按步骤构建第一个工具，请阅读构建工具。packages/shell/tool-bash 是生产级的三包示例。
如何接入一个新的模型提供方。参考实现：packages/llm/llm-deepseek（直接 HTTP，SSE（Server-Sent Events）由 eventsource-parser 分帧）与 packages/llm/llm-pi-ai（封装 LLM 库）。请先阅读 packages/llm/llm/src/types.ts 中的 StreamChunk 文档——它记录了两个适配器都经过验证的协议约定。
harness 扩展的参考模式。代码片段省略了 import 和辅助实现，无法直接复制运行。具体编写路径见包检查清单、第一个工具教程、工具参考和 LLM（大语言模型）适配器指南；系统与扩展点映射由架构文档负责。
本教程为 Web Client Chat 视图添加一行由业务自行拥有的内容。完成后的插件会把一个持久 Session 事件族关联成一个 Context，增量构造业务 State，发布类型化 Step 数据，再渲染 keyed Chat Node；整个过程不扫描 Session 窗口或其他已渲染节点。本教程假设 Host 已经记录这些事件，且该 Client 插件已组装进 Web bundle；Host 侧外部 UI 和 Trajectory 等额外视图目标不在本文范围内。
Conversation Node 组装决策记录完整的引擎模型和设计理由；本文只说明实现路径。