更新日志与文档维护

2026-10-04

• 按技术文档树补充入口规范、角色索引、术语表和文档地图。
• 新增架构、服务地图、请求链路、数据分层、安全、配置和端口差异专题。
• 新增部署前置条件、开发启动、Docker、Nacos、数据库、存储、健康检查、排障和发布清单。
• 新增 AI 核心生命周期、Agent 运行时、规划执行、工具 Skill、记忆、RAG、渠道和可观测性专题。
• 新增 Agent 管理、模型/Dataset、工具 Skill、FileRoom、API、平台、业务服务、计费、数据、开发测试和附录入口。
• 根据 muotai-backend 当前 POM、application.yml、Controller、迁移脚本和 Compose 文件记录端口与部署差异。
• 深入对照自主规划 Agent 源码，补充主图/Agentic Loop 子图、状态桥接、工具 journal、HITL、上下文压缩、checkpoint/JSONL 恢复、dispatcher 与 SSE 时序。

2026-10-03

• 建立“用户文档 / 技术文档 / 产品生态”三级入口。
• 以 muotai-ai 源码为依据补齐 Agent 核心、MCP、Skill、VFS、渠道、LLM、管理和日志专题。
• 补充生产部署、配置参考、前端对接边界和当前代码状态说明。
• 将 SPG、审计、标准化、Legalstar 和 WFlow 从 AI 核心中拆为产品生态入口。
• 标记旧 Agent 自动注册类已注释，以及源码端口与 Docker/Compose 声明不一致的问题。

后续维护节奏

每次后端发布至少检查：

1. Controller 路径和 DTO 是否变化。
2. 配置键、默认值和 Nacos 覆盖关系是否变化。
3. Agent 节点、工具执行器和响应事件是否变化。
4. 数据库迁移、文件挂载和部署端口是否变化。
5. 生态模块的 Feign/API 契约是否变化。

文档修改完成后运行 npm run docs:build，并检查新页面、内部链接和导航层级。