let5see/huobao-drama
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat:修改readme关于我们

Browse Source
This commit is contained in:
jiangzj
2026-01-19 17:33:38 +08:00
parent eb0f34a4d1
commit db7103aa51
3 changed files with 235 additions and 113 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
README-EN.md
View File

@@ -61,22 +61,26 @@ Experience AI short drama generation:
## ✨ Features
### 🎭 Character Management
- ✅ AI-generated character portraits
- ✅ Batch character generation
- ✅ Character image upload and management
### 🎬 Storyboard Production
- ✅ Automatic storyboard script generation
- ✅ Scene descriptions and shot design
- ✅ Storyboard image generation (text-to-image)
- ✅ Frame type selection (first frame/key frame/last frame/panel)
### 🎥 Video Generation
- ✅ Automatic image-to-video generation
- ✅ Video composition and editing
- ✅ Transition effects
### 📦 Asset Management
- ✅ Unified asset library management
- ✅ Local storage support
- ✅ Asset import/export
@@ -89,7 +93,7 @@ Experience AI short drama generation:
### 📋 Prerequisites
| Software | Version | Description |
|----------|---------|-------------|
| ----------- | ------- | ------------------------------- |
| **Go** | 1.23+ | Backend runtime |
| **Node.js** | 18+ | Frontend build environment |
| **npm** | 9+ | Package manager |
@@ -99,11 +103,13 @@ Experience AI short drama generation:
#### Installing FFmpeg
**macOS:**
```bash
brew install ffmpeg
```
**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install ffmpeg
@@ -113,6 +119,7 @@ sudo apt install ffmpeg
Download from [FFmpeg Official Site](https://ffmpeg.org/download.html) and configure environment variables
Verify installation:
```bash
ffmpeg -version
```
@@ -160,6 +167,7 @@ ai:
```
**Key Configuration Items:**
- `app.debug`: Debug mode switch (recommended true for development)
- `server.port`: Service port
- `server.cors_origins`: Allowed CORS origins for frontend
@@ -260,12 +268,14 @@ docker logs -f huobao-drama
```
**Local Build** (optional):
```bash
docker build -t huobao-drama:latest .
docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-drama:latest
```
**Docker Deployment Advantages:**
- ✅ Ready to use with default configuration
- ✅ Environment consistency, avoiding dependency issues
- ✅ One-click start, no need to install Go, Node.js, FFmpeg
@@ -280,6 +290,7 @@ The container is configured to access host services using `http://host.docker.in
**Configuration Steps:**
1. **Start service on host (listen on all interfaces)**
```bash
export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
```
@@ -306,12 +317,14 @@ go build -o huobao-drama .
```
Generated files:
- `huobao-drama` - Backend executable
- `web/dist/` - Frontend static files (embedded in backend)
#### 2. Prepare Deployment Files
Files to upload to server:
```
huobao-drama # Backend executable
configs/config.yaml # Configuration file
@@ -372,6 +385,7 @@ WantedBy=multi-user.target
```
Start service:
```bash
sudo systemctl daemon-reload
sudo systemctl enable huobao-drama
@@ -401,11 +415,13 @@ sudo systemctl restart huobao-drama
```
**Reason:**
- SQLite requires write permission on both the database file **and** its directory
- Needs to create temporary files in the directory (e.g., `-wal`, `-journal`)
- **Key**: Ensure systemd `User` matches data directory owner
**Common Usernames:**
- Ubuntu/Debian: `www-data`, `ubuntu`
- CentOS/RHEL: `nginx`, `apache`
- Custom deployment: `deploy`, `app`, current logged-in user
@@ -436,6 +452,7 @@ server {
## 🎨 Tech Stack
### Backend
- **Language**: Go 1.23+
- **Web Framework**: Gin 1.9+
- **ORM**: GORM
@@ -445,6 +462,7 @@ server {
- **AI Services**: OpenAI, Gemini, Doubao, etc.
### Frontend
- **Framework**: Vue 3.4+
- **Language**: TypeScript 5+
- **Build Tool**: Vite 5
@@ -454,6 +472,7 @@ server {
- **Router**: Vue Router 4
### Development Tools
- **Package Management**: Go Modules, npm
- **Code Standards**: ESLint, Prettier
- **Version Control**: Git
@@ -463,19 +482,24 @@ server {
## 📝 FAQ
### Q: How can Docker containers access Ollama on the host?
A: Use `http://host.docker.internal:11434/v1` as Base URL. Note two things:
1. Host Ollama needs to listen on `0.0.0.0`: `export OLLAMA_HOST=0.0.0.0:11434 && ollama serve`
2. Linux users using `docker run` need to add: `--add-host=host.docker.internal:host-gateway`
See: [DOCKER_HOST_ACCESS.md](docs/DOCKER_HOST_ACCESS.md)
### Q: FFmpeg not installed or not found?
A: Ensure FFmpeg is installed and in the PATH environment variable. Verify with `ffmpeg -version`.
### Q: Frontend cannot connect to backend API?
A: Check if backend is running and port is correct. In development mode, frontend proxy config is in `web/vite.config.ts`.
### Q: Database tables not created?
A: GORM automatically creates tables on first startup, check logs to confirm migration success.
---
@@ -485,6 +509,7 @@ A: GORM automatically creates tables on first startup, check logs to confirm mig
### v1.0.2 (2026-01-16)
#### 🚀 Major Updates
- Pure Go SQLite driver (`modernc.org/sqlite`), supports `CGO_ENABLED=0` cross-platform compilation
- Optimized concurrency performance (WAL mode), resolved "database is locked" errors
- Docker cross-platform support for `host.docker.internal` to access host services
@@ -493,6 +518,7 @@ A: GORM automatically creates tables on first startup, check logs to confirm mig
### v1.0.1 (2026-01-14)
#### 🐛 Bug Fixes / 🔧 Improvements
- Fixed video generation API response parsing issues
- Added OpenAI Sora video endpoint configuration
- Optimized error handling and logging
@@ -512,13 +538,27 @@ Issues and Pull Requests are welcome!
---
## API Configuration Site
Configure in 2 minutes: [API Aggregation Site](https://api.chatfire.site/models)
## 📧 Contact
Business Contact (WeChat): dangbao1117
---
## 👨‍💻 About Us
**AI Huobao - AI Studio Startup**
- 🏠 **Location**: Nanjing, China
- 🚀 **Status**: Startup in Progress
- 📧 **Email**: [18550175439@163.com](mailto:18550175439@163.com)
- 💬 **WeChat**: dangbao1117 (Personal WeChat - No technical support)
- 🐙 **GitHub**: [https://github.com/chatfire-AI/huobao-drama](https://github.com/chatfire-AI/huobao-drama)
> _"Let AI help us do more creative things"_
## Community Group
![Community Group](drama.png)
- Submit [Issue](../../issues)
- Email project maintainers

46
README-JA.md
View File

@@ -61,22 +61,26 @@ AIショートドラマ生成を体験：
## ✨ 機能
### 🎭 キャラクター管理
- ✅ AI 生成キャラクターポートレート
- ✅ バッチキャラクター生成
- ✅ キャラクター画像のアップロードと管理
### 🎬 絵コンテ制作
- ✅ 自動絵コンテスクリプト生成
- ✅ シーン説明とショットデザイン
- ✅ 絵コンテ画像生成（テキストから画像）
- ✅ フレームタイプ選択（先頭フレーム/キーフレーム/末尾フレーム/パネル）
### 🎥 動画生成
- ✅ 画像から動画の自動生成
- ✅ 動画合成と編集
- ✅ トランジション効果
### 📦 アセット管理
- ✅ 統合アセットライブラリ管理
- ✅ ローカルストレージサポート
- ✅ アセットのインポート/エクスポート
@@ -89,7 +93,7 @@ AIショートドラマ生成を体験：
### 📋 前提条件
| ソフトウェア | バージョン | 説明 |
|-------------|----------|------|
| ------------ | ---------- | ------------------------ |
| **Go** | 1.23+ | バックエンドランタイム |
| **Node.js** | 18+ | フロントエンドビルド環境 |
| **npm** | 9+ | パッケージマネージャー |
@@ -99,11 +103,13 @@ AIショートドラマ生成を体験：
#### FFmpeg のインストール
**macOS:**
```bash
brew install ffmpeg
```
**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install ffmpeg
@@ -113,6 +119,7 @@ sudo apt install ffmpeg
[FFmpeg 公式サイト](https://ffmpeg.org/download.html)からダウンロードし、環境変数を設定
インストール確認：
```bash
ffmpeg -version
```
@@ -160,6 +167,7 @@ ai:
```
**主要設定項目：**
- `app.debug`: デバッグモードスイッチ（開発環境では true を推奨）
- `server.port`: サービスポート
- `server.cors_origins`: フロントエンドの許可 CORS オリジン
@@ -260,12 +268,14 @@ docker logs -f huobao-drama
```
**ローカルビルド**（オプション）：
```bash
docker build -t huobao-drama:latest .
docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-drama:latest
```
**Docker デプロイの利点：**
- ✅ デフォルト設定ですぐに使用可能
- ✅ 環境の一貫性、依存関係の問題を回避
- ✅ ワンクリック起動、Go、Node.js、FFmpeg のインストール不要
@@ -280,6 +290,7 @@ docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-d
**設定手順：**
1. **ホストでサービスを起動（全インターフェースでリッスン）**
```bash
export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
```
@@ -306,12 +317,14 @@ go build -o huobao-drama .
```
生成ファイル：
- `huobao-drama` - バックエンド実行ファイル
- `web/dist/` - フロントエンド静的ファイル（バックエンドに埋め込み）
#### 2. デプロイファイルの準備
サーバーにアップロードするファイル：
```
huobao-drama # バックエンド実行ファイル
configs/config.yaml # 設定ファイル
@@ -372,6 +385,7 @@ WantedBy=multi-user.target
```
サービスを起動：
```bash
sudo systemctl daemon-reload
sudo systemctl enable huobao-drama
@@ -401,11 +415,13 @@ sudo systemctl restart huobao-drama
```
**原因：**
- SQLite はデータベースファイル**と**そのディレクトリの両方に書き込み権限が必要
- ディレクトリ内に一時ファイル（例: `-wal`、`-journal`）を作成する必要がある
- **重要**: systemd の`User`がデータディレクトリの所有者と一致していることを確認
**一般的なユーザー名：**
- Ubuntu/Debian: `www-data`、`ubuntu`
- CentOS/RHEL: `nginx`、`apache`
- カスタムデプロイ: `deploy`、`app`、現在ログインしているユーザー
@@ -436,6 +452,7 @@ server {
## 🎨 技術スタック
### バックエンド
- **言語**: Go 1.23+
- **Web フレームワーク**: Gin 1.9+
- **ORM**: GORM
@@ -445,6 +462,7 @@ server {
- **AI サービス**: OpenAI、Gemini、Doubao など
### フロントエンド
- **フレームワーク**: Vue 3.4+
- **言語**: TypeScript 5+
- **ビルドツール**: Vite 5
@@ -454,6 +472,7 @@ server {
- **ルーター**: Vue Router 4
### 開発ツール
- **パッケージ管理**: Go Modules、npm
- **コード規約**: ESLint、Prettier
- **バージョン管理**: Git
@@ -463,19 +482,24 @@ server {
## 📝 よくある質問
### Q: Docker コンテナからホストの Ollama にアクセスするには？
A: Base URL として `http://host.docker.internal:11434/v1` を使用します。注意点：
1. ホストの Ollama は `0.0.0.0` でリッスンする必要があります: `export OLLAMA_HOST=0.0.0.0:11434 && ollama serve`
2. `docker run` を使用する Linux ユーザーは追加が必要: `--add-host=host.docker.internal:host-gateway`
詳細: [DOCKER_HOST_ACCESS.md](docs/DOCKER_HOST_ACCESS.md)
### Q: FFmpeg がインストールされていない、または見つからない？
A: FFmpeg がインストールされ、PATH 環境変数に含まれていることを確認してください。`ffmpeg -version` で確認。
### Q: フロントエンドがバックエンド API に接続できない？
A: バックエンドが実行中で、ポートが正しいか確認してください。開発モードでは、フロントエンドプロキシ設定は `web/vite.config.ts` にあります。
### Q: データベーステーブルが作成されない？
A: GORM は初回起動時にテーブルを自動作成します。ログでマイグレーション成功を確認してください。
---
@@ -485,6 +509,7 @@ A: GORMは初回起動時にテーブルを自動作成します。ログでマ
### v1.0.2 (2026-01-16)
#### 🚀 主要アップデート
- 純粋な Go SQLite ドライバー（`modernc.org/sqlite`）、`CGO_ENABLED=0` クロスプラットフォームコンパイルをサポート
- 並行性能を最適化（WAL モード）、"database is locked" エラーを解決
- ホストサービスへのアクセス用 `host.docker.internal` の Docker クロスプラットフォームサポート
@@ -493,6 +518,7 @@ A: GORMは初回起動時にテーブルを自動作成します。ログでマ
### v1.0.1 (2026-01-14)
#### 🐛 バグ修正 / 🔧 改善
- 動画生成 API レスポンスのパース問題を修正
- OpenAI Sora 動画エンドポイント設定を追加
- エラー処理とログ出力を最適化
@@ -512,13 +538,27 @@ IssueとPull Requestを歓迎します！
---
## API 設定サイト
2 分で設定完了: [API 集約サイト](https://api.chatfire.site/models)
## 📧 連絡先
ビジネス連絡先（WeChat）: dangbao1117
---
## 👨‍💻 私たちについて
**AI 火宝 - AI スタジオ起業中**
- 🏠 **所在地**: 中国南京
- 🚀 **ステータス**: 起業中
- 📧 **Email**: [18550175439@163.com](mailto:18550175439@163.com)
- 💬 **WeChat**: dangbao1117 （個人 WeChat - 技術的な質問には対応しません）
- 🐙 **GitHub**: [https://github.com/chatfire-AI/huobao-drama](https://github.com/chatfire-AI/huobao-drama)
> _「AI に私たちのより創造的なことを手伝ってもらおう」_
## コミュニティグループ
![コミュニティグループ](drama.png)
- [Issue](../../issues)を提出
- プロジェクトメンテナにメール

48
README.md
View File

@@ -63,22 +63,26 @@ Huobao Drama is an AI-powered short drama production platform that automates the
## ✨ 功能特性
### 🎭 角色管理
- ✅ AI 生成角色形象
- ✅ 批量角色生成
- ✅ 角色图片上传和管理
### 🎬 分镜制作
- ✅ 自动生成分镜脚本
- ✅ 场景描述和镜头设计
- ✅ 分镜图片生成（文生图）
- ✅ 帧类型选择（首帧/关键帧/尾帧/分镜板）
### 🎥 视频生成
- ✅ 图生视频自动生成
- ✅ 视频合成和剪辑
- ✅ 转场效果
### 📦 资源管理
- ✅ 素材库统一管理
- ✅ 本地存储支持
- ✅ 资源导入导出
@@ -91,7 +95,7 @@ Huobao Drama is an AI-powered short drama production platform that automates the
### 📋 环境要求
| 软件 | 版本要求 | 说明 |
|------|---------|------|
| ----------- | -------- | -------------------- |
| **Go** | 1.23+ | 后端运行环境 |
| **Node.js** | 18+ | 前端构建环境 |
| **npm** | 9+ | 包管理工具 |
@@ -101,11 +105,13 @@ Huobao Drama is an AI-powered short drama production platform that automates the
#### 安装 FFmpeg
**macOS:**
```bash
brew install ffmpeg
```
**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install ffmpeg
@@ -115,6 +121,7 @@ sudo apt install ffmpeg
从 [FFmpeg 官网](https://ffmpeg.org/download.html) 下载并配置环境变量
验证安装：
```bash
ffmpeg -version
```
@@ -162,6 +169,7 @@ ai:
```
**重要配置项：**
- `app.debug`: 调试模式开关（开发环境建议设为 true）
- `server.port`: 服务运行端口
- `server.cors_origins`: 允许跨域访问的前端地址
@@ -262,12 +270,14 @@ docker logs -f huobao-drama
```
**本地构建**（可选）：
```bash
docker build -t huobao-drama:latest .
docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-drama:latest
```
**Docker 部署优势：**
- ✅ 开箱即用，内置默认配置
- ✅ 环境一致性，避免依赖问题
- ✅ 一键启动，无需安装 Go、Node.js、FFmpeg
@@ -282,6 +292,7 @@ docker run -d --name huobao-drama -p 5678:5678 -v $(pwd)/data:/app/data huobao-d
**配置步骤：**
1. **宿主机启动服务（监听所有接口）**
```bash
export OLLAMA_HOST=0.0.0.0:11434 && ollama serve
```
@@ -308,12 +319,14 @@ go build -o huobao-drama .
```
生成文件：
- `huobao-drama` - 后端可执行文件
- `web/dist/` - 前端静态文件（已嵌入后端）
#### 2. 准备部署文件
需要上传到服务器的文件：
```
huobao-drama # 后端可执行文件
configs/config.yaml # 配置文件
@@ -374,6 +387,7 @@ WantedBy=multi-user.target
```
启动服务：
```bash
sudo systemctl daemon-reload
sudo systemctl enable huobao-drama
@@ -403,11 +417,13 @@ sudo systemctl restart huobao-drama
```
**原因说明**：
- SQLite 需要对数据库文件 **和** 所在目录都有写权限
- 需要在目录中创建临时文件（如 `-wal`、`-journal`）
- **关键**：确保 systemd 配置中的 `User` 与数据目录所有者一致
**常用用户名**：
- Ubuntu/Debian: `www-data`、`ubuntu`
- CentOS/RHEL: `nginx`、`apache`
- 自定义部署: `deploy`、`app`、当前登录用户
@@ -438,6 +454,7 @@ server {
## 🎨 技术栈
### 后端技术
- **语言**: Go 1.23+
- **Web 框架**: Gin 1.9+
- **ORM**: GORM
@@ -447,6 +464,7 @@ server {
- **AI 服务**: OpenAI、Gemini、火山等
### 前端技术
- **框架**: Vue 3.4+
- **语言**: TypeScript 5+
- **构建工具**: Vite 5
@@ -456,6 +474,7 @@ server {
- **路由**: Vue Router 4
### 开发工具
- **包管理**: Go Modules, npm
- **代码规范**: ESLint, Prettier
- **版本控制**: Git
@@ -465,19 +484,24 @@ server {
## 📝 常见问题
### Q: Docker 容器如何访问宿主机的 Ollama？
A: 使用 `http://host.docker.internal:11434/v1` 作为 Base URL。注意两点：
1. 宿主机 Ollama 需监听 `0.0.0.0`：`export OLLAMA_HOST=0.0.0.0:11434 && ollama serve`
2. Linux 用户使用 `docker run` 需添加：`--add-host=host.docker.internal:host-gateway`
详见：[DOCKER_HOST_ACCESS.md](docs/DOCKER_HOST_ACCESS.md)
### Q: FFmpeg 未安装或找不到？
A: 确保 FFmpeg 已安装并在 PATH 环境变量中。运行 `ffmpeg -version` 验证。
### Q: 前端无法连接后端 API？
A: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 `web/vite.config.ts`。
### Q: 数据库表未创建？
A: GORM 会在首次启动时自动创建表，检查日志确认迁移是否成功。
---
@@ -487,6 +511,7 @@ A: GORM会在首次启动时自动创建表，检查日志确认迁移是否成
### v1.0.2 (2026-01-16)
#### 🚀 重大更新
- SQLite 纯 Go 驱动（`modernc.org/sqlite`），支持 `CGO_ENABLED=0` 跨平台编译
- 优化并发性能（WAL 模式），解决 "database is locked" 错误
- Docker 跨平台支持 `host.docker.internal` 访问宿主机服务
@@ -495,6 +520,7 @@ A: GORM会在首次启动时自动创建表，检查日志确认迁移是否成
### v1.0.1 (2026-01-14)
#### 🐛 Bug Fixes / 🔧 Improvements
- 修复视频生成 API 响应解析问题
- 添加 OpenAI Sora 视频端点配置
- 优化错误处理和日志输出
@@ -514,12 +540,27 @@ A: GORM会在首次启动时自动创建表，检查日志确认迁移是否成
---
## API 配置站点
2 分钟完成配置：[API 聚合站点](https://api.chatfire.site/models)
## 📧 联系方式
商务联系V：dangbao1117
---
## 👨‍💻 关于我们
**AI 火宝 - AI 工作室创业中**
- 🏠 **位置**: 中国南京
- 🚀 **状态**: 创业中
- 📧 **Email**: [18550175439@163.com](mailto:18550175439@163.com)
- 💬 **微信**: dangbao1117 （私人微信不解答任何技术问题）
- 🐙 **GitHub**: [https://github.com/chatfire-AI/huobao-drama](https://github.com/chatfire-AI/huobao-drama)
> _"让 AI 帮我们做更有创造力的事"_
## 项目交流群
![项目交流群](drama.png)
- 提交 [Issue](../../issues)
- 发送邮件至项目维护者
@@ -528,6 +569,7 @@ A: GORM会在首次启动时自动创建表，检查日志确认迁移是否成
<div align="center">
**⭐ 如果这个项目对你有帮助，请给一个 Star！**
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=chatfire-AI/huobao-drama&type=date&legend=top-left)](https://www.star-history.com/#chatfire-AI/huobao-drama&type=date&legend=top-left)