# content-agent-os

**Repository Path**: ifredom/content-agent-os

## Basic Information

- **Project Name**: content-agent-os
- **Description**: 内容创作agent
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video Extract — 视频 AI 二创工具

输入抖音/B站视频链接，自动提取字幕/文案、AI 总结、一键生成多平台风格的口播文案。

## 快速启动

```bash
# 后端
cd backend
uv sync                          # 首次：安装依赖
cp .env.example .env             # 首次：填写 API Key + 模型路径
uv run python run.py             # → http://127.0.0.1:8080

# 前端
cd frontend
npm install                      # 首次
npm run dev                      # → http://localhost:5173
```

### 无界面 / 命令行调用

**方式一：CLI 直调（无需启动服务）**
```bash
cd backend && uv run python ../.agents/skills/video-extract/scripts/extract.py "<链接>"

# 强制 Whisper 语音转文字（即使有官方字幕）
cd backend && uv run python ../.agents/skills/video-extract/scripts/extract.py --whisper "<链接>"
```

**方式二：HTTP API（先启动后端，再用 curl 调用）**
```bash
# 终端1：启动后端
cd backend && uv run python run.py

# 终端2：解析视频 + 获取字幕
curl -s -X POST http://127.0.0.1:8080/api/video/parse \
  -H "Content-Type: application/json" \
  -d '{"url": "<链接>"}'

curl -s -X POST http://127.0.0.1:8080/api/video/subtitle \
  -H "Content-Type: application/json" \
  -d '{"url": "<链接>"}'
```

## 效果预览

### Step 1 — 输入视频链接，自动解析

![输入链接](screenshot/step0.png)

### Step 2 — 字幕展示 + AI 结构化总结

![字幕与总结](screenshot/step1.png)

### Step 3 — 风格化改写 + Markdown 导出

![改稿导出](screenshot/step2.png)

[点击查看导出示例](screenshot/AI建站总像模板？问题是这4步错了.md)

## 安装详解

### 环境要求

| 依赖 | 说明 |
|------|------|
| Python 3.11+ | 后端 |
| uv | Python 包管理器 |
| Node.js 18+ | 前端 |
| ffmpeg | 需在 PATH 中 |
| DeepSeek API Key | AI 总结与改写 |

### 1. 后端

```bash
cd backend
uv sync                          # 自动创建隔离环境，安装全部依赖
cp .env.example .env             # 编辑 .env 填写配置
```

`.env` 内容：
```env
WHISPER_MODEL_PATH=E:\cache\AAA-model\whisper-models\faster-whisper-large-v3-turbo
DEEPSEEK_API_KEY=sk-xxx
DASHSCOPE_API_KEY=               # 可选
```

### 2. Whisper 模型

下载 [faster-whisper-large-v3-turbo](https://huggingface.co/Systran/faster-whisper-large-v3-turbo)（CTranslate2 格式，含 `model.bin`），放到 `.env` 配置的路径。也支持 `small` / `large-v3` 尺寸。

### 3. 前端

```bash
cd frontend
npm install
npm run dev
```

## 使用流程

1. **配置 API Key** — 顶栏「模型配置」填 DeepSeek Key
2. **粘贴链接** — B站/抖音视频或分享口令
3. **开始解析** — 自动获取信息 + 字幕（无字幕自动 Whisper 转录）
4. **AI 总结** — 摘要/核心观点/金句/时间轴
5. **风格改写** — 抖音/小红书/公众号
6. **导出** — Markdown 一键下载

## 功能一览

- **B站 + 抖音** — 双平台视频解析
- **字幕提取** — 官方字幕/抖音文案自动获取
- **faster-whisper 转录** — 无字幕时自动语音转文字
- **AI 总结** — 摘要/观点/金句/时间轴
- **多风格改写** — 抖音口播/小红书/公众号
- **质量模式** — 快速/深度/传播/学习
- **CLI 直调** — 无需服务，一行命令提取

## 技术架构

详见 [README_TECH.md](README_TECH.md)