# video_demo_create

**Repository Path**: zhoudlz/video_demo_create

## Basic Information

- **Project Name**: video_demo_create
- **Description**: 视频大纲创作
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-26
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video Demo Create Project

该项目主要用于 [视频生成 / 内容处理相关场景，可根据实际业务补充]，通过整合飞书等外部服务、串联数据处理流程，完成从数据获取到结果输出的全链路逻辑。


## 项目核心模块与结构

### 1. 核心流程与关键模块

- **`app/services/content_service.py`**  
  项目**总流程核心入口**，负责协调各模块（数据读取、处理、输出等），驱动从 “数据输入” 到 “结果生成” 的全流程运转。

- **`app/utils/feishu_spreadsheet.py`**  
   **从content_service 340行进入该模块。** 关键工具类，**全流程数据流转的核心环节**：负责与飞书表格交互，包括「飞书表格数据读取」和「处理结果写入飞书」，是业务流程中 “数据来源” 与 “结果回写” 的关键载体。

- **`processors` 目录**  
  承接 `content_service` 中转入的处理流程（如关键节点 “340 步骤” 后的逻辑），是业务逻辑的具体处理层：  
  - `base_processor.py`：定义处理逻辑的基类与通用接口；  
  - `evaluation.py`、`seeding.py`：基于基类实现的具体业务处理逻辑（如评估、种子数据处理等）。  


### 2. 其他重要模块

- **`app/models/schemas.py`**  
  管理项目各环节的**入参结构与数据校验**，确保流程中数据格式的规范性与一致性。

- **`app/api/routes.py`**  
  定义 API 路由，处理外部接口请求，并将请求转发至对应的服务逻辑。

- **`app/core`**  
  基础服务支撑：包含日志相关逻辑（`request_context.py`、`request_middleware.py`），以及 `downloaded_images` 目录（用于存放流程中下载的图片资源）。

- **`app/utils`**  
  通用工具集合：除 `feishu_spreadsheet.py` 外，还包含文件操作（`file_utils.py`）、日志工具（`logger.py`）、文本处理（`text_utils.py`）等辅助功能。  


### 3. 辅助与其他模块

- **`app/clients`**：封装第三方服务客户端（如 `feishu_client.py` 对接飞书、`volcano_client.py` 对接火山引擎），处理与外部服务的交互。  
- **`output`**：存放项目生成的最终结果（如视频文件、报告等）。  
- **`tests`**：测试用例目录，包含 `test_api.py`（API 接口测试）、`test_main.py`（主流程测试）等。  
- **`config/setting.py`**：项目配置中心，管理环境变量、服务配置等。  
- **`prompts.py`**：管理 AI 交互等场景的提示词内容。  


## 快速运行指引

1. **环境配置**：参考 `.env` 文件，配置必要的环境变量（如第三方服务的 API 密钥、飞书应用凭证等）。  
2. **启动流程**：运行项目根目录的 `main.py` 启动主流程；或部署后通过 API 接口（由 `app/api/routes.py` 定义）触发业务逻辑。  


（可根据实际项目细节，补充更具体的部署、使用步骤）