2.7 KiB
examples/：开箱可运行的演示组合包
English | 中文
预先组合的插件 bundle（组合包），供轻量叶节点 cordis.yml 加载，无需手工组装主干和前端入口。这些是 演示／参考 包；npm 名称的 -demo 后缀把每个包标为非产品表层，直接查看包名即可辨认。仓库根目录 examples/ 下的可运行叶节点与 Python SDK runtime 是消费方；每个叶节点都只包含可替换后端和一个组合包入口。
| 包 | npm 名称 | 角色 |
|---|---|---|
agent-spine-demo/ |
@deepseek-ai/dsh-agent-spine-demo |
不含执行器和 UI 的 agent 主干，打包为一个组合包插件，带后备会话标题和选用的持久目标栈 |
cli-demo/ |
@deepseek-ai/dsh-cli-demo |
无头单次应用：主干 + JSONL 持久化 + 预创建的 main agent，提供文本和 DSH 原生 JSON 输出 |
acp-demo/ |
@deepseek-ai/dsh-acp-demo |
ACP 自动化服务器应用：主干 + 持久目标 + JSONL 持久化 + acp 桥接层（无 stdout logger），带启动 bin |
jsonrpc-demo/ |
@deepseek-ai/dsh-jsonrpc-demo |
只有 bin 的 runtime，用于启动外部 cordis.yml，供 stdio JSON-RPC SDK 客户端使用 |
agent-spine-demo 是共享组合包；cli-demo 和 acp-demo 分别将它与无头单次和 ACP 自动化前端入口组合，并拥有各自的启动 bin。产品 dsh CLI 不使用组合包：其 TUI 与 web surface 都是一份共享的 base.cordis.yml 加各自一份 overlay。jsonrpc-demo 自身不挂载任何组合，而是启动部署的 cordis.yml 所指名的任意插件树；Python SDK runtime 会启动它。
这些 不是 产品 API。它们打包的主干组件位于 core/，人类／SDK 通道和启动粘合代码位于 ui/，自动化传输位于 acp/，可替换后端位于各自能力组；演示组合包只选定其中一种具体组合。可以自由替换或 fork。
不要将此组与仓库根目录的 examples/ 混淆：该目录存放可运行的 cordis.yml 叶节点；此组存放这些叶节点加载的 组合包。
jsonrpc bin／exe 名称是历史遗留
jsonrpc-demo 已像同级包一样重命名，但其 bin 仍为 dsh-jsonrpc-agent，单文件可执行程序仍为 dsh-jsonrpc-agent-pkg（在 Python 分发各处被引用）。这些名称属于 SDK 的 runtime 启动表层；只有 SDK 统一该启动流程时才会协调它们，而不会在此次移动中处理。