CodexMedia 使用教程

📖 项目简介

CodexMedia 不是一个新的软件，而是一套把六个开源工具串起来的内容制作方案。它按照选题、配音、视频合成、封面排版和多平台发布五个环节组织，每个工具只负责自己擅长的部分。

选题环节用热点监测和 RSS 补齐信息源；口播定稿后交给本地语音合成；真实录屏、截图、字幕和音频再由 Python 视频工具合成，封面文字由图像库稳定排版；最后把成片和发布文案交给统一命令行工具。

Codex 的作用是读取输入输出、调用脚本并衔接步骤。它不会替代选题判断、账号登录和发布前审核。先把单个平台、单条视频跑通，再逐步增加自动化，排错成本最低。

📎 六个项目地址（点击展开）

TrendRadar
RSSHub
CosyVoice
MoviePy
Pillow
SocialAutoUpload

✨ 核心亮点

🧭

按环节分工

每个工具只处理一个清晰输入和输出，失败时容易定位。

⌨️

命令行可调用

Codex 可以执行 Python、Docker 和统一发布命令。

🎬

保留真实素材

软件教程继续使用真实录屏和截图，不用示意图冒充演示。

🛡️

人工检查点

选题、参考音频授权、账号验证和发布前检查仍由人确认。

🧩 能力速览

环节	工具	输入与输出
选题	TrendRadar + RSSHub	热点、RSS → 筛选后的候选资料
配音	CosyVoice	口播文本、已授权参考音频 → 语音文件
视频	MoviePy	录屏、截图、字幕、配音 → 成片
封面	Pillow	标题、图片、版式参数 → 封面图
发布	SocialAutoUpload	成片、标题、简介、话题 → 平台提交任务

🖥️ 环境要求

环境	建议配置
操作系统	Windows、macOS 或主流 Linux；发布工具需可运行浏览器。
运行环境	Python、Git、FFmpeg；RSSHub 还需要 Node.js 或 Docker。
内存与存储	视频素材和模型会占用较多空间，建议预留独立素材目录。
显卡	选题、封面、视频合成和发布可用 CPU；本地语音模型是否需要显卡取决于模型版本和速度要求。
账号准备	各平台首次登录需手动完成，并单独保存本地会话。

🚀 如何使用

💡

不要一次部署全部工具。先创建统一目录和任务清单，再逐环节验证输入、输出。

准备基础环境

先确认 Python、Git 和 FFmpeg 可用，再创建隔离环境。

PowerShellpython --version
git --version
ffmpeg -version
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip

先装视频与封面工具

它们依赖少，最适合先验证素材目录、输出目录和 FFmpeg。

PowerShellpython -m pip install moviepy pillow
python -c "import moviepy, PIL; print('video tools ready')"

部署信息源和语音工具

分别在 GitHub 搜索项目名，严格按对应版本 README 安装。先单独跑通热点报告、RSS 输出和一段短配音，再接入主流程。

PowerShellNew-Item -ItemType Directory -Force -Path data,output,assets
Set-Content -Path task.json -Value '{"topic":"","script":"","voice":"","video":""}'

建议统一字段：

字段	作用
`topic`	人工确认后的选题，不直接等同于热点。
`script`	定稿口播路径。
`voice`	生成后的配音路径。
`video`	导出的成片路径。

准备发布工具

安装后先查看帮助，再为每个平台执行登录与会话检查。不要把账号会话文件提交到 Git。

PowerShellsau --help
sau douyin login --account creator
sau douyin check --account creator

结合 Codex 使用

把每一步写成独立 skills：明确允许读取的目录、必须检查的输入、生成文件的位置，以及遇到登录失效、验证码和缺少素材时必须停止。

✅

推荐执行顺序：生成候选 → 人工确认选题和口播 → 配音 → 合成 → 发布前检查 → 提交平台。

🎯 典型应用场景

📰

热点监测

按关键词收集候选资料。

🎙️

批量配音

定稿后统一生成场景音频。

💻

软件教程

真实录屏配合字幕和讲解。

🖼️

封面模板

稳定控制标题和安全边距。

📤

多平台提交

复用成片和发布文案。

🔁

系列化内容

复用目录、模板和检查清单。

📈 选型与边界

工具	适合做什么	主要边界
TrendRadar / RSSHub	拓宽信息源	不能代替账号数据和选题判断
CosyVoice	本地语音合成	部署速度取决于硬件与模型
MoviePy / Pillow	确定性合成和排版	需要先准备真实素材与模板
SocialAutoUpload	复用发布参数	会话、验证码和平台变化需人工处理

🧠

这套方案的核心不是“一个工具全包”，而是用文件和命令把边界清楚的工具连接起来。

❓ 常见问题

Q: 必须一次安装六个工具吗？

不需要。先装 MoviePy、Pillow 和一个发布平台，跑通成片到提交，再增加选题和本地配音。

Q: 收到热点后可以直接生成视频吗？

不建议。先检查是否适合账号受众、是否与历史内容重复，并核实事实来源。

Q: 没有显卡能用吗？

除本地语音模型外，其余环节可用 CPU。语音环节可以选择更小模型、较慢生成或单独部署到有显卡的机器。

Q: 为什么视频画面还要自己准备？

MoviePy 负责合成，不负责替你制造真实的软件操作。教程类内容应优先使用自己的录屏和截图。

Q: 参考音频有什么要求？

只使用本人声音或明确获得授权的声音，并保留授权记录。

Q: 发布时遇到验证码怎么办？

立即暂停自动化，手动完成验证后重新检查会话，不要循环重试。

Q: 怎么避免把账号信息提交到仓库？

将会话、密钥、配置和生成素材加入忽略文件，skills 中只写变量名和读取规则。

Q: 各工具许可证一样吗？

不一样。六个项目分别采用不同许可证，发布改版或商业集成前应逐项查看当前仓库许可证。

Q: 能做到完全无人值守吗？

不应这样承诺。选题确认、事实核实、账号验证和发布前审核都需要保留人工检查点。