更新 2026-04-18 18:32

产品协作约定.md

@@ -0,0 +1,25 @@
+# 产品协作约定
+
+## 分工
+
+- **默认**：由产品侧（AI 辅助）输出**产品说明**（需求、流程、交互、文案、验收标准等），**不写代码**。
+- **实现**：代码与排期由**研发工程师**负责。
+- **例外**：仅当负责人**明确要求**「改代码 / 实现某功能」时，再进入编码类任务。
+
+## 文档存放
+
+- 上述产品说明类产出，**统一放在本仓库 `docs/` 目录下**（可分子目录，如 `docs/prd/`、`docs/feature/`）。
+- 命名建议：`主题-简述.md` 或带日期的版本，便于检索与评审。
+
+## 评审与迭代
+
+- 研发实现前：对产品说明做一次**技术可行性**粗评；有分歧时在产品说明里更新口径或拆期。
+- 上线前：按说明中的**验收标准**做产品验收。
+
+## Cursor 规则
+
+- 仓库已配置 `.cursor/rules/product-collaboration.mdc`（`alwaysApply: true`），便于在 Cursor 中默认遵循上述分工。
+
+---
+
+*约定建立后，新需求默认遵循本文；若需调整分工，请直接改本文件或口头同步。*

产品改进建议.md

@@ -7,10 +7,10 @@
 
 ## 〇、本期产品迭代重点（2026-04）
 
-**洗美过程短视频自动成片**（竖屏 15s、模板化 FFmpeg 拼接、过程素材 + 前后对比，详见专文）。
+**洗美过程短视频自动成片**（竖屏 9:16、**时长随素材量变化**、服务端模板化拼接；过程素材 + 前后对比，详见专文）。
 
-- **主文档**：[《洗美报告短视频成片方案（MVP）》](./洗美报告短视频成片方案.md)（分镜、规格、成本与工程机制）。
+- **主文档**：[《洗美报告短视频成片方案》](./洗美报告短视频成片方案.md)（分镜参考、规格、成本与工程机制；**第一版范围**与演进说明见文内「与工程实现同步」）。
-- **关联主流程**：《产品设计文档》§5.3 服务报告延伸能力；后端已有 `highlight_video_*` 等字段与异步任务方向，本期需把**产品闭环**（发起 → 排队/进度 → 成功播放与分享 → 失败降级）与**成片质量**（模板、字幕、配乐、对比段）一次性打穿。
+- **关联主流程**：《产品设计文档》§5.3 服务报告延伸能力；后端已有 `highlight_video_*`、`highlight_compose_mode` 等字段与异步任务方向，本期需把**产品闭环**（发起 → 排队/进度 → 成功播放与分享 → 失败降级）与**成片质量**（编排策略、字幕、配乐、对比段）一次性打穿。
 
 以下各节仍为中长期方向库；**不与本期重点冲突的条目可排后**，避免分散研发火力。
 
@@ -62,7 +62,7 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 
 | 优先级 | 方向 | 说明 |
 |--------|------|------|
-| **本期** | **洗美过程短视频自动成片（15s MVP）** | **迭代重点**；与 §〇 专文一致，传播与差异化核心 |
+| **本期** | **洗美过程短视频自动成片（可变时长、双编排）** | **迭代重点**；与 §〇 专文一致，传播与差异化核心 |
 | P0 | 会员卡 / 储值 / 次卡 | 贴近门店现金流与粘性 |
 | P0 | 按宠物维度的消费与服务历史 | 复购与情感连接；**已做 MVP**：`/api/pet/history` + 我的宠物「服务记录」时间线（预约关联 `pet_id` + 报告）；**未含**金额/储值（见上条） |
 | P1 | 回访提醒池与自动化触达 | 依赖短信/公众号资质与合规 |
@@ -84,7 +84,7 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 
 - **设计系统落地**：已有 UI 规范时，建议有组件清单/示例页，避免新页面风格漂移。
 - **加载 / 空态 / 失败态**：理想路径外三态需统一，避免只在成功态「好看」。
-- **H5 报告页**：对外门面；**本期**需与成片联动（播放/下载/分享入口、生成中/失败态）；可加强对比呈现（如滑块对比）、过程素材相册化；**品牌色与 15s 片头片尾模板**需统一调性。
+- **H5 报告页**：对外门面；**本期**需与成片联动（播放/下载/分享入口、生成中/失败态）；可加强对比呈现（如滑块对比）、过程素材相册化；**品牌色与片头片尾模板**（若后续单独加轨）需统一调性；当前实现以**素材拼接成片**为主，勿对外承诺固定秒数。
 
 ---
 
@@ -116,7 +116,7 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 
 > **说明**：以下三条为历史「通用优先级」备忘；**当前迭代已单独锁定「洗美过程短视频自动成片」为首位**（见 §〇），其余能力并行或顺延。
 
-1. **洗美过程短视频自动成片（15s MVP）**（本期迭代重点，见专文）。
+1. **洗美过程短视频自动成片（可变时长、双编排）**（本期迭代重点，见专文）。
 2. **报告页运营能力**（留资、回访清单、成片分享链路）互相补强。
 3. **宠物档案与成长/服务历史** 或 **老板工作台首页 + 业绩概览**（按下一版本资源二选一或分期）。
 
@@ -125,9 +125,13 @@ v1 宠主多为「链接访客」，若不沉淀 openid/手机号，门店无法
 ## 十、与仓库内其他文档的关系
 
 - 《产品设计文档.md》：v1 功能与数据模型以该文档为准。
-- 《洗美报告短视频成片方案.md》：成片能力与 §5.3 延伸对应。
+- 《洗美报告短视频成片方案.md》：成片能力与 §5.3 延伸对应；文内「约 15s 分镜」为**参考示例**，实际成片时长以素材与配置上限为准。
 - 《前端UI规范.md》：实现层视觉基线。
 
 ---
 
 *文档为建议汇总，实施时请结合版本目标、研发成本与合规评审裁剪。*
+
+---
+
+**修订备忘（2026-04-18）**：全局措辞同步——成片由「固定 15s」统一为「竖屏、可变时长、配置上限、双编排」；与《洗美报告短视频成片方案》§0、《产品设计文档》v1.8 一致。

产品设计文档.md

@@ -1,12 +1,12 @@
 # 宠伴生活馆 - 产品设计文档
 
-> 版本：v1.7
+> 版本：v1.8
-> 日期：2026-04-18
+> 日期：2026-04-18（v1.8：成片「可变时长 + 双编排」措辞与 §5.3 对齐专文 §0）
-> 状态：产品设计确认中；**本期迭代重点：洗美过程短视频自动成片（15s MVP）**
+> 状态：产品设计确认中；**本期迭代重点：洗美过程短视频自动成片（竖屏、可变时长、双编排）**
 
 **相关子文档：**
 
-- [洗美报告短视频成片方案（MVP）](./洗美报告短视频成片方案.md) — **本期迭代主方案**：过程短视频与 15s 自动成片（与 §5.3 服务报告延伸能力对应）
+- [洗美报告短视频成片方案](./洗美报告短视频成片方案.md) — **本期迭代主方案**：过程短视频与自动成片（与 §5.3 服务报告延伸能力对应；时长与编排以专文「与工程实现同步」为准）
 - [产品改进建议](./产品改进建议.md) — 中长期方向库；**§〇** 为本期重点说明
 
 ---
@@ -206,9 +206,9 @@
 - 提交后锁死，不可再修改
 - 一约一份报告
 
-> **本期迭代重点：** 洗美报告「过程短视频 + 自动生成 **15s 竖屏成片**」，产品边界、分镜、成本与工程机制见子文档 [《洗美报告短视频成片方案（MVP）》](./洗美报告短视频成片方案.md)。成片以模板化 FFmpeg 拼接为主，成片可在报告页/H5 播放与分享。
+> **本期迭代重点：** 洗美报告「过程短视频 + 自动生成 **竖屏成片（9:16）**」，**成片时长随素材量变化**（配置级总时长上限），支持 **预设顺序 / 穿插** 两种编排（`highlight_compose_mode`）。产品边界、参考分镜、成本与工程机制见子文档 [《洗美报告短视频成片方案》](./洗美报告短视频成片方案.md)。成片以服务端模板化拼接（如 FFmpeg）为主，成片可在报告页/H5 播放与分享。
 >
-> **实现对齐备注（2026-04）**：服务端已落库过程素材，报告查询接口对 `duringMedia` 的回传需与成片任务对齐；`highlight_video_*` 等字段承载成片 URL 与任务状态，本期需完成**发起 → 异步生成 → 成功播放 / 失败提示**闭环。
+> **实现对齐备注（2026-04）**：服务端已落库过程素材，报告查询接口对 `duringMedia` 的回传需与成片任务对齐；`highlight_video_*`、`highlight_duration_sec`、`highlight_compose_mode` 等字段承载成片 URL、时长、编排方式与任务状态，本期需完成**发起 → 异步生成 → 成功播放 / 失败提示**闭环。
 
 ### 5.4 发送报告（v1 核心功能）
 
@@ -291,7 +291,7 @@
 | P0 | H5报告页（品牌信息强化） | 🔨 本次 |
 | P0 | H5报告页（链接+二维码） | ✅ |
 | P1 | 报告过程素材回传（duringMedia） | 🔨 进行中 |
-| **P0** | **洗美过程短视频自动成片（15s、模板拼接）** | **🔨 本期迭代重点** |
+| **P0** | **洗美过程短视频自动成片（可变时长、双编排、模板拼接）** | **🔨 本期迭代重点** |
 | P0 | 老板后台（员工管理+邀请码） | ✅ 已合并到index.html |
 | P0 | 老板后台（预约概览） | ✅ 已合并到index.html |
 | P1 | 服务类型管理（老板后台） | ✅ |

报告短片下载功能-产品说明.md

@@ -0,0 +1,76 @@
+# 报告短片：下载到本地（产品说明）
+
+> 状态：**已实现**（微信小程序「保存视频」+ H5「下载短片」）；App 内 WebView 仍为后续。  
+> 目标：宠主/店员在报告页将**已生成成功的回顾短片**保存到相册或系统下载目录，便于私发、二次剪辑或留存。
+
+---
+
+## 与当前实现同步（工程 · 2026-04）
+
+| 端 | 入口文案 | 行为摘要 |
+|----|-----------|----------|
+| **微信小程序** | **「保存视频」**（仅 `highlight_video_status === done` 且有效 URL） | 用户点击 → `downloadFile` → `saveVideoToPhotosAlbum`；失败含域名未配置、权限引导；页内提示**右上角「···」转发本页**；分享小程序卡片仍用底部「转发给宠主」。 |
+| **H5 报告页** | **「下载短片」** | 优先 `fetch` 同源/CORS 视频为 Blob 触发浏览器下载；失败则**复制视频链接**并说明可在浏览器打开或右上角分享。 |
+
+**前置条件与验收**仍以下文 §2、§6 为准；若产品与研发口径冲突，以本表与 `reportView.vue` 实际交互为准。
+
+---
+
+## 1. 是否要做
+
+**建议做。** 成片的核心价值之一是**可带走、可转发**；仅在线播放而不提供「保存」，会削弱传播与留存，尤其在微信生态外分享、或用户希望「先存再发」时。
+
+---
+
+## 2. 前置条件
+
+- 仅当 **`highlight_video_status === done`** 且存在有效 **成片 URL** 时展示下载入口。
+- **生成中 / 失败**：不展示下载；失败态沿用现有「重试生成」等能力，不误导为可下载。
+
+---
+
+## 3. 端与能力差异
+
+| 场景 | 常见实现要点 | 产品注意 |
+|------|----------------|----------|
+| **微信小程序内嵌报告页** | 使用 `video` 组件 + 用户触发后调 **`wx.downloadFile`** → **`wx.saveVideoToPhotosAlbum`**（或等价 API）；需处理**相册权限**授权失败文案 | 必须**用户主动点击**（入口「保存视频」），符合平台规范；首次需说明用途 |
+| **H5 报告页** | 同源或可 CORS 的视频 URL：`fetch` blob 触发下载；跨域受限时可服务端 **`Content-Disposition`** 或代理（可选增强） | 若视频在**另一域名**（如 CDN/API 域名），需配置 **CORS** 等；失败时提供「复制链接到浏览器打开」类降级（已实现） |
+| **App 内 WebView** | 与容器约定是否允许下载/保存相册 | 暂无 App 时可标为后续 |
+
+**产品结论**：**小程序与 H5 均已按上表实现全量能力**（入口、loading、成功/失败反馈一致）；两端差异仅来自平台能力（相册 vs 本机下载），不作为「一端全量、一端仅兜底」的阶段性策略。可选后续：独立下载接口、CDN 防盗链与签名 URL，由运维与研发按环境评估。
+
+---
+
+## 4. 交互与文案
+
+- **入口名称**：建议统一为 **「保存视频」** 或 **「下载短片」**（与「生成短片」区分）。
+- **位置**：成片播放器旁或下方，与「分享」并列（若本期有分享能力）。
+- **过程**：点击 → loading（短）→ 成功 toast「已保存到相册」/「已开始下载」；失败 toast **可理解原因**（权限拒绝 / 网络 / 格式不支持），不暴露技术栈。
+- **权限**：小程序拒绝相册权限时，引导用户去设置页，**单次**即可，勿连环弹窗。
+
+---
+
+## 5. 合规与品牌
+
+- 视频内容为门店服务记录，下载行为视为用户**自行保存**；对外页已有隐私与转发提示的，与《产品改进建议》§八 一致即可。
+- 若短片含水印/门店标识，下载文件与在线播放**一致**，无需单独说明。
+
+---
+
+## 6. 验收标准（建议）
+
+1. 成片成功状态下，用户可一键触发保存/下载，**无需**额外登录（与当前报告 token 访问策略一致）。  
+2. 保存成功后在系统相册（或浏览器下载目录）中**可找到**对应 mp4。  
+3. 权限拒绝、网络错误、资源 404 等均有明确提示，**不出现**白屏或无反馈。  
+4. 生成中、未生成、失败时**不出现**下载入口，或置灰并说明原因。
+
+---
+
+## 7. 与仓库文档的关系
+
+- 《产品设计文档》§5.5 H5 报告页「分享能力」可后续增补「保存视频」一条。  
+- 《本期主线-下一步产品优化点》中 **B. 成片** 的传播属性可与本说明交叉引用。
+
+---
+
+*实现细节（接口域名、小程序 downloadFile 合法域名、H5 跨域、视频格式）由运维与研发按环境配置；本文定产品与验收口径。*

本期主线-下一步产品优化点.md

@@ -0,0 +1,92 @@
+# 本期主线：报告传播 + 成片 + 留资 + 微信绑定 — 下一步产品优化点
+
+> 角色：产品说明，供本期迭代评审与排期。  
+> 主线：以「可传播的报告页」为枢纽，串联 **成片资产**、**留资转化**、**微信身份沉淀**，形成可度量闭环。
+
+---
+
+## 一、主线在闭环中的位置（共识图）
+
+```
+门店完成报告 → 传播（链接/海报/分享）→ 宠主打开 H5/小程序
+        → 观看成片 / 对比内容 → 留资（电话/意向）→ 微信绑定（可回访）
+        → 门店回访池 / 自动化提醒（后续）
+```
+
+**本期北极星建议（可二选一或并列）：**  
+报告链接 **二次打开率**、成片 **生成成功率 × 分享触达次数**、留资 **有效线索数/转化率**、绑定 **从留资到 openid 关联成功率**。
+
+---
+
+## 二、按主线拆分的「下一步优化」——产品细节清单
+
+### A. 报告传播
+
+| 方向 | 现状/风险 | 建议优化的产品细节 |
+|------|-----------|-------------------|
+| **传播素材统一** | 链接、二维码、分享卡片信息可能不一致 | 明确**一页一摘要**：标题规则（宠物名+服务+门店）、摘要图优先序（成片封面帧 > 服务后首图 > Logo）、分享失败时的降级文案。 |
+| **员工动作成本** | 多步操作易漏发 | 「发送报告」后 **一键组合**：复制链接 + 话术模板（可配置 2～3 条），二维码与链接同屏展示，减少切 App 次数。 |
+| **传播效果可感知** | 难判断哪类报告更易被打开 | 产品侧先定 **最小埋点口径**：链接打开（首次/再次）、停留时长区间、成片是否播放、是否触发留资（与 D 对齐）；不要求第一期就做复杂看板，但要**可统计**。 |
+| **链接安全与体验** | token 永久有效有隐私与滥用风险（见《产品改进建议》§六） | 分期策略：**短期**在对外页提示「请勿公开转发」+ 异常频次提示；**中期**可选「店员一键作废并重发」、有效期策略（需与门店培训同步）。 |
+
+### B. 成片（洗美回顾短片）
+
+| 方向 | 现状/风险 | 建议优化的产品细节 |
+|------|-----------|-------------------|
+| **预期对齐** | 文档已全局同步为可变时长；对外仍要统一口径 | 报告页文案：**时长随素材量变化（有上限）**；两种编排（预设顺序 / 穿插）各**一句话说明**，避免宠主与测试按固定秒数验收。 |
+| **闭环体验** | 生成中/失败/成功三态若不一致会伤信任 | 固化三态：**生成中**（预估提示 + 可离开）、**失败**（可重试 + 简明原因枚举）、**成功**（播放器 + 与海报/分享联动）。失败原因对用户展示**归类**（网络/素材/服务不可用），不全量抛技术错误。 |
+| **传播属性** | 成片是差异化资产，若分享路径弱则浪费算力 | 明确 **分享优先级**：小程序内转发标题/封面图规则；H5 若无法直接调起微信分享，则 **强引导「长按保存 / 复制链接」** 与门店话术。 |
+| **合规与品牌** | BGM、肖像、水印 | 产品规则写清：**默认水印/门店标识**是否强制；配乐为「门店配置商用曲库」时的责任提示（对内配置说明即可）。 |
+
+### C. 留资
+
+| 方向 | 现状/风险 | 建议优化的产品细节 |
+|------|-----------|-------------------|
+| **动机与时机** | 无明确钩子则转化率低 | 设计 **留资触发点**：如「预约下次洗护提醒」「领取小礼品/优惠券（若业务有）」「专属顾问回访」——与运营确认**一条主钩子**，避免表单字段堆砌。 |
+| **字段与摩擦** | 字段多易放弃 | **默认最少字段**（如手机号 + 可选宠物名），其余由店员在回访池补全；说明「用途：回访与提醒，非营销骚扰」类话术（合规与《产品改进建议》§八对齐）。 |
+| **与回访池衔接** | 留资进了池若无人跟进会反噬口碑 | 产品规则：**留资后门店侧反馈时限**（建议值由运营定）、超时提醒（老板端轻量即可）；退订/拒绝路径清晰。 |
+| **重复留资** | 同一人多次提交 | 展示层：**已提交感谢态** + 修改入口（可选）；数据层去重策略由研发定，产品给口径「同一报告 token + 同一手机号」等。 |
+
+### D. 微信绑定（身份沉淀）
+
+| 方向 | 现状/风险 | 建议优化的产品细节 |
+|------|-----------|-------------------|
+| **绑定动机** | 用户不知道为何要绑 | 在留资成功页或报告页 **一句话价值**：「绑定后可接收服务提醒 / 报告更新」（需与真实能力一致，避免虚假宣传）。 |
+| **路径最短** | 步骤多会断层 | 理想路径：**留资后同一页引导授权**；若不能同页完成，则 **短信/页面二次引导** 的规则写清（频次、文案）。 |
+| **账号关系** | 多宠物、多报告 | 产品口径：**一个微信可关联多个宠物/多次服务**时的展示与默认进入页（最近一次报告 or 宠物列表 v2）。本期至少 **不阻塞**「绑得上、找得到上次留资」。 |
+| **与留资一致性** | 手机号与 openid 两套体系 | 明确 **主键策略**（产品视角）：以哪一端为「客户主档」、冲突时如何提示（研发实现），避免用户看到两套身份。 |
+
+---
+
+## 三、跨主线的「体验底座」（建议并行关注）
+
+1. **加载 / 空态 / 失败态**（《产品改进建议》§五）：报告页、成片区、留资表单、绑定按钮四类组件统一交互规范，避免只有成功态精致。  
+2. **H5 与小程序差异**：传播主阵地若在小程序，需列 **能力差异表**（分享、登录、相册、视频播放），对外话术不承诺 H5 做不到的能力。  
+3. **老板端可观测性**：最小集合——成片任务状态、留资条数、绑定转化漏斗（可与埋点分期）。  
+4. **文档与研发对齐**：成片与编排规则以《洗美报告短视频成片方案》§0、《产品设计文档》§5.3 为准；专文 §5 为**约 15s 参考分镜**，非固定成片契约。
+
+---
+
+## 四、建议的迭代切片（便于排期）
+
+| 切片 | 内容 | 产出物 |
+|------|------|--------|
+| **S1 传播打底** | 发送报告动线 + 分享元信息 + 链接打开埋点 | PRD 片段 + 文案/埋点表 |
+| **S2 成片体验** | 三态、对外说明、分享联动 | 报告页原型说明 + 异常枚举 |
+| **S3 留资 MVP** | 单钩子 + 最少字段 + 回访池入口规则 | 表单与状态说明 |
+| **S4 绑定闭环** | 留资后引导 + 身份口径说明 | 流程图 + 文案 |
+
+实际顺序可按研发依赖调整（例如埋点可与 S1 并行）。
+
+---
+
+## 五、与仓库内文档的关系
+
+- 《产品改进建议.md》：战略与中长期方向库。  
+- 《产品设计文档.md》§5.3–5.5：报告与发送流程基线。  
+- 《洗美报告短视频成片方案.md》：成片能力边界（需与当前「可变时长、双编排」实现同步修订）。  
+- 《产品协作约定.md》：产品说明默认落 `docs/`，代码由研发实现。
+
+---
+
+*本文随评审更新；定稿后可将「已采纳」项勾进迭代看板，未采纳项注明原因避免重复讨论。*

洗美报告短视频成片方案.md

@@ -1,6 +1,6 @@
-# 洗美报告短视频成片方案（MVP）
+# 洗美报告短视频成片方案
 
-> **本期产品迭代重点（2026-04）** — 实施范围、分镜与工程口径**以本文为准**；与《产品改进建议》§〇、《产品设计文档》§5.3、§七 开发进度联动更新。
+> **本期产品迭代重点（2026-04）** — 与《产品改进建议》§〇、《产品设计文档》§5.3、§七 联动更新；**措辞与工程实现冲突时，以「§0 与工程实现同步」为准。**
 
 > **主文档：** [《宠伴生活馆 - 产品设计文档》](./产品设计文档.md)（预约与洗美报告主流程见 **第二章、§5.3～§5.5**）
 
@@ -8,25 +8,39 @@
 
 ---
 
+## 0. 与工程实现同步（全局措辞 · 2026-04）
+
+以下与当前研发实现一致，**对外宣传与测试验收请以此为准**：
+
+| 维度 | 产品口径 |
+|------|----------|
+| **成片时长** | **不固定**：由素材种类与数量决定，按「图片基准秒数 + 视频截取长（有封顶）」累加；总和超过配置级 **最大总时长** 时整体等比压缩。勿对用户承诺「固定 15 秒 / 30 秒」。 |
+| **编排方式** | 至少两种：**预设顺序**（对比封面 → 服务前其余 → 过程 → 服务后其余 → 服务后首张收尾）与 **穿插**（全局照片/小视频均匀穿插）。用户侧称「预设顺序」「穿插成片」。 |
+| **对比呈现** | 预设模式中封面为**左右拼接对比图**（服务前首张 \| 服务后首张）；下文 §2 早期「不做左右拼图」指**分镜脚本草案**中的全屏切换方案，与当前工程封面实现**并存说明**：若后续增加独立片头片尾轨，再统一叙事口径。 |
+| **技术路径** | 服务端 **FFmpeg**（及可选 ffprobe）拼接、竖屏 9:16、可选 BGM 混音；异步任务 + `highlight_video_*` / `highlight_duration_sec` / `highlight_compose_mode` 等字段。 |
+| **参考分镜** | §5「约 15s 均衡分镜」保留为**对内/营销节奏参考**与二期加片头片尾时的脚本基础，**不是**当前成片的固定秒数契约。 |
+
+---
+
 ## 1. 背景与目标
 
 - 在现有「服务前后照片」基础上，增加服务过程中拍摄的**短视频**素材。
 - 将**前后对比图 + 过程视频**合成为一条**竖屏短视频**，风格偏**抖音短视频**，提升传播与观感。
-- 成片以**固定片头 / 片尾模板**为主，控制成本与审核风险；用**字幕 + 背景音乐**完成叙事，第一版**不做口播/配音**。
+- 中长期可叠加**固定片头 / 片尾模板**以强化品牌与审核一致性；第一版以**素材拼接成片**为主，控制成本；**字幕 + 强叙事 BGM** 可分期上线，第一版**不做口播/配音**（与实现对齐）。
 
 ---
 
-## 2. MVP 范围（已确认）
+## 2. 第一版范围（产品边界 · 随实现演进）
 
 | 维度 | 决策 |
 |------|------|
-| 成片时长 | **15s**，快节奏 |
+| 成片时长 | **可变**（见 §0）；有**配置级总时长上限**；节奏随素材量变化 |
-| 音轨 | **背景音乐 + 字幕** |
+| 音轨 | **可选 BGM 混音**；口播/字幕轨为**后续增强**（第一版以后续迭代为准） |
-| 口播 | **不做** |
+| 口播 | **不做**（第一版） |
-| 品牌结构 | **固定片头 + 固定片尾模板**（可接受） |
+| 品牌结构 | **可选**：独立片头/片尾模板为增强项；当前以素材拼接 + 封面对比为主 |
-| 对比呈现 | **全屏切换**（前图全屏 → 硬切 → 后图全屏），**不做左右拼图同框** |
+| 对比呈现 | **预设模式**：首张多为**左右拼接对比封面**；**参考分镜**中仍可规划全屏硬切对比段（见 §5） |
 | 对比重点 | **毛量 / 造型**（非局部病灶类叙事） |
-| 叙事权重 | **均衡**：过程与对比都有明确篇幅 |
+| 叙事权重 | **均衡**：过程与对比在参考分镜中都有篇幅；实际成片以编排算法为准 |
 
 ---
 
@@ -49,9 +63,9 @@
 
 ---
 
-## 5. 默认分镜与时间轴（均衡 · 总时长约 15s）
+## 5. 参考分镜与时间轴（均衡节奏 · 约 15s 基准示例）
 
-> 若过程素材仅 2 段，可将「过程 C」并入「过程 B」，或略缩短对比段，**总时长仍锚定 15s**。
+> **性质说明**：下表为**对内参考**（偏营销短视频节奏），用于讨论剪辑点与叙事权重；**实际成片时长不锚定 15s**，以 §0 为准。若过程素材仅 2 段，可将「过程 C」并入「过程 B」，或略缩短对比段，在**约 15s 量级**内自洽即可。
 
 | 段落 | 时长（约） | 内容 | 目的 |
 |------|-----------:|------|------|
@@ -106,7 +120,7 @@
 
 ---
 
-## 8. 后续迭代（不在 MVP）
+## 8. 后续迭代（不在第一版核心）
 
 - AI 辅助更强分镜、口播稿、更多曲风包。
 - 更强生成式画面/特效（成本高、时延长、审核与版权风险大，需单独评估）。
@@ -117,5 +131,6 @@
 
 | 日期 | 说明 |
 |------|------|
-| 2026-04-14 | 初稿：基于产品讨论沉淀 MVP 边界、15s 均衡分镜、全屏对比与毛量/造型取向 |
+| 2026-04-14 | 初稿：基于产品讨论沉淀第一版边界、15s 均衡参考分镜、全屏对比与毛量/造型取向 |
 | 2026-04-18 | 标注为**本期产品迭代重点**；与《产品改进建议》《产品设计文档》交叉引用 |
+| 2026-04-18 | **全局措辞同步**：固定 15s → 可变时长与上限；补充 §0 与工程实现一致；§5 明确为参考分镜 |