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/, подключите навык публикации и запустите мастер установки. Мастер создаёт конфигурацию, настраивает автозапуск на 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 и ваш собственный сайт отправляются автоматически, после того как форма перечитана и проверена.
Зачем автор это сделал?Автор публикует в одиночку на шести-семи платформах, у каждой свои тексты, обложки и форматы. Maitian — это одно рабочее место, где можно публиковать, следить за цифрами и видеть, какой выпуск приводит регистрации и выручку.
Могу ли я посмотреть, как это выглядит, до настройки?Да. Запустите node src/demo.mjs, чтобы открыть большой экран с демо-данными. Для этого не нужны аккаунты на платформах.
Что показывает панель для каждого выпуска?Просмотры и взаимодействия по каждой платформе, сравнение с предыдущим выпуском на тот же срок после публикации, прирост подписчиков и карточку с проверкой на 1, 3 и 7 день после публикации. Еженедельный отчёт приходит каждый понедельник.
Может ли оно показать, какой выпуск приносит регистрации и выручку?Да, но по желанию. Подключите свой сайт через интерфейс, описанный в src/site.mjs, и страница конверсии покажет воронку каждого выпуска: от просмотров до регистраций, подписок и выручки. Без сайта эта часть остаётся выключенной.
Какие есть похожие проекты?AiToEarn, social-auto-upload, Easel, autoclip, MediaCrawler, chubbyskills, saas-growth-agents, FreeCast
Автор
CzzzzzzJ
Размер
4.4 MB
Звёзды
1K
Возраст
4 д
Коммиты · 90 дней