MediaCrawler/mac-agent-os-main/archive_docs/matrix_docs/V6_UPGRADE_PLAN.md

Matrix 系统全面升级规划框架 v6.0

日期: 2026-06-14 | 状态: 规划阶段 本文件定义全部需求，拆解为可执行的任务清单

---

一、身份与账号 → 主页信息增强

现状

profiles.json 已采集 fans、posts、following、likes 字段，但前端卡片未展示。

改动

在身份与账号页面的平台行中增加：

🎵 抖音  ✅ ✅ ✅  2次  小美养生茶  📊1.1k粉 📹11作  🔑 🚫 🗑

在 api_sms_accounts 返回数据中透传 fans、posts、following、likes 字段。

---

二、命令与任务 → 信息采集模块重构

当前问题

• 页面太简单，只有一个下拉+两个按钮
• 只能按账号选，不能按身份/身份的平台选

目标结构

┌─ 👤 信息采集 ──────────────────────────────────┐
│                                                   │
│ 选择范围： [按身份 ▾] [按平台 ▾] [按账号 ▾]       │
│                                                   │
│ ┌─ 可选列表（按选择范围动态展示）───────────────┐  │
│ │ ☑ 📱 15370103682                             │  │
│ │   ├ ☑ 🎵 抖音 (小美养生茶)                   │  │
│ │   └ ☐ 📕 小红书 (xhs_01)                     │  │
│ │ ☐ 📱 13382504284                             │  │
│ │   └ ☐ 🎵 抖音 (douyin_133)                   │  │
│ └──────────────────────────────────────────────┘  │
│                                                   │
│ [👤 执行选中]  [📋 全部采集]                      │
│                                                   │
│ 采集日志：                                        │
│ ✅ douyin_test 采集完成 → 小美养生茶(1.1k粉)      │
│ ⏳ xhs_01 采集中...                               │
└───────────────────────────────────────────────────┘

采集范围切换逻辑

• 按身份：显示手机号列表，勾选后该身份下所有平台都采集
• 按平台：显示抖音/小红书列表，勾选后所有该平台的账号都采集
• 按账号：显示所有账号列表（当前方式）

---

三、定时任务 → 完整可执行系统

当前状态

mc/scheduler.py 已实现：

• YAML 配置读取
• cron 表达式支持（time: "09:00" 格式）
• 自动执行 mc run 命令
• 日志记录

缺少的：

• Dashboard 创建/编辑/启停管理
• 历史执行记录
• 执行结果回传（成功/失败）
• 跨机器独立运行
• 命令行 mc schedule 完整子命令

目标架构

┌─ 定时任务系统 ───────────────────────────────────┐
│                                                    │
│ 配置层：config/schedule.yaml                        │
│   schedules:                                       │
│     douyin_daily:                                  │
│       enabled: true                                │
│       account: douyin_test                         │
│       blueprint: douyin_daily                      │
│       rounds: 3                                    │
│       time: "09:00"                                │
│       days: "1,2,3,4,5,6,7"  # 每周运行日          │
│                                                    │
│ 调度层：mc/scheduler.py                            │
│   - 30秒轮询检查                                   │
│   - 到达时间→执行 mc run                           │
│   - 记录结果到 logs/schedule_{date}.jsonl          │
│                                                    │
│ 管理层：Dashboard                                  │
│   - 任务列表（显示/编辑/删除/启停）                 │
│   - 历史记录（最近20次执行结果）                    │
│   - 手动触发执行                                   │
│                                                    │
│ CLI层：mc schedule                                  │
│   mc schedule list                                 │
│   mc schedule add --id xxx ...                     │
│   mc schedule remove --id xxx                      │
│   mc schedule start/stop                           │
│   mc schedule history --id xxx                     │
└────────────────────────────────────────────────────┘

执行结果记录格式

{"id":"douyin_daily","time":"09:00","date":"2026-06-14","status":"success","success":12,"failed":1,"duration":180}
{"id":"douyin_daily","time":"09:00","date":"2026-06-15","status":"failed","error":"Cookie expired","duration":5}

跨机器执行

• 每台机器独立运行 scheduler.py
• 从本地 accounts.yaml 读取账号
• 使用本地 profiles.json
• 结果写入本地 logs/

---

四、语料库 → 全面升级 + 移到命令与任务

当前结构（v1.x）

categories:
  赞美:
    comments: ["讲得太好了"]
    templates: ["{keyword}很好"]

目标结构（v2.0）

version: "2.0"

# 三维语料模型：身份 × 场景 × 内容
personas:
  health_lover:
    name: "养生爱好者"
    tags: ["养生", "健康"]

scenes:
  first_comment:
    label: "首次评论"
    rules: ["与视频内容相关"]
  follow_up:
    label: "跟帖回复"
    rounds: 2

content:
  health_lover.first_comment:
    - "这个养生方法很实用"
  health_lover.follow_up.round_1:
    - "确实如此，{keyword}我也是这么认为的"

# AI 生成配置
ai:
  provider: openai
  model: gpt-4o-mini
  temperature: 0.8
  prompt_template: |
    你是一个{persona}，请对视频"{title}"发表{direction}评论。
    要求：{rules}

# 故事线/对话脚本
storylines:
  douyin_hot_topic:
    name: "抖音热门话题讨论"
    script:
      - scene: intro
        text: "最近{keyword}这个事我也关注了"
      - scene: develop
        text: "其实这个事情要从几个方面看..."
      - scene: reply_expected
        text: "你觉得呢？"

Dashboard 语料库管理

命令与任务 → 语料库 TAB
├─ TAB: 按身份     — 选择身份→查看/编辑评论模板
├─ TAB: 按场景     — 首次评论/跟帖回复/作者回复
├─ TAB: 按故事线   — 创建/编辑对话脚本
├─ TAB: AI 生成    — 配置 API Key/模型/提示词模板
└─ TAB: 统计       — 语料总量/各分类数量/使用频率

---

五、批量执行 → 自动刷新 + 参数完整性

当前状态

• 账号列表：每次 loadMatrixRun 调用时从 API 获取 ✅ 自动更新
• 蓝图列表：同上 ✅ 自动更新
• 执行参数：轮数/轮间隔/账号间延迟/混合随机/语料分类/代理策略

需要确认的

参数	状态
--accounts	✅ 自动从 API 获取
--blueprints	✅ 自动从 API 获取
--rounds	✅ 有
--interval	✅ 有
--stagger	✅ 有（新增）
--mix	✅ 有
--corpus	✅ 有（但需确认是否生效）
--proxy	✅ 有
--keep	❌ 预览和执行都缺少

修复

• --keep 参数在 batchPreview 和 batchExecute 中补全

---

六、实施路线

阶段	内容	优先级	工作量
P1	身份与账号增加粉丝/视频数展示	高	0.5天
P2	信息采集模块重构（三维选择）	高	1天
P3	定时任务完善（历史+结果+管理）	高	2天
P4	语料库 v2 + Dashboard 管理	中	3天
P5	批量执行参数补全 + 自动刷新	中	0.5天
P6	同步文档 + 其他机器部署	高	1天

---

七、风险与依赖

风险	影响	缓解
scheduler.py 当前只解析 time，不支持 cron 全语法	定时灵活性	先保持 time 格式兼容，后续扩展
profiles.json 中粉丝/视频数据可能为空（未采集）	展示不全	为空时显示"-"，提示用户采集
语料库 v2 格式与 v1 不兼容	旧语料不可用	代码兼容两种格式