示例索引

新增 Package

为新建 @deepseek-ai/dsh-<name> 包提供的逐文件清单。本清单以 bash 和适配器这两个包为模板进行验证；如果清单与模板有出入，请在此修正。

新增 Tool

面向模型的工具必须满足哪些约定，均以本文为准。如需按步骤构建第一个工具，请阅读构建工具。packages/shell/tool-bash 是生产级的三包示例。

新增 LLM Adapter

如何接入一个新的模型提供方。参考实现：packages/llm/llm-deepseek（直接 HTTP，SSE（Server-Sent Events）由 eventsource-parser 分帧）与 packages/llm/llm-pi-ai（封装 LLM 库）。请先阅读 packages/llm/llm/src/types.ts 中的 StreamChunk 文档——它记录了两个适配器都经过验证的协议约定。

新增设置卡片

插件如何把自己的配置放上 Web 设置页。这条路径上没有任何一步需要改动本仓库：Host 服务每一个已注册的 settings 命名空间，而插件配置分区以卡片所编辑的命名空间为键，因此同时注册了两个半侧的插件会被自动配对。

两个半侧住在同一个包里——Host 半侧在 src/，浏览器半侧在 src/client/，以 ./client 导出并用 dsh.client 声明。packages/client/ui-theme 是这种打包方式的现成例子；本分区自带的卡片在 packages/client/ui-settings-plugins。

扩展模式

harness 扩展的参考模式。代码片段省略了 import 和辅助实现，无法直接复制运行。具体编写路径见包检查清单、第一个工具教程、工具参考和 LLM（大语言模型）适配器指南；系统与扩展点映射由架构文档负责。