矩媒 MatrixMedia：多平台视频矩阵分发工具，支持CLI/HTTP/MCP三模接入

矩媒（MatrixMedia）是一款基于 Electron 的自媒体矩阵发布工具，专为批量向多平台账号分发视频设计。提供图形界面与命令行（CLI）双模式，已完整自动化抖音、快手、百家号、哔哩哔哩、头条号、视频号、小红书、番茄视频共8个平台的发布流程。CLI 采用 AI 工具无关设计，通过统一退出码与 JSON 输出约定，可被 OpenClaw、Claude Code、Dify、n8n 等任意智能体或工作流框架直接调用。GUI 启动后暴露本地 HTTP API（POST http://127.0.0.1:30088/publish），并内置 MCP Server 支持 Claude Desktop/Cursor/Cline 原生集成。针对小红书反自动化检测，新增真实浏览器发布模式，通过 puppeteer-core 驱动本机 Chrome 规避风控。

• GitHub：https://github.com/hanliang97/MatrixMedia
• 网盘：https://pan.quark.cn/s/596aebdeb3e4

核心架构：三模接入与AI编排友好设计

MatrixMedia 的核心价值在于将“平台发布”抽象为标准化外部服务，其接入层设计充分考虑了自动化生态的多样性：

CLI 模式：Shell 友好的原子命令

• 触发条件：argv 含 cli 子串即进入无 GUI 流程
• 子命令集：login（抖音/视频号扫码）、publish（8平台视频）、publish-article（掘金文章）、accounts（登录态检测）、history（发布记录查询）
• 机器可读契约：
  • 退出码：0=成功 / 1=异常 / 2=参数错误 / 3=业务失败
  • JSON 输出：--json 标志产出稳定结构，便于上游解析
• 会话共享：CLI 与 GUI 共用 persist:<phone><平台> session partition，GUI 登录后 CLI 自动复用，无需重复认证

HTTP API：GUI 驻留时的轻量接口

• 端点：POST http://127.0.0.1:30088/publish
• 适用场景：其他程序在 GUI 运行时触发布局，避免冷启动开销
• 文档：应用内「项目详情」页或 docs/http-api.md

MCP Server：AI 工具的原生能力扩展

• 构建：cd mcp && npm install && npm run build
• 配置：在 Claude Desktop/Cursor/Cline 的 MCP 配置中添加 stdio transport，指向 mcp/dist/index.js
• 可用 Tool：
  • list_accounts：按平台过滤已登录账号
  • list_history：按平台/状态/天数筛选发布记录
  • publish_video：发布视频（≤35分钟，支持定时）
  • publish_article：发布掘金文章
• 关键限制：MCP 运行于无头 stdio 环境，无法弹出扫码窗口；所有平台需先在 GUI 完成登录

这种分层设计使 MatrixMedia 既能作为独立桌面工具使用，又能无缝嵌入复杂自动化流水线——无论上游是 shell 脚本、HTTP 客户端还是 LLM Agent，都能找到匹配的接入方式。

平台自动化现状与小红书特殊处理

已完整自动化平台（8个）
抖音、快手、百家号、哔哩哔哩、头条号、视频号、小红书、番茄视频。CLI publish 命令对这8个平台行为一致，file 参数支持本地路径或 http(s) URL（远程文件自动下载，上传后清理临时文件）。

小红书反检测对策：真实浏览器模式
由于小红书对 Electron 内置窗口的自动化检测日趋严格，可能触发「AI 托管」警告甚至封号风险，MatrixMedia 提供专属解决方案：

• 启用路径：账号管理 → 小红书账号 → 「发布设置」→ 开启「使用真实浏览器」
• 工作原理：
  1. 使用轻量级 puppeteer-core（不捆绑 Chromium）驱动本机已安装的 Chrome/Chromium
  2. 发布时自动从内置窗口同步 Cookie 到真实浏览器实例
  3. Chrome 路径全局配置（userData/chrome-config.json），所有小红书账号共用
  4. 若 Chrome 不可用或启动失败，自动回退至内置窗口模式
• 配置要点：
  • macOS 选择 .app 包，Windows 选择 .exe 可执行文件
  • 首次开启后务必点击「测试连接」验证可用性
  • 真实浏览器模式下，发布过程可见窗口操作，更接近人工行为特征

此方案从根源上规避指纹检测，但牺牲了部分静默性；建议高风险账号优先启用，低风险批量号可继续用内置窗口以提升效率。

部署实践与集成注意事项

安装与启动

• GUI：下载对应平台安装包（Windows/macOS），双击运行
• CLI：matrixmedia cli <subcommand> 或通过源码 npm run cli -- <args>
• MCP：构建后按工具要求配置 stdio transport，重启 AI 工具生效

AI 集成最佳实践

• 登录前置：除抖音/视频号支持 CLI 扫码外，其余平台必须先在 GUI 登录一次
• 错误处理：根据退出码区分参数错误（2）与业务失败（3），前者需修正调用方，后者可能需要重新登录或检查平台规则
• 并发控制：同一平台多账号发布建议串行执行，避免触发平台频率限制
• 会话保鲜：长期运行的自动化应定期调用 cli accounts --json 检测登录态，失效时及时告警

已知边界与风险

• 平台策略变动：各平台反爬/反自动化机制持续升级，工具可能阶段性失效；建议关注仓库 issue 区与更新日志
• 内容合规责任：工具仅解决“发布”技术问题，内容合法性、版权、广告法合规由使用者自行承担
• Chrome 依赖：真实浏览器模式要求本机安装 Chrome/Chromium，纯服务器环境无法使用
• MCP 功能局限：当前仅4个 tool，未覆盖全部 CLI 能力；如需扩展可自行修改 mcp/src/tools.ts
• 数据安全：session partition 存储于本地 userData 目录，敏感账号建议加密磁盘或隔离用户环境

对于个人创作者，MatrixMedia 是多平台分发的效率倍增器；对于 MCN 或营销团队，其标准化接入能力使其成为自动化内容工厂的关键组件。但需清醒认知：它降低的是操作成本，而非运营风险。真正的矩阵竞争力仍在于内容质量与平台理解，工具只是让这份理解更高效地触达受众。