MediaCrawler/mac-agent-os-main/99_system/COMMAND-CENTER-PLAN.md

AgentOS 联邦智能体协作指挥台 — 总体规划 v0.3

版本: v0.3（草案） | 最后更新: 2026-06-15 状态: 架构方向已确认，待细化各层

---

一、系统架构：命名空间分层

顶层入口

agentos                    ← 联邦智能体顶层命令
├── matrix                社交矩阵（抖音/小红书运营）
├── ave                   视频工厂（视频制作与编辑）
├── crawl                 内容采集（互联网内容抓取）
├── fleet                 联邦管理（多机协同）
└── serve                 服务管理（MCP/Dashboard/调度）

每一层的内部结构

agentos matrix                    社交矩阵
├── run                           执行养号/互动
├── account                       账号管理
├── collect                       主页信息采集
├── publish                       内容发布（短视频/图文）
├── blueprint                     蓝图管理
├── task                          定向任务
│   ├── comment                   定向评论
│   ├── search                    搜索任务
│   └── reply                     回复管理
├── schedule                      矩阵定时任务
├── corpus                        语料库
├── sms                           短信验证码
└── proxy                         代理管理


agentos ave                       视频工厂
├── render                        视频渲染/生成
├── script                        脚本/文案生成
├── material                      素材管理
│   ├── list                      素材列表
│   ├── add                       添加素材
│   └── search                    素材搜索
├── template                      模板管理
└── export                        导出/发布


agentos crawl                     内容采集
├── web                           网页内容抓取
├── video                         视频下载
├── extract                       信息提取（正文/标题/标签）
├── schedule                      采集定时任务
└── source                        采集源管理


agentos fleet                     联邦管理
├── sync                          一键同步所有机器
├── reconcile                     对账检查
├── exec                          远程执行命令
├── status                        集群状态
└── logs                          日志聚合


agentos serve                     服务管理
├── mcp                           启动 MCP Server（AI 调用入口）
├── dashboard                     启动/停止看板
└── schedule                      全局定时调度器

---

二、与现有系统的对应关系

新结构	现有位置	迁移方式
agentos matrix	mc 全部命令	改名为 agentos，mc 保留为 alias
agentos matrix run	mc run	不变，直接继承
agentos matrix collect	mc collect	不变
agentos matrix account	mc account	不变
agentos matrix publish	publish_video.py	封装为子命令
agentos ave	09_ave/ (96个脚本)	封装 CLI
agentos crawl	05_crawl/ (29个脚本)	封装 CLI
agentos fleet	fleet_sync.sh + fleet_reconcile.sh	封装 CLI
agentos serve mcp	新建	新增
agentos serve dashboard	run.py 9988	封装 CLI

---

三、Dashboard 看板的映射

看板的导航结构直接映射到 agentos 的命名空间：

┌─── AgentOS 联邦指挥台 ──────────────────────────┐
│                                                    │
│  [矩阵]  [视频工厂]  [内容采集]  [联邦]  [服务]     │
│                                                    │
│  ┌─ 矩阵 ───────────────────────────────────────┐  │
│  │  账号管理 │ 养号执行 │ 信息采集 │ 内容发布    │  │
│  │  蓝图管理 │ 定向评论 │ 定时任务 │ 语料库      │  │
│  └──────────────────────────────────────────────┘  │
│                                                    │
│  ┌─ 视频工厂 ────────────────────────────────────┐  │
│  │  渲染任务 │ 脚本生成 │ 素材库 │ 模板          │  │
│  └──────────────────────────────────────────────┘  │
│                                                    │
│  ┌─ 内容采集 ────────────────────────────────────┐  │
│  │  采集任务 │ 源管理 │ 采集历史                  │  │
│  └──────────────────────────────────────────────┘  │
│                                                    │
│  ┌─ 联邦 ────────────────────────────────────────┐  │
│  │  机器状态 │ 一键同步 │ 对账检查 │ 远程Shell   │  │
│  └──────────────────────────────────────────────┘  │
│                                                    │
│  ┌─ 服务 ────────────────────────────────────────┐  │
│  │  MCP 状态 │ Dashboard日志 │ 全局定时任务      │  │
│  └──────────────────────────────────────────────┘  │
└────────────────────────────────────────────────────┘

---

四、MCP 暴露策略

按分层暴露，每个领域提供一组 MCP 工具：

agentos-mcp（总入口，自动发现所有子模块）
│
├── matrix/*             社交矩阵工具
│   ├── run_nurture      执行养号
│   ├── collect_info     采集主页
│   ├── publish_video    发布视频
│   ├── task_comment     定向评论
│   └── account_status   账号状态
│
├── ave/*                视频工厂工具 
│   ├── render_video     渲染视频
│   └── generate_script  生成脚本
│
├── crawl/*              内容采集工具
│   ├── fetch_web        抓取网页
│   └── download_video   下载视频
│
└── fleet/*              联邦管理工具
    ├── exec_remote      远程执行
    ├── sync_all         同步
    └── cluster_status   集群状态

---

五、Dashboard 插件映射

现有的插件系统保持不变，新增插件对应新命名空间：

插件	对应命名空间	状态
plugins/matrix.py	agentos matrix	✅ 已有，需改造
plugins/kb_api.py	属于 serve	✅ 已有
plugins/ave.py	agentos ave	✅ 已有
plugins/guardd.py	agentos fleet	✅ 已有
plugins/federation.py	agentos fleet	🔴 新增
plugins/scheduler.py	agentos serve schedule	🔴 新增
plugins/crawl.py	agentos crawl	🔴 新增

---

六、当前 Dashboard 在此架构中的位置

Dashboard 不是"一个模块"，而是"所有模块的统一操作界面"。

agentos serve dashboard ← 启动看板
                           ↓
                    Dashboard Web
                    ├── 矩阵标签页    → 调用 agentos matrix *
                    ├── 视频工厂标签页 → 调用 agentos ave *
                    ├── 内容采集标签页 → 调用 agentos crawl *
                    ├── 联邦标签页    → 调用 agentos fleet *
                    └── 服务标签页    → 调用 agentos serve *

每个标签页的操作按钮调用对应的 agentos 命令。 每个标签页的数据展示来自各机器的 API 聚合。

---

七、待讨论问题（下一轮）

架构方向定了之后，需要细化的点：

7.1 迁移策略

当前 mc 已经有很多脚本、蓝图、配置引用它。迁移方案：

• A) 一步到位：把所有 mc 引用改为 agentos，mc 作为 alias 保留
• B) 渐进迁移：先加 agentos 入口，mc 继续可用，逐步过渡

7.2 命名空间的 CLI 实现方式

• A) 单 CLI 多级子命令：一个 agentos 二进制，通过子命令分发（当前 mc 的做法）
• B) 多 CLI 独立安装：agentos-matrix、agentos-ave 各自独立

7.3 各领域的开发优先级

当前资源有限，先做哪个领域？

领域	现有成熟度	建议优先级
matrix（社交矩阵）	最成熟，91个脚本	Phase 1
fleet（联邦管理）	基础已通	Phase 2
ave（视频工厂）	96个脚本但未 CLI 化	Phase 3
crawl（内容采集）	29个脚本	Phase 4
serve（服务管理）	新建	穿插进行

---

你觉得这个结构清晰了吗？如果没问题，下一轮我们就定：

1. 迁移策略（一步到位 vs 渐进）
2. CLI 实现方式（单CLI vs 多CLI）
3. 开发优先级