soul-yongping/派对AI

Soul创业实验AI · 使用手册

《一场soul的创业实验》项目的内容运营智能助手。 覆盖视频剪辑、文章写作、运营报表、飞书管理、多平台分发、小程序站管理、素材库上传、Soul账号注册。

---

快速开始

1. 首次配置凭证

cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平/项目AI/config
cp .env.example .env
# 编辑 .env 填入各平台真实凭证

2. 告诉AI你要做什么

直接说需求，魂AI会自动匹配对应技能：

你说的	AI做的
「帮我切片第119场视频」	读视频剪辑Skill → 执行切片流水线
「写第119场文章」	读文章写作Skill → 按写作规范写作
「上传到小程序」	执行 content_upload.py
「发飞书群」	生成海报 + 推送飞书群
「一键分发到5个平台」	读多平台分发Skill → distribute_all.py
「第119场运营数据」	读运营报表Skill → 填飞书表格
「发到素材库」	上传到飞书多维表格
「检查Cookie」	检测各平台凭证有效性

---

目录结构

项目AI/
├── BOOTSTRAP.md                    ← 启动指令（AI 第一个读的文件）
├── SKILL_REGISTRY.md               ← 9 技能一张表（按关键词查找）
├── README.md                       ← 本文件（使用手册）
│
├── config/                         ← 凭证统一管理
│   ├── .env.example                ← 模板（所有平台配置键）
│   ├── .env                        ← 实际凭证（不入Git）
│   └── credentials.md              ← 凭证获取与刷新指南
│
├── 01_魂资（金）/                   ← 配置与存储
│   └── Token管理/SKILL.md          ← S01 凭证管理
│
├── 02_魂流（水）/                   ← 运营与协调
│   ├── 运营报表/SKILL.md           ← S02 派对数据→飞书表格
│   ├── 飞书管理/SKILL.md           ← S03 妙记下载/群推送/知识库
│   └── Soul账号注册/SKILL.md       ← S04 Soul账号与派对房间
│
├── 03_魂产（木）/                   ← 内容创作
│   ├── 视频剪辑/SKILL.md           ← S05 录屏→竖屏切片→成片
│   ├── 文章写作/SKILL.md           ← S06 写文章→上传→推送
│   └── 素材库上传/SKILL.md         ← S07 成片→飞书内容看板
│
├── 04_魂码（火）/                   ← 网站与程序
│   └── 小程序站管理/SKILL.md       ← S08 三端管理与发布
│
└── 05_魂质（土）/                   ← 分发与变现
    └── 多平台分发/SKILL.md         ← S09 5平台一键分发

---

9 个技能速查

S01 · Token管理（金）

管理 8 个平台的凭证，统一从 config/.env 读取。

平台	有效期	刷新频率
小红书	~7天	每周
抖音/快手	~30天	每月
B站	~6个月	每季度
飞书/数据库	长期	仅重置时

S02 · 运营报表（水）

派对截图/TXT → soul_party_to_feishu_sheet.py → 飞书电子表格 → 发群

S03 · 飞书管理（水）

• 妙记下载：feishu_minutes_download.py --url <妙记链接>
• 群推送：send_chapter_poster_to_feishu.py <id> "<标题>"
• 知识库上传：feishu_wiki_upload.py

S04 · Soul账号注册（水）

Soul App 注册 → 灵魂测试 → 资料完善 → 创建派对房间 → 投流设置。

S05 · 视频剪辑（木）

录屏 → MLX转录 → 高光识别 → 批量切片 → 竖屏裁剪(498×1080) → 封面+字幕+后期 → 成片
一键命令：python3 soul_slice_pipeline.py --input video.mp4 --vertical

S06 · 文章写作（木）

写作规范(6:3:1) → 写文章 → content_upload.py上传 → send_chapter_poster推送

S07 · 素材库上传（木）

成片 → feishu_slice_upload_to_wiki_table.py → 飞书内容看板(多维表格)

S08 · 小程序站管理（火）

三端管理：miniprogram（小程序）+ soul-admin（管理端）+ soul-api（API后端）。 开发规范引用 .cursor/skills/ 中的完整 Skill 集。

S09 · 多平台分发（土）

飞书视频下载 → 切片(可选) → distribute_all.py → 5平台同时发布
平台：抖音(API) / B站(API) / 视频号(扫码) / 小红书(逆向) / 快手(逆向)

---

典型工作流

流程A：派对完整流程

1. Soul账号注册(S04) → 创建派对房间 → 开播
2. 运营报表(S02)    → 派对数据填入飞书表格
3. 视频剪辑(S05)    → 录屏切片为成片
4. 素材库上传(S07)   → 成片登记到飞书看板
5. 多平台分发(S09)   → 成片发到5个平台

流程B：文章发布流程

1. 文章写作(S06) → 按规范写第9章文章
2. 上传(S06)     → content_upload.py 写入数据库
3. 推送(S03)     → 海报+摘要发飞书群

流程C：飞书妙记→全链路

1. 飞书管理(S03) → 下载妙记视频
2. 视频剪辑(S05) → 切片+后期
3. 素材库上传(S07) → 登记到内容看板
4. 文章写作(S06) → 妙记文字写成文章
5. 多平台分发(S09) → 视频发5平台

---

与卡若AI的关系

本项目AI是卡若AI的子项目，聚焦于 Soul 创业实验的内容运营。

复用卡若AI的能力：

• 视频切片脚本 → 卡若AI/03_卡木（木）/木叶_视频内容/
• 多平台分发脚本 → 卡若AI/03_卡木（木）/木叶_视频内容/多平台分发/
• 飞书管理脚本 → 卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/
• 智能纪要/妙记下载 → 卡若AI/02_卡人（水）/水桥_平台对接/智能纪要/
• 写作规范 → 卡若AI/02_卡人（水）/水桥_平台对接/Soul创业实验/

本项目独有：

• content_upload.py → 文章上传到小程序数据库
• scripts/send_chapter_poster_to_feishu.py → 海报生成与推送
• .cursor/skills/ → 三端开发规范
• 开发文档/ → 完整开发文档体系

---

注意事项

1. 凭证安全：config/.env 包含敏感信息，已在 .gitignore 中排除，不要提交到 Git
2. Cookie 过期：小红书每周需刷新，抖音/快手每月刷新，发布前先检测
3. 视频号扫码：视频号每次发布需微信扫码，无法完全自动化
4. 数据库直连：content_upload.py 直连腾讯云 MySQL，注意网络环境
5. 开发 vs 运营：代码开发用 .cursor/skills/，内容运营用 项目AI/