MyAgents 架构方案

主题

MyAgents 架构方案 ​

本目录是一套可以独立阅读和部署的系统架构方案。Markdown 是内容与导航的唯一事实源，PNG 用于展示架构视图，Draw.io 文件用于后续编辑。

架构目录 ​

编号专题PNGDraw.io
01MyAgents 平台能力全景方案PNGDraw.io
02系统模块与依赖边界方案PNGDraw.io
03单进程运行时分层方案PNGDraw.io
04Engine 与 Tenant Runtime 组件方案PNGDraw.io
05Agent 任务执行链路方案PNGDraw.io
06多入口与 Channel 路由方案PNGDraw.io
07Session、Memory、文件与生成物数据流方案PNGDraw.io
08扩展包与 Plugin Runtime 架构方案PNGDraw.io
09多租户配置与跨副本广播方案PNGDraw.io
10Gateway / Runtime 多副本部署方案PNGDraw.io
11Chat ownership、心跳与恢复方案PNGDraw.io

阅读顺序 ​

  1. 全景与边界：01-02，建立平台能力和模块依赖的整体认识。
  2. 运行时核心：03-06，理解运行时分层、租户组件、任务执行和入口路由。
  3. 领域链路：07-09，理解数据、扩展和多租户配置链路。
  4. 部署与恢复：10-11，理解多副本拓扑、所有权保护和恢复机制。

状态图例 ​

  • 绿色实线：当前能力。
  • 紫色虚线：规划或待完善能力。

独立部署 ​

进入本目录后即可安装、预览和构建：

bash
pnpm install --frozen-lockfile
pnpm dev
pnpm build
pnpm preview

生产静态文件位于 .vitepress/dist/，可直接交给任意静态文件服务。

Cloudflare Pages ​

  • 根目录：architecture
  • 构建命令：pnpm install --frozen-lockfile && pnpm build
  • 输出目录：.vitepress/dist
  • 环境变量：无需配置

GitHub Pages ​

将 architecture/ 作为独立仓库根目录，启用 GitHub Pages 的 GitHub Actions 发布方式；内置 .github/workflows/deploy-pages.yml 会自动使用仓库名设置子路径。

如果由其它 CI 执行构建，仓库根路径部署使用 pnpm build，子路径部署使用 SITE_BASE=/仓库名/ pnpm build。