MYZX Studio 多模式 AI 带货创作平台 PRD
版本：1.0 · 日期：2026年11月9日 · 状态：产品与架构基线，待实现
1 产品定位与目标
MYZX Studio 为暂定展示名称，正式品牌名称待确定。产品以 studio.myzxai.com 为统一入口，面向通过网页注册、充值并制作商品视频的用户。首批提供「剧情式带货」和「数字人带货」，后续将本地 Codex 环境中验证成熟的 skill 转换为版本化能力包。
生产运行不依赖 Codex 桌面或用户个人电脑。模型负责理解和创作；平台负责流程、权限、工具执行、任务恢复、数据与计费。新项目直接在已授权服务器开发、测试和部署。
成功标准：用户完成注册、商品建档、模式选择、制作、审阅、局部返工和成片下载；每次消费可核对，每个成果可追溯，重启不会导致重复提交或重复扣费。
2 已确定事项与待确定事项
| 事项 | 结论 |
|---|---|
| 首批入口 | 剧情式带货、数字人带货 |
| 域名 | studio.myzxai.com，已获用户确认 |
| 开发部署 | 直接在服务器独立项目目录进行 |
| 登录账号 | QQ、163、126邮箱验证码注册，邮箱加密码登录 |
| 找回密码 | 邮箱验证码验证后重置，撤销旧会话 |
| 付费模式 | 平台统一上游API，用户充值积分使用 |
| 并发 | 多用户、多项目、独立素材并发，受额度和依赖约束 |
| 模型配置 | 仅管理员配置总控、编剧、生图、视频和数字人服务 |
| 扩展方式 | 经过测试发布的能力包，固定项目版本 |
| 待定商业参数 | 人民币兑换率、各能力售价、套餐、退款及赠送规则 |
| 待定服务 | 支付与邮件供应商、数字人生成路线、总控和生图型号 |
| 品牌 | MYZX Studio为原型展示名，不构成最终命名确认 |
示例价格和余额只用于原型演示，不是正式报价。供应商模型别名不能视作官方上游身份保证，接入时验证真实能力。
3 用户角色与权限
普通用户管理自己的项目、素材、任务、钱包与账号。平台管理员管理服务、定价、能力发布、用户、订单和异常对账。管理员操作须记录操作者、时间、对象、原因和结果。
所有读写在后端校验资源归属。下载地址按权限签发短期链接，不能只依赖前端隐藏。后台使用更严格的会话和敏感操作验证；管理员不得读取用户明文密码。
4 信息架构与主要页面
| 页面 | 内容与主要动作 |
|---|---|
| 创作首页 | 双模式入口、最近项目、制作状态、新建项目 |
| 项目工作台 | 当前步骤、成果预览、版本、修改意见、确认与继续 |
| 我的项目 | 模式筛选、状态筛选、搜索、继续和归档 |
| 素材库 | 商品、角色、场景、声音、视频的版本与引用关系 |
| 任务中心 | 排队、进行中、待核对、待审阅、失败与完成 |
| 钱包 | 可用与冻结积分、充值、消费、退款和订单 |
| 账号安全 | 邮箱、密码修改、会话管理 |
| 管理后台 | API、定价、能力包、并发、用户、邮件、支付、日志 |
5 两种创作流程
5.1 剧情式带货
商品与转化目标 → 策略方案 → 完整剧本 → 分镜 → 资产 → 视频生成 → 剪辑交付。
商品档案包括品牌、SKU、口语短名、外观、价格规格、可用卖点、证据限制和真实参考素材。发现本次所需缺项时集中询问；用户补齐或明确授权默认处理后才推进。挂车成交、引流直播间、种草搜索选择一个主目标。
策略、剧本与分镜由指定Gemini角色独立执行，直接交原稿；仅用户明确要求修改时提交修订。总控不自行改写、重拆或自动反复退稿。未锁定的创作选择由编剧在授权范围内决定。
总控负责资产提取、服化道设计、参考图、ZHIFEIJIAI视频提示词编译、生成组织、剪辑与验收。默认9:16、对白驱动；角色板16:9三栏、场景参考21:9四向布局，按当前skill规则版本执行。源视频无BGM、字幕和水印，包装统一在后期添加。来源skill中的专用模型参数需由实际适配器验证。
保留原镜号与生成段映射，一个生成段可以覆盖多个原镜头；最终剪辑再记录实际采用区间。试片审阅节点依据项目授权设置。人物声音、口型、商品状态和动作接点不能仅凭ASR判定合格。
5.2 数字人带货
商品与目标 → 讲解稿 → 数字人形象与声音 → 画面编排 → 视频制作 → 剪辑交付。
需要独立验证数字人API路线：可选直接生成带对白视频，或声音生成与口型驱动组合，以供应商实测结果决定。首版不假定所有视频API都支持声音克隆、口型同步或上传人物视频。资产保存来源及使用授权信息。
商品建档、上传、任务、钱包、预览和导出使用平台公共模块。形象、声音、口播与商品补镜采用专用交互。
5.3 单环节与返工
允许用户从已有剧本、分镜、图片或视频开始，校验该阶段依赖。改动上游成果后标记受影响下游，不覆盖历史，不自动全量重做。用户明确选择返工范围后按新任务报价执行。
6 账号与邮箱
允许域名首版为qq.com、163.com、126.com，可由后台扩展。流程为输入邮箱、发送验证码、输入验证码、设置并确认密码、验证成功后创建唯一账号。用户设置平台密码，不提交邮箱密码。
验证码建议6位、5分钟有效、60秒重发间隔、最多5次验证；成功后一次性失效，重发使旧码失效。验证码绑定邮箱、用途与挑战ID，注册和密码重置不能混用。限制邮箱、IP、设备及全局发送量；验证码使用带服务端密钥的摘要保存，避免短码离线枚举。
找回入口统一响应，减少账号枚举。验证成功仅授予短时单次密码重置权限，不能直接获得普通登录会话。重置后撤销旧会话并发送通知。密码使用Argon2id加盐哈希。邮件供应商接受发送不等于收件成功，QQ、163、126均需实测。
7 积分 充值与计费
7.1 定价与用量
兑换率和服务售价分开配置并版本化。人民币以整数分保存；积分使用整数最小单位，不用浮点数计算余额。每次报价固定价格版本、用量单位、舍入规则、有效期与预算。
| 服务 | 面向用户计量 |
|---|---|
| 策略、剧本、分镜 | 固定任务积分，明确输入输出与修订范围 |
| 图片 | 按成功交付张数、模型和规格 |
| 视频 | 按模型、分辨率和约定计费秒数 |
| 剪辑导出 | 基础次数或按明确服务项计费 |
视频计费秒数不等于排队耗时，也不等于剪辑采用时长。15秒生成段只采用10秒不回退已发生的生成用量。参考视频时长是否计入上游成本由适配器记录，用户计费规则须在报价中明确。实际文件时长用于核验，处理帧率误差与计费单位的关系。
7.2 钱包状态与事务
报价 → 原子校验余额并冻结积分 → 创建任务和待派发事件 → 执行 → 结算或释放。
钱包记录可用、冻结、累计消费。不可变流水记录充值、赠送、冻结、扣费、释放、退款和人工调整；每条关联业务订单与幂等键。账务与任务创建在一个数据库事务中提交，Outbox负责事务后的可靠派发。
并发提交不得重复使用余额。同一任务的重复回调、重复查询和队列重投只允许一次结算。支付状态和用户账务由代码决定，模型无权限改余额或发起退款。
7.3 支付与退款
服务端创建充值订单，验证支付通知签名、商户身份、订单与金额；同一支付交易只入账一次。浏览器支付成功页面不能直接触发充值。漏回调通过主动查单补偿。赠送积分和付费积分分别记账，保留退款所需来源关系。
明确失败按已公示规则释放或退款；上游受理状态未知时进入对账。下载失败先重试下载，不能重新生成。技术失败与审美不满意分别制定规则。供应商成本和用户收费分开保存，上游已收费但用户退款须保留真实成本。
8 工作流 并发与恢复
项目流程以持久状态机及任务依赖图实现。状态包括草稿、待资料、待确认、排队、执行、等待上游、待核对、下载、校验、待审阅、成功、失败和取消。前端状态由后端事件投影，不由模型自由宣布完成。
角色图与场景图等独立任务可并行；引用未就绪资产的任务等待；尾帧续接按依赖执行。平台、供应商、模型、用户与渲染并发分别限制，跨Worker统一生效。按用户公平调度，供应商限流时退避。异步等待不长期占用执行槽；供应商活动任务额度直到任务终态才释放。
Worker通过租约、心跳和检查点领取任务。每次尝试保留输入哈希、模型配置版本、上游ID与结果。重启后恢复查询原任务；提交超时且无可信ID标记待核对，绝不盲目重提。供应商不支持幂等或查单时保留人工对账路径。
未提交任务可以取消并释放冻结。已受理任务只在供应商支持时申请取消，取消请求不等于取消成功。用户最高预算由后端检查，超出预算的下一批任务等待补充授权。
9 总体技术架构
前端React与TypeScript；后端Python与FastAPI；主数据库PostgreSQL；Redis用于缓存、限流和任务传输；Celery运行后台任务；FFmpeg与包装渲染器处理媒体；私有对象存储保存资产；Nginx承接HTTPS；Docker Compose交付。
模块化单体共享业务模型和数据库，API、调度器、AI Worker和媒体Worker独立进程。PostgreSQL是任务和账务权威，Redis或Celery结果缓存不作为唯一凭据。事件Outbox使任务可在消息丢失后恢复派发。
9.1 模型与工具边界
总控模型执行资料整理、资产设计、提示词编译和剪辑规划。Gemini角色独立创作策略、剧本和分镜。模型通过受控工具申请操作，后端校验用户、项目、范围、预算和能力。
模型不持有供应商密钥，不访问任意用户文件，不执行任意服务器命令，不更改积分或权限。上传文档、供应商返回内容和素材文字均视为不可信输入，不得覆盖平台规则。
9.2 供应商适配
统一接口覆盖能力探测、预检、报价参考、提交、查询、取消、下载和用量。实际支持矩阵记录输入格式、尺寸、时长、参考数量、声音与视频能力；不把未验证参数显示为支持。
密钥在服务器加密保存，主密钥与业务库分离，日志脱敏。Windows绝对路径与DPAPI读取改为服务器配置和密钥服务。更换模型或服务需显式配置，不在失败时暗中换线。
10 能力包与Skill迁移
能力包含manifest、版本、输入输出schema、流程定义、提示词、工具依赖、专用UI、计量定义、验收与恢复规则。平台接口版本独立于能力版本，新增能力必须声明兼容范围。
流程模板与提示词随包版本不可变发布，用户项目固定版本。供应商配置、定价另有版本并在任务中快照。普通用户不能上传任意代码作为可执行能力。
迁移流程：本地skill真实案例验证 → 提取输入、流程和规则 → 适配服务器工具 → 测试环境验证 → 小范围发布 → 正式入口。已有工具支持时主要增加能力包；新媒体或新交互仍需开发适配器或组件。
能力状态为开发中、测试中、已上线、暂停新建、已停用。暂停新建不影响存量任务查询和合理交付。旧项目升级先展示影响范围，不自动迁移。
11 数据与版本设计
| 实体 | 核心关联 |
|---|---|
| users、sessions、email_challenges | 用户身份、会话与验证码用途 |
| projects、project_revisions | 所属用户、模式、能力版本和目标 |
| products、product_revisions | 商品事实和引用版本 |
| assets、asset_versions、asset_links | 来源、存储、状态及依赖 |
| capabilities、capability_versions | 入口与发布包 |
| workflow_runs、step_runs | 流程、当前步骤、确认记录 |
| jobs、job_attempts、provider_tasks | 执行、重试、上游状态 |
| quotes、price_versions、usage_records | 报价与实际用量 |
| wallets、ledger_entries、reservations | 余额、不可变流水与冻结 |
| payment_orders、payment_events、refunds | 充值与对账 |
| outbox_events、audit_events | 可靠派发和审计 |
数据库唯一约束覆盖邮箱、支付交易、结算事件和提交幂等键。用户资源使用明确owner字段，后端各入口校验；管理操作通过独立权限路径。
12 服务器与发布
2026年11月9日实测：Ubuntu26.04 LTS、2核、7.2GB内存、当时约1.8GB可用；系统盘40GB剩余约8.3GB，数据盘/data约98GB剩余约88GB；已有Docker、Compose、Nginx、Python、Node和FFmpeg。资源数值是当时快照，不是容量承诺。
沿用现有Ubuntu26.04，无需重装24.04。容器固定应用依赖。新项目根目录/data/creator-platform，设计文档位于design/v1，源代码、联调环境、发布、数据和备份独立目录。保留现有网站和容器，新站使用独立Nginx虚拟主机、数据库和Docker项目。
现有DNS已将studio.myzxai.com指向服务器。初次检查时证书尚不覆盖该子域名，发布需配置独立证书。开发与正式版本分开，生产使用固定镜像及可回退发布。初期媒体渲染并发1，AI并发依据上游与内存压测调整。
数据库与媒体备份必须包含异机副本和恢复验证。开发构建也占系统盘空间，使用数据盘并控制构建缓存。正式多用户上线需压测；单机部署属于可恢复方案，不构成高可用承诺。
13 非功能要求与验收
| 维度 | 必须验证的结果 |
|---|---|
| 并发扣费 | 多请求竞争同一余额不会透支或重复冻结 |
| 充值幂等 | 重复通知、主动查单同时发生也只入账一次 |
| 执行恢复 | 提交后断线、Worker重启、消息重投不盲目重生 |
| 租户隔离 | 修改项目、素材、任务、账单ID不能越权 |
| 版本追溯 | 每个视频可追溯到剧本、分镜、资产、模型与价目版本 |
| 邮件账号 | 三类邮箱收件及重置通过，验证码不可复用或跨用途使用 |
| 成片 | 可完整解码；字幕、对白、音量、商品和画幅验收通过 |
| 备份恢复 | 在独立环境恢复账号、账本、任务与媒体引用 |
| 界面 | 桌面与手机可用；键盘可操作；减少动态效果偏好生效 |
| 成本 | 供应商成本与用户积分消费能够分别对账 |
性能门槛通过测试环境建立：测量页面响应、任务排队、数据库连接、内存峰值和渲染耗时；在确定用户规模和API限额前不承诺固定商业并发数。
14 开发里程碑
P0：账号、项目、资产、能力注册、任务状态机、积分账本及模拟支付测试。
P1：剧情式带货独立API总控与完整成片闭环，验证单段返工和断点恢复。
P2：数字人路线验证与第二入口闭环，验证新能力复用公共模块。
P3：真实邮件与支付、后台定价、成本对账及小范围试运营。
P4：并发与故障验收、备份恢复、安全隔离和发布回退，达到开放注册条件。
15 HTML原型交付范围
本次原型展示创作首页、两个入口、新建项目、工作台阶段切换、模拟生成进度与冻结结算、项目筛选、素材、钱包、任务和后台能力配置。交互均使用演示数据；不连接真实AI、支付、验证码或用户系统。原型的后台入口不代表已实现管理员权限。
演示数据刷新后可重置，API密钥不保存真实值。原型无登录限制用于设计审阅，不允许输入真实凭据或个人资料。正式产品必须实现本PRD的后端鉴权和账务。
视觉方向：暖纸白、炭黑、朱红与草木绿；大字号编辑式排版，电影感影像、留白、细线网格和轻微动效。兼容reduced-motion并避免自动播放声音。
图像仅为原型示意，来源为Unsplash公开图片：photo-1485846234645-a62644f84728、photo-1534528741775-53994a69daeb、photo-1608571423902-eed4a5ad8108；不是平台生成作品或用户案例。
16 设计依据
本会话确认的产品要求；ecommerce-drama-selling skill及相关运行器；服务器2026年11月9日只读检查。
技术参考：Docker Compose生产部署 https://docs.docker.com/compose/how-tos/production/ ；Celery任务与幂等 https://docs.celeryq.dev/en/latest/userguide/tasks.html ；OWASP密码找回 https://cheatsheetseries.owasp.org/cheatsheets/Forgot_Password_Cheat_Sheet.html 。