**TypeScript ãã«ã¹ã¿ãã¯ã® AI ã·ã§ãŒããã©ãèªåå¶äœãã©ãããã©ãŒã **
[](https://nodejs.org)
[](https://vuejs.org)
[](https://creativecommons.org/licenses/by-nc-sa/4.0/)
[](https://github.com/chatfire-AI/huobao-drama/releases/latest)
[äžè±åè¯](README.md) | [English](README.en.md) | [ç®äœäžæ](README.zh-CN.md) | **æ¥æ¬èª** | [íêµìŽ](README.ko.md)
[æ©èœ](#-æ©èœ) ⢠[ã¯ã€ãã¯ã¹ã¿ãŒã](#-ã¯ã€ãã¯ã¹ã¿ãŒã) ⢠[ãã¥ãŒããªã¢ã«](#-ãã¥ãŒããªã¢ã«ç»åä»ã) ⢠[ãã¹ã¯ãããç](#-ãã¹ã¯ãããã¢ããªæšå¥š) ⢠[ãããã€](#-ãããã€)
**ããã¹ãã»ç»åã»åç»ã®ãã¹ãŠã® AI æ©èœãã1 ã€ã® Key ã§æå¹å**
ãããã€åŸããèšå® â ç«å®ã¯ã€ãã¯èšå®ãã« Key ã貌ãã ãã§ã3 ã€ã®æšå¥šèšå®ãã¯ã³ã¯ãªãã¯ã§æžã蟌ã¿
---
## ð ãããžã§ã¯ãæŠèŠ
Huobao Drama 㯠AI ããŒã¹ã®ã·ã§ãŒããã©ãèªåå¶äœãã©ãããã©ãŒã ã§ããèæ¬çæããã£ã©ã¯ã¿ãŒãã¶ã€ã³ãåéå¶äœããåç»åæãŸã§ãå
šå·¥çšãèªååããŸãã
### ð¯ ã³ã¢ããªã¥ãŒ
- **ð€ AI é§å**ïŒå€§èŠæš¡èšèªã¢ãã«ã§èæ¬ãè§£æãããã£ã©ã¯ã¿ãŒã»ã·ãŒã³ã»åéæ
å ±ãæœåº
- **ðš ã€ã³ããªãžã§ã³ãå¶äœ**ïŒAI ç»åçæã§ãã£ã©ã¯ã¿ãŒåœ¢è±¡ãšã·ãŒã³èæ¯ãäœæ
- **ð¹ åç»çæ**ïŒããã¹ãâåç»ã»ç»åâåç»ã¢ãã«ã§åéåç»ãèªåçæ
- **ð ã¯ãŒã¯ãããŒ**ïŒã¢ã€ãã¢ãã宿äœåãŸã§ã®ã·ã§ãŒããã©ãå¶äœãã¯ã³ã¹ãããã§å®çµ
### ð ïž æè¡ã¢ãŒããã¯ãã£
```
frontend/ â Nuxt 3 + Vue 3 + TypeScript (çŽç² CSSãUI ãã¬ãŒã ã¯ãŒã¯ãªã)
backend/ â Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3
backend/workspace/skills/ â Agent ã¹ãã«å®çŸ© (SKILL.mdãUI ãããªã³ã©ã€ã³ç·šéå¯èœ)
desktop/ â Electron ãã¹ã¯ãããçïŒã¡ã€ã³ããã»ã¹ + esbuild ãã³ãã« + electron-builder ã§ dmg/exeïŒ
data/ â çæã¢ã»ãããš SQLite ããŒã¿ããŒã¹
```
---
## âš æ©èœ
### ð ãã£ã©ã¯ã¿ãŒç®¡ç
- â
AI ã«ãããã£ã©ã¯ã¿ãŒåœ¢è±¡çæ
- â
ãã£ã©ã¯ã¿ãŒã®äžæ¬çæ
- â
ãã£ã©ã¯ã¿ãŒç»åã®ã¢ããããŒããšç®¡ç
### ð¬ åç»ã¿ã¹ã¯
- â
AI ã«ããåç»ã¿ã¹ã¯ã®èªåçæ
- â
ã·ãŒã³èª¬æãšåç»ããã³ããã®çæ
- â
ã¿ã¹ã¯åäœã®äžæ¬åç»çæ
### ð¥ åç»çæ
- â
ããã¹ãâåç»ã®èªåçæ
- â
FFmpeg ã«ããã·ã§ããåäœã®åæãšåå¹åŠç
- â
ãšããœãŒãå
šäœã®çµåãšæžãåºã
### ðŠ ã¢ã»ãã管ç
- â
çŽ æã©ã€ãã©ãªã®äžå
管ç
- â
ããŒã«ã«ã¹ãã¬ãŒãžå¯Ÿå¿
- â
ã¿ã¹ã¯é²æãã©ããã³ã°
### ð€ AI Agents
4 ã€ã® Mastra Agent ãå
èµãããŒã¿ããŒã¹èšå®ãš Skill æ¡åŒµã«å¯Ÿå¿ïŒ
| Agent | åœ¹å² |
|---|---|
| `script_rewriter` | å°èª¬ â ãã©ãŒãããæžã¿èæ¬ãžã®ãªã©ã€ã |
| `extractor` | ãã£ã©ã¯ã¿ãŒ / ã·ãŒã³ / å°éå
·ã®ã€ã³ããªãžã§ã³ãæœåºãšéè€æé€ |
| `storyboard_breaker` | èæ¬ â åéã·ãŒã±ã³ã¹ãžã®åè§£ |
| `prompt_generator` | ãã£ã©ã¯ã¿ãŒ/ã·ãŒã³/å°éå
·ã®ç»åããã³ãã + åéåç»ããã³ããçæ |
### ð å€èšèª UI
ã€ã³ã¿ãŒãã§ãŒã¹ã¯ **äžæ / English / æ¥æ¬èª / íêµìŽ** ãå
èµããAI çæã³ã³ãã³ãã®èšèªãã°ããŒãã«ã«èšå®ã§ããŸãã
### ð ãã«ããããã€ããŒå¯Ÿå¿
| ã¿ã€ã | 察å¿ãããã€ã㌠|
|---|---|
| **ããã¹ã** | OpenAIïŒäºæ APIïŒãGemini |
| **ç»å** | OpenAIãGeminiãVolcano Engine |
| **åç»** | Volcano Engine Seedance 2.0ïŒStandard / Fast / MiniïŒãMiniMax H3ãAlibaba Bailian Wan 3.0ïŒPrime / StandardïŒ |
---
## ð ã¯ã€ãã¯ã¹ã¿ãŒã
### ð åäœç°å¢
| ãœãããŠã§ã¢ | ããŒãžã§ã³ | 説æ |
|---|---|---|
| **Node.js** | 20+ | ããã³ããšã³ãã»ããã¯ãšã³ãå®è¡ç°å¢ |
| **npm** | 9+ | ããã±ãŒãžãããŒãžã£ãŒ |
> **ããŒã¿ããŒã¹äžèŠ**ïŒSQLite å
èµïŒãããžã§ã¯ãã®ããŒã¿ãã£ã¬ã¯ããªã«åäžãã¡ã€ã«ïŒãããŒã¿ããŒã¹ãµãŒããŒã®ã€ã³ã¹ããŒã«ã¯äžèŠã§ãã
> **FFmpeg äžèŠ**ïŒ`ffmpeg-static` / `ffprobe-static` npm ããã±ãŒãžã«ãã€ããªãå
èµãããã«äœ¿ããŸãã
### âïž ç°å¢å€æ°
èšå®ãã¡ã€ã«ã¯äžèŠãç°å¢å€æ°ã§èšå®ããŸãïŒãã¹ãŠããã©ã«ãå€ãããããŒã«ã«éçºã¯ãŒãèšå®ã§èµ·åå¯èœïŒïŒ
| 倿° | ããã©ã«ãå€ | 説æ |
|---|---|---|
| `SQLITE_PATH` | `<ãªããžããª>/data/huobao.sqlite3` | SQLite ããŒã¿ããŒã¹ãã¡ã€ã«ã®å Žæ |
| `PORT` | `5679` | ããã¯ãšã³ããµãŒãã¹ã®ããŒã |
| `STORAGE_PATH` | `<ãªããžããª>/data/static` | çæãã¡ã€ã«ã®ä¿åãã£ã¬ã¯ã㪠|
| `HUOBAO_DATA_DIR` | â | ãã¹ã¯ãããçã§ Electron ã¡ã€ã³ããã»ã¹ã泚å
¥ïŒuserData ããŒã¿ã«ãŒãïŒ |
| `WORKSPACE_PATH` | `backend/workspace` | Agent ã¹ãã«/ããã³ãããã£ã¬ã¯ããªïŒãã¹ã¯ãããç㯠userData ã®æžã蟌ã¿å¯èœãªã³ããŒïŒ |
| `FRONTEND_DIST` | `frontend/dist` | ããã³ããšã³ãéçãã«ããã£ã¬ã¯ã㪠|
| `FFMPEG_BIN` / `FFPROBE_BIN` | npm å
èµãã€ã㪠| ã«ã¹ã¿ã ffmpeg/ffprobe ã®å®è¡ãã¡ã€ã«ãã¹ |
| `PUBLIC_BASE_URL` | â | Seedance ãããŒã«ã«åç
§ãªãœãŒã¹ã䜿ãéã«å¿
èŠãªå
¬é URLïŒãµãŒããŒãããã€çšïŒ |
> **説æ**ïŒAI ãµãŒãã¹ã® API KeyãBase URLãã¢ãã«ãã©ã¡ãŒã¿ã¯ãã¹ãŠ Web UI ã®ãèšå®ãããŒãžã§èšå®ããŠããŒã¿ããŒã¹ã«ä¿åããŸããèšå®ãã¡ã€ã«ãç°å¢å€æ°ã§ã¯ç®¡çããŸããã
### ð¥ ã€ã³ã¹ããŒã«
```bash
# ãªããžããªãã¯ããŒã³
git clone https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama
# ããã¯ãšã³ãã®äŸåãã€ã³ã¹ããŒã«
cd backend && npm install
# ããã³ããšã³ãã®äŸåãã€ã³ã¹ããŒã«
cd ../frontend && npm install
```
### ð¯ èµ·å
#### æ¹æ³ 1ïŒéçºã¢ãŒãïŒæšå¥šïŒ
ããã³ããšã³ããšããã¯ãšã³ããåé¢ããããããªããŒã察å¿ïŒ
```bash
# ã¿ãŒããã« 1ïŒããã¯ãšã³ã
cd backend
npm run dev
# ã¿ãŒããã« 2ïŒããã³ããšã³ã
cd frontend
npm run dev
```
- ããã³ããšã³ãïŒ`http://localhost:3013`
- ããã¯ãšã³ã APIïŒ`http://localhost:5679/api/v1`
- ããã³ããšã³ã㯠`/api` ãš `/static` ãããã¯ãšã³ããžèªåãããã·
#### æ¹æ³ 2ïŒã·ã³ã°ã«ãµãŒãã¹ã¢ãŒã
ããã¯ãšã³ãã API ãšããã³ããšã³ãéçãã¡ã€ã«ã®äž¡æ¹ãæäŸïŒ
```bash
# 1. ããã³ããšã³ãããã«ã
cd frontend && npm run generate
# 2. ãã«ãææç©ãããã¯ãšã³ããèªããã£ã¬ã¯ããªãžã³ããŒ
# ïŒgenerate ã®åºå㯠.output/publicãããã¯ãšã³ã㯠frontend/dist ãèªãïŒ
cp -r .output/public dist
# 3. ããã¯ãšã³ããèµ·å
cd ../backend && npm start
```
ã¢ã¯ã»ã¹ïŒ`http://localhost:5679`
### ðïž ããŒã¿ããŒã¹
SQLite å
èµïŒ`better-sqlite3` + WAL ã¢ãŒãïŒãååèµ·åæã«ããŒãã«ãèªåäœæïŒåªç㪠DDL ãªãã¬ã€ + ã·ãŒãããŒã¿ïŒãããã©ã«ãã®ãã¡ã€ã«ã¯ `data/huobao.sqlite3`ã`SQLITE_PATH` ã§å€æŽå¯èœããã¹ã¯ãããçã¯ãŠãŒã¶ãŒããŒã¿ãã£ã¬ã¯ããªïŒ`~/Library/Application Support/HuobaoDrama/data/`ïŒã«ä¿åããŸãã
æ§ MySQL ããã®ããŒã¿ç§»è¡ïŒ
**èµ·åæã®èªåç§»è¡ïŒæšå¥šïŒ**ïŒMySQL ãæç€ºçã«èšå®ãããŠããïŒ`DATABASE_URL` ãŸã㯠`MYSQL_HOST`ïŒãSQLite ã空ã®å Žåãããã¯ãšã³ãèµ·åæã«èªåæ€åºããŠå
šããŒãã«ãäžåºŠã ãã€ã³ããŒãããŸãïŒããŒãã«ããšã®è¡æ°æ€èšŒãåäžãã©ã³ã¶ã¯ã·ã§ã³ã®ååæžã蟌ã¿ã倱ææã¯èªåããŒã«ããã¯ããŠæ¬¡åèµ·åæã«å詊è¡ãæååŸã¯ `.mysql-imported` ããŒã«ãŒãæžã蟌ã¿éè€ã鲿¢ïŒã`MYSQL_AUTO_IMPORT=false` ã§ç¡å¹åã§ããŸãã
```bash
# æåå®è¡ãå¯èœïŒå¯Ÿè±¡ DB ã空ã§ãªãå Žå㯠--force ãå¿
èŠãæžã蟌ã¿åã«èªåããã¯ã¢ããïŒ
cd backend && npx tsx scripts/import-mysql-to-sqlite.ts
```
> ç§»è¡ã¯ããŒã¿ããŒã¹ã®è¡ã®ã¿ãã«ããŒããŸããæ§ãããã€ã® `data/static/` é
äžã®ç»åã»åç»ãªã©ã®ã¡ãã£ã¢ãã¡ã€ã«ã¯æåã§ã³ããŒããŠãã ãããã³ããŒããªããšéå»ã®çŽ æã«ã¢ã¯ã»ã¹ã§ããŸããã
### ð ååå©çšïŒAI ãµãŒãã¹ã®èšå®
èµ·ååŸããã¹ãŠã® AI æ©èœïŒããã¹ã/ç»å/åç»ïŒã䜿ãã«ã¯ãå
ã«ã¢ãã«ãµãŒãã¹ã®èšå®ãå¿
èŠã§ããæªèšå®ã®å ŽåãããŒãžäžéšã«ãããŒã§æ¡å
ãããŸãïŒ
1. ãèšå®ãããŒãžãéã
2. ãç«å®ã¯ã€ãã¯èšå®ãã« Huobao API Key ã貌ãïŒ[api.firemux.com ã§ååŸ](https://api.firemux.com)ïŒãããã¹ãã»ç»åã»åç»ã® 3 ã€ã®æšå¥šèšå®ãã¯ã³ã¯ãªãã¯ã§æžã蟌ã¿
3. ãŸãã¯ãæåãã³ãã¬ãŒããã§ãããã€ããŒããšã«è¿œå ãæ¥ç¶ãã¹ãã«å¯Ÿå¿
èšå®ãå®äºãããšãããŒã¯èªåã§æ¶ãããšããœãŒãå¶äœãéå§ã§ããŸãã
---
## ð ãã¥ãŒããªã¢ã«ïŒç»åä»ãïŒ
å°èª¬ãã宿ãšããœãŒããŸã§ã®å
šå·¥çšãå·Šã®é²æããŒãåžžã«çŸåšã®ã¹ããŒãžã瀺ããŸãã
### ã¹ããã 1 · ãããžã§ã¯ãäœæ
ããŒã ã§ãæ°èŠãããžã§ã¯ãããã¯ãªãã¯ãã**ã¢ã¹ãã¯ãæ¯**ïŒ16:9 暪 / 9:16 瞊ãäœæåŸã¯å€æŽäžå¯ïŒãš**äœç»ã¹ã¿ã€ã«**ïŒ3D / ãªã¢ã«ç³»ãªã©ãå
šçå³ããã³ããã«æ³šå
¥ïŒãéžæããŸãã