实战与发布

按 Definition → Provider → Consumer 实现 myCap，并在 cordis.yml 中组合加载。

完成 4.4 与 3.5。

1. Definition：抽象类继承 Service，声明 execute(request) 与 Request/Result 类型。
2. Provider：继承抽象类实现 execute，通过 ctx.plugin(MyCapLocal) 注册实现。
3. Consumer：用 defineTool 暴露工具，inject: ['tools', 'myCap']。
4. 组合：cordis.yml 同时加载 Provider 与 Consumer；模型只认识工具名，不认识服务。
5. 数据流：模型 → Consumer → Definition → Provider；换 Provider 时前两层不动。

实现最小 LlmAdapter，把自定义端点接入 dsh，并知道哪些字段不能静默丢弃。

完成 4.1；了解流式 API。

1. 继承 LlmAdapter，实现 async *stream(options)，逐片产出 StreamChunk。
2. GenerateOptions 包含 provider、model、messages、system、tools、reasoning、signal 等字段。
3. 用 ctx.llm.registerAdapter(['my-provider'], adapter) 绑定路由。
4. 不支持的字段要抛带稳定 code 的 LlmError，不能静默丢弃，否则模型会拿到残缺结果。
5. 可选覆写 listModels() / resolveModel()，提供模型与 reasoning 元数据。

按协议产出分片，并用 LlmError 表达传输与协议故障。

完成 5.2。

1. 顺序：block-start → delta → block-end → usage → finish；文本与工具调用各走一遍。
2. index 从 0 递增；text-delta 与 tool-call-delta 都要带所属块 index，块之间不要交叉。
3. 五条硬规则：start/end 成对、index 递增、argumentsDelta 是原始 JSON 增量、usage 在 finish 前、finish 必须最后。
4. 错误用带稳定 code 的 LlmError；每个 HTTP 请求合并 attributionHeaders()，并把 options.signal 传给 fetch。
5. 取消要完全停稳：不能只发 abort 就返回，要等待资源释放。

区分 bundle 与 profile，并做出一个可安装的组合包。

完成 3.2。

1. bundle 是附带配置层的 npm 包，manifest 声明 dsh.bundle.patch，回答「贡献什么」。
2. profile 是 $DSH_HOME/profiles/<name> 下的启动配置，manifest 声明 dsh.profile.bundles，回答「由哪些 bundle 按什么顺序组成」。
3. 没有东西同时是两者；profile 由 dsh plugin 创建维护，不需要手写。
4. bundle 的 patch 用包名引用插件，安装后由 Node 模块解析找到；用相对源码路径只适合本地 --patch。
5. 没有 dsh.bundle 声明的包仍然能安装，但只是普通依赖，不激活任何层。

说清四层配置叠加顺序，并用 dump-config 验证某一层来自哪里。

完成 5.4。

1. 顺序：profile 的 bundles 列表 → profile 的 cordis.patch.yml → home 级 patch → 每个 --patch overlay。
2. 后应用的层按行胜出；patch 按 id 整行替换整个 config，不是深度合并。
3. 覆盖一行时必须重述该行需要的所有键，否则丢掉未写的键。
4. dsh plugin --profile demo add/remove 管理依赖与 bundles；--dump-config 打印叠加后的完整配置树。
5. 用户可以在自己的 profile patch 里覆盖你的行，不需要改你的包。

选对三种分发方式，并避免 Git 安装的构建授权坑。

完成 5.4 / 5.5。

1. npm 与 tarball 分发预构建产物，用户安装时不需要构建授权。
2. Git 安装拉的是源码：作者要提供自包含的 prepare，用户要在 pnpm-workspace.yaml 里 allowBuilds 授权。
3. 构建脚本会在用户机器上执行，且不在 Agent 沙箱内；只给可信源码授权。
4. Git 安装要锁 commit（github:you/plugin#sha），防止默认分支变化。
5. 发布前核对 files、main、dsh.bundle，确认用户拿到的是可加载的产物。