简单优先      单进程 + SQLite，不引入复杂基础设施
本地优先      本地运行，数据本地持久化
持久化优先    重启后数据、消息、Task 状态不丢失
协议清晰      MCP 标准工具接口，Agent 无关
MCP 优先      第一阶段只实现 MCP 传输
Agent 解耦    Core 不绑定任何具体 Agent
方便扩展      预留 HTTP / WebSocket / 更多 Agent

                 ┌─────────────────────┐
                 │   Agent Bridge MCP  │
                 │                     │
Codex ──MCP────► │  Agent Registry     │
                 │  Message Router     │
Qoder ──MCP────► │  Task Manager       │
                 │  SQLite             │
                 └─────────────────────┘

Core
 ├── Agent Manager       —— Agent 注册 / 发现
 ├── Message Manager     —— 消息发送 / 接收
 ├── Task Manager        —— Task 状态机 / 回复
 └── Storage             —— SQLite 持久化

Interfaces
 ├── MCP                 —— 第一阶段已实现
 ├── HTTP                —— 预留
 └── WebSocket           —— 预留

agent-bridge/
├── src/
│   ├── core/
│   │   ├── agent_manager.ts
│   │   ├── message_manager.ts
│   │   ├── task_manager.ts
│   │   ├── storage.ts
│   │   ├── bridge.ts
│   │   └── ids.ts
│   ├── mcp/
│   │   ├── server.ts
│   │   └── tools.ts
│   ├── models/
│   │   └── types.ts
│   └── main.ts
├── tests/
├── config/
│   ├── codex.config.toml.example      # Codex CLI 接入
│   ├── qoder.mcp.json.example         # Qoder CN CLI 接入
│   ├── qoder-add-mcp.bat              # Qoder CN Windows 一键添加
│   ├── codex-desktop.mcp.json.example # Codex 桌面版接入
│   └── qoder-desktop.mcp.json.example # Qoder IDE 桌面版接入
├── .github/
│   ├── workflows/ci.yml               # CI（build + test + typecheck）
│   ├── ISSUE_TEMPLATE/                # Issue 模板
│   └── PULL_REQUEST_TEMPLATE.md       # PR 模板
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── README.md
├── package.json
├── tsconfig.json
└── LICENSE

npm install
npm run build

node dist/main.js

{ "agent_id": "codex", "agent_name": "Codex" }

{
  "from": "codex",
  "to": "qoder",
  "message": "检查 STM32 工程中的 LVGL 初始化问题",
  "expects_response": true
}

{ "task_id": "task-xxx", "status": "pending" }

{
  "task_id": "task-xxx",
  "status": "completed",
  "message": "发现 LVGL 初始化存在 xxx 问题"
}

[mcp_servers.agent-bridge]
command = "node"
args = ["dist/main.js"]
env = { "AGENT_BRIDGE_DB" = "data/agent-bridge.db" }
cwd = "/absolute/path/to/agent-bridge"

codex mcp add agent-bridge -- node dist/main.js
codex mcp list

qoderclicn mcp add agent-bridge -s user -- node /absolute/path/to/agent-bridge/dist/main.js
qoderclicn mcp list

{
  "mcpServers": {
    "agent-bridge": {
      "command": "node",
      "args": ["dist/main.js"],
      "env": { "AGENT_BRIDGE_DB": "data/agent-bridge.db" },
      "cwd": "/absolute/path/to/agent-bridge"
    }
  }
}

{
  "mcpServers": {
    "agent-bridge": {
      "command": "node",
      "args": ["/absolute/path/to/agent-bridge/dist/main.js"],
      "env": { "AGENT_BRIDGE_DB": "/absolute/path/to/agent-bridge/data/agent-bridge.db" }
    }
  }
}

{
  "servers": {
    "agent-bridge": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/agent-bridge/dist/main.js"],
      "env": { "AGENT_BRIDGE_DB": "/absolute/path/to/agent-bridge/data/agent-bridge.db" }
    }
  }
}

Codex：“让 Qoder 检查 xxx”
      ↓ create_task(to=qoder)
Qoder：“收到任务”
      ↓ reply_task(status=running)
Qoder：“检查完成，发现 xxx”
      ↓ reply_task(status=completed, message=...)
Codex：“收到结果”
      ↑ get_task(task_id)

npm test          # 运行全部测试
npm run typecheck # 类型检查