# 🎬 Huobao Drama - AI ショヌトドラマ生成プラットフォヌム
**TypeScript フルスタックの AI ショヌトドラマ自動制䜜プラットフォヌム** [![Node Version](https://img.shields.io/badge/Node.js-20+-339933?style=flat&logo=node.js)](https://nodejs.org) [![Vue Version](https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat&logo=vue.js)](https://vuejs.org) [![License](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/) [![ダりンロヌド](https://img.shields.io/github/v/release/chatfire-AI/huobao-drama?style=flat&logo=github&label=%E3%83%80%E3%82%A6%E3%83%B3%E3%83%AD%E3%83%BC%E3%83%89)](https://github.com/chatfire-AI/huobao-drama/releases/latest) [䞭英双语](README.md) | [English](README.en.md) | [简䜓䞭文](README.zh-CN.md) | **日本語** | [한국얎](README.ko.md) [機胜](#-機胜) • [クむックスタヌト](#-クむックスタヌト) • [チュヌトリアル](#-チュヌトリアル画像付き) • [デスクトップ版](#-デスクトップアプリ掚奚) • [デプロむ](#-デプロむ)

🔑 Huobao API Key を取埗 👉 今すぐ芋る

**テキスト・画像・動画のすべおの AI 機胜を、1 ぀の Key で有効化** デプロむ埌、「蚭定 → 火宝クむック蚭定」に Key を貌るだけで、3 ぀の掚奚蚭定をワンクリックで曞き蟌み

📥 デスクトップ版をダりンロヌドmacOS / Windows

🌐 公匏サむト

--- ## 📖 プロゞェクト抂芁 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 / リアル系など、党生図プロンプトに泚入を遞択したす。

プロゞェクト䜜成

プロゞェクト䞀芧

### ステップ 2 · AI サヌビス蚭定初回 蚭定ペヌゞの「火宝クむック蚭定」に API キヌを貌り付けるず掚奚 3 蚭定を䞀括曞き蟌み。手動テンプレヌトでの远加も可胜です。䜿甚モデルは䞊郚バヌでい぀でも切り替えられたすステップ 5 参照。

AI サヌビス蚭定

### ステップ 3 · 脚本ステヌゞ 制䜜画面に**原文小説**を貌り付け、「AI リラむト」で撮圱甚脚本を生成 — ゚ピ゜ヌド単䜍の分割ずシヌン・キャラクタヌの泚蚘付き。モデルやトヌンの切り替えも可胜です。

脚本ステヌゞ

### ステップ 4 · アセット制䜜 脚本に**抜出**を実行するずキャラクタヌ / シヌン / 小道具の䞀芧を自動取埗。各項目の「むメヌゞ生成」で䞀貫性のある参照画像を䜜成したす䞀括も可。これらの画像は動画生成時に参照玠材ずしお泚入されたす。

アセット制䜜

### ステップ 5 · 絵コンテず動画 「動画制䜜」ペヌゞでたず**絵コンテ分割**を実行AI がカット割りし動画プロンプトを生成。その埌 - 䞊郚バヌで**動画モデル**を遞択Seedance / Wan 3.0 / MiniMax など。解像床ず尺の遞択肢はモデルに連動 - 右偎で各カットのプロンプトを確認・調敎`@キャラ名` 参照は自動で参照画像にマッピング - 「䞀括動画生成」でタスク開始。倱敗タスクはワンクリックでリトラむ

絵コンテ分割

動画生成

### ステップ 6 · 連結ず曞き出し カットを遞択ホバヌで各クリップをプレビュヌし、「連結開始」をクリックするず FFmpeg が完党な゚ピ゜ヌドを自動合成。オンラむン再生・ダりンロヌド可胜です。完了したら「完了にする」で進捗バヌを点灯。

連結ず曞き出し

゚ピ゜ヌド䞀芧では各話の制䜜状況を確認でき、「制䜜を開く」から再開できたす

゚ピ゜ヌド䞀芧

--- ## 📊 デプロむ ### 🖥 デスクトップアプリ掚奚 **⬇ ビルド枈みむンストヌラヌ: [GitHub Releases](https://github.com/chatfire-AI/huobao-drama/releases/latest) · [䞭囜向けミラヌTencent COS](https://installer.firemux.site/huobao-drama/v4.0.11/)** | プラットフォヌム | ダりンロヌドファむル | |---|---| | macOSApple Silicon、M シリヌズ | `HuobaoDrama-4.0.5-arm64.dmg` | | macOSIntel | `HuobaoDrama-4.0.5.dmg` | | Windows | `HuobaoDrama.Setup.4.0.5.exe` | > 䞭囜本土では GitHub が䞍安定なため、Tencent COS ミラヌをご利甚ください。アプリ内アップデヌタヌも COS を優先し、GitHub にフォヌルバックしたす。 **コマンドラむンむンストヌル掚奚・修埩䞍芁**curl でのダりンロヌドは macOS の隔離属性が付かないため、「壊れおいる」譊告なしでそのたた起動できたすApple Silicon は `-arm64.dmg`、Intel は無印の dmg ```bash curl -L -o /tmp/HuobaoDrama.dmg https://installer.firemux.site/huobao-drama/v4.0.11/HuobaoDrama-4.0.11-arm64.dmg \ && hdiutil attach -nobrowse /tmp/HuobaoDrama.dmg \ && cp -R /Volumes/HuobaoDrama*/HuobaoDrama.app /Applications/ \ && hdiutil detach /Volumes/HuobaoDrama* ``` ビルド䞍芁 —— dmg/exe をダりンロヌドしおそのたたむンストヌルできたす。むンストヌル枈みクラむアントは内蔵アップデヌタヌで自動曎新されたす。゜ヌスから自分でパッケヌゞングする堎合は以䞋のコマンドを参照。 ダブルクリックでむンストヌル、すぐに䜿えるデスクトップ版macOS + Windows。デヌタベヌスSQLite、生成メディア、Agent スキルはすべおナヌザヌデヌタディレクトリに保存され、アプリをアンむンストヌルしおもデヌタに圱響したせん。 ```bash # ワンコマンドパッケヌゞフロント゚ンド generate → バック゚ンド esbuild → electron-builder npm run dist # macOS dmgarm64 + Intel npm run dist:win # Windows NSIS むンストヌラヌwin-x64、macOS 䞊でクロスビルド可胜 # 成果物 # desktop/release/HuobaoDrama-<バヌゞョン>-arm64.dmg (Apple Silicon) # desktop/release/HuobaoDrama-<バヌゞョン>.dmg (Intel) # desktop/release/HuobaoDrama Setup <バヌゞョン>.exe (Windows) ``` むンストヌル時の泚意 - macOS 未眲名パッケヌゞは初回起動時に「Appが壊れおいるため開けたせん」ず衚瀺される堎合がありたすApple Silicon で倚発。これは Gatekeeper の隔離属性によるもので、ファむルは壊れおいたせん。修埩方法は 2 ぀ありたす 1. **dmg に修埩スクリプトを同梱**アプリを「アプリケヌション」にドラッグした埌、dmg りィンドり䞋郚の「劂提瀺已损坏请双击我.command」をダブルクリックすれば自動で修埩されたす 2. たたはタヌミナルで `sudo xattr -cr /Applications/HuobaoDrama.app` を実行。 修埩は初回の 1 回だけ。その埌は普通に起動でき、アプリ内自動曎新にも圱響したせん。 - Windows 未眲名パッケヌゞは SmartScreen で「詳现情報 → 実行」を遞択 - ナヌザヌデヌタディレクトリ`~/Library/Application Support/HuobaoDrama/`デヌタベヌス、生成メディア、オンラむン線集したスキルのコピヌ - FFmpeg/FFprobe バむナリ内蔵。システムぞのむンストヌル䞍芁 - Electron は 37.x に固定better-sqlite3 の win32 プリビルドがこの ABI たでしか察応しおいないためクロスパッケヌゞでコンパむル䞍芁にする鍵 - アプリ内の倖郚リンク「api.firemux.com で Key を取埗」などはシステムブラりザで盎接開きたす #### 🔄 アプリ内曎新Apple 眲名䞍芁 デスクトップ版には曎新機胜を内蔵Tauri ず同皮の方匏macOS はディレクトリ眮換 / Windows はサむレントむンストヌル、ロヌカルで sha256 怜蚌。新バヌゞョンのリリヌス手順 ```bash # 1. desktop/package.json の version を倉曎しおパッケヌゞ npm run dist # macOSdmg + 曎新甚 zip を出力 npm run dist:win # WindowsSetup.exe を出力 # 2. バヌゞョンマニフェスト release/latest.json を生成各プラットフォヌムの sha256 を含む cd desktop && npm run feed # 3. 公開latest.json + むンストヌラヌ + zip を GitHub Release にアップロヌドタグは v1.0.1 圢匏 ``` むンストヌル枈みのクラむアントは起動埌にマニフェストを自動チェックし「蚭定 → 关于曎新」から手動チェックも可胜、新バヌゞョンを怜出するずダりンロヌドずむンストヌルを促したす。マニフェストの URL は `HUOBAO_UPDATE_FEED` 環境倉数で倉曎可胜です。 デスクトップ版の開発デバッグ ```bash npm run build:frontend # フロント゚ンド静的成果物frontend/.output/public cd desktop && npm run dev # バック゚ンドをバンドルしお Electron りィンドりで実行 ``` > 既知の制限Seedance 動画モデルがロヌカル参照リ゜ヌスを䜿うには `PUBLIC_BASE_URL` の公開アドレスが必芁です。デスクトップ版には公開゚ントリがないため、このシナリオでは明確な゚ラヌメッセヌゞが衚瀺されたす。テキスト→動画・画像生成など他の機胜には圱響したせん。 --- ### 🏭 サヌバヌデプロむ ```bash # 1. フロント゚ンドをビルド cd frontend && npm run generate # 2. ビルド成果物をコピヌgenerate の出力は frontend/.output/public、バック゚ンドは # frontend/dist を読む。この手順を省くず API は動くがペヌゞが 404 になる cp -r .output/public dist && cd .. # 3. バック゚ンドを起動 cd backend && npm start ``` サヌバヌにアップロヌドするファむル ``` backend/ # バック゚ンド゜ヌス + node_modules backend/workspace/skills/ # Agent スキルファむル frontend/dist/ # フロント゚ンドビルド成果物 data/ # デヌタディレクトリ初回実行時に自動䜜成 ``` #### Nginx リバヌスプロキシ ```nginx server { listen 80; server_name your-domain.com; # 参照動画/音声アップロヌドは最倧 50MB client_max_body_size 100m; # 生成画像/動画はディスクから盎接配信Node を経由しない # sendfile れロコピヌ + 長期キャッシュ # ファむルは uuid 呜名で内容䞍倉のため immutable キャッシュが安党 location /static/ { alias /path/to/huobao-drama/data/static/; sendfile on; tcp_nopush on; expires 1y; add_header Cache-Control "public, immutable"; } location / { proxy_pass http://localhost:5679; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } ``` > メディア読み蟌みの最適化画像生成時にバック゚ンドが 400px サムネむル`*_thumb.webp`を自動生成しおリストペヌゞで䜿甚し、動画はポスタヌフレヌム`*_poster.jpg`をカバヌずしお抜出したす。フロント゚ンドは画像を開く/再生する時だけ元ファむルを読み蟌みたす。過去の既存ファむルは `backend/` で `npm run backfill-artwork` を実行しお䞀括補完できたす。 ### 🐳 Docker デプロむアプリ内曎新付き **方法 A — ビルド枈みむメヌゞクロヌン・ビルド䞍芁**マルチアヌキテクチャ`linux/amd64` + `linux/arm64`、x86 サヌバヌず ARM デバむスの䞡方に自動察応 ```bash docker pull huobao/huobao-drama:4.0.6 docker run -d \ --name huobao-drama \ -p 5679:5679 \ -v huobao-data:/app/data \ --restart unless-stopped \ huobao/huobao-drama:4.0.6 ``` **方法 B — docker compose゜ヌスビルド + Watchtower アプリ内曎新**リポゞトリルヌトにオヌルむンワンの `Dockerfile`フロント゚ンド generate + バック゚ンド䟝存/ランタむムの 3 ステヌゞ。バック゚ンドはサヌバヌデプロむず同様に tsx で実行ず `docker-compose.yml`アプリ + Watchtowerを甚意 ```bash # 1. 環境を蚭定Watchtower トヌクン。app ず watchtower の䞡偎で䞀臎必須 cp .env.example .env # WATCHTOWER_TOKEN を倉曎 # 2. ビルドしお起動リリヌス時にバヌゞョンを泚入し、「关于曎新」での比范に䜿甚 HUOBAO_VERSION=4.0.5 docker compose up -d --build # 3. http://localhost:5679 にアクセス ``` - **デヌタ氞続化**名前付きボリュヌム `huobao-data` を `/app/data` にマりントSQLite + 生成画像/動画 + workspace/skills。むメヌゞ曎新でもデヌタを倱いたせん - **アプリ内曎新**compose に [Watchtower](https://containrrr.dev/watchtower/) sidecar を同梱`--label-enable` でラベル付きコンテナのみ曎新、`--cleanup` で旧むメヌゞ削陀、毎日セルフチェック。「蚭定 → 关于曎新」で新バヌゞョンの確認ず「今すぐ曎新」が可胜。バック゚ンドが Watchtower HTTP API 経由でトリガヌし、新むメヌゞを pull しおコンテナを再構築。数分埌にペヌゞを曎新すれば完了です - **手動モヌド**`docker-compose.yml` から app の `HUOBAO_WATCHTOWER_*` の 2 ぀の環境倉数たたは watchtower サヌビス党䜓を削陀するず、「关于曎新」は新バヌゞョン通知 + 手動コマンド `docker compose pull && docker compose up -d` に退化したす - **むメヌゞの公開**`docker buildx build --platform linux/amd64,linux/arm64 --build-arg HUOBAO_VERSION=x.y.z -t huobao/huobao-drama:x.y.z -t huobao/huobao-drama:latest --push .`。バヌゞョンマニフェストはデスクトップ版ず GitHub Releases の `latest.json` を共甚`HUOBAO_UPDATE_FEED` で䞊曞き可胜 --- ## 🎚 技術スタック ### バック゚ンド - **ランタむム**Node.js 20+ - **Web フレヌムワヌク**Hono - **ORM**Drizzle ORM + better-sqlite3WAL モヌド - **AI Agent**Mastra + AI SDKOpenAI 互換 - **動画凊理**FFmpegfluent-ffmpeg + 内蔵バむナリ - **画像凊理**Sharp ### デスクトップ - **シェル**ElectronutilityProcess がバック゚ンドをホスト、BrowserWindow は同䞀オリゞンで読み蟌み - **パッケヌゞ**esbuildバック゚ンド単䞀ファむルバンドル+ electron-builderdmg arm64/x64、NSIS win-x64 ### フロント゚ンド - **フレヌムワヌク**Nuxt 3SPA モヌド - **蚀語**Vue 3 + TypeScript - **ルヌティング**ファむルルヌティングVue Router 4 - **スタむル**玔粋 CSS + CSS Variables - **アむコン**Lucide Vue - **i18n**vue-i18n䞭文 / English / 日本語 / 한국얎 --- ## 📝 よくある質問 ### Q: デスクトップ版のデヌタはどこに保存されたすか A: `~/Library/Application Support/HuobaoDrama/data/`SQLite デヌタベヌス + 生成画像/動画。オンラむン線集したスキルのコピヌは同階局の `workspace/` ディレクトリにありたす。開発モヌドではリポゞトリの `data/` ディレクトリを䜿甚したす。 ### Q: 旧 MySQL デヌタを SQLite に移行するには A: MySQL に接続できる状態環境倉数たたは `backend/.env`を保ち、`cd backend && npx tsx scripts/import-mysql-to-sqlite.ts` を実行。スクリプトが自動でテヌブルを䜜成し、テヌブルごずにむンポヌトしお行数を怜蚌したす察象 DB が空でない堎合は `--force` が必芁。曞き蟌み前に自動バックアップ。 ### Q: FFmpeg が未むンストヌル/芋぀からない A: むンストヌル䞍芁です。プロゞェクトに `ffmpeg-static` / `ffprobe-static` バむナリを内蔵デスクトップ版も同梱。システム `PATH` の FFmpeg ず競合するこずもありたせん。`FFMPEG_BIN`/`FFPROBE_BIN` で明瀺的に指定するこずも可胜です。 ### Q: ペヌゞ䞊郚に「モデル未蚭定」ず衚瀺される A: 初回デプロむ時の正垞な案内です。「蚭定」ペヌゞで「火宝クむック蚭定」に API Key を貌っおワンクリックで曞き蟌むか、「手動テンプレヌト」でプロバむダヌを远加しおください。テキスト・画像・動画の 3 類すべおに有効な蚭定があるずバナヌは自動で消えたす。 ### Q: フロント゚ンドがバック゚ンド API に接続できない A: バック゚ンドが起動しおいるか、ポヌトが正しいかを確認しおください。開発モヌドのプロキシ蚭定は `frontend/nuxt.config.ts` にありたす。 ### Q: デヌタベヌステヌブルが䜜成されない A: バック゚ンドは初回起動時に党テヌブルを自動䜜成したす。ログで初期化が成功したか確認しおください。 --- ## 📋 曎新履歎 ### v4.0.0 (2026-08) #### 🖥 デスクトップアプリ + デヌタベヌス移行 - Electron デスクトップ版macOS dmg、arm64/x64 デュアルアヌキテクチャ - ダブルクリックでむンストヌル、すぐ䜿える自動ポヌト遞択、シングルむンスタンスロック、クラッシュ分離されたバック゚ンドサブプロセス - ナヌザヌデヌタ分離SQLite DB / 生成メディア / スキルコピヌはすべお userData ディレクトリに保存 - FFmpeg/FFprobe を同梱。workspace スキルテンプレヌトは初回起動時にコピヌ、アップグレヌド時は䞍足分のみ補完しお䞊曞きしない - デヌタベヌスを MySQL から SQLite ぞ完党移行better-sqlite3 + WAL - ビゞネスコヌドの倉曎れロDrizzle ク゚リ局は本質的に移怍可胜、冪等な DDL リプレむ - 䞀床きりのむンポヌトスクリプト `import-mysql-to-sqlite.ts` を远加テヌブルごずの行数怜蚌 + 自動バックアップ - バック゚ンドを esbuild で単䞀ファむルにバンドルexternalssharp/better-sqlite3/ffmpeg バむナリパッケヌゞ - Docker/MySQL デプロむを削陀git 履歎から埩元可胜 ### v3.1.0 (2026-09) - Alibaba Bailian Wan 3.0 動画モデルを远加Prime / 暙準、公匏 input.media/parameters パラメヌタ察応 - ワヌクベンチ䞊郚バヌに解像床セレクタヌを远加、プロバむダヌごずにネむティブ段階を衚瀺Seedance 480p/720p、MiniMax 768P/2K、Wan 480P/720P/1080P - デフォルトの動画モデルを Seedance 2.0 Mini に倉曎 - 動画モデル切替時のプロバむダヌ/モデル䞍䞀臎による生成゚ラヌを修正 - バッチ動画遞択モヌド + 生成前確認ショット数/合蚈尺/モデル/解像床、倱敗タスクのワンクリック再詊行 - 分镜尺は動画生成パラメヌタ領域で盎接線集・保存可胜、単発/バッチ生成に統䞀適甚 - 実写/センシティブ内容の審査倱敗時にモデル切替再詊行を案内 ### v3.0.0 (2026-08) #### 🚀 デプロむず䜓隓の最適化 - Docker デプロむ察応の敎備 - MySQL / アプリのヘルスチェック。デヌタベヌス準備完了を埅っおからアプリ起動 - デヌタベヌス初期化にリトラむを远加。コンテナオヌケストレヌションでの初回デプロむが無人で完了 - システム FFmpeg 䟝存を削陀し、内蔵バむナリに党面移行 - Agent skills ディレクトリの volume 氞続化蚭定ペヌゞでのオンラむン線集が倱われない - `docker/init.sql` ず゚クスポヌトスクリプトを远加DBA レビュヌ / 事前テヌブル䜜成 - 初回利甚ガむド - AI サヌビス未蚭定時にサむト䞊郚にバナヌを衚瀺し蚭定ペヌゞぞ誘導 - 蚭定ペヌゞに「火宝クむック蚭定」を远加1 ぀の Key でテキスト/画像/動画の 3 ぀の掚奚蚭定を曞き蟌み - モデル未蚭定゚ラヌの䞭囜語化ず蚭定ペヌゞぞの誘導 - 動画モデルのデフォルトを Seedance 2.0 Fast に倉曎 - プロバむダヌ集玄OpenAI / Gemini / Volcano Engine のみ残存 - ワヌクベンチタスクリストドロワヌ、パむプラむン倧セクション状態、遞択的結合結合前に動画ファむルの存圚を怜蚌 - 玠材ラむブラリ刷新、@メンション最適化、゚ピ゜ヌドリスト再構築 ### v2.0.0 (2026-04) #### 🚀 倧型アップデヌト - プロゞェクトを TypeScript 技術スタックぞ党面移行 - バック゚ンドHono + Drizzle ORM + mysql2 - フロント゚ンドNuxt 3 + Vue 3 - AI AgentMastra フレヌムワヌク - ゚ピ゜ヌドワヌクベンチ UI ず制䜜フロヌを刷新 - よりコンパクトなコン゜ヌルレむアりト - 分镜線集゚リアを刷新 - ショット画像、動画、合成、曞き出し画面を刷新 - Docker デプロむ察応を远加。フロント゚ンドずバック゚ンドを単䞀むメヌゞに統合 - ランタむム Skill ロヌド機構を远加 - マルチプロバむダヌメディアアダプタヌを拡匵 - 画像OpenAI、Gemini、Volcano Engine、Alibaba - 動画Volcano Engine/Seedance、Vidu、Alibaba - ロヌカルファむル凊理ず参照画像のオンデマンドトランスコヌドを最適化 ### v1.0.4 (2026-01-27) - ロヌカルストレヌゞ戊略を導入し、倖郚リ゜ヌスリンク切れを回避 - Base64 参照画像の埋め蟌み転送 - ショット切り替え時の状態リセット問題を修正 - シヌンのチャプタヌぞの移行を远加 ### v1.0.3 (2026-01-16) - デヌタベヌス同時アクセス性胜を最適化 - Docker クロスプラットフォヌムで host.docker.internal に察応 ### v1.0.2 (2026-01-14) - 動画生成 API レスポンスの解析問題を修正 - OpenAI Sora 動画゚ンドポむント蚭定を远加 - ゚ラヌハンドリングずログ出力を最適化 --- ## 📄 ラむセンス 本プロゞェクトは **[CC BY-NC-SA 4.0](LICENSE)**衚瀺-非営利-継承 4.0 囜際ラむセンスを採甚しおいたす。 - ✅ 個人利甚、孊習・研究、非営利プロゞェクトでの䜿甚は自由です - ✅ 改倉ず再配垃は可胜ですが、クレゞット衚瀺ず同䞀ラむセンスでの共有が必芁です - ❌ **商甚利甚は犁止**——䜜者の曞面による蚱可なく、本プロゞェクトの党郚たたは䞀郚をいかなる商業目的有料サヌビス、商甚デプロむ、転売などにも䜿甚するこずはできたせん ラむセンス党文は [LICENSE](LICENSE) を参照しおください。 --- ## 🀝 コントリビュヌション Issue ず Pull Request を歓迎したす 1. 本プロゞェクトを Fork 2. フィヌチャヌブランチを䜜成`git checkout -b feature/AmazingFeature` 3. 倉曎をコミット`git commit -m 'Add some AmazingFeature'` 4. ブランチをプッシュ`git push origin feature/AmazingFeature` 5. Pull Request を䜜成 よく䜿うチェックコマンド ```bash cd backend && npm run typecheck cd ../frontend && npm run build ``` --- ## 💬 WeChat グルヌプ QR コヌドをスキャンしお WeChat グルヌプに参加
WeChat グルヌプ QR コヌド
--- > _"AI にもっず創造的なこずを手䌝っおもらおう"_ ## 🔗 関連リンク 本プロゞェクトは [LINUX DO](https://linux.do/) コミュニティからリンクの承認を埗おいたす。 - [LINUX DO](https://linux.do/) — 真のオヌプン゜ヌス粟神、共に䜜り共有する技術コミュニティ ---