# 内置 ComfyUI 视频助手 + SaaS 多租户方案 > 生成: gpt-5.5 via api.boos.lat | 2026-05-18 --- ## 1. 数据表设计 (SQLite migrations) ### 1.1 `tenants` 租户 ```sql CREATE TABLE tenants ( id TEXT PRIMARY KEY, name TEXT NOT NULL, slug TEXT UNIQUE NOT NULL, plan TEXT NOT NULL DEFAULT 'free', status TEXT NOT NULL DEFAULT 'active', owner_user_id TEXT NOT NULL, settings TEXT NOT NULL DEFAULT '{}', created_at TEXT NOT NULL DEFAULT (datetime('now')), updated_at TEXT NOT NULL DEFAULT (datetime('now')) ); ``` ### 1.2 `tenant_members` 租户成员 ```sql CREATE TABLE tenant_members ( id TEXT PRIMARY KEY, tenant_id TEXT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE, user_id TEXT NOT NULL, role TEXT NOT NULL DEFAULT 'member', status TEXT NOT NULL DEFAULT 'active', created_at TEXT NOT NULL DEFAULT (datetime('now')), UNIQUE(tenant_id, user_id) ); ``` ### 1.3 `subscriptions` 订阅与额度 ```sql CREATE TABLE subscriptions ( id TEXT PRIMARY KEY, tenant_id TEXT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE, plan TEXT NOT NULL, status TEXT NOT NULL DEFAULT 'active', monthly_generations_limit INTEGER NOT NULL DEFAULT 100, monthly_video_seconds_limit INTEGER NOT NULL DEFAULT 300, storage_bytes_limit INTEGER NOT NULL DEFAULT 5368709120, created_at TEXT NOT NULL DEFAULT (datetime('now')), updated_at TEXT NOT NULL DEFAULT (datetime('now')) ); ``` ### 1.4 `usage_counters` 用量统计 ```sql CREATE TABLE usage_counters ( id TEXT PRIMARY KEY, tenant_id TEXT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE, period TEXT NOT NULL, generations_used INTEGER NOT NULL DEFAULT 0, video_seconds_used INTEGER NOT NULL DEFAULT 0, storage_bytes_used INTEGER NOT NULL DEFAULT 0, ai_tokens_used INTEGER NOT NULL DEFAULT 0, updated_at TEXT NOT NULL DEFAULT (datetime('now')), UNIQUE(tenant_id, period) ); ``` ### 1.5 `comfy_workflows` 工作流模板 ```sql CREATE TABLE comfy_workflows ( id TEXT PRIMARY KEY, tenant_id TEXT REFERENCES tenants(id) ON DELETE CASCADE, name TEXT NOT NULL, description TEXT, type TEXT NOT NULL DEFAULT 'video', visibility TEXT NOT NULL DEFAULT 'private', workflow_json TEXT NOT NULL, input_schema TEXT NOT NULL DEFAULT '{}', version INTEGER NOT NULL DEFAULT 1, is_default INTEGER NOT NULL DEFAULT 0, created_by TEXT, created_at TEXT NOT NULL DEFAULT (datetime('now')), updated_at TEXT NOT NULL DEFAULT (datetime('now')) ); ``` ### 1.6 `video_jobs` 视频任务 ```sql CREATE TABLE video_jobs ( id TEXT PRIMARY KEY, tenant_id TEXT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE, user_id TEXT, workflow_id TEXT REFERENCES comfy_workflows(id), status TEXT NOT NULL DEFAULT 'queued', priority INTEGER NOT NULL DEFAULT 100, prompt TEXT, negative_prompt TEXT, params TEXT NOT NULL DEFAULT '{}', comfy_prompt_id TEXT, progress REAL NOT NULL DEFAULT 0, error_message TEXT, result_asset_id TEXT, estimated_video_seconds INTEGER DEFAULT 0, actual_video_seconds INTEGER DEFAULT 0, started_at TEXT, completed_at TEXT, created_at TEXT NOT NULL DEFAULT (datetime('now')), updated_at TEXT NOT NULL DEFAULT (datetime('now')) ); ``` ### 1.7 `assets` 文件资产 ```sql CREATE TABLE assets ( id TEXT PRIMARY KEY, tenant_id TEXT NOT NULL REFERENCES tenants(id) ON DELETE CASCADE, user_id TEXT, job_id TEXT REFERENCES video_jobs(id) ON DELETE SET NULL, type TEXT NOT NULL, mime_type TEXT, file_name TEXT, storage_path TEXT NOT NULL, public_url TEXT, size_bytes INTEGER NOT NULL DEFAULT 0, metadata TEXT NOT NULL DEFAULT '{}', created_at TEXT NOT NULL DEFAULT (datetime('now')) ); ``` --- ## 2. API 路由设计 ### 租户管理 ``` POST /api/tenants → 创建租户 GET /api/tenants → 我的租户列表 GET /api/tenants/:id → 租户详情 PATCH /api/tenants/:id → 更新租户 ``` ### 成员管理 ``` GET /api/tenants/:id/members → 成员列表 POST /api/tenants/:id/members/invite → 邀请成员 DELETE /api/tenants/:id/members/:uid → 移除成员 PATCH /api/tenants/:id/members/:uid/role → 修改角色 ``` ### 视频助手 ``` POST /api/tenants/:id/video/analyze → 解析脚本(角色/场景/对话) POST /api/tenants/:id/video/generate → 生成视频任务 GET /api/tenants/:id/video/jobs → 任务列表 GET /api/tenants/:id/video/jobs/:jid → 任务详情 POST /api/tenants/:id/video/jobs/:jid/cancel → 取消任务 GET /api/tenants/:id/video/jobs/:jid/events → SSE 进度 ``` ### ComfyUI 工作流 ``` GET /api/tenants/:id/workflows → 工作流模板列表 POST /api/tenants/:id/workflows → 创建模板 GET /api/tenants/:id/workflows/:wid → 模板详情 DELETE /api/tenants/:id/workflows/:wid → 删除模板 ``` ### 资产生成(ai Helper) ``` POST /api/tenants/:id/ai/character → gpt-image-2 生成角色四视图 POST /api/tenants/:id/ai/scene → 生成场景图 POST /api/tenants/:id/ai/tts → TTS 语音 POST /api/tenants/:id/ai/prompt-optimize → 优化视频 prompt ``` ### 用量与订阅 ``` GET /api/tenants/:id/usage → 当前用量 GET /api/tenants/:id/subscription → 订阅信息 ``` --- ## 3. 前端页面/组件结构 ``` src/web/pages/ ├── VideoAssistant.tsx ← 视频助手主页面(prompt→生成→预览) ├── VideoJobs.tsx ← 历史任务列表 ├── WorkflowLibrary.tsx ← 工作流模板库 ├── TenantSettings.tsx ← 租户设置 └── TenantMembers.tsx ← 成员管理 src/web/components/ ├── video/ │ ├── ScriptEditor.tsx ← 自然语言脚本编辑 │ ├── ScriptPreview.tsx ← 脚本解析预览(角色/场景/对话) │ ├── CharacterCard.tsx ← 角色四视图卡片 │ ├── SceneCard.tsx ← 场景图卡片 │ ├── TTSPlayer.tsx ← TTS 语音播放 │ ├── WorkflowExport.tsx ← ComfyUI 工作流导出 │ └── VideoPlayer.tsx ← 视频播放/下载 ├── tenant/ │ ├── TenantSwitcher.tsx ← 租户切换 │ ├── MemberList.tsx ← 成员列表 │ ├── InviteDialog.tsx ← 邀请对话框 │ └── UsageQuota.tsx ← 用量/配额显示 ``` --- ## 4. 核心业务流程 ### 注册 → 创作 → 导出 ``` 1. 注册/登录 2. 自动创建个人租户(或个人空间) 3. 进入视频助手页面 4. 输入自然语言脚本 5. 系统解析 → 提取角色/场景/对话 6. 自动调用 AI 生成: - 【CHARACTER】→ gpt-image-2 四视图 - 【SCENE】 → 场景图 - 【TTS】 → 语音 - 【WORKFLOW】 → ComfyUI 工作流 JSON 7. 预览所有生成内容 8. 导出/下载/提交 ComfyUI 执行 9. 视频生成 → 预览 → 下载 如需协作: → 创建组织 → 邀请成员 → 设置角色 ``` ### 租户管理流程 ``` 创建组织 → 成为 owner → 可创建 API Key → 可邀请成员(邮箱/链接) → 角色: owner / admin / member → 每个成员有独立用量跟踪 套餐限制: free: 50 次/月, 5GB 存储, 基础功能 pro: 500 次/月, 50GB, 全功能+更高配额 custom: 定制 ``` --- ## 5. 文件变更清单 ### 新增文件 **后端 Rust:** ``` src/routes/tenants/mod.rs → 租户 CRUD src/routes/tenants/{handlers,types}.rs src/routes/video_jobs/ → 视频任务管理 src/routes/video_jobs/{handlers,sse}.rs src/routes/ai_assist.rs → AI 辅助生成(角色/场景/TTS/prompt) src/routes/subscriptions.rs → 订阅/用量 src/services/tenant_service.rs → 租户业务逻辑 src/services/video_service.rs → 视频任务调度 src/services/usage_service.rs → 用量统计 src/services/comfy_client.rs → ComfyUI API 客户端 src/workers/video_worker.rs → 后台视频任务 Worker src/middleware/tenant_context.rs → 租户上下文中间件 migrations/0010_tenants.sql migrations/0011_tenant_members.sql migrations/0012_subscriptions.sql migrations/0013_usage_counters.sql migrations/0014_comfy_workflows.sql migrations/0015_video_jobs.sql migrations/0016_assets.sql ``` **前端:** ``` src/web/pages/VideoAssistant.tsx src/web/pages/VideoJobs.tsx src/web/pages/WorkflowLibrary.tsx src/web/pages/TenantSettings.tsx src/web/pages/TenantMembers.tsx src/web/components/video/*.tsx src/web/components/tenant/*.tsx src/web/hooks/useVideoJobs.ts src/web/hooks/useTenant.ts src/web/hooks/useAssets.ts src/web/hooks/useUsage.ts ``` ### 修改文件 ``` src/routes/mod.rs → 注册新路由 src/web/App.tsx → 添加导航项和路由 src/routes/video_agent.rs → 增强现有 Agent SSE src/services/mod.rs → 注册新服务 src/config.rs → 添加 ComfyUI/套餐配置 src/main.rs → 注册 Worker src/db/mod.rs → 新增表类型 ``` --- ## 6. 实施步骤（按优先级） ### P0 - 基础链路 1. migrations: tenants + video_jobs + assets 三张核心表 2. 租户上下文中间件 3. 视频助手 Agent SSE 增强 → 脚本解析 + AI 生成调用 4. 前端 VideoAssistant 页面（脚本输入→解析→预览→导出） 5. ComfyUI client → 提交 prompt + 获取结果 ### P1 - 多租户 6. 租户 CRUD + 成员管理 + 邀请 7. 资源 tenant_id 隔离 8. 用量统计 + 套餐限制 9. API Key 管理 10. 顶栏租户切换 + 用量显示 ### P2 - 生产增强 11. SSE 实时进度 12. Worker 后台任务队列 13. 视频任务历史 + 重试 14. ComfyUI 工作流模板库 15. AI prompt 优化（调用 gpt-5.5） ### P3 - 商业化 16. 订阅管理(Stripe/内部) 17. 多 ComfyUI 节点调度 18. 对象存储集成