Tools Hub Server（工具中枢后端服务）产品系统Vibe Coding

软件工程正从「人写代码」转向「自然语言描述目标、智能体落地执行」。

当前痛点：

- 需求碎片化、迭代频繁
- 文档与代码易脱节
- 多工具链难统一编排
- 传统 CI/CD 难覆盖「创建 → 开发 → 测试 → QA → 封版 → 能力沉淀」全闭环

AI Coding Agent（Qwen / Qoder / Cursor / CodeBuddy 等）使「一句话启动一次可交付迭代」成为现实，典型能力包括：

- 工作区隔离、按版本管理
- 会话可续接、执行过程可回放

后端侧关键诉求：

- 消息驱动编排
- 多智能体命令差异适配
- 流式日志采集与聚合
- 与元数据、文件、命令执行等微服务深度集成

随着低代码交付、内部工具库与产品能力注册普及，对「可配置智能体、可审计会话、可扩展场景」的编排服务需求持续上升。竞争焦点在编排稳定性、可观测性与工程化运维，而非单一模型调用。

本服务是 Tools Hub 的后端编排中枢：以消息中心为事件入口，调度本地 AI 编程智能体，并同步工具版本与能力任务状态。

**1. 异步开发编排**

- 订阅 `development_ready` 等事件
- 按 `agent-config.json` 组装并执行命令
- 支持自动调用、仅打印命令、`other` 手动话术
- 支持当前终端 / 新终端两套命令策略
- 开发完成后监控工作区状态，回写数据库并推送完成消息

**2. 测试反馈与 QA**

- 按测试反馈 / QA 指导文档调度智能体
- 支持链式下一条修复
- 支持会话续接（`--resume`）

**3. 运维 / 产品能力注册**

- 按指导文档更新 `ops-list.json`
- 更新 `product-scene-capability.json` 等能力沉淀产物

**4. 智能体配置与话术**

- 智能体列表、默认智能体、启动前置校验
- 按场景查询可复制调度话术

**5. 执行日志推送与聚合查询**

- 将流式输出结构化推送到消息中心
- 按会话聚合 `tool_logs`
- 输出 JSON / 原文 / Markdown
- 按 qwen、qoder、cursor、codebuddy 等专属规则渲染

**6. 运维与任务可视**

- 健康检查、任务查询
- Winston 日志轮转
- Makefile 统一启停，降低同机多服务干扰

### 负责任务

我负责本服务从架构设计到迭代交付，主要包括：

1. 消息订阅与业务分发
（异步开发、手动提交检查、测试反馈、QA、能力注册）

2. 多智能体命令构建
（`agent-config.json`、自动/手动策略、会话续接）

3. 流式执行日志
（采集、推送、按 Agent 策略的 Markdown 聚合查询）

4. 外部服务对接
（Model Data Server、消息中心、本地文件 API、命令执行 API）

5. 工程化与文档
（TypeScript 工程、Winston、环境配置、Makefile、设计/测试文档）

### 技术栈

| 类别 | 技术 |
|------|------|
| 语言与运行时 | TypeScript、Node.js |
| Web 框架 | Express |
| 实时通信 | WebSocket（`ws`） |
| HTTP 客户端 | Axios |
| 日志 | Winston |
| 配置 | dotenv |

### 架构

采用 MVC / 分层服务：

- **Controller**：承接 REST
- **Service**：承载编排与外部调用
- **Model**：描述任务与载荷
- **Markdown 渲染**：按策略模式按 Agent 拆分，便于扩展

### 实现难点与亮点

1. **多 Agent 差异适配**
命令字段、终端策略与流式 JSON 协议差异大；统一抽象的同时保留专属解析。

2. **异步开发全链路一致性**
收消息 → 建任务 → 执行 → 监控 status → 回写 → 推送 → 清理；保证状态一致与失败可观测。

3. **会话日志可读回放**
按 sequence 聚