design v0.3.1: DESIGN.md apply review feedback (NATS client role, JSON config)

This commit is contained in:
openbot committed 2026-10-06 10:33:54 +08:00
1 parent dad43aa1fd
commit 27d4da67fb
1 file changed
+35 -24
+35 -24
View File
@@ -1,6 +1,6 @@
# agenthub 设计方案 # agenthub 设计方案
> 版本:v0.3(2026-10-05) > 版本:v0.3.1(2026-10-05)
> 目标:把本地 ACP 编码 agent 桥接到 NATS 消息总线上,形成可发现、可派活、 > 目标:把本地 ACP 编码 agent 桥接到 NATS 消息总线上,形成可发现、可派活、
> 可编排的 agent 服务网格。IM(Octop)只是前端的一种。 > 可编排的 agent 服务网格。IM(Octop)只是前端的一种。
@@ -98,8 +98,11 @@ agenthub **不绑定任何前端**。它的入口就是消息总线:
└─────────┘ └─────────┘ └─────────┘ └──────────┘ └─────────┘ └─────────┘ └─────────┘ └──────────┘
``` ```
角色说明:agenthub 在 ACP 协议里是 **client**;agent 子进程是 server。 角色说明:
NATS 侧 agenthub 是 **server**。hub 是两种协议之间的翻译层。
- ACP 协议里:agenthub 是 **client**,agent 子进程是 server
- NATS 架构里:NATS Server 是**独立部署**的总线服务;agenthub 是 **NATS client**,作为客户端接入 NATS Server;在总线语义上它以服务身份(订阅 bots.agenthub.in、发布事件)供其他 client 调用
- agenthub 整体定位:ACP 与 NATS 两个世界之间的翻译层
## 3. 总线接口设计 ## 3. 总线接口设计
@@ -187,26 +190,34 @@ NATS 侧 agenthub 是 **server**。hub 是两种协议之间的翻译层。
## 5. Agent 进程池(agent_registry.py) ## 5. Agent 进程池(agent_registry.py)
配置驱动(config.example.yaml): 配置驱动(config.json,JSON 格式;DB 建立前的引导配置):
```yaml ```json
agents: {
claude-code: "agents": {
cmd: ["claude", "--acp"] # 或 npx @anthropic-ai/claude-agent-acp "claude-code": {
cwd_whitelist: ["~/projects/*"] "cmd": ["claude", "--acp"],
default_model: null "cwd_whitelist": ["~/projects/*"],
opencode: "default_model": null
cmd: ["opencode"] },
cwd_whitelist: ["~/projects/*"] "opencode": {
session: "cmd": ["opencode"],
idle_ttl_s: 1800 # 空闲会话进程回收 "cwd_whitelist": ["~/projects/*"]
max_sessions: 8 }
orchestration: },
max_depth: 3 # supervisor 递归上限 "session": {
nats: "idle_ttl_s": 1800,
url: "nats://127.0.0.1:4222" "max_sessions": 8
inbox: "bots.agenthub.in" },
events: "bots.agenthub.out" "orchestration": {
"max_depth": 3
},
"nats": {
"url": "nats://127.0.0.1:4222",
"inbox": "bots.agenthub.in",
"events": "bots.agenthub.out"
}
}
``` ```
- 启动时不预拉进程;首个 new_session 拉起,idle_ttl 到期 kill。 - 启动时不预拉进程;首个 new_session 拉起,idle_ttl 到期 kill。
@@ -254,8 +265,8 @@ agenthub 启动后向 `bots.registry.upsert` 广播自述(A2A Agent Card 的
| **编排** | max_depth、事件限流阈值、预算上限 | DB | | **编排** | max_depth、事件限流阈值、预算上限 | DB |
| **NATS** | url、inbox/events 主题名 | DB(改后需重启) | | **NATS** | url、inbox/events 主题名 | DB(改后需重启) |
- 配置来源演进:v0.2 起以 **sqlite DB 为唯一事实源**,yaml 只做首次 - 配置来源演进:v0.2 起以 **sqlite DB 为唯一事实源**,json 只做首次
引导导入(config.example.yaml → DB);UI 改 DB,运行时读 DB 引导导入(config.json → DB);UI 改 DB,运行时读 DB
- 配置变更写审计日志(who/when/what) - 配置变更写审计日志(who/when/what)
### 8.2 运行操作 ### 8.2 运行操作