mdldm-maitian README

项目的 README,来自 github.com/CzzzzzzJ/mdldm-maitian。合并为一个 markdown 文件:README.md。

麦田 · 给多平台博主的开源工作台

MIT macOS Node 22.5+ 麦田发布助手 Stars

一行装好 · 看它跑一遍 · 怎么配合 · 各平台的坑 · 作者

一个人做内容,要发六七个平台,每个平台的文案、封面、发布形式都不一样;发完还想知道哪期起来了、哪个平台涨粉、哪个平台真的带来了付费。麦田就是我自己每天在用的那套工作台:

  1. 发得出去:一期视频分批填好 B站、抖音、小红书、视频号、YouTube、X、Instagram,提前排进「分发计划」,到点发布、自动取链接。
  2. 看得清楚:每期在每个平台的播放、互动,各平台粉丝,每天自动采、长期留存;手机上看大屏,飞书群推卡片。
  3. 算得出钱:接上你自己的站点,看哪一期、哪个平台带来了注册和收入。

跑在一台常开的 Mac 上,用你自己登录好的浏览器操作各平台,不存任何平台密码。国内四家只填写不发布,最后一下由你自己点。

看它跑一遍

一期视频的发布流程:Agent 写文案 → 进分发计划 → 插件分批填写各平台 → 国内平台你来点发布 → 到点回填链接

一期视频从写文案到上线(47 秒,各平台发布页为示意,数据是作者第 4 期的真实文案和封面)· 高清 MP4

麦田大屏:最新一期轮播、粉丝、数据分析、各平台卡片(演示数据)

大屏(演示数据,node src/demo.mjs 就能看到)

日历:分发计划 单期复盘:同龄对比 每期转化漏斗
日历 单期复盘 转化漏斗

怎么配合

发布 skill → 麦田发布助手 → 麦田

部分 做什么 在哪
发布 skill 让 AI 助手(Claude Code / Codex)看片、写各平台文案、生成发布工程并校验 本仓库 skills/maitian-publish
麦田发布助手 Chrome 插件,各平台适配器:打开上传页、传视频和封面、填文案、设定时 Chrome 应用商店(装进麦田的专用 Chrome,自动更新)
麦田(本仓库) 分发计划、调度、防重、等你点发布、取链接、采数据、网页大屏、飞书通知 本仓库

链路:成片 → skill 写「发布素材.md」→ 生成 publish.json → hub plan 进分发计划 → hub run 分批填写 → 国内平台你点发布 → 到点取链接 → 每天采数据 → 大屏和飞书卡片。

一行装好

bash -c "$(curl -fsSL https://raw.githubusercontent.com/CzzzzzzJ/mdldm-maitian/main/scripts/install.sh)"

下载麦田和发布助手到 ~/maitian/、接上发布 skill、打开安装向导;向导问完几个问题,生成配置、装好开机自启、打开各平台登录页。需要 macOS、Node.js ≥ 22.5、Google Chrome。

Windows(社区贡献,感谢 ajin558;开机自启暂未适配):

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/CzzzzzzJ/mdldm-maitian/main/scripts/install-windows.ps1 | iex"

同样下载到 %USERPROFILE%\maitian\、接上发布 skill、打开安装向导,安装目录里另有 4 个双击启动器(演示 / 登录 / 体检 / 启动)。需要 Windows 10/11、Node.js ≥ 22.5、Google Chrome;缺 Git / Node 时脚本会用 winget 自动补装。开机自启暂未适配(向导里的 launchd 步骤会自动跳过),可用任务计划程序指向安装目录的 4-start.bat 代替。

一行安装演示

手动安装

或者手动:

需要:macOS、Node.js ≥ 22.5(用到内置 node:sqlite)、Google Chrome;可选 NAS(放成片)、飞书群机器人、cloudflared。

git clone https://github.com/CzzzzzzJ/mdldm-maitian.git && cd mdldm-maitian
node src/demo.mjs                       # 先用假数据看看效果:http://localhost:8788/?key=demo
node src/init.mjs                       # 安装向导:检查环境、生成 config.json、装开机自启;在专用 Chrome 里从应用商店添加麦田发布助手、登录各平台
node src/hub.mjs doctor                 # 登录完检查各平台登录态和上传页(不上传、不填写)

打开向导最后给出的地址(http://localhost:8787/?key=<web.key>),之后浏览器会记住口令。手动安装也可以:cp config.example.json config.json 填好后跑 scripts/install-launchd.sh。

三级上手

级别 你能得到 要装的 大概时间
L1 只看数据 各平台粉丝、已发作品的播放互动、大屏、飞书日报 麦田;专用 Chrome 里登录各平台;已发的期用 hub adopt 登记 30 分钟
L2 分发 一期一次填好七个平台,定时,自动取链接 + 麦田发布助手(应用商店装进专用 Chrome);+ 发布 skill(或手写 publish.json) 再 1 小时
L3 转化 每期带来的注册和收入 + 你自己的站点按 src/site.mjs 的接口接入 看站点

它做什么

各平台的坑(实战总结)

架构
            ┌────────────── Mac(常开)──────────────┐
NAS 发布工程 │  hub.mjs 守护进程 ──── 专用 Chrome(CDP 9333)── 各平台创作者后台
publish.json ─▶│     │  ▲                 ▲                       │
成片/封面     │     │  │ 平台适配器(麦田发布助手 lib/)       │
            │     ▼  │                                          │
            │  SQLite(data/hub.db) ── web.mjs(麦田网页 :8787)── 手机/电脑(可选 Cloudflare 隧道)
            │     │                                              │
            │     └── feishu.mjs ──▶ 飞书群机器人(卡片通知)       │
            └───────────────────────────────────────────────┘
  • 平台填写逻辑在 麦田发布助手(Chrome 插件)里。插件从应用商店装进麦田的专用 Chrome 后由 Chrome 自动更新,麦田直接加载专用 Chrome 里这份插件的发布引擎(src/plugin.mjs),平台改版时插件更新一次,所有人自动生效。src/chrome-shim.mjs 在 Node 里模拟插件需要的 chrome.tabs / chrome.debugger。
  • 发布工程 publish.json 由 src/make-publish.mjs 从一份 Markdown 发布素材生成,src/validate.mjs 校验(字数、禁词、封面比例、成片 faststart 等),字段规则跟着插件走。
命令
node src/hub.mjs plan [工程目录]            # 登记进分发计划(不带目录 = 扫描 rootPath)
node src/hub.mjs run <工程目录> [--only x,zsz] [--force] [--now]   # 发一期;--now 让站点课程立即上线(默认推迟到定时前 30 分钟)
node src/hub.mjs status [id] [--logs]
node src/hub.mjs sync <id> [--only a,b]     # 取链接,写 发布记录.json,回填发布素材 md 的「已发布」行
node src/hub.mjs mark <id> <平台> <状态> [备注] [--url 链接]   # 手动改状态(平台认不出时用)
node src/hub.mjs adopt <工程目录>            # 登记一期已经发过的(不上传),按标题取链接
node src/hub.mjs metrics [id]               # 采流量并发日报
node src/hub.mjs followers                  # 采粉丝
node src/hub.mjs review <id> [天数] [--notify]   # 看某期发布 N 天的复盘(守护进程会在第 1/3/7 天自动发)
node src/hub.mjs weekly [--notify]          # 上周周报(守护进程每周一自动发)
node src/hub.mjs board                      # 同步到飞书多维表格(可选)
node src/hub.mjs daemon                     # 常驻(install-launchd.sh 装的就是它)
配置要点(config.json)
项 说明
plugin store(默认):用专用 Chrome 里从应用商店装的麦田发布助手
rootPath / nasUrl 发布工程根目录;NAS 掉线或被挂到「…-1」时守护进程会自己卸掉重挂
batches 上传批次。一次传太多平台会互相抢带宽导致超时,建议国内两两一批
auto / manual 自动提交 / 等你点发布的平台
keepAlive 容易掉登录的平台(视频号),定时刷一下保活
site 自有站点,可选,见下
board 飞书多维表格看板,可选
web.key 网页口令,所有页面和接口没有口令一律 401
接入你自己的站点(可选,二次开发)

不配 config.site 就整块关掉,网页上不显示站点卡片,「转化」页只说明怎么接。要看转化:

  1. 发布 skill 会在 B站、YouTube、X 的链接上带 utm_campaign=<主题>-<序号>;你的站点记下访客第一次带来的这个参数,注册和下单时一起存。
  2. 站点提供两个只读接口给麦田(用专用 Chrome 里的管理员登录态去调),字段见 src/site.mjs 顶部注释。
  3. 在 config.site 里填站点地址和接口路径。

作者用自己的课程站做了示例;你的站结构不同,改 src/site.mjs 和转化页即可。

远程访问(可选)

scripts/install-launchd.sh --tunnel 会装一个 cloudflared 隧道,地址推到飞书。

  • 固定域名(推荐):域名交给 Cloudflare 后,跑 cloudflared tunnel login、cloudflared tunnel create maitian、cloudflared tunnel route dns maitian maitian.你的域名,在 config.json 里加 "tunnel": { "name": "maitian", "hostname": "maitian.你的域名" }。地址永远不变,建议再在 Cloudflare Zero Trust 里给它加一层邮箱验证码登录(Access → Self-hosted 应用),然后在 config.json 的 web.access 填团队域名和应用的 AUD Tag:麦田会验证 Access 签发的登录凭证,手机上输邮箱收验证码就能进,不用再带 ?key=。
  • 飞书验证码登录(推荐,零配置):config.json 的 web 里加 "login": "feishu"。远程打开麦田会先到登录页,点「发送验证码」,6 位码推到飞书群,输入后这台设备记住 30 天;验证码 5 分钟有效、只能用一次、错 5 次作废,60 秒内只能发一次。?key= 口令仍可用作备用。
  • 快速隧道(默认):不配 tunnel 时用 https://xxx.trycloudflare.com,不用账号,但每次重启地址都会变。

手机小组件(可选)

iPhone 桌面 / 锁屏常驻显示全平台粉丝、今日涨粉、最新一期播放、站点近 7 天注册和收入,点一下打开麦田。

  1. config.json 的 web 里加 "widgetToken": "<一串随机字符>"(只读口令,只能读 /api/widget 的汇总数字);想在小组件上显示头像和署名,再加 "avatar": "data/avatar.jpg"、"owner": "你的名字"(中号、大号还会显示最新一期封面)
  2. 手机上登录麦田后打开 /widget,按页面提示装 Scriptable、复制脚本(地址和口令已填好)。复制的是一个加载器:每次刷新从麦田的 /api/widget/code 拉最新的 scripts/widget/maitian-widget.js 来运行,以后改样式手机上自动生效,拉不到就用上次存下的那份
  3. 桌面添加 Scriptable 小组件(小 / 中 / 大),锁屏也可以加(长条 / 圆形 / 单行),Script 选它

另外,Safari 里「分享 → 添加到主屏幕」可以把麦田当 App 用(全屏、带麦苗图标)。

数据和隐私

作者

麦当 mdldm · 0 基础 AI Agent 教学博主 · mdldm.club 知识站

我是麦当,做 0 基础 AI Agent / AI Coding 教程。麦田是照着我自己的发布流程一点点搭起来的,一边发视频一边在改。

交流群

想一起聊麦田、多平台运营的,微信扫码进群(1、2 群已满,现在开的是 3 群):

微信群:麦当 mdldm 的麦田 3 群

微信群码 7 天有效(这张 11 月 24 日前可扫),我会定期换;扫不进去就提个 Issue 喊我一声。

觉得有用就点个 ⭐ Star,这是我继续改下去的动力;遇到问题直接提 Issue。

Star History

Star History Chart

License

MIT

mdldm-maitian (CzzzzzzJ/mdldm-maitian)

正在搜索数据库…

这是什么?Maitian(麦田)是一个控制面板,供单打独斗的创作者使用,让他们把同一条视频发布到多个平台。它可以在 Bilibili、Douyin、Xiaohongshu、WeChat Channels、YouTube、X 和 Instagram 上填写上传表单,安排定时发布,并在仪表盘上跟踪播放量、粉丝数和 Feishu 通知。
它是桌面应用、网站还是浏览器扩展?两者兼有。调度器和仪表盘在 Mac 上本地运行,各平台的填表逻辑则放在一个 Chrome 扩展程序里,该扩展在专用的 Chrome 配置文件中运行。你可以在浏览器中查看仪表盘,也可以选择用手机查看。
我该怎么把它跑起来?将 Maitian 和发布助手下载到 ~/maitian/,加载 publish skill,然后运行安装向导。向导会生成配置文件,设置 macOS 开机自启,并打开各平台的登录页面。第一级(只显示数据)大约需要 30 分钟。
我得先装好什么?macOS(Windows 10/11 为社区移植版)、Node.js 22.5 或更新版本(用于内置的 node:sqlite),以及 Google Chrome。可选附加项包括用于存放视频文件的 NAS、用于接收通知的 Feishu 群机器人,以及用于远程访问的 cloudflared。
它会自动发布到每个平台吗?不会。Bilibili、Douyin、Xiaohongshu 和 WeChat Channels 只会填好表单就停下,需要你自己点击发布。X、YouTube、Instagram 和你自己的网站会在读回并检查表单后自动提交。
作者为什么要做这个?作者独自在六到七个平台上发布内容,每个平台的文案、封面和格式都不同。麦田是一个统一的工作台,用来发布内容、查看数据,并看出哪一集带来了注册和收入。
我能在做任何设置之前先看看效果吗?可以。运行 node src/demo.mjs 即可打开大屏展示,使用演示数据,无需任何平台账号。
仪表盘会为每一集显示什么?每个平台的播放量和互动数据、与上一集同期的对比、粉丝增长,以及发布后第 1、3、7 天的复盘卡片。每周一会收到一份周报。
它能看出哪一集带来了注册和收入吗?可以,但需要你自己配置。通过 src/site.mjs 中描述的接口接入你自己的网站后,转化页面会显示每一集从播放到注册、会员和收入的转化漏斗。没有网站的话,这部分功能保持关闭。
作者
CzzzzzzJ
大小
4.4 MB
星标
1K
时长
4天
提交 · 90 天