MatrixMedia 矩媒使用教程:多账号视频矩阵管理与批量发布详解

原创2026-10-21 09:06:452,554 阅读

MatrixMedia 矩媒使用教程:多账号视频矩阵管理与批量发布详解

MatrixMedia(矩媒)是一款面向自媒体的开源视频矩阵工具,基于 Electron + CLI 构建,支持多账号视频矩阵管理与批量发布:一个视频可自动分发到抖音、快手、小红书、哔哩哔哩、头条、视频号、百家号、番茄视频等 8 个平台,并提供图形界面、CLI 命令行、HTTP API、MCP 四种接入方式,是自媒体矩阵运营的自动化发布利器。

一、矩媒支持哪些视频平台?

矩媒目前已完成 8 个平台的自动上传发布,覆盖主流短视频与图文社区:

平台 别名/参数 元数据支持
抖音 dy 标题 + 简介/标签拼正文
快手 ks 标题 + 简介/标签拼正文
视频号 sph 标题 + 6~16 字短标题
哔哩哔哩 blbl 标题 + 简介 + 独立标签
小红书 xhs 标题 + 正文 + 话题控件
头条号 tt 标题
百家号 bjh 标题(可填地址)
番茄视频 fqsp 支持 GUI/CLI 发布与审核状态回查

此外还内置数据统计功能(粉丝/播放/点赞/评论/收藏快照),可追踪每个账号的运营表现。各平台发布逻辑位于 src/main/services/upLoad/ 目录,例如 sph.js 对应视频号发布流程。

二、一键安装步骤:Windows / macOS / Linux

矩媒支持三大操作系统,安装方式如下(详见 website/guide/getting-started.md):

Windows:下载 MatrixMedia-<version>-win-x64.exe 双击安装即可,安装包会自动把 matrixmedia 命令加入 PATH,装完重开终端即可使用 CLI。

macOS:Intel 芯片下载 mac-x64.dmg,Apple Silicon(M1/M2/M3/M4)请选 mac-arm64.dmg,拖入「应用程序」即可。若首次打开被系统拦截,进入「系统设置 → 隐私与安全性」点击「仍要打开」:

macOS 隐私与安全性中点击仍要打开以放行矩媒视频矩阵工具

Linux:提供 AppImage、deb、rpm、tar.gz 四种安装包,按发行版选择即可;无图形环境的服务器可解压便携包后直接走 CLI 模式。

三、多账号视频矩阵管理:账号添加与登录

打开应用后默认进入「所有账号」页,核心流程是:添加账号 → 各平台登录 → 按分组管理矩阵。

1. 按手机号分组管理账号

矩媒以手机号作为账号分组的唯一标识,每个账号在每个平台的登录态保存在独立的 session 分区(persist:<手机号><平台>)中,互不干扰。多账号、多平台的 Cookie 各占一格,批量发布时可精准定位到"某账号在某平台"的登录态。

2. 打开登录窗口完成扫码

进入 媒体平台管理页 后,点击侧栏的平台即可打开该平台的独立登录窗口:

  • 在弹窗中扫码登录对应平台账号;
  • 登录成功后点击「验证登录」确认 Cookie 有效;
  • 若登录态过期,页面会显示「❌重新登录」,重新扫码一次即可。

💡 提示:视频号在内置窗口扫码若提示"没有可登录的视频号",可改用「使用 Chrome 登录」按钮走本机 Chrome 完成鉴权。

3. 账号级发布设置

每个账号平台节点都支持个性化配置:

  • 默认发布到草稿:开启后该账号发布时先存草稿箱,人工确认后再公开,适合谨慎运营的主力号;
  • 真实浏览器模式(小红书专属):小红书对自动化检测日趋严格,开启该开关后可用本机 Chrome 代替内置窗口发布,从根源上规避「AI 托管」警告。配置后建议点击「测试连接」确认可用;
  • 代理配置:多账号矩阵可给不同账号绑定不同出口 IP,降低关联风险。

四、本地视频批量发布:从选片到一键分发

批量发布是矩媒最核心的能力,入口在「本地视频发布」组件 LocalVideoPublish.vue。操作流程分三步:

第一步:填写发布内容

选择本地视频文件后,弹窗中填写:

  • 视频标题:发布到各平台的标题;
  • 视频简介:将作为各平台正文或简介;
  • 视频标签:支持回车/空格逐个添加,也支持批量粘贴 #标签1 #标签2;
  • 视频号短标题:仅视频号使用,建议 6~16 字;
  • 定时发布:打开开关后可指定发布时间,任务立即进入发布历史,到点自动执行。

第二步:勾选目标账号与平台

下一步进入账号平台选择树:

  • 以「分组 → 平台」两层树形结构展示所有已登录账号;
  • 支持全选/反选,一眼看到每个账号的登录状态(绿色「登录√」/ 红色「❌重新登录」);
  • 可对已勾选账号批量应用创作声明(如 AI 生成内容声明),一次设置多账号;
  • 每个叶子节点还会显示该账号的代理配置,方便矩阵运维。

第三步:确认发布方式并执行

  • 可选择显示或隐藏自动化发布过程(观看发布过程便于排错);
  • 点击确认后,任务进入发布队列,按顺序自动完成上传、填写元数据、提交发布;
  • 发布结果实时写入本机发布历史,可在「视频管理」页查看每次批量任务的成败状态与失败截图。

⚠️ 注意:远程视频 URL 只会被下载一次,多平台分发时复用同一临时文件,全部平台发布结束后自动清理。

五、四种接入方式:GUI、CLI、HTTP API、MCP

矩媒不仅是图形界面工具,同一可执行文件还提供三种程序化接入方式,适合进阶玩家与 AI 智能体编排:

方式 适用场景 前置条件
GUI 图形界面 日常运营、批量勾选发布 无
CLI 命令行 脚本化、CI/CD、定时任务 登录态与 GUI 共用
HTTP API 其他程序触发发布 GUI 已启动(默认 30088 端口)
MCP Server Claude Desktop / Cursor 等 AI 工具原生调用 先构建 mcp/ 子包

CLI:无头批量发布的正确姿势

在参数中加入 cli 即进入命令行模式,完整说明见 docs/cli.md。常用命令:

# 抖音终端二维码扫码登录
matrixmedia cli login -p dy --phone 13800138000

# 发布视频到抖音(简介、标签)
matrixmedia cli publish -p dy --phone 13800138000 -f /path/to/video.mp4 \
  -t "标题" --description "视频简介" --tags "#跑步 #新手"

# 视频号发布(额外短标题 + 定时)
matrixmedia cli publish -p sph --phone 13800138000 -f /path/to/video.mp4 \
  -t "标题" --short-title "5公里新手挑战" --publish-at "2026-10-22 08:00:00"

# 只读查询(不触发任何登录/发布,适合脚本预检)
matrixmedia cli accounts --json
matrixmedia cli history --json --days 7

关键约定:

  • 退出码:0 成功 / 1 异常 / 2 参数错误 / 3 业务失败(未登录、上传失败等),方便脚本判断;
  • 登录态共享:CLI 与 GUI 共用同一 session partition。抖音、视频号支持 CLI 终端二维码登录;其他平台只需先在 GUI 登录一次,CLI 会自动复用;
  • 草稿模式:加 --draft 可只保存草稿箱,不直接公开。

HTTP API:让其他程序触发发布

GUI 启动后自动监听本机 http://127.0.0.1:30088,通过 POST /publish 即可发布。单平台与 GUI 等价,多平台时提交到队列后立即返回。一个多平台分发的最小示例:

curl -X POST http://127.0.0.1:30088/publish \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "13800138000",
    "file": "C:/videos/demo.mp4",
    "title": "我的视频标题",
    "tags": "跑步 新手",
    "platforms": ["dy", "sph", "ks"]
  }'

完整路由、请求/响应字段见 docs/http-api.md,路由实现位于 src/main/server/routes/index.js。

MCP:AI 工具原生接入

仓库内置 mcp/ 子包,实现了 Model Context Protocol Server。构建并配置后,Claude Desktop、Cursor 等 AI 工具可直接调用 7 个工具:list_accounts、list_history、publish_video、publish_article、get_account_stats、sync_account_stats、get_work_stats,用自然语言即可驱动视频矩阵发布,详细说明见 docs/mcp.md。

六、新手常见问题速查

Q1:发布时报"cookie 已过期"怎么办? cli accounts 检测到登录态失效时会明确提示,回到 GUI 对应账号节点点击「重新登录」重新扫码一次,CLI 即自动恢复。

Q2:为什么小红书发布被提示"AI 托管"? 开启该账号「发布设置 → 使用真实浏览器」,用本机 Chrome 代替内置窗口发布,详见上文"账号级发布设置"。

Q3:定时发布错过了时间会怎样? 定时任务创建后立即可在发布历史中查看;若程序关闭导致错过时间点,任务会显示"任务过期",需手动重新触发。

Q4:多账号矩阵如何降低风险? 三个手段配合:不同账号绑定不同代理 IP(账号管理页可配置)、重要账号开启"默认草稿"、合理控制单账号单日发布频率,并严格遵守各平台服务协议。

Q5:支持 Linux 服务器无头跑批吗? 支持。解压 tar.gz 便携包后用 ./matrixmedia cli publish ... 即可;SSH 无显示环境下登录扫码需配合 xvfb-run -a。

七、写在最后

从「添加账号 → 扫码登录 → 勾选矩阵 → 一键分发」,MatrixMedia 把一个视频铺到 8 个平台的操作压缩到了几分钟内。新手建议先用 GUI 完整走一遍本地视频批量发布流程,熟悉账号分组与发布历史后再尝试 CLI / HTTP API 自动化,最后按需接入 MCP 让 AI 工具参与运营。

合规提醒:本项目仅用于合法合规的学习与效率提升场景,请勿用于批量作弊、恶意营销、侵权搬运等违规用途;涉及账号 Cookie 等敏感数据请妥善保管。

登录后查看全文
MatrixMedia