当前代码状态与文档边界

本文记录源码扫描后确认的容易误读之处，避免把历史设计稿当成线上事实。

已确认的实现

• CentralizedAgentMessageDispatcher 使用 dispatcher 线程和每个 session 独占的单线程虚拟线程执行器。
• AgentResponseChannelRegistry 统一管理 SSE 和回调通道。
• VirtualFileSystem 基于 Jimfs，支持纯内存和 DocSpace backing store 两种模式。
• AiToolFeignAutoRegistrationConfig 和 Nacos MCP 自动发现配置是有效的 Spring 组件。
• 日志采集覆盖会话、节点、LLM、工具、RAG、Embedding 和流式输出。

需要特别标注的历史实现

• AiAgentAutoRegistrationConfig.java 当前被整段注释，旧文档描述的启动扫描 Agent 注册流程并未作为有效 Bean 运行。
• 部分旧文档仍使用 6060、旧包名或已拆分前的模块名；部署页已记录端口差异，类名和路径以当前源码为准。
• modules/ai、modules/wflow 等目录包含大量方案记录、修复记录和版本草稿，适合作为背景资料，不应覆盖新架构文档。

文档维护规则

新增核心机制时，至少同步更新：模块首页、架构图或时序、配置键、接口入口、失败处理和变更日志。发现代码与文档不一致时，先在本文或更新日志登记，再修订具体专题。