先说问题:一条视频发一圈平台,要重复劳动多少次
做短视频的人都熟这个流程:片子剪好了,打开抖音创作者后台,上传、等转码、填标题、填简介、选标签、挂话题;再打开快手,重复一遍;再打开视频号,重复一遍,而且它还要多填一个短标题;然后是小红书、B 站、百家号、头条号……平台之间字段还各不一样,有的把简介和标签拼进正文,有的标签走单独的话题控件,有的干脆只认标题。
一条视频发一圈,熟练了也要小半个小时,全是无脑重复劳动。要是手里不止一个账号——主号、垂类号、地区号组成的账号矩阵——这个数字还要再乘以账号数。更麻烦的是发完之后:每个平台的数据(粉丝、播放、点赞)要逐个后台去看,评论要逐个后台去回。一天下来,真正花在创作上的时间没多少,全耗在「搬运」上了。
本篇主线:认识矩媒的四种操控方式 → 把账号矩阵登录好 → 图形界面手动发一条 → 用 CLI 把发布变成可脚本化的命令 → 用 HTTP 接口和 MCP 把发布交给其它程序和 AI 助手 → 最后把风控边界说清楚。
它是什么:一个 Electron 应用,四种操控方式
矩媒(MatrixMedia)是一个开源的视频矩阵发布工具,GPL-2.0 许可,基于 Electron + Vue 构建,支持 Windows 与 macOS。它和常见的「一键分发」工具最大的区别不在界面,而在于它从设计上就准备了四种操控方式:
| 操控方式 | 适合谁 | 上手门槛 | 能否被智能体调用 | 典型场景 |
|---|---|---|---|---|
| 图形界面(GUI) | 手动运营者 | 低,装好、登录就能用 | 不能直接调用,但它是全部登录态的来源 | 日常手动发布、各平台首次登录、改发布设置 |
| 命令行(CLI) | 会写脚本的人、自动化流程 | 中,要熟悉终端 | 能,靠退出码与 JSON 输出对接 | 定时批量发布、流水线里的发布环节、上线前检查 |
| HTTP 接口 | 本机上其它程序 | 中,要会发 HTTP 请求 | 能,前提是 GUI 保持运行 | 自己的小工具、本地服务触发发布 |
| MCP 服务 | AI 助手用户 | 中,要先构建一次并写配置 | 能,原生工具调用 | 在对话里让助手查账号、发视频、回评论 |
四种方式共用同一份账号登录态和同一套发布记录。也就是说:先在图形界面里把账号登录好,剩下的事就可以逐步从手动过渡到脚本,再过渡到智能体,不用为每种方式各登一遍号。
从仓库的 Releases 页下载安装包即可。Windows 的 NSIS 安装包(0.4.5 起)会自动把安装目录加入当前用户的 PATH,装完重开终端就能直接用 matrixmedia 命令;macOS 把 App 拖进「应用程序」后,需要手动建一个符号链接:
sudo ln -sf /Applications/matrixmedia.app/Contents/MacOS/matrixmedia /usr/local/bin/matrixmedia之后在任意终端都能直接敲 matrixmedia cli ...。覆盖升级时 App 路径不变,链接继续有效,不用重做。
能发哪些平台:8 个视频平台,外加掘金文章
矩媒目前完整自动化的发布平台共 8 个,命令行里用短码指代:
| 平台 | CLI 短码 | 备注 |
|---|---|---|
| 抖音 | dy | CLI 可扫码登录;支持商品挂载配置 |
| 快手 | ks | 评论拉取与回复已支持 |
| 百家号 | bjh | 发布只写标题,正文规则随平台 |
| 哔哩哔哩 | blbl | 简介与标签各自独立填写 |
| 头条号 | tt | 发布只写标题 |
| 视频号 | sph | CLI 可扫码登录;有独立的短标题字段 |
| 小红书 | xhs | 有真实浏览器发布模式,见下文 |
| 番茄视频 | fqsp | 别名 fanqie、fq、番茄视频 |
除视频外,它还能往掘金发文章(短码 juejin),走的是单独的 publish-article 子命令。发布时 file 参数除了本地路径,也支持 http(s) 远程 URL:工具会先把视频下载到临时目录,全部平台发布结束后自动清理。
账号与登录:矩阵的根基在登录态共享
矩阵运营的前提是多账号管理。矩媒里账号以手机号分组,每个账号在每个平台各有一份登录态,CLI 与图形界面共用同一个 session 分区(persist:<手机号><平台>),互不侵扰。登录方式有讲究:
- 抖音与视频号:CLI 直接支持扫码登录,终端里会打印二维码(抖音另支持 puppeteer 无头方式)。
- 其它平台:先在图形界面里登录一次,之后 CLI、HTTP、MCP 全部复用这份登录态。
- 登录态过期:
cli accounts会报cookie 已过期,回图形界面重新登录一次即可,不用逐个工具处理。
# 抖音扫码登录(终端出二维码)matrixmedia cli login -p dy --phone 13800138000
# 随时检查全部账号的登录态,适合放在自动化流程开头做 preflightmatrixmedia cli accounts --jsonaccounts 和 history 这两个查询命令只读本机数据,不会触发任何登录或发布动作,所以特别适合在流水线里做发布前检查:先确认目标账号在线,再决定要不要往下走。
图形界面:本地视频发布
图形界面的核心页是「本地视频发布」:选好视频文件,逐个平台填标题、简介、标签,再勾选要发的账号,一次提交。字段会按平台规则各自落地——抖音、快手、视频号把简介与标签拼进正文;小红书正文写简介、标签走话题控件;B 站简介和标签分开填;头条、百家号只写标题。视频号还有一个短标题字段(建议 6~16 字),和标题是两回事,别漏填。定时发布、创作声明这类选项在批量设置里统一配。
几个平台特有项值得单独说:
- 抖音商品挂载:在「本地视频发布 → 第三方属性」里可为每个账号配置一种商品,填完整商品链接和 1~10 字的商品短标题(注意这与视频号的短标题是两个独立字段)。官方说明该功能尚待有带货权限的真实账号验收,开启后任务只尝试一次,失败先人工核对再重试;目录批量发布配了抖音商品会被明确阻断,要改走单视频发布。
- 小红书真实浏览器发布模式:小红书对 Electron 内置窗口的自动化检测日趋严格,可能弹出「AI 托管」类警告。矩媒的对策是改用本机已安装的 Google Chrome 发布:在「账号管理 → 小红书账号 → 发布设置」里打开「使用真实浏览器」开关,首次开启会自动检测 Chrome 路径(也可以手动选
.app或.exe),点「测试连接」确认可用后保存。发布时它用 puppeteer-core 驱动本机 Chrome,并自动把内置窗口的登录态同步过去;若 Chrome 检测不到或启动失败,会自动回退到内置窗口模式。Chrome 路径是全局配置,所有小红书账号共用。
命令行:子命令、退出码与 JSON
在启动参数里带上 cli 子串即进入命令行模式,不打开主窗口。子命令一览:
| 子命令 | 支持平台 | 作用 |
|---|---|---|
cli login | 抖音、视频号 | 终端二维码扫码登录 |
cli publish | 8 个视频平台 | 发布视频,本地路径或远程 URL |
cli publish-article | 掘金 | 发布文章,--content 或 --file |
cli accounts | 全平台 | 列出账号并实时检测登录态 |
cli history | 全平台 | 查本机发布记录,可按平台、状态、天数过滤 |
cli stats | 7 个平台 | 读账号粉丝数据快照(粉丝、播放、点赞、评论、收藏) |
cli stats-sync | 7 个平台 | 主动采集最新数据并写入快照 |
cli stats-work | 7 个平台 | 按完整标题查某个视频的发布数据 |
cli comments | 抖音、快手、视频号 | 拉取已发布作品的评论列表(只读) |
cli comments-reply | 抖音、快手、视频号 | 回复评论,默认 dry-run |
每个子命令都支持 --help。真正让它能被程序消费的是这套统一约定:
| 约定项 | 内容 |
|---|---|
| 进入 CLI 模式 | 启动参数含 cli 即进入无 GUI 流程 |
| 退出码 | 0 成功 / 1 异常 / 2 参数错误 / 3 业务失败(登录、上传等) |
| 机器可读输出 | accounts --json、history --json 产出稳定 JSON |
| 登录态共享 | CLI 与 GUI 共用同一 session 分区 |
可直接抄的发布示例:
# 发抖音:标题、简介、标签一次给全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 "标题" --description "视频简介" --short-title "5公里新手挑战" --tags "#跑步 #新手"
# 发掘金文章matrixmedia cli publish-article -p juejin --phone 13800138000 -t "文章标题" --file ./post.md
# 查最近 7 天发布记录(JSON 输出,给上游程序消费)matrixmedia cli history --json --days 7数据统计是「先采集、再读快照」的两步:stats-sync 主动去平台抓最新数据写进本地快照,stats 和 stats-work 只读快照,所以查询瞬间返回、不必每次都惊动平台。
评论互动:默认 dry-run,真发要显式确认
cli comments 把抖音、快手、视频号已发布作品的评论拉回本地,归一化成统一 JSON。回复走 cli comments-reply,工作方式是先把回复内容写进一个 JSON 文件,再交给命令校验:
# 拉评论matrixmedia cli comments -p ks --phone 123
# 只校验、不真发(默认 dry-run)matrixmedia cli comments-reply -p ks --phone 123 --file replies.json
# 人工核准后,加 --execute 才真正发出matrixmedia cli comments-reply -p ks --phone 123 --file replies.json --execute不加 --execute 就永远只是校验,加了才会真发,整个过程全程留台账,事后能查每条回复的去向。这个「默认不动手」的设计对自动化场景很重要:脚本和智能体可以先把回复草稿批量生成好,人过目确认后统一放行。
HTTP 接口:GUI 开着,本机程序就能触发发布
图形界面启动后,应用会在本机 30088 端口监听一个内置服务,其它程序 POST 一个 JSON 就能触发发布:
curl -X POST http://127.0.0.1:30088/publish \ -H "Content-Type: application/json" \ -d '{ "phone": "13800138000", "file": "https://example.com/video.mp4", "title": "我的视频标题", "description": "视频简介", "shortTitle": "5公里新手挑战", "tags": "跑步 新手", "platforms": ["dy", "sph", "ks"] }'行为细节:单平台请求会等待上传完成再返回最终状态;多平台请求与图形界面的批量发布一致,提交到发布队列后立即返回,响应里 status 为 submitted,最终成败以发布记录为准。请求体里 file 必填(本地绝对路径或远程 URL,远程文件只下载一次供多平台共用),publishAt 可指定一次性定时发布(格式 YYYY-MM-DD HH:mm:ss,多平台时需全部一致)。错误语义也和 CLI 对齐:参数错误返回 HTTP 400;发布失败(如未登录)仍返回 HTTP 200,但 success: false、exitCode: 3,调用方按退出码判断即可,不用去猜 HTTP 状态。
与 CLI 的分工很清楚:HTTP 接口依赖 GUI 主进程已运行(窗口或托盘在就行),胜在接入简单;CLI 可以独立冷启动,胜在适合定时任务和流水线。
MCP 接入:让 AI 助手在对话里直接发布
仓库内置了 mcp/ 子包,实现了一个标准的 MCP Server,让支持 MCP 的 AI 工具不用绕 shell 就能直接操作矩媒。先构建一次:
cd mcp && npm install && npm run build然后在 Claude Desktop、Cursor、Cline 的 MCP 配置里加上(把路径换成本机仓库的绝对路径):
{ "mcpServers": { "matrixmedia": { "command": "node", "args": ["<MATRIXMEDIA_DIR>/mcp/dist/index.js"], "env": { "MATRIXMEDIA_DIR": "<MATRIXMEDIA_DIR>" } } }}重启 AI 工具后,以下 9 个工具即可在对话中直接调用:
| 工具 | 说明 |
|---|---|
list_accounts | 列出本机已登录账号,支持按平台过滤 |
list_history | 查询本机发布记录,支持按平台、状态、天数过滤 |
publish_video | 发布视频到指定平台(最长 35 分钟,支持定时发布) |
publish_article | 发布掘金文章(需已登录掘金账号) |
get_account_stats | 读取账号粉丝数据快照 |
sync_account_stats | 主动采集最新数据并写入快照 |
get_work_stats | 按完整标题查某个视频的发布数据 |
list_comments | 拉取已发布作品的评论列表(抖音、快手、视频号,只读) |
reply_comment | 回复评论,默认 dry-run,confirm=true 才真发 |
有一个前提必须记牢:所有平台都要先在图形界面里登录,MCP 运行在无头环境,弹不出扫码窗口。所以正确顺序永远是:装好应用 → 界面里把号登全 → 再接 MCP。reply_comment 的 dry-run 默认值也延续了 CLI 的克制:助手可以起草,真发必须显式确认。
为什么它适合交给智能体
把上面几节串起来看,矩媒为自动化准备的其实是一整套契约:参数里带 cli 就进无头模式;退出码四档语义稳定;查询类命令输出稳定 JSON;登录态在 GUI、CLI、HTTP、MCP 之间共享一份;危险动作(回评论)默认 dry-run、全程台账。这意味着它与具体框架无关——Claude Code、Codex 这类编程智能体,Cursor、Cline 这类 IDE 助手,以及 Dify、n8n 这类工作流编排平台(参见 Dify 工作流篇),只要能调用外部命令、读退出码或接 MCP,就能把矩媒当成发布环节接进去。仓库甚至在顶部留了给智能体生态的可发现注释标记,声明自己的 CLI 入口与约定。
放到整条创作流水线里看分工更清楚:上一篇介绍的 Toonflow 负责生产端——剧本、分镜、角色资产到视频片段都在一张画布里完成;矩媒负责分发端——成片出来后,一条命令或一次 MCP 调用就铺到 8 个平台。生产与分发各交给一个开源工具,中间用 CLI 与 MCP 串起来,就是一条能跑通的短视频流水线。而 CLI 助手篇 里讲的那些命令行智能体,正好是最适合站在中间发号施令的角色。
风险与边界:自动化发布不是没有代价
WARNING矩阵批量发布本质上是自动化操作各平台的创作者后台,而每个平台对自动化行为的规则与风控尺度各不相同。同一条视频短时间内铺满全平台、多账号发高度重复的内容、发布频率明显超出真人节奏,都可能触发平台的限流、审核拦截,严重的直接封号。这类风险与工具无关,是这类玩法自带的。
实操上克制一点:发布频率贴近真人节奏,各平台的标题、简介、标签做差异化而不是一字不差地复制;新号、刚养的号先小批量试水,确认账号状态正常再放大;重要账号不要和测试账号混在同一批任务里。账号 Cookie、本地素材都属于敏感数据,只存在本机、妥善保管。工具自带的使用声明也写明了:仅用于合法合规的学习与效率提升场景,不要用于批量作弊、恶意营销、侵权搬运与刷量。
常见问题与排障
终端里提示找不到 matrixmedia 命令?
Windows 先确认装的是 0.4.5 之后的安装包(会自动写 PATH),并重开终端;macOS 按上文建好符号链接,或临时用 alias 指向 App 内的可执行文件。
macOS 提示「已损坏,无法打开」? 多半是 Gatekeeper 拦截未签名应用,并非安装包真损坏。先确认下的是与芯片匹配的包(Apple Silicon 用 arm64 版),把 App 拖进「应用程序」后执行一次:
xattr -dr com.apple.quarantine /Applications/matrixmedia.appcli accounts 报 cookie 已过期?
回图形界面把该平台重新登录一次即可,CLI、HTTP、MCP 共用同一份登录态,不用逐处处理。
在 MCP 里发布失败,或提示未登录?
MCP 无头环境无法扫码。先打开图形界面确认对应平台账号在线,再回助手里重试;也可以先用 list_accounts 让助手自查一遍登录态。
HTTP 接口连不上(30088 端口无响应)?
这个接口依赖 GUI 主进程运行,先把应用打开(窗口或托盘在即可)。参数错误会返回 HTTP 400,先对照字段表检查请求体;发布类失败返回的是 HTTP 200 加 exitCode: 3,别只看状态码。
comments-reply 执行了却没发出回复?
默认就是 dry-run,只做校验并写台账。确认内容无误后,加 --execute 重新执行才是真发。
小红书发布时弹出自动化/托管类警告? 去「账号管理 → 小红书账号 → 发布设置」开启「使用真实浏览器」,用本机 Chrome 发布;开启后点一次「测试连接」,若检测不到 Chrome 会自动回退内置窗口,那就先把 Chrome 装好或手动指定路径。
启动时提示 ELECTRON_RUN_AS_NODE 相关错误?
该环境变量被误开启会导致启动异常,按提示先关闭它再启动应用。
小结
矩媒解决的是短视频流水线的最后一公里:一条视频从成片到铺满 8 个平台,从半小时的重复劳动变成一次提交。它真正的分量不在图形界面,而在界面之下那套为自动化准备的契约——退出码、JSON 输出、登录态共享、危险动作默认 dry-run,这四样齐了,一个发布工具才算得上能交给智能体的基础设施。手动发用 GUI,定时批量用 CLI,本机程序联动用 HTTP,想让 AI 助手直接上手就接 MCP;再往前接上 Toonflow 这类生产工具,一条从创作到分发的完整链路就成型了。只记住一条底线:能力越自动,节奏越要克制,账号安全永远排在效率前面。