# Soul创业实验AI · 使用手册

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

---

## 快速开始

### 1. 首次配置凭证

```bash
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/`