SynapseAutomation 是一个 AI 驱动的多平台矩阵投放与自动化发布系统; 面向多账号、多素材、多平台的内容分发场景，提供从计划生成、任务调度到执行监控与数据回收的全链路能力；
SynapseAutomation 是一个“矩阵投放 / 分发中台”，把「账号、素材、计划、排期、执行、监控、回收」统一到可编排的任务系统中：
- 适合多平台、多账号的规模化分发与运营底座；
- 不强行覆盖剪辑/混剪/内容工厂，可作为外部生产链路的对接层；
- 设计参考行业常见“编-投-管-回”闭环，但项目更聚焦于“投 + 管 + 回”；
- 多平台、多账号、多素材组合发布；
- 批量生成任务、统一入队、并发调度；
- 定时发布、结果回传、失败重试；
- 账号绑定、状态监控、异常提醒；
- 任务队列看板、执行日志可视化；
- 当前支持：抖音、B 站；
- 预留可扩展：快手、小红书、视频号等（按平台适配器扩展）；
- 内置 HermesAgent AI 助手；
- 自然语言生成/润色标题、标签、话题等投放配置；
- 支持“一句话投放”（示例见下）；
- FastAPI + Next.js + Celery/Redis + Playwright；
- 平台适配器模块化扩展；
- Web 控制台 + Electron 桌面端，可本地或私有化部署；
支持平台「抖音、快手、小红书、视频号、B 站」；扫码后无需频繁点击，账号自动入库并持续维护；
支持 AI 自动补全标题、标签，支持批量拖拽上传；
支持「抖音、快手、小红书、视频号、B 站」同步发布；支持 AI 一句话发布： “帮我把素材库刚上传的视频，生成标题、标签并定时发布 23:55，发布到五个平台；”
当前支持：抖音、B 站（可扩展快手、小红书、视频号）；
内置平台适配器（可扩展）：
- 抖音
- 快手
- 小红书
- 视频号
- B 站
规划可扩展：TikTok（如需国际化平台可按适配器扩展）；
技术栈：FastAPI、Next.js、Celery/Redis、Playwright、Electron；
syn_frontend_react/ # Next.js 控制台（计划/任务/看板）
syn_backend/ # FastAPI 后端（矩阵调度 + AI 服务）
scripts/ # 启动与运维脚本
desktop-electron/ # Electron 客户端与打包
推荐优先使用下面两种方式之一：
- Docker 一键部署：适合快速验证、单机部署、避免本机逐个拉起服务。
- 本地部署：适合开发、调试、单独查看 Redis / Celery / Playwright Worker / FastAPI / HermesAgent 的运行状态。
前置条件：
- 已安装 Docker Desktop（或可用的 Docker Engine + Compose）。
- 根目录
.env已按本机端口和浏览器策略调整。 syn_backend\config\hermes_agent.toml已配置 HermesAgent 的模型信息。
启动：
.\docker-deploy.bat该脚本会完成以下动作：
- 构建并启动
redis、app、frontend三个容器； - 在
app容器内同时拉起FastAPI + Celery Worker + Playwright Worker + HermesAgent Dashboard + HermesAgent WebUI； - 验证
3000 / 7000 / 9119 / 9131端口可访问； - 输出当前
docker compose ps状态。
访问地址：
- 控制台：http://localhost:3000
- 后端 API：http://localhost:7000/api/docs
- HermesAgent Dashboard：http://localhost:9119
- HermesAgent WebUI：http://localhost:9131
停止：
.\docker-stop.bat方式 A：synenv（默认推荐）
python -m venv synenv
synenv\Scripts\activate
pip install -r requirements.txt
cd syn_frontend_react
npm install
cd ..也可以直接运行 start.bat。它会优先检测 synenv，不存在时自动创建并安装根 requirements.txt。
方式 B：conda
conda create -n syn python=3.11.4
conda activate syn
pip install -r requirements.txt
cd syn_frontend_react
npm install
cd ..必须检查两类配置：
- 根目录
.env：端口、Redis、浏览器路径、前后端连接地址。 syn_backend\config\hermes_agent.toml：HermesAgent 的 provider / model / api_key / base_url。
浏览器依赖：
scripts\launchers\setup_browser.bat桌面版也支持在“系统设置”页动态下载 Chromium / Firefox，并切换 Patchright / Playwright 运行时。
方式 A：一键拉起完整本地栈
start.bat等价于默认 synenv 模式，会按顺序启动：
- Redis
- Celery Worker
- Playwright Worker
- FastAPI Backend
- Frontend
重要说明：
- 本地后端进程缺一不可。少起任意一个进程，前端页面可能能打开，但任务调度、浏览器执行、异步回调、HermesAgent 调用链都会不完整。
- HermesAgent Dashboard / WebUI 由 FastAPI 在非 Supervisor 模式下自动托管；前提是
syn_backend\config\hermes_agent.toml已正确配置，且本地 Hermes 运行时已通过scripts\hermes\setup-local-hermes.ps1安装完成。
方式 B：Supervisor 模式
start.bat supervisor该模式会启动：
- Redis
- Supervisor
- Frontend
再由 Supervisor 托管：
- FastAPI Backend
- Celery Worker
- Playwright Worker
- HermesAgent 相关界面与网关
方式 C：手动逐个进程启动（仅调试时使用）
scripts\launchers\start_redis.bat
scripts\launchers\start_celery_synenv.bat
scripts\launchers\start_worker_synenv.bat
scripts\launchers\start_backend_synenv.bat
scripts\launchers\start_frontend.bat- 控制台：http://localhost:3000
- 后端 API：http://localhost:7000/api/docs
- Playwright Worker：http://localhost:7001
- Supervisor API：http://localhost:7002（仅
start.bat supervisor） - HermesAgent Dashboard：http://localhost:9119
- HermesAgent WebUI：http://localhost:9131
- 绑定账号（多平台账号矩阵）；
- 素材入库（批量上传 / AI 标题标签润色）；
- 创建矩阵计划（平台、账号、素材、话题、封面、定时策略）；
- 生成矩阵任务并调度执行（队列化、并发、失败重试）；
- 看板监控与日志审计（异常提醒 / 人工介入点）；
- 数据回收（抖音、B 站）并复盘迭代；
生成矩阵任务：
POST /api/v1/matrix/generate_tasks
Content-Type: application/json{
"platforms": ["xiaohongshu", "douyin"],
"accounts": {
"xiaohongshu": ["account_id_1", "account_id_2"],
"douyin": ["account_id_3"]
},
"materials": ["material_id_1", "material_id_2"],
"title": "xxxxx",
"topics": ["#xxx", "#xxx"]
}syn_backend/fastapi_app：API、矩阵调度、任务队列与服务逻辑；syn_frontend_react/：矩阵投放控制台（Next.js）；desktop-electron/：桌面客户端与打包脚本；scripts/：启动、调试、维护脚本；scripts/tests/：手动与集成验证脚本（原Test/目录已收纳至此）；
本项目用于自动化流程与效率提升，请在合法合规、遵守平台规则的前提下使用； 涉及账号体系与内容发布的规模化运营，建议建立团队内部内容审核与风险控制流程；
本项目在能力建设上受益于开源生态，以下项目提供了启发或参考：
本项目基于 Apache License 2.0 开源；
 |
 |
 |