# 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-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BiliAI — B站视频 AI 二创工具

输入一个 B站视频链接，自动提取字幕、AI 总结内容、一键生成抖音/小红书/公众号风格的口播文案。

## 效果预览

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

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

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

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

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

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

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

## 安装与运行

### 环境要求

| 依赖 | 说明 |
|------|------|
| Python 3.11+ | 后端运行环境 |
| Node.js 18+ | 前端运行环境 |
| NVIDIA GPU + CUDA 12.x | 可选，Whisper 本地转录加速 |
| DeepSeek API Key | AI 总结与改写（或兼容 OpenAI 接口的其他 API）|

### 1. 克隆仓库

```bash
git clone git@gitee.com:ifredom/content-agent-os.git
cd content-agent-os
```

### 2. 安装后端

```bash
cd backend
python -m venv venv
venv\Scripts\pip install -r requirements.txt
```

### 3. 下载 Whisper 模型

模型下载方式详见 [MODEL.md](MODEL.md)。推荐使用 HuggingFace 镜像快速下载：

```bash
# 在 backend/model/ 下创建模型目录，放入以下文件：
backend/model/large-v3-turbo/
    ├── config.json
    ├── model.safetensors
    ├── preprocessor_config.json
    ├── tokenizer.json
    └── generation_config.json
```

如果未手动下载，首次转录时程序会自动从 hf-mirror.com 下载。

### 4. 启动后端

```bash
cd backend
$env:PYTHONPATH = "."
venv\Scripts\uvicorn app.main:app --host 0.0.0.0 --port 8000
```

### 5. 安装并启动前端

```bash
cd frontend
npm install
$env:NEXT_PUBLIC_API_URL = "http://localhost:8000/api"
npm run dev
```

### 6. 打开浏览器

访问 **http://localhost:3000**

## 使用流程

1. **配置 API Key** — 点击顶栏「模型配置」，填入 DeepSeek API Key
2. **粘贴 B站链接** — 例如 `https://www.bilibili.com/video/BV1UtdtBAELa/`
3. **点击「开始解析」** — 自动获取视频信息 + 字幕（无官方字幕时自动 AI 转录）
4. **查看 AI 总结** — 自动生成摘要、核心观点、金句提取、时间轴
5. **生成二创文案** — 选择风格（抖音/小红书/公众号），一键改写
6. **导出 Markdown** — 所有内容导出为 .md 文件

## 功能一览

- **B站视频解析** — 视频标题、UP主、封面、时长、简介
- **字幕提取** — 官方 CC 字幕自动获取
- **Whisper AI 转录** — 无字幕时自动用本地 GPU 转录音频（支持 large-v3-turbo/large/small）
- **AI 结构化总结** — 摘要 + 核心观点 + 金句 + 时间轴
- **多平台风格改写** — 抖音口播、小红书图文、公众号长文
- **质量模式** — 快速/深度/传播/学习 四种模式，token 策略不同
- **自定义 Prompt** — 支持自建改写模板，localStorage 持久化
- **一键导出** — 原字幕 + 总结 + 改稿结果打包为 Markdown 文件

## 技术架架

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