991e17698c
1. Bug修复： - 修复Markdown星号/下划线在小程序端原样显示问题（markdownToHtml增加__和_支持，contentParser增加Markdown格式剥离） - 修复@提及无反应（MentionSuggestion使用ref保持persons最新值，解决闭包捕获空数组问题） - 修复#链接标签点击"未找到小程序配置"（增加appId直接跳转降级路径） 2. 分享功能优化： - "分享到朋友圈"改为"分享给好友"（open-type从shareTimeline改为share） - 90%收益提示移到分享按钮下方 - 阅读20%后向上滑动弹出分享浮层提示（4秒自动消失） 3. 代付功能： - 后端：新增UserBalance/BalanceTransaction/GiftUnlock三个模型 - 后端：新增8个余额相关API（查询/充值/充值确认/代付/领取/退款/交易记录/礼物信息） - 小程序：阅读页新增"代付分享"按钮，支持用余额为好友解锁章节 - 分享链接携带gift参数，好友打开自动领取解锁 Made-with: Cursor
190 lines
6.6 KiB
Markdown
190 lines
6.6 KiB
Markdown
# 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/`
|