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

一行装好 · 看它跑一遍 · 怎么配合 · 各平台的坑 · 作者
一个人做内容,要发六七个平台,每个平台的文案、封面、发布形式都不一样;发完还想知道哪期起来了、哪个平台涨粉、哪个平台真的带来了付费。麦田就是我自己每天在用的那套工作台:
跑在一台常开的 Mac 上,用你自己登录好的浏览器操作各平台,不存任何平台密码。国内四家只填写不发布,最后一下由你自己点。

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

大屏(演示数据,node src/demo.mjs 就能看到)
| 日历:分发计划 | 单期复盘:同龄对比 | 每期转化漏斗 |
|---|---|---|
![]() |
![]() |
![]() |

| 部分 | 做什么 | 在哪 |
|---|---|---|
| 发布 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 的接口接入 |
看站点 |
sync 会拿平台记录的定时和计划比对,不一致发 ⚠️ 卡片。curl 127.0.0.1:9333/json/close/<id> 关掉卡住的标签页,不会触发「离开此网站」确认。 ┌────────────── Mac(常开)──────────────┐
NAS 发布工程 │ hub.mjs 守护进程 ──── 专用 Chrome(CDP 9333)── 各平台创作者后台
publish.json ─▶│ │ ▲ ▲ │
成片/封面 │ │ │ 平台适配器(麦田发布助手 lib/) │
│ ▼ │ │
│ SQLite(data/hub.db) ── web.mjs(麦田网页 :8787)── 手机/电脑(可选 Cloudflare 隧道)
│ │ │
│ └── feishu.mjs ──▶ 飞书群机器人(卡片通知) │
└───────────────────────────────────────────────┘
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 装的就是它)
| 项 | 说明 |
|---|---|
plugin |
store(默认):用专用 Chrome 里从应用商店装的麦田发布助手 |
rootPath / nasUrl |
发布工程根目录;NAS 掉线或被挂到「…-1」时守护进程会自己卸掉重挂 |
batches |
上传批次。一次传太多平台会互相抢带宽导致超时,建议国内两两一批 |
auto / manual |
自动提交 / 等你点发布的平台 |
keepAlive |
容易掉登录的平台(视频号),定时刷一下保活 |
site |
自有站点,可选,见下 |
board |
飞书多维表格看板,可选 |
web.key |
网页口令,所有页面和接口没有口令一律 401 |
不配 config.site 就整块关掉,网页上不显示站点卡片,「转化」页只说明怎么接。要看转化:
utm_campaign=<主题>-<序号>;你的站点记下访客第一次带来的这个参数,注册和下单时一起存。src/site.mjs 顶部注释。config.site 里填站点地址和接口路径。作者用自己的课程站做了示例;你的站结构不同,改 src/site.mjs 和转化页即可。
scripts/install-launchd.sh --tunnel 会装一个 cloudflared 隧道,地址推到飞书。
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 天注册和收入,点一下打开麦田。
config.json 的 web 里加 "widgetToken": "<一串随机字符>"(只读口令,只能读 /api/widget 的汇总数字);想在小组件上显示头像和署名,再加 "avatar": "data/avatar.jpg"、"owner": "你的名字"(中号、大号还会显示最新一期封面)/widget,按页面提示装 Scriptable、复制脚本(地址和口令已填好)。复制的是一个加载器:每次刷新从麦田的 /api/widget/code 拉最新的 scripts/widget/maitian-widget.js 来运行,以后改样式手机上自动生效,拉不到就用上次存下的那份另外,Safari 里「分享 → 添加到主屏幕」可以把麦田当 App 用(全屏、带麦苗图标)。
config.json、data/(数据库、日志)、chrome-profile/(各平台登录态)都不进 git。config.json 里加 "learnLinks": false。我是麦当,做 0 基础 AI Agent / AI Coding 教程。麦田是照着我自己的发布流程一点点搭起来的,一边发视频一边在改。
想一起聊麦田、多平台运营的,微信扫码进群(1、2 群已满,现在开的是 3 群):

微信群码 7 天有效(这张 11 月 24 日前可扫),我会定期换;扫不进去就提个 Issue 喊我一声。
觉得有用就点个 ⭐ Star,这是我继续改下去的动力;遇到问题直接提 Issue。
MIT