SocialAutoUpload 使用教程

一句话把视频发到抖音、快手、小红书、B站

发布教程

📖 项目简介

social-auto-upload 是 dreammis 开源的多平台发布工具,MIT 协议。做好的视频留在你自己电脑上,说一句发到哪个平台、标题写什么、几点发,它就去创作者后台把这一步做完。

抖音、快手、小红书、B 站已经接进统一命令 sau,并且各有一份给 Codex 读的 skills。登录扫一次码,登录信息存在本机,下次不用再扫。不传定时参数就是马上发,传了就按那个时间发。

它和 Codex 的接法不是再配一套远程接口,而是把仓库交给 Codex,把官方写好的启动提示词发过去。Codex 按文档用 uv 装环境、跑 sau --help 验收,之后你用大白话下发布任务。视频号有浏览器上传实现,但还没有配套 skills,本教程的主线只写上面四个平台。

✨ 核心亮点

💬
一句话发布
告诉 Codex 平台、标题、话题和发布时间,它去调对应的 sau 命令
📱
扫一次码
登录信息存在本机。失效了再跑一次 login,不用每次重装
⏰
可以定时
加上 --schedule,时间格式是年-月-日 时:分。不写就是马上发
📏
平台规矩写进文件
快手话题最多 3 个,小红书标题不超过 20 字,抖音话题最多 5 个。写在 AGENTS.md 里,发之前让它自己对

🧩 它能做什么、输出什么

项目说明
输入本地视频文件;图文是一组图片。标题、简介、话题、定时时间用命令参数传
适用类型已经做好的短视频或图文,发到创作者后台。不是从零生成画面
输出对应平台的已发布或已定时作品。命令返回登录是否有效
语言 / 兼容主线命令:抖音、快手、小红书、B 站。Codex、Claude Code 按官方启动说明接入
规格 / 容量一次上传命令只发一个视频。抖音图文最多 35 张,不支持 GIF。小红书标题不超过 20 字

🖥️ 环境要求

环境建议配置
操作系统Windows、macOS、Linux 均可,按仓库安装说明走
运行环境用 uv 管理 Python 环境。不要默认回退到旧的 requirements.txt
硬件不需要显卡。发布时会打开浏览器,内存留给浏览器即可
低配 / 无卡方案本机就能跑。登录用有头模式,方便扫码;发布可以无头
关键依赖uv、本机浏览器。B 站上传会在运行时自己准备 biliup

🚀 如何使用

💡
先把仓库交给 Codex,让它按官方启动提示词装到 sau --help 能跑。再逐个平台扫码,最后用大白话发一条测试视频。建议用小号试。
1

拿到仓库

在 GitHub 搜索 social-auto-upload,仓库作者是 dreammis。把整个仓库设成 Codex 的工作目录。地址在本页底部折叠块里。

2

装环境并验收

在仓库根目录用 uv 安装。装完必须跑帮助命令,四个平台的入口都要在。

bash uv sync sau --help sau douyin --help sau kuaishou --help sau xiaohongshu --help sau bilibili --help
3

每个平台扫一次码

--account 是你自己起的账号名,不是平台昵称。一个名字对应一份登录文件,多账号就起多个名字。登录用有头模式,二维码出来就扫。扫完用 check 看是不是 valid。

bash sau douyin login --account creator --headed sau douyin check --account creator

快手、小红书、B 站把命令里的 douyin 换成 kuaishou、xiaohongshu、bilibili。B 站登录不要在非交互环境里强行代跑,在本机真实终端执行。

4

发一条定时视频

一次命令只发一个视频文件。不写 --schedule 就是马上发。时间格式是年-月-日 空格 时:分。

bash sau douyin upload-video --account creator --file videos/demo.mp4 --title "示例标题" --desc "示例简介" --tags AI编程 --schedule "2026-10-14 19:00"

常用参数:

参数作用
--account必填。你起的账号名
--file必填。视频路径,一次一个文件
--title必填。标题。小红书不要超过 20 字
--desc视频简介。图文正文用 --note,不要混
--tags话题,逗号分隔。快手最多 3 个,抖音最多 5 个。不要和标题里的词重复
--schedule定时。格式 YYYY-MM-DD HH:MM
--headed / --headless登录建议有头,方便扫码
5

结合 Codex 使用

把仓库 docs 里的 Agent Bootstrap 提示词整段发给 Codex,等它装完并跑过四个 sau 平台 --help。然后直接说:把某条视频发到抖音和快手,今晚七点发,话题带上 AI编程。让它走 sau 命令,不要去翻历史 examples 目录。

在项目的 AGENTS.md 里写上:快手话题最多 3 个,小红书标题不超过 20 字,抖音话题最多 5 个,标题末尾不带话题,话题只走 --tags。

✅
接好之后,换视频、换平台,只是换一句话。登录失效时让它先跑 check,再 login。

🎯 典型应用场景

📤
一条视频发多个平台
同一条成片,抖音、快手、小红书、B 站各跑一次上传命令
⏰
排好发布时间
晚上的片子白天做好,用 --schedule 定到播出时间
🖼️
顺手发图文
upload-note 传多张图片。抖音图文最多 35 张
👤
一个人管多个号
不同 --account 名字对应不同登录文件
🤖
交给 Codex 代发
你只说平台、标题、话题和时间,命令由它拼
🧪
先用小号试
它是在浏览器里模拟人点发布,平台可能风控,先别用主号

📈 和托管发布接口比

对比social-auto-upload托管发布接口
发抖音 / 小红书 / 视频号本机浏览器代操作。视频号还没有 skills抖音、小红书、视频号要装它的浏览器插件,抖音有时还要在手机上点确认
登录每个平台在本机扫一次码,登录信息留在自己电脑上要装浏览器插件,抖音有时还要在手机上点确认
怎么接 Codex官方启动提示词 + 四个平台的 skills,直接跑 sau 命令在配置里填远程地址和密钥
🧠
它不生成视频。命令背后是一个带着你扫码登录信息的浏览器,打开创作者后台,上传、填标题、点发布。

❓ 常见问题

Q: 和托管发布接口有什么区别?

托管接口发抖音、小红书、视频号要走浏览器插件,抖音还可能要手机确认。这个项目在你自己电脑上打开创作者后台。代价是要自己扫码,也有平台风控,建议先用小号。

Q: 支持哪些平台?

带 skills、能让 Codex 稳定调用的是抖音、快手、小红书、B 站。视频号、百家号等有浏览器上传实现,但没有配套 skills,不要当成同一条命令。

Q: check 返回 invalid 怎么办?

登录信息过期或没扫过码。重新跑 sau 平台名 login --account 你的账号名 --headed,扫完再 check,看到 valid 再上传。

Q: 要显卡吗?

不要。它不跑模型,只开浏览器。装不上依赖时,确认用的是 uv,而不是旧的 requirements.txt。

Q: 为什么 Codex 跑去翻 examples 目录?

仓库里有历史示例。把官方启动提示词整段发给它,并写明优先走 sau 命令和 skills 目录,不要走历史 examples。

Q: 怎么和 Codex 结合?

仓库作为工作目录,发送 docs 里的 Agent Bootstrap 提示词。验收标准是四个平台的 sau 平台 --help 都能跑。之后用大白话下任务。

Q: 图文和视频的命令一样吗?

不一样。视频是 upload-video,简介用 --desc。图文是 upload-note,正文用 --note,图片用 --images。图文不支持 GIF,抖音图文最多 35 张。

Q: 可以商用吗?

仓库根目录是 MIT 协议,可以商用,分发时保留版权声明。这是软件协议,不是平台允许你自动发布的承诺。发布行为请先用小号试。