English · 中文
@hanphone/dsh-a2a 是 DeepSeek Harness
的 Agent2Agent（A2A）v1.0.1 双端插件。它把一个 DSH profile 变成 A2A 一等公民：
一个或多个入站 server 把 DSH agent 发布给其他 A2A 客户端；一个或多个出站连接
把远端 A2A 技能映射为 DSH 内的模型工具。
这份手册写给安装、运维和排障的人。内容描述 v0.4.0 在 DeepSeek Harness 0.2.1-rc.2 上的当前行为。内部设计动机见下方架构与设计文档。
| 文档 | 回答什么 |
|---|---|
| 快速开始 | 怎么安装、发布第一个 agent、调用一个远端 agent？ |
| 核心概念 | 入站/出站、preset、技能、任务、上下文、能力分别是什么？ |
| 运维指南 | GUI 和 /a2a 命令怎么用？配置、存储、安全怎么管？ |
| HTTP API 与 A2A 协议 | 面板 API 有哪些动作？线上端点和协议长什么样？ |
| 排障 | 任务为空、出站失败、工具看不到，分别怎么查？ |
| 文档 | 读者 |
|---|---|
| 架构 | 维护者与插件作者：manager、执行器、路由、存储、安全 |
| Harness 兼容性 | 跨 DSH 版本升级的维护者；含验证流程与发布记录 |
| 测试 | 贡献者：测试分层、hermetic e2e 冒烟，以及为什么 stub 测试不够 |
| 设计记录 | 历史设计决策（中文） |
文档冲突时按以下顺序裁决：
src/ 下实际运行的代码与 tests/ 下的测试。README.md 与深入文档。手册由人工维护，可能滞后于代码。每页都标注了核对时的版本；如果你的观察与文档不一致， 以代码为准，并带着版本和你执行的命令提 issue。
@hanphone/dsh-a2a 0.4.00.2.1-rc.2（CI 同时覆盖 0.2.1-alpha.2 与 0.1.7-rc.2）1.0.1 的 JSON-RPC 绑定（本实现声明的协议版本为 1.0）精确的 peer 范围与发布证据见 Harness 兼容性。