[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-chatfire-AI--huobao-drama":3,"tool-chatfire-AI--huobao-drama":64},[4,17,27,35,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":10,"last_commit_at":41,"category_tags":42,"status":16},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[13,14,15,43],"视频",{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":23,"last_commit_at":50,"category_tags":51,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":23,"last_commit_at":58,"category_tags":59,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,60,43,61,15,62,26,13,63],"数据工具","插件","其他","音频",{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":80,"owner_twitter":79,"owner_website":81,"owner_url":82,"languages":83,"stars":100,"forks":101,"last_commit_at":102,"license":79,"difficulty_score":10,"env_os":103,"env_gpu":104,"env_ram":105,"env_deps":106,"category_tags":120,"github_topics":79,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":121,"updated_at":122,"faqs":123,"releases":164},4184,"chatfire-AI\u002Fhuobao-drama","huobao-drama","🎬 火宝短剧 - 基于AI的一站式短剧生成平台 《一句话生成完整短剧，从剧本到成片全自动化》  Huobao Drama - An AI-Powered End-to-End Short Drama Generator \"One Sentence to Complete Drama: Fully Automated from Script to Final Video\"","火宝短剧（Huobao Drama）是一款基于 AI 技术的全栈自动化短剧生成平台，旨在将“一句话创意”直接转化为完整的短视频作品。它彻底改变了传统短剧制作流程繁琐、成本高昂的痛点，实现了从剧本创作、角色设计、分镜拆解到视频合成与配音的全链路自动化。\n\n该工具特别适合希望快速验证创意的内容创作者、短剧制作人以及具备一定技术基础的开发者使用。对于普通用户，它降低了视频制作门槛；对于开发者，其开源架构提供了极高的定制自由度。\n\n火宝短剧的技术亮点在于其模块化设计与强大的 Agent 协作能力。系统内置了五个专用 AI 智能体，分别负责剧本改写、要素提取、分镜规划、音色分配及提示词生成，确保各环节精准衔接。技术栈采用 TypeScript 全栈方案（前端 Nuxt 3 + Vue 3，后端 Hono + Mastra），支持灵活对接 OpenAI、MiniMax、火山引擎等多家主流大模型厂商的图片、视频及语音服务。配合本地 SQLite 数据库与 FFmpeg 处理引擎，用户不仅能统一管理素材与任务进度，还能在本地环境中高效完成高质量的短剧生产与导出。","# 🎬 Huobao Drama - AI 短剧生成平台\n\n\u003Cdiv align=\"center\">\n\n**基于 TypeScript 全栈的 AI 短剧自动化生产平台**\n\n[![Node Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-20+-339933?style=flat&logo=node.js)](https:\u002F\u002Fnodejs.org)\n[![Vue Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVue-3.x-4FC08D?style=flat&logo=vue.js)](https:\u002F\u002Fvuejs.org)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-CC%20BY--NC--SA%204.0-lightgrey.svg)](https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby-nc-sa\u002F4.0\u002F)\n\n[功能特性](#功能特性) • [快速开始](#快速开始) • [部署指南](#部署指南)\n\n\u003C\u002Fdiv>\n\n---\n\n## 📖 项目简介\n\nHuobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。\n\n火宝短剧商业版地址：[火宝短剧商业版](https:\u002F\u002Fdrama.chatfire.site\u002Fshortvideo)\n火宝小说生成：[火宝小说生成](https:\u002F\u002Fmarketing.chatfire.site\u002Fhuobao-novel\u002F)\n\n### 🎯 核心价值\n\n- **🤖 AI 驱动**：使用大语言模型解析剧本，提取角色、场景和分镜信息\n- **🎨 智能创作**：AI 绘图生成角色形象和场景背景\n- **📹 视频生成**：基于文生视频和图生视频模型自动生成分镜视频\n- **🔄 工作流**：完整的短剧制作工作流，从创意到成片一站式完成\n\n### 🛠️ 技术架构\n\n```\nfrontend\u002F   — Nuxt 3 + Vue 3 + TypeScript (纯 CSS，无 UI 框架)\nbackend\u002F    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3\nconfigs\u002F    — config.yaml 配置文件\ndata\u002F       — SQLite 数据库 + 生成资源文件\nskills\u002F     — Agent 技能定义 (SKILL.md)\n```\n\n### 🎥 作品展示 \u002F Demo Videos\n\n体验 AI 短剧生成效果：\n\n\u003Cdiv align=\"center\">\n\n**示例作品 1**\n\n\u003Cvideo src=\"https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002F20260114094337396.mp4\" controls width=\"640\">\u003C\u002Fvideo>\n\n**示例作品 2**\n\n\u003Cvideo src=\"https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002Ffcede75e8aeafe22031dbf78f86285b8.mp4\" controls width=\"640\">\u003C\u002Fvideo>\n\n[点击观看视频 1](https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002F20260114094337396.mp4) | [点击观看视频 2](https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002Ffcede75e8aeafe22031dbf78f86285b8.mp4)\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ 功能特性\n\n### 🎭 角色管理\n\n- ✅ AI 生成角色形象\n- ✅ 批量角色生成\n- ✅ 角色图片上传和管理\n- ✅ 角色音色分配与试听\n\n### 🎬 分镜制作\n\n- ✅ AI 自动拆解分镜脚本\n- ✅ 场景描述和镜头设计\n- ✅ 分镜图片生成（文生图）\n- ✅ 宫格图生成、切分与分配\n- ✅ 帧类型选择（首帧\u002F尾帧\u002F分镜板）\n\n### 🎥 视频生成\n\n- ✅ 图生视频自动生成\n- ✅ TTS 配音生成\n- ✅ FFmpeg 单镜头合成（视频 + 音频 + 字幕）\n- ✅ 整集拼接导出\n\n### 📦 资源管理\n\n- ✅ 素材库统一管理\n- ✅ 本地存储支持\n- ✅ 任务进度追踪\n\n### 🤖 AI Agents\n\n内置 5 个 Mastra Agent，支持数据库配置和 Skill 扩展：\n\n| Agent | 职责 |\n|---|---|\n| `script_rewriter` | 小说 → 格式化剧本改写 |\n| `extractor` | 角色 + 场景智能提取与去重 |\n| `storyboard_breaker` | 剧本 → 分镜序列拆解 |\n| `voice_assigner` | 角色音色自动分配 |\n| `grid_prompt_generator` | 角色\u002F场景\u002F宫格图提示词生成 |\n\n### 🔌 多厂商适配\n\n| 类型 | 支持厂商 |\n|---|---|\n| **图片** | OpenAI、Gemini、MiniMax、火山引擎、阿里、Chatfire |\n| **视频** | MiniMax、火山引擎\u002FSeedance、Vidu、阿里 |\n| **TTS** | MiniMax |\n\n---\n\n## 🚀 快速开始\n\n### 📋 环境要求\n\n| 软件 | 版本要求 | 说明 |\n|---|---|---|\n| **Node.js** | 20+ | 前后端运行环境 |\n| **npm** | 9+ | 包管理工具 |\n| **FFmpeg** | 4.0+ | 视频处理（**必需**） |\n\n#### 安装 FFmpeg\n\n**macOS:**\n\n```bash\nbrew install ffmpeg\n```\n\n**Ubuntu\u002FDebian:**\n\n```bash\nsudo apt update && sudo apt install ffmpeg\n```\n\n**Windows:**\n从 [FFmpeg 官网](https:\u002F\u002Fffmpeg.org\u002Fdownload.html) 下载并配置环境变量\n\n验证安装：\n\n```bash\nffmpeg -version\n```\n\n### ⚙️ 配置文件\n\n复制并编辑配置文件：\n\n```bash\ncp configs\u002Fconfig.example.yaml configs\u002Fconfig.yaml\n```\n\n配置文件格式（`configs\u002Fconfig.yaml`）：\n\n```yaml\napp:\n  name: \"Huobao Drama API\"\n  version: \"1.0.0\"\n  debug: true\n\nserver:\n  port: 5679\n  host: \"0.0.0.0\"\n  cors_origins:\n    - \"http:\u002F\u002Flocalhost:3013\"\n\ndatabase:\n  type: \"sqlite\"\n  path: \".\u002Fdata\u002Fhuobao_drama.db\"\n\nstorage:\n  type: \"local\"\n  local_path: \".\u002Fdata\u002Fstorage\"\n  base_url: \"http:\u002F\u002Flocalhost:5679\u002Fstatic\"\n\nai:\n  default_text_provider: \"openai\"\n  default_image_provider: \"openai\"\n  default_video_provider: \"doubao\"\n```\n\n> **说明**：AI 服务的具体 API Key 和模型参数在 Web 界面的「设置」页面中配置。\n\n### 📥 安装依赖\n\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama.git\ncd huobao-drama\n\n# 安装后端依赖\ncd backend && npm install\n\n# 安装前端依赖\ncd ..\u002Ffrontend && npm install\n```\n\n### 🎯 启动项目\n\n#### 方式一：开发模式（推荐）\n\n前后端分离，支持热重载：\n\n```bash\n# 终端1：启动后端\ncd backend\nnpm run dev\n\n# 终端2：启动前端\ncd frontend\nnpm run dev\n```\n\n- 前端地址: `http:\u002F\u002Flocalhost:3013`\n- 后端 API: `http:\u002F\u002Flocalhost:5679\u002Fapi\u002Fv1`\n- 前端自动代理 `\u002Fapi` 和 `\u002Fstatic` 到后端\n\n#### 方式二：单服务模式\n\n后端同时提供 API 和前端静态文件：\n\n```bash\n# 1. 构建前端\ncd frontend && npm run generate\n\n# 2. 启动后端\ncd ..\u002Fbackend && npm start\n```\n\n访问: `http:\u002F\u002Flocalhost:5679`\n\n### 🗄️ 数据库\n\n数据库表在首次启动时自动创建，无需手动迁移。默认路径 `data\u002Fhuobao_drama.db`，可通过环境变量覆盖：\n\n```bash\nDB_PATH=\u002Fpath\u002Fto\u002Fyour.db npm start\n```\n\n---\n\n## 📦 部署指南\n\n### ☁️ 云端一键部署（推荐 3080Ti）\n\n👉 [优云智算，一键部署](https:\u002F\u002Fwww.compshare.cn\u002Fimages\u002FCaWEHpAA8t1H?referral_code=8hUJOaWz3YzG64FI2OlCiB&ytag=GPU_YY_YX_GitHub_huobaoai)\n\n> ⚠️ **注意**：云端部署方案数据请及时存储到本地\n\n---\n\n### 🐳 Docker 部署（推荐）\n\n#### 方式一：Docker Compose（推荐）\n\n```bash\n# 启动服务\ndocker compose up -d\n\n# 查看日志\ndocker compose logs -f\n\n# 停止服务\ndocker compose down\n```\n\n#### 方式二：Docker 命令\n\n```bash\n# 从 Docker Hub 运行\ndocker run -d \\\n  --name huobao-drama \\\n  -p 5679:5679 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  -v $(pwd)\u002Fconfigs\u002Fconfig.yaml:\u002Fapp\u002Fconfigs\u002Fconfig.yaml \\\n  --restart unless-stopped \\\n  huobao\u002Fhuobao-drama:latest\n\n# 查看日志\ndocker logs -f huobao-drama\n```\n\n> **注意**：Linux 用户需添加 `--add-host=host.docker.internal:host-gateway` 以访问宿主机服务\n\n**本地构建**（可选）：\n\n```bash\ndocker build -t huobao-drama:latest .\ndocker run -d --name huobao-drama -p 5679:5679 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  -v $(pwd)\u002Fconfigs\u002Fconfig.yaml:\u002Fapp\u002Fconfigs\u002Fconfig.yaml \\\n  huobao-drama:latest\n```\n\n**Docker 部署优势：**\n\n- ✅ 开箱即用，内置 FFmpeg 和默认配置\n- ✅ 前后端合并为单镜像、单端口\n- ✅ 环境一致性，避免依赖问题\n- ✅ `data\u002F` 目录 volume 挂载，数据持久化\n\n#### 🔗 访问宿主机服务（Ollama \u002F 本地模型）\n\n容器内可通过 `http:\u002F\u002Fhost.docker.internal:端口号` 访问宿主机服务。\n\n**配置步骤：**\n\n1. 宿主机启动服务（监听所有接口）：\n\n   ```bash\n   export OLLAMA_HOST=0.0.0.0:11434 && ollama serve\n   ```\n\n2. 在 Web 界面「设置 → AI 服务配置」中填写：\n   - Base URL: `http:\u002F\u002Fhost.docker.internal:11434\u002Fv1`\n   - Provider: `openai`\n   - Model: `qwen2.5:latest`\n\n---\n\n### 🏭 传统部署方式\n\n```bash\n# 1. 构建前端\ncd frontend && npm run generate && cd ..\n\n# 2. 启动后端\ncd backend && npm start\n```\n\n需要上传到服务器的文件：\n\n```\nbackend\u002F          # 后端源码 + node_modules\nfrontend\u002Fdist\u002F    # 前端构建产物\nconfigs\u002Fconfig.yaml\ndata\u002F             # 数据目录（首次运行自动创建）\nskills\u002F           # Agent 技能文件\n```\n\n#### Nginx 反向代理\n\n```nginx\nserver {\n    listen 80;\n    server_name your-domain.com;\n\n    location \u002F {\n        proxy_pass http:\u002F\u002Flocalhost:5679;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    }\n}\n```\n\n---\n\n## 🎨 技术栈\n\n### 后端\n\n- **运行时**: Node.js 20+\n- **Web 框架**: Hono\n- **ORM**: Drizzle ORM + better-sqlite3\n- **AI Agent**: Mastra + AI SDK (OpenAI compatible)\n- **视频处理**: FFmpeg (fluent-ffmpeg)\n- **图片处理**: Sharp\n\n### 前端\n\n- **框架**: Nuxt 3 (SPA 模式)\n- **语言**: Vue 3 + TypeScript\n- **路由**: 文件路由 (Vue Router 4)\n- **样式**: 纯 CSS + CSS Variables (暗色主题)\n- **图标**: Lucide Vue\n\n---\n\n## 📝 常见问题\n\n### Q: Docker 容器如何访问宿主机的 Ollama？\n\nA: 使用 `http:\u002F\u002Fhost.docker.internal:11434\u002Fv1` 作为 Base URL。注意：\n1. 宿主机 Ollama 需监听 `0.0.0.0`：`export OLLAMA_HOST=0.0.0.0:11434 && ollama serve`\n2. Linux 用户使用 `docker run` 需添加：`--add-host=host.docker.internal:host-gateway`\n\n### Q: FFmpeg 未安装或找不到？\n\nA: 确保 FFmpeg 已安装并在 PATH 环境变量中。运行 `ffmpeg -version` 验证。Docker 部署已内置 FFmpeg。\n\n### Q: 前端无法连接后端 API？\n\nA: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 `frontend\u002Fnuxt.config.ts`。\n\n### Q: 数据库表未创建？\n\nA: 后端会在首次启动时自动创建所有表，检查日志确认初始化是否成功。\n\n---\n\n## 📋 更新日志\n\n### v2.0.0 (2026-04)\n\n#### 🚀 重大更新\n\n- 项目全面迁移至 TypeScript 技术栈\n  - 后端：Hono + Drizzle ORM + better-sqlite3\n  - 前端：Nuxt 3 + Vue 3\n  - AI Agent：Mastra 框架\n- 重做单集工作台 UI 和生产流程\n  - 更紧凑的控制台布局\n  - 重做分镜编辑区\n  - 重做配音、镜头图、视频、合成、导出界面\n- 新增 Docker 部署支持，前后端合并为单镜像\n- 增加运行时 Skill 加载机制\n- 扩展多厂商媒体 Adapter\n  - 图片：OpenAI、Gemini、MiniMax、火山引擎、阿里\n  - 视频：MiniMax、火山引擎\u002FSeedance、Vidu、阿里\n  - TTS：MiniMax\n- 增加宫格图生成、切分和重新分配流程\n- 优化本地文件处理与参考图按需转码\n\n### v1.0.4 (2026-01-27)\n\n- 引入本地存储策略，规避外部资源链接失效\n- Base64 参考图嵌入式传输\n- 修复镜头切换状态重置问题\n- 添加场景迁移至章节\n\n### v1.0.3 (2026-01-16)\n\n- SQLite 纯 Go 驱动，支持 CGO_ENABLED=0 跨平台编译\n- 优化并发性能（WAL 模式）\n- Docker 跨平台支持 host.docker.internal\n\n### v1.0.2 (2026-01-14)\n\n- 修复视频生成 API 响应解析问题\n- 添加 OpenAI Sora 视频端点配置\n- 优化错误处理和日志输出\n\n---\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 本项目\n2. 创建特性分支 (`git checkout -b feature\u002FAmazingFeature`)\n3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature\u002FAmazingFeature`)\n5. 开启 Pull Request\n\n常用检查命令：\n\n```bash\ncd backend && npm run typecheck\ncd ..\u002Ffrontend && npm run build\n```\n\n---\n\n## API 配置站点\n\n2 分钟完成配置：[API 聚合站点](https:\u002F\u002Fapi.chatfire.site\u002Fmodels)\n\n---\n\n## 👨‍💻 关于我们\n\n**AI 火宝 - AI 工作室创业中**\n\n- 🏠 **位置**: 中国南京\n- 🚀 **状态**: 创业中\n- 📧 **Email**: [18550175439@163.com](mailto:18550175439@163.com)\n- 🐙 **GitHub**: [https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama](https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama)\n\n> _\"让 AI 帮我们做更有创造力的事\"_\n\n## 项目交流群\n\n![项目交流群](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fchatfire-AI_huobao-drama_readme_9f557afd9454.png)\n\n- 提交 [Issue](..\u002F..\u002Fissues)\n- 发送邮件至项目维护者\n\n---\n\n\u003Cdiv align=\"center\">\n\n**⭐ 如果这个项目对你有帮助，请给一个 Star！**\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fchatfire-AI_huobao-drama_readme_0cf13cc5788e.png)](https:\u002F\u002Fwww.star-history.com\u002F#chatfire-AI\u002Fhuobao-drama&type=date&legend=top-left)\nMade with ❤️ by Huobao Team\n\n\u003C\u002Fdiv>\n","# 🎬 虎宝短剧 - AI 短剧生成平台\n\n\u003Cdiv align=\"center\">\n\n**基于 TypeScript 全栈的 AI 短剧自动化生产平台**\n\n[![Node Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-20+-339933?style=flat&logo=node.js)](https:\u002F\u002Fnodejs.org)\n[![Vue Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVue-3.x-4FC08D?style=flat&logo=vue.js)](https:\u002F\u002Fvuejs.org)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-CC%20BY--NC--SA%204.0-lightgrey.svg)](https:\u002F\u002Fcreativecommons.org\u002Flicenses\u002Fby-nc-sa\u002F4.0\u002F)\n\n[功能特性](#功能特性) • [快速开始](#快速开始) • [部署指南](#部署指南)\n\n\u003C\u002Fdiv>\n\n---\n\n## 📖 项目简介\n\n虎宝短剧是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。\n\n火宝短剧商业版地址：[火宝短剧商业版](https:\u002F\u002Fdrama.chatfire.site\u002Fshortvideo)\n火宝小说生成：[火宝小说生成](https:\u002F\u002Fmarketing.chatfire.site\u002Fhuobao-novel\u002F)\n\n### 🎯 核心价值\n\n- **🤖 AI 驱动**：使用大语言模型解析剧本，提取角色、场景和分镜信息\n- **🎨 智能创作**：AI 绘图生成角色形象和场景背景\n- **📹 视频生成**：基于文生视频和图生视频模型自动生成分镜视频\n- **🔄 工作流**：完整的短剧制作工作流，从创意到成片一站式完成\n\n### 🛠️ 技术架构\n\n```\nfrontend\u002F   — Nuxt 3 + Vue 3 + TypeScript (纯 CSS，无 UI 框架)\nbackend\u002F    — Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3\nconfigs\u002F    — config.yaml 配置文件\ndata\u002F       — SQLite 数据库 + 生成资源文件\nskills\u002F     — Agent 技能定义 (SKILL.md)\n```\n\n### 🎥 作品展示 \u002F Demo Videos\n\n体验 AI 短剧生成效果：\n\n\u003Cdiv align=\"center\">\n\n**示例作品 1**\n\n\u003Cvideo src=\"https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002F20260114094337396.mp4\" controls width=\"640\">\u003C\u002Fvideo>\n\n**示例作品 2**\n\n\u003Cvideo src=\"https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002Ffcede75e8aeafe22031dbf78f86285b8.mp4\" controls width=\"640\">\u003C\u002Fvideo>\n\n[点击观看视频 1](https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002F20260114094337396.mp4) | [点击观看视频 2](https:\u002F\u002Fffile.chatfire.site\u002Fcf\u002Fpublic\u002Ffcede75e8aeafe22031dbf78f86285b8.mp4)\n\n\u003C\u002Fdiv>\n\n---\n\n## ✨ 功能特性\n\n### 🎭 角色管理\n\n- ✅ AI 生成角色形象\n- ✅ 批量角色生成\n- ✅ 角色图片上传和管理\n- ✅ 角色音色分配与试听\n\n### 🎬 分镜制作\n\n- ✅ AI 自动拆解分镜脚本\n- ✅ 场景描述和镜头设计\n- ✅ 分镜图片生成（文生图）\n- ✅ 宫格图生成、切分与分配\n- ✅ 帧类型选择（首帧\u002F尾帧\u002F分镜板）\n\n### 🎥 视频生成\n\n- ✅ 图生视频自动生成\n- ✅ TTS 配音生成\n- ✅ FFmpeg 单镜头合成（视频 + 音频 + 字幕）\n- ✅ 整集拼接导出\n\n### 📦 资源管理\n\n- ✅ 素材库统一管理\n- ✅ 本地存储支持\n- ✅ 任务进度追踪\n\n### 🤖 AI Agents\n\n内置 5 个 Mastra Agent，支持数据库配置和 Skill 扩展：\n\n| Agent | 职责 |\n|---|---|\n| `script_rewriter` | 小说 → 格式化剧本改写 |\n| `extractor` | 角色 + 场景智能提取与去重 |\n| `storyboard_breaker` | 剧本 → 分镜序列拆解 |\n| `voice_assigner` | 角色音色自动分配 |\n| `grid_prompt_generator` | 角色\u002F场景\u002F宫格图提示词生成 |\n\n### 🔌 多厂商适配\n\n| 类型 | 支持厂商 |\n|---|---|\n| **图片** | OpenAI、Gemini、MiniMax、火山引擎、阿里、Chatfire |\n| **视频** | MiniMax、火山引擎\u002FSeedance、Vidu、阿里 |\n| **TTS** | MiniMax |\n\n---\n\n## 🚀 快速开始\n\n### 📋 环境要求\n\n| 软件 | 版本要求 | 说明 |\n|---|---|---|\n| **Node.js** | 20+ | 前后端运行环境 |\n| **npm** | 9+ | 包管理工具 |\n| **FFmpeg** | 4.0+ | 视频处理（**必需**） |\n\n#### 安装 FFmpeg\n\n**macOS:**\n\n```bash\nbrew install ffmpeg\n```\n\n**Ubuntu\u002FDebian:**\n\n```bash\nsudo apt update && sudo apt install ffmpeg\n```\n\n**Windows:**\n从 [FFmpeg 官网](https:\u002F\u002Fffmpeg.org\u002Fdownload.html) 下载并配置环境变量\n\n验证安装：\n\n```bash\nffmpeg -version\n```\n\n### ⚙️ 配置文件\n\n复制并编辑配置文件：\n\n```bash\ncp configs\u002Fconfig.example.yaml configs\u002Fconfig.yaml\n```\n\n配置文件格式（`configs\u002Fconfig.yaml`）：\n\n```yaml\napp:\n  name: \"Huobao Drama API\"\n  version: \"1.0.0\"\n  debug: true\n\nserver:\n  port: 5679\n  host: \"0.0.0.0\"\n  cors_origins:\n    - \"http:\u002F\u002Flocalhost:3013\"\n\ndatabase:\n  type: \"sqlite\"\n  path: \".\u002Fdata\u002Fhuobao_drama.db\"\n\nstorage:\n  type: \"local\"\n  local_path: \".\u002Fdata\u002Fstorage\"\n  base_url: \"http:\u002F\u002Flocalhost:5679\u002Fstatic\"\n\nai:\n  default_text_provider: \"openai\"\n  default_image_provider: \"openai\"\n  default_video_provider: \"doubao\"\n```\n\n> **说明**：AI 服务的具体 API Key 和模型参数在 Web 界面的「设置」页面中配置。\n\n### 📥 安装依赖\n\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama.git\ncd huobao-drama\n\n# 安装后端依赖\ncd backend && npm install\n\n# 安装前端依赖\ncd ..\u002Ffrontend && npm install\n```\n\n### 🎯 启动项目\n\n#### 方式一：开发模式（推荐）\n\n前后端分离，支持热重载：\n\n```bash\n# 终端1：启动后端\ncd backend\nnpm run dev\n\n# 终端2：启动前端\ncd frontend\nnpm run dev\n```\n\n- 前端地址: `http:\u002F\u002Flocalhost:3013`\n- 后端 API: `http:\u002F\u002Flocalhost:5679\u002Fapi\u002Fv1`\n- 前端自动代理 `\u002Fapi` 和 `\u002Fstatic` 到后端\n\n#### 方式二：单服务模式\n\n后端同时提供 API 和前端静态文件：\n\n```bash\n# 1. 构建前端\ncd frontend && npm run generate\n\n# 2. 启动后端\ncd ..\u002Fbackend && npm start\n```\n\n访问: `http:\u002F\u002Flocalhost:5679`\n\n### 🗄️ 数据库\n\n数据库表在首次启动时自动创建，无需手动迁移。默认路径 `data\u002Fhuobao_drama.db`，可通过环境变量覆盖：\n\n```bash\nDB_PATH=\u002Fpath\u002Fto\u002Fyour.db npm start\n```\n\n---\n\n## 📦 部署指南\n\n### ☁️ 云端一键部署（推荐 3080Ti）\n\n👉 [优云智算，一键部署](https:\u002F\u002Fwww.compshare.cn\u002Fimages\u002FCaWEHpAA8t1H?referral_code=8hUJOaWz3YzG64FI2OlCiB&ytag=GPU_YY_YX_GitHub_huobaoai)\n\n> ⚠️ **注意**：云端部署方案数据请及时存储到本地\n\n---\n\n### 🐳 Docker 部署（推荐）\n\n#### 方式一：Docker Compose（推荐）\n\n```bash\n# 启动服务\ndocker compose up -d\n\n# 查看日志\ndocker compose logs -f\n\n# 停止服务\ndocker compose down\n```\n\n#### 方式二：Docker 命令\n\n```bash\n# 从 Docker Hub 运行\ndocker run -d \\\n  --name huobao-drama \\\n  -p 5679:5679 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  -v $(pwd)\u002Fconfigs\u002Fconfig.yaml:\u002Fapp\u002Fconfigs\u002Fconfig.yaml \\\n  --restart unless-stopped \\\n  huobao\u002Fhuobao-drama:latest\n\n# 查看日志\ndocker logs -f huobao-drama\n```\n\n> **注意**：Linux 用户需添加 `--add-host=host.docker.internal:host-gateway` 以访问宿主机服务\n\n**本地构建**（可选）：\n\n```bash\ndocker build -t huobao-drama:latest .\ndocker run -d --name huobao-drama -p 5679:5679 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  -v $(pwd)\u002Fconfigs\u002Fconfig.yaml:\u002Fapp\u002Fconfigs\u002Fconfig.yaml \\\n  huobao-drama:latest\n```\n\n**Docker 部署优势：**\n\n- ✅ 开箱即用，内置 FFmpeg 和默认配置\n- ✅ 前后端合并为单镜像、单端口\n- ✅ 环境一致性，避免依赖问题\n- ✅ `data\u002F` 目录 volume 挂载，数据持久化\n\n#### 🔗 访问宿主机服务（Ollama \u002F 本地模型）\n\n容器内可通过 `http:\u002F\u002Fhost.docker.internal:端口号` 访问宿主机服务。\n\n**配置步骤：**\n\n1. 宿主机启动服务（监听所有接口）：\n\n   ```bash\n   export OLLAMA_HOST=0.0.0.0:11434 && ollama serve\n   ```\n\n2. 在 Web 界面「设置 → AI 服务配置」中填写：\n   - Base URL: `http:\u002F\u002Fhost.docker.internal:11434\u002Fv1`\n   - Provider: `openai`\n   - Model: `qwen2.5:latest`\n\n---\n\n### 🏭 传统部署方式\n\n```bash\n# 1. 构建前端\ncd frontend && npm run generate && cd ..\n\n# 2. 启动后端\ncd backend && npm start\n```\n\n需要上传到服务器的文件：\n\n```\nbackend\u002F          # 后端源码 + node_modules\nfrontend\u002Fdist\u002F    # 前端构建产物\nconfigs\u002Fconfig.yaml\ndata\u002F             # 数据目录（首次运行自动创建）\nskills\u002F           # Agent 技能文件\n```\n\n#### Nginx 反向代理\n\n```nginx\nserver {\n    listen 80;\n    server_name your-domain.com;\n\n    location \u002F {\n        proxy_pass http:\u002F\u002Flocalhost:5679;\n        proxy_set_header Host $host;\n        proxy_set_header X-Real-IP $remote_addr;\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n    }\n}\n```\n\n---\n\n## 🎨 技术栈\n\n### 后端\n\n- **运行时**: Node.js 20+\n- **Web 框架**: Hono\n- **ORM**: Drizzle ORM + better-sqlite3\n- **AI Agent**: Mastra + AI SDK (OpenAI compatible)\n- **视频处理**: FFmpeg (fluent-ffmpeg)\n- **图片处理**: Sharp\n\n### 前端\n\n- **框架**: Nuxt 3 (SPA 模式)\n- **语言**: Vue 3 + TypeScript\n- **路由**: 文件路由 (Vue Router 4)\n- **样式**: 纯 CSS + CSS Variables (暗色主题)\n- **图标**: Lucide Vue\n\n---\n\n## 📝 常见问题\n\n### Q: Docker 容器如何访问宿主机的 Ollama？\n\nA: 使用 `http:\u002F\u002Fhost.docker.internal:11434\u002Fv1` 作为 Base URL。注意：\n1. 宿主机 Ollama 需监听 `0.0.0.0`：`export OLLAMA_HOST=0.0.0.0:11434 && ollama serve`\n2. Linux 用户使用 `docker run` 需添加：`--add-host=host.docker.internal:host-gateway`\n\n### Q: FFmpeg 未安装或找不到？\n\nA: 确保 FFmpeg 已安装并在 PATH 环境变量中。运行 `ffmpeg -version` 验证。Docker 部署已内置 FFmpeg。\n\n### Q: 前端无法连接后端 API？\n\nA: 检查后端是否启动，端口是否正确。开发模式下前端代理配置在 `frontend\u002Fnuxt.config.ts`。\n\n### Q: 数据库表未创建？\n\nA: 后端会在首次启动时自动创建所有表，检查日志确认初始化是否成功。\n\n---\n\n## 📋 更新日志\n\n### v2.0.0 (2026-04)\n\n#### 🚀 重大更新\n\n- 项目全面迁移至 TypeScript 技术栈\n  - 后端：Hono + Drizzle ORM + better-sqlite3\n  - 前端：Nuxt 3 + Vue 3\n  - AI Agent：Mastra 框架\n- 重做单集工作台 UI 和生产流程\n  - 更紧凑的控制台布局\n  - 重做分镜编辑区\n  - 重做配音、镜头图、视频、合成、导出界面\n- 新增 Docker 部署支持，前后端合并为单镜像\n- 增加运行时 Skill 加载机制\n- 扩展多厂商媒体 Adapter\n  - 图片：OpenAI、Gemini、MiniMax、火山引擎、阿里\n  - 视频：MiniMax、火山引擎\u002FSeedance、Vidu、阿里\n  - TTS：MiniMax\n- 增加宫格图生成、切分和重新分配流程\n- 优化本地文件处理与参考图按需转码\n\n### v1.0.4 (2026-01-27)\n\n- 引入本地存储策略，规避外部资源链接失效\n- Base64 参考图嵌入式传输\n- 修复镜头切换状态重置问题\n- 添加场景迁移至章节\n\n### v1.0.3 (2026-01-16)\n\n- SQLite 纯 Go 驱动，支持 CGO_ENABLED=0 跨平台编译\n- 优化并发性能（WAL 模式）\n- Docker 跨平台支持 host.docker.internal\n\n### v1.0.2 (2026-01-14)\n\n- 修复视频生成 API 响应解析问题\n- 添加 OpenAI Sora 视频端点配置\n- 优化错误处理和日志输出\n\n---\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n1. Fork 本项目\n2. 创建特性分支 (`git checkout -b feature\u002FAmazingFeature`)\n3. 提交改动 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature\u002FAmazingFeature`)\n5. 开启 Pull Request\n\n常用检查命令：\n\n```bash\ncd backend && npm run typecheck\ncd ..\u002Ffrontend && npm run build\n```\n\n---\n\n## API 配置站点\n\n2 分钟完成配置：[API 聚合站点](https:\u002F\u002Fapi.chatfire.site\u002Fmodels)\n\n---\n\n## 👨‍💻 关于我们\n\n**AI 火宝 - AI 工作室创业中**\n\n- 🏠 **位置**: 中国南京\n- 🚀 **状态**: 创业中\n- 📧 **Email**: [18550175439@163.com](mailto:18550175439@163.com)\n- 🐙 **GitHub**: [https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama](https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama)\n\n> _\"让 AI 帮我们做更有创造力的事\"_\n\n## 项目交流群\n\n![项目交流群](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fchatfire-AI_huobao-drama_readme_9f557afd9454.png)\n\n- 提交 [Issue](..\u002F..\u002Fissues)\n- 发送邮件至项目维护者\n\n---\n\n\u003Cdiv align=\"center\">\n\n**⭐ 如果这个项目对你有帮助，请给一个 Star！**\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fchatfire-AI_huobao-drama_readme_0cf13cc5788e.png)](https:\u002F\u002Fwww.star-history.com\u002F#chatfire-AI\u002Fhuobao-drama?type=date&legend=top-left)\nMade with ❤️ by Huobao Team\n\n\u003C\u002Fdiv>","# Huobao Drama 快速上手指南\n\nHuobao Drama 是一个基于 AI 的短剧自动化生产平台，支持从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。\n\n## 1. 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **操作系统**: Linux \u002F macOS \u002F Windows\n*   **Node.js**: 版本 20+ ([下载地址](https:\u002F\u002Fnodejs.org))\n*   **npm**: 版本 9+ (随 Node.js 安装)\n*   **FFmpeg**: 版本 4.0+ (**必需**，用于视频处理)\n\n### 安装 FFmpeg\n\n*   **macOS**:\n    ```bash\n    brew install ffmpeg\n    ```\n*   **Ubuntu\u002FDebian**:\n    ```bash\n    sudo apt update && sudo apt install ffmpeg\n    ```\n*   **Windows**:\n    前往 [FFmpeg 官网](https:\u002F\u002Fffmpeg.org\u002Fdownload.html) 下载并配置环境变量。\n\n验证安装：\n```bash\nffmpeg -version\n```\n\n## 2. 安装步骤\n\n### 克隆项目\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama.git\ncd huobao-drama\n```\n\n### 安装依赖\n分别安装后端和前端依赖：\n```bash\n# 安装后端依赖\ncd backend && npm install\n\n# 安装前端依赖\ncd ..\u002Ffrontend && npm install\n```\n\n### 配置文件\n复制示例配置文件并进行编辑（如需修改端口或数据库路径）：\n```bash\ncp configs\u002Fconfig.example.yaml configs\u002Fconfig.yaml\n```\n> **注意**：具体的 AI 模型 API Key 和参数建议在启动后通过 Web 界面的「设置」页面进行配置。\n\n## 3. 基本使用\n\n推荐使用**开发模式**启动，前后端分离运行，支持热重载。\n\n### 启动后端\n打开终端 1：\n```bash\ncd backend\nnpm run dev\n```\n后端服务将运行在 `http:\u002F\u002Flocalhost:5679`\n\n### 启动前端\n打开终端 2：\n```bash\ncd frontend\nnpm run dev\n```\n前端服务将运行在 `http:\u002F\u002Flocalhost:3013`\n\n### 开始创作\n1. 浏览器访问 `http:\u002F\u002Flocalhost:3013`。\n2. 进入「设置」页面，配置您的 AI 服务商（如 OpenAI, MiniMax, 火山引擎等）及 API Key。\n3. 返回工作台，输入小说文本或创意，即可开始自动化生成分镜、角色及视频。\n\n---\n\n### 🐳 替代方案：Docker 一键部署\n\n如果您希望快速体验或使用生产环境，推荐使用 Docker：\n\n```bash\ndocker run -d \\\n  --name huobao-drama \\\n  -p 5679:5679 \\\n  -v $(pwd)\u002Fdata:\u002Fapp\u002Fdata \\\n  -v $(pwd)\u002Fconfigs\u002Fconfig.yaml:\u002Fapp\u002Fconfigs\u002Fconfig.yaml \\\n  --restart unless-stopped \\\n  huobao\u002Fhuobao-drama:latest\n```\n启动后直接访问 `http:\u002F\u002Flocalhost:5679` 即可使用。","某小型新媒体团队急需在一天内为热门网络小说制作一部宣传短剧，以赶上晚上的流量高峰。\n\n### 没有 huobao-drama 时\n- **人力协调难**：需要分别寻找编剧改写剧本、画师绘制分镜、配音员录制音频及剪辑师合成视频，沟通成本极高且难以凑齐人手。\n- **生产周期长**：从文本到成片的传统流程至少耗时 3-5 天，无法应对突发的热点营销需求，极易错失最佳传播时机。\n- **风格统一差**：不同环节由不同人员执行，导致角色形象在分镜图与最终视频中不一致，画面割裂感强，严重影响观感。\n- **试错成本高**：若导演对某个镜头不满意，修改需重新协调多方资源，单次迭代成本高昂，团队往往被迫妥协于次品。\n\n### 使用 huobao-drama 后\n- **全流程自动化**：运营人员只需输入一句小说简介，huobao-drama 内置的 AI Agent 即可自动完成剧本改写、角色提取、分镜拆解及视频合成，单人即可操盘。\n- **分钟级出片**：依托并行的 AI 工作流，从创意输入到生成完整带配音字幕的短剧仅需数十分钟，完美契合“上午选题、晚上发布”的快节奏运营。\n- **角色高度一致**：系统自动锁定角色特征与音色，确保生成的文生图、图生视频及 TTS 配音在整部剧中保持严格的一致性，提升作品专业度。\n- **低成本快速迭代**：对不满意的分镜或镜头，可在界面中一键重新生成或微调提示词，无需额外费用即可无限次尝试，直至达到最佳效果。\n\nhuobao-drama 将短剧制作门槛从“专业团队协作”降维至“单人一句话指令”，让内容创作者能真正专注于创意本身而非繁琐的制作流程。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fchatfire-AI_huobao-drama_5c14a947.png","chatfire-AI","AI 火宝","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fchatfire-AI_ada8cfc4.png","AI 火宝开源社区",null,"421505648@qq.com","https:\u002F\u002Fapi.chatfire.site\u002Fmodels","https:\u002F\u002Fgithub.com\u002Fchatfire-AI",[84,88,92,96],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",49.8,{"name":89,"color":90,"percentage":91},"Vue","#41b883",48.4,{"name":93,"color":94,"percentage":95},"CSS","#663399",1.5,{"name":97,"color":98,"percentage":99},"Dockerfile","#384d54",0.3,9588,1815,"2026-04-05T23:45:06","Linux, macOS, Windows","未说明 (项目基于 Node.js 运行，本地无需 GPU；若使用云端部署或本地运行大模型如 Ollama，则需根据具体模型需求配置，推荐部署方案提及 3080Ti)","未说明",{"notes":107,"python":108,"dependencies":109},"1. 核心运行环境为 Node.js 20+，非 Python 项目。2. FFmpeg 是视频处理的必需组件，必须安装并配置环境变量（Docker 部署已内置）。3. 支持通过 Docker 一键部署，推荐用于生产环境。4. AI 模型调用支持多种云厂商 API，也可在容器内通过 host.docker.internal 访问宿主机运行的本地模型服务（如 Ollama）。5. 数据库使用 SQLite，首次启动自动创建表结构。","不需要 (项目基于 Node.js\u002FTypeScript)",[110,111,112,113,114,115,116,117,118,119],"Node.js >= 20","npm >= 9","FFmpeg >= 4.0","Hono","Drizzle ORM","better-sqlite3","Mastra AI Agents","Nuxt 3","Vue 3","Sharp",[26,14,63,43,15],"2026-03-27T02:49:30.150509","2026-04-06T14:05:47.975112",[124,129,134,139,144,149,154,159],{"id":125,"question_zh":126,"answer_zh":127,"source_url":128},19068,"点击切换分镜时，之前的提示词会被错误带入怎么办？","请拉取最新的代码或更新 Docker 镜像，该问题已在最新版本中修复。如果问题仍然存在，可能是缓存导致，建议清理浏览器缓存后重试。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F43",{"id":130,"question_zh":131,"answer_zh":132,"source_url":133},19069,"如何配置非 OpenAI 格式的自定义 API 端点（如 Flow2API 或 Sora2API）？","目前系统主要兼容 OpenAI 格式。对于图片生成，可以尝试直接修改 SQLite 数据库中 `ai_service_configs` 表的 `endpoint` 字段值来适配；但视频生成由于不同平台传参要求差异较大，暂时无法通过简单配置实现，需要等待官方后续适配或自行修改源码。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F34",{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},19070,"是否支持硅基流动（SiliconFlow）模型？","支持。硅基流动的接口兼容 OpenAI 格式，您无需等待专门适配。只需在配置中将 API 地址（Base URL）修改为硅基流动的接口地址，并使用对应的 API Key 即可直接使用。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F62",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},19071,"使用豆包（Doubao）等模型生成图片时报错\"size 参数无效\"如何解决？","这是尺寸参数不匹配导致的。部分模型（如豆包某些版本）要求最低尺寸为 2K。建议更换为 `nano-banana` 模型，或者在源码中调整请求的尺寸参数以符合目标模型的要求。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F39",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},19072,"生成的视频中人物角色和场景不一致，如何使用参考图？","视频生成逻辑是以“镜头图片”为参考进行融图生成的。正确的操作流程是：先生成满意的镜头图片（首尾帧），然后在视频生成界面选择“单图参考”上传该图片，或选择“首尾帧”模式，确保视频基于已生成的角色和场景图片进行制作。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F30",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},19073,"合成视频时报错或输出文件为空怎么办？","该问题通常由 FFmpeg 在流复制模式（-c copy）下起始帧不是关键帧导致。解决方案是修改源码中的 `trimVideo` 函数，移除所有 FFmpeg 命令中的 `-c copy` 参数。这样 FFmpeg 将进行重新编码，虽然速度稍慢，但能解决输出文件为空的问题。最新代码已包含此修复。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F6",{"id":155,"question_zh":156,"answer_zh":157,"source_url":158},19074,"之前生成的图片或视频链接过期（403 错误）无法查看怎么办？","这是因为云存储生成的签名 URL 有过期时间限制。请更新到最新代码，新版本已支持本地文件路径和 Base64 格式存储。更新后，数据库相关表（如 assets, image_generations 等）会增加 `local_path` 字段，系统将优先读取本地文件，从而避免链接过期问题。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F58",{"id":160,"question_zh":161,"answer_zh":162,"source_url":163},19075,"配置 Chatfire 或其他 API 后生成视频失败，如何排查？","请按以下步骤排查：1. 检查账户额度是否充足；2. 确认 API Key 是否正确；3. 在终端使用 curl 或 Python 脚本单独调用 API 测试连通性，排除网络或密钥问题；4. 如果以上无误，建议加入官方社群联系管理员获取即时帮助。","https:\u002F\u002Fgithub.com\u002Fchatfire-AI\u002Fhuobao-drama\u002Fissues\u002F40",[165],{"id":166,"version":167,"summary_zh":79,"released_at":168},117128,"v1.0.4","2026-01-27T09:52:45"]