mdldm-maitian README

The project's README from github.com/CzzzzzzJ/mdldm-maitian. As one markdown file: 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)

Searching Database…

What is this?Maitian (麦田) is a control panel for solo creators who publish the same video to many platforms. It fills upload forms on Bilibili, Douyin, Xiaohongshu, WeChat Channels, YouTube, X and Instagram, schedules posts, and tracks views, followers and Feishu notifications on a dashboard.
Is it a desktop app, a website or a browser extension?A bit of each. The scheduler and dashboard run locally on a Mac, and the platform-filling logic lives in a Chrome extension that runs inside a dedicated Chrome profile. You view the dashboard in a browser, and optionally from a phone.
How do I get it running?Download Maitian and the publish assistant into ~/maitian/, attach the publish skill and run the install wizard. The wizard generates the config, sets up auto-start on macOS and opens each platform's login page. The first level, which only shows data, takes about 30 minutes.
What do I need installed first?macOS (Windows 10/11 is a community port), Node.js 22.5 or newer for the built-in node:sqlite, and Google Chrome. Optional extras are a NAS for video files, a Feishu group bot for notifications and cloudflared for remote access.
Does it publish to every platform automatically?No. Bilibili, Douyin, Xiaohongshu and WeChat Channels are only filled in and then stop, so you click publish yourself. X, YouTube, Instagram and your own site are submitted automatically after the form is read back and checked.
Why did the author build it?The author publishes alone to six or seven platforms, each with different copy, covers and formats. Maitian is one workbench to publish, watch the numbers and see which episode brings in sign-ups and revenue.
Can I see how it looks before setting anything up?Yes. Run node src/demo.mjs to open the big screen with demo data, which needs no platform accounts.
What does the dashboard show for each episode?Per-platform views and interactions, a same-age comparison with the previous episode, follower gains, and a review card on days 1, 3 and 7 after publishing. A weekly report arrives every Monday.
Can it tell which episode brings in sign-ups and revenue?Yes, optionally. Connect your own site through the interface described in src/site.mjs, and the conversion page shows each episode's funnel from plays to sign-ups, memberships and revenue. Without a site, that part stays off.
Creator
CzzzzzzJ
Size
4.4 MB
Stars
1K
Age
4d
Commits · 90 Days