MatrixMedia 矩媒使用教程:多账号视频矩阵管理与批量发布详解
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,拖入「应用程序」即可。若首次打开被系统拦截,进入「系统设置 → 隐私与安全性」点击「仍要打开」:
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 等敏感数据请妥善保管。
