企业官网建设流程全解析

MatrixMedia（矩媒）是一款面向自媒体的视频矩阵批量发布工具，基于 Vue + Electron + Puppeteer 构建。它让你把一个视频一键分发到抖音、快手、小红书、视频号、哔哩哔哩、头条、百家号、番茄视频等 8 个平台，同时支持图形界面（GUI）、命令行（CLI）、HTTP API 与 MCP 智能体接入，是个人创作者和矩阵运营者做跨平台内容分发的实用选择。

这篇文章面向新手，按「下载安装 → 登录账号 → 一键批量发布 → 进阶自动化」的顺序，带你 10 分钟走完整个上手流程。

上手前：MatrixMedia 矩媒能做什么

在开始之前，先快速了解它的核心能力，方便你选择最适合自己的一条路：

💡 新手建议：先走 GUI 完成一次发布，熟悉账号登录与发布流程后，再按需解锁 CLI 与 API 能力。

第一步：下载并安装 MatrixMedia 矩媒

矩阵媒支持 Windows、macOS 和 Linux（x64 / arm64），从项目 Releases 页面下载对应系统的安装包即可，无需额外依赖。

Windows：双击安装即可用

下载MatrixMedia-<version>-win-x64.exe，双击安装。0.4.5版本起，安装程序会自动把应用目录加入当前用户PATH并固定命令名为matrixmedia——重新打开终端后，直接就能执行 CLI 命令，无需任何配置。

macOS：注意芯片架构与「仍要打开」

下载 dmg 前先看一眼芯片类型：Apple Silicon（M1/M2/M3/M4）请选mac-arm64包，Intel 选mac-x64包。把 app 拖进「应用程序」后，首次打开通常会被系统拦截：

进入「系统设置 → 隐私与安全性」，点击「仍要打开」，之后双击图标即可正常启动。命令行用户还可以执行一次符号链接，让matrixmedia全局可用：

sudo ln -sf /Applications/matrixmedia.app/Contents/MacOS/matrixmedia /usr/local/bin/matrixmedia

Linux：四种包格式任选

⚠️ AppImage / tar.gz 若启动报错，一般是缺 Electron 运行库，按发行版apt或dnf补齐libgtk-3-0、libnss3等依赖即可，详见 website/guide/getting-started.md。

第二步：首次打开——管理账号并登录各平台

启动应用后，默认进入「项目详情」页（源码见 src/renderer/views/projectDetail/index.vue），这里会展示 HTTP / MCP / CLI 三种接入方式的说明摘要，可以先扫一眼。

接着进入「账号管理」（src/renderer/views/accountManager/index.vue）：

1. 按平台分组添加账号（用手机号或自定义名称区分同一平台的多个账号，例如138****0001 抖音）；
2. 逐一点开各平台账号的登录入口，扫码完成登录；
3. 登录态会自动保存在本机，与 CLI、HTTP API共享同一份会话，GUI 登录一次，命令行和 API 都能复用。

📌小红书特别提示：小红书对内置窗口的自动化检测日趋严格。如果发布时出现「AI 托管」警告，可在账号管理的「发布设置」中打开「使用真实浏览器」开关，矩阵媒会自动检测本机 Chrome / Chromium 并用它完成发布，从根本上规避检测（实现见 src/main/services/upLoad/xhsChrome.js）。

第三步：一键批量发布视频

账号就绪后，打开「本地视频发布」（src/renderer/components/LocalVideoPublish.vue），这是整个工具的主战场：

1. 选择视频文件：支持本机视频，也支持http(s)远程 URL（自动下载，发布完自动清理临时文件）；
2. 填写元数据：标题、简介、标签；其中「短标题」仅视频号消费，各平台字段写入规则会自动适配（如小红书的标签走话题控件、哔哩哔哩标签独立填写）；
3. 勾选目标账号：可同时勾选多个平台、多个账号，一次提交即可排队批量分发；
4. 可选定时发布：通过--publish-at/ 界面定时选项设置YYYY-MM-DD HH:mm:ss，到点自动执行；
5. 提交后任务进入发布队列，状态与历史可在发布记录中回查，失败的会保留失败截图便于排查。

🎯 批量发布的本质是把「登录一次 → 选文件 → 填信息 → 勾选账号 → 提交」压缩成一次操作，这就是矩阵运营的效率来源。多平台分发时远程视频 URL 只下载一次，再分发到各账号，带宽和时间都省了。

第四步（进阶）：用 CLI 命令行批量发布

安装后无需打开窗口，同一可执行文件就是一条完整的 CLI。常用子命令一览：

抖音与视频号支持终端二维码登录（无需弹窗）；其他平台先在 GUI 登录一次即可，CLI 会自动复用会话。典型流程：

# 抖音终端二维码登录 matrixmedia cli login -p dy --phone 13800138000 # 一键发布（简介、标签；远程 URL 同样可用） matrixmedia cli publish -p dy --phone 13800138000 -f /path/to/video.mp4 \ -t "标题" --description "视频简介" --tags "#跑步 #新手" # 查询账号状态与发布历史（JSON 输出，方便接入脚本） matrixmedia cli accounts --json matrixmedia cli history --json --days 7

子命令完整参数见 docs/cli.md，CLI 入口源码在 src/main/cli/index.js。无显示器或 SSH 环境可配合xvfb-run -a提供虚拟显示。

第五步（进阶）：HTTP API 与 AI 智能体接入

HTTP API：GUI 启动后，应用自动在本机 30088 端口监听内置服务，一条curl就能触发发布（路由实现见 src/server/routes/index.js）：

curl -X POST http://127.0.0.1:30088/publish \ -H "Content-Type: application/json" \ -d '{"platforms":["dy","sph","ks"], "phone":"13800138000", "file":"/path/to/video.mp4", "title":"我的视频"}'

多平台请求会立即返回submitted并进入发布队列，与 GUI 批量发布行为一致。完整字段说明见 docs/http-api.md。

MCP Server：仓库内置mcp/子包（mcp/src/index.ts），让 Claude Desktop、Cursor、Cline 等工具无需 shell 调用即可直接操作矩阵媒，提供list_accounts、publish_video、get_work_stats等 7 个工具，详见 docs/mcp.md。

常见问题速答

Q：提示「cookie 已过期」怎么办？A：CLI 与 GUI 共用会话，登录态过期时回到 GUI 重新扫码登录一次即可，后续cli publish自动恢复可用。

Q：CLI 启动报require('electron') 异常？A：多半是环境变量ELECTRON_RUN_AS_NODE被设置为1。执行unset ELECTRON_RUN_AS_NODE，或按提示显式清空后再启动。

Q：macOS 提示「已损坏，无法打开」？A：通常不是真损坏，而是 Gatekeeper 拦截。执行一次xattr -dr com.apple.quarantine /Applications/matrixmedia.app后即可正常双击打开。

Q：哪些平台能完全自动化？A：抖音、快手、百家号、哔哩哔哩、头条、视频号、小红书、番茄视频 8 个平台均已实现 CLI/GUI/HTTP 自动发布；掘金走publish-article文章发布通道。

写在最后

到这里，你已经掌握了矩阵媒从安装、登录到一键批量发布的完整路径：

1. 安装：Windows 双击即装；macOS 拖入应用程序后「仍要打开」；
2. 登录：账号管理里逐平台扫码，登录态全端共享；
3. 发布：本地视频发布页勾选多平台多账号，一次提交批量分发；
4. 进阶：CLI、HTTP API、MCP 三条自动化通道随取随用。

更多参考：快速开始 · CLI 参考 · HTTP API · MCP

⚖️ 温馨提示：本项目仅用于合法合规的学习与效率提升场景，请遵守各平台服务协议与法律法规，避免用于刷量、侵权搬运等违规用途。