dsh-insta360-pipeline

Readme

# Insta360 AI Content Studio

> 让固定机位的相机拥有一个**每天自动产出、不断进化的 AI 内容工作室**。
> 当前场景：Insta360 GO 3S × 鱼缸兰寿金鱼 → B站每日自动更新。

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## 这是什么

一个**端到端全自动的内容生产系统**——从相机拍摄到成片发布，零人工：

```
BLE 遥控拍摄（随机时刻触发）
      ↓
WiFi 无线取回（HTTP 增量）
      ↓
质量评估 → AI 选段（ffmpeg 五维评分）
      ↓
Auto 剪辑（拼接/运镜/转场/调色）
      ↓
AI 旁白（edge-tts，4 种创作风格）＋ 字幕 ＋ 配乐（免费合法多源）
      ↓
自动投稿 B站（标题/分区/标签/封面）
      ↓
观众数据 → bandit 优化（拍摄时段/模板/音乐/文案风格）
```

## 已验证能力（全部实测通过）

| 能力 | 技术 | 状态 |
|---|---|---|
| 遥控拍摄 | GO 3S BLE（BE80 服务，Go2BlePacket 协议逆向） | ✅ |
| 无线取回 | 相机 WiFi HTTP（开机状态开放） | ✅ |
| 质量评估 | ffmpeg blackdetect/freezedetect/signalstats/scdet | ✅ |
| 自动剪辑 | ffmpeg（Ken Burns/转场/色彩/字幕/配乐） | ✅ |
| AI 旁白 | edge-tts 中文神经网络音色（免费） | ✅ |
| 内容创作 | 内容导演/旁白文案师 skills（4 风格体系） | ✅ |
| 投稿与反馈 | biliup + B站公开数据 API | ✅ |
| FCP 工程 | final-cut-pro-cli（fcpxml 工程生成） | ✅ |

## 快速开始

```bash
# 1. 环境
python3 -m venv .venv
.venv/bin/pip install biliup edge-tts bleak final-cut-pro-cli
# pb2（GPL 组件，安装脚本拉取——见 docs/DESIGN.md §TROUBLESHOOTING）
# 2. 配置
cp config.example.json config.json   # 填 BLE 地址等
# 3. B站登录（扫码一次）
.venv/bin/python tools/bili_login.py
# 4. 遥控拍摄（相机开机）
.venv/bin/python lib/camera_remote.py --capture 15
# 5. 取回
tools/go3s-import.sh import data/footage
# 6. 每日闭环演练
.venv/bin/python lib/pipeline.py --dry-run
```

## 内容创作体系（核心差异化）

程序自动化只决定"能不能发"，内容 skills 决定"值不值得看"：

- **aquarium-content-director**：每日企划卡（选题/角度/钩子/人设/连载）
- **aquarium-voiceover**：旁白风格化（幽默可爱/知识科普/治愈陪伴/悬念叙事）
- roadmap：节奏导演/封面设计师/系列运营（规划中，见 [ROADMAP.md](ROADMAP.md)）

## 路线图

[ROADMAP.md](ROADMAP.md)——Phase 1 自动闭环 → Phase 2 内容 skill 体系 → Phase 3 开源社区化 → Phase 4 多平台 × 多相机 → Phase 5 内容智能。

## 文档

- [设计文档（完整方案 v0.5）](docs/DESIGN.md)
- [环境问题与修复档案](docs/TROUBLESHOOTING.md)
- [测试设计 DRYRUN](test/DRYRUN.md)
- [GO 3S 取回全自动技术方案](docs/GO3S取回全自动技术方案.md)

## 许可与合规

- 自研代码：**MIT**（[LICENSE](LICENSE)）
- 上游：`insta360-go3s-mac-import`（MIT，运行时参考）、GO 系列 protobuf pb2（**GPL-3.0**，来自 [rigacci/insta360-wifi-api](https://github.com/RigacciOrg/insta360-wifi-api)——**不入库**，由 setup 脚本拉取到本地 venv）
- 配乐仅用免费合法源（B站创作中心正版音频库/Jamendo CC/FMA/CC-BY 自动署名）
- B站投稿仅用于自有素材，个人频率，遵守平台条款

## 社区

- 讨论/选题投稿：GitHub Issues
- 相关：DSH（DeepSeek Harness）插件生态
- 愿景延伸：水族/绿植/宠物/天文——任何"固定机位观察"品类（见 ROADMAP Phase 3）

## 贡献

见 [CONTRIBUTING.md](CONTRIBUTING.md)——架构/接口规范/扩展指南/后续计划/已知问题。
贡献路径：开发者（后期引擎/新平台）、内容创作者（skills/选题/人设词库）、测试者（dry-run）。

**当前状态**：P1 通用后期工具已提交（配音/字幕/配乐/剪辑），最小闭环可跑；内容策划功能待规划（见 CONTRIBUTING §5）。

## 复用评估

开发前复用检索（三查）：CAPABILITY-INDEX（DSH 内部）无同构能力；awesome/工具生态无同主题开源条目；GitHub 明确复用四项——go3s-mac-import（MIT，TCP 取回）、rigacci-wifi-api（GPL-3.0，pb2 运行时拉取）、insta360ctl（BLE 协议文档）、biliup（投稿 CLI）。自研部分：管线编排/通用后期引擎/内容方法论。