ai/docs/work-sync/07_版本记录/CHANGELOG.md

# Work 同步变更记录

本文件只追加已实现、已验证或明确改变状态的事项。未来设想写入 `FEATURE_*.md`，不要混入变更记录。

## [WORK_SYNC_2026-07-19_V11] - 2026-07-19

### 新增

- 新增 `S_PLUS_PRODUCTION_FLOW_AUDIT_V1.md`，按当前代码、数据库和项目 #22 审计从原著到成片的真实流程风险。
- 新增 `S_PLUS_BATCH_AUTOMATED_PRODUCTION_PIPELINE_V2.md`，作为新建 S+ 项目的唯一目标生产流程。
- 目标流程统一为真人剧组逻辑：开发、前期、生产、后期，对用户呈现十步制作流程。
- 明确短篇完整故事、长篇连载小说和现成分集剧本三种入口，不再强迫所有内容走同一编剧顺序。
- 明确制作拆解、资产与导演双轨、场景地理、风险分级、G0-G7 质量门、任务 DAG、预算和局部失效策略。

### 决策

- 批量生产采用异常驱动人工介入；低风险镜头可自动通过，高风险镜头必须人工批准。
- Generation Plan 拆分为可修订 Intent Plan 和关键帧批准后冻结的不可变 Execution Plan。
- 视频生成只创建候选；未通过 QC、未批准或被拒绝的素材不得进入活动指针、合并或发布。
- 项目 #22 保留为回归样本，不再作为新流程结构的母版。

### 状态说明

- 本批次只完成流程审计和目标规范，没有修改数据库、生产服务或付费 Provider 调用。
- V2 流程标记为目标规范，代码需按 P0-P5 分阶段实现和验收。

## [WORK_SYNC_2026-07-16_V2] - 2026-07-16

### 新增

- 新增确认资产计划到 `Episode` / `EpisodeScript` / `StoryboardShot` 的 S+ 执行桥接。
- 支持在外部生成角色三视图的情况下，先落地导演分镜草案。
- 新增外部资产占位状态 `external_assets_pending`。

### 保护

- 草案只能引用资产计划内的 `REQ_*` 逻辑编号。
- 素材未导入前不编译 Provider Prompt，不冻结 Generation Plan，不触发付费生成。
- 已有确认分镜或冻结计划后禁止覆盖。

### 验证

- 项目 #22 已落地第1集 9 镜，总时长 60 秒，全部等待外部资产。
- Production Kernel 定向测试 24/24 通过。
- Backend 与 User App 生产构建通过，后端健康检查通过。
- 未调用付费 AI Provider。

## [WORK_SYNC_2026-07-15_V1] - 2026-07-15

### 新增

- 建立 AI 内容生产平台首个 Work 同步包。
- 生成项目真实状态快照 `PROJECT_STATUS_V1.md`。
- 生成当前架构、小说引擎、短剧引擎、AI 流水线和数据库文档。
- 纳入 AI 视频生产经验快照。
- 建立同步协议、文档模板、历史设计隔离说明和文件校验清单。

### 当前确认

- 全仓生产构建通过。
- Prisma 33 个迁移全部已部署。
- backend、worker、MySQL、Redis、Nginx 正在运行。
- 后端测试 273 条中 238 通过、35 失败。
- 当前运行进程尚未加载审计期间的最新构建。
- Git 只有初始提交，当前现实代码尚未形成可靠版本基线。

### 风险

- 数据库和本地私有素材缺少已验证恢复流程。
- 队列任务目录与实际 Worker 执行覆盖不一致。
- Provider 路由、状态字符串和成本口径需要统一。
- 用户端、管理端和若干 Service 文件过大。

## [WORK_SYNC_2026-07-15_V2] - 2026-07-15

### 新增

- 部署 S+ Phase 2“原著分析 -> 改编圣经 -> 分集计划”结构化写路径。
- 新增不可变来源快照、版本化生产合同和 Reviewer 记录。
- 新增三个阶段 Prompt、确定性硬门、三集连续性检查和人工单集放行。
- 用户端新增 S+ 生产工作台；付费阶段生成入口暂不开放。

### 变更

- 普通新项目默认使用 `splus_v1`；原有 20 个项目全部保留为 `legacy_v1`。
- 新项目不再使用旧 StoryBible/旧 Episode 写入口；后端同步增加隔离守卫。
- 单次原著分析限制为最多 20 个连续章节、180,000 字。

### 数据库

- 迁移：`20260715143000_splus_production_contracts_v1`。
- Prisma Model 从 61 个增加到 64 个，迁移从 33 个增加到 34 个。
- 新表当前为空，没有自动迁移或改写历史内容。

### 验证

- Phase 2 定向测试：13/13 通过。
- 后端生产构建：通过。
- 用户端生产构建：通过。
- Prisma schema 校验与迁移：通过。
- 后端健康检查：`ok`。
- 全量后端测试：254 通过、34 失败；失败数未扩大。

### 风险/回滚

- 工程链路已部署，真实新项目连续三集内容验收尚未执行。
- 进入 Phase 3 前必须只放行一个通过三集连续性检查的分集计划。
- Phase 0 数据库与私有素材备份继续作为本次回滚基线。

## [WORK_SYNC_2026-07-15_V3] - 2026-07-15

### 新增

- 新增镜头级不可变 `ShotGenerationPlan`，以内容哈希和修订号保存 S+ 执行计划。
- 新增生成计划冻结、查询、快照与定向规则测试。
- 关键帧、参考资产、角色元素、逐角色音色、视频请求、QC、重试、回退和成本审计共同读取同一计划。

### 变更

- S+ 视频队列不能被普通请求静默覆盖 Provider；系统修复仅可使用冻结回退链。
- 镜头、关键帧、视频片段和渲染任务增加生成计划追踪 ID。
- 旧 `legacy_v1` 项目不强制迁移或回填计划。

### 数据库

- 迁移：`20260715223000_shot_generation_plan_v1`。
- 新增 `shot_generation_plans`；当前 Prisma 迁移共 38 个并已全部部署。

### 验证

- Generation Plan 与 AI Router 定向测试：9/9 通过。
- Backend、User App、Admin、Workers 生产构建：通过。
- 全量后端测试：265 通过、34 失败；本阶段新增测试全部通过。
- 未触发真实付费 AI 生成。

### 风险/后续

- 前端尚未提供生成计划修订差异界面。
- 模型能力、参数 Schema 和价格仍需升级为版本化注册表。
- 需要用一个全新 S+ 项目执行单镜头真实验收。

## [WORK_SYNC_2026-07-15_V4] - 2026-07-15

### 新增

- 新增不可变 `ModelCapabilityVersion`、`ModelParameterSchemaVersion` 和 `ModelPricingVersion`。
- 当前 114 个 Provider 已初始化三类首版注册表，各 114 条。
- 新增模型注册表查询、按当前 Provider 配置发布或复用修订的管理接口。
- 新增同一镜头两个 Generation Plan 修订的字段级比较接口。
- 用户端真人短剧制作台新增活动计划、历史修订、成本和分类差异视图。

### 变更

- `ShotGenerationPlan` 绑定能力、参数 Schema 和价格三个不可变版本 ID，并继续保存完整快照。
- S+ 计划冻结前按绑定 Schema 校验最终 Provider 请求；参数冲突会在付费调用前阻断。
- `ProviderConfig` 明确为可编辑工作区，不再被当作历史执行凭证。

### 数据库

- 迁移：`20260715233000_model_registry_versions_v1`。
- Prisma Model 从 64 个增加到 68 个，迁移共 39 个并已全部部署。

### 验证

- Backend、User App、Admin、Workers 生产构建：通过。
- 模型注册表与计划修订定向测试：6/6 通过。
- 全量后端测试：269 通过、34 失败；失败数与上一基线一致。
- Backend 与 Worker 受控重启后均为 `active`，后端健康检查返回 `ok`。
- 未触发真实付费 AI 生成。

### 风险/后续

- 仍需用一个全新 S+ 单镜头核对计划、ProviderLog、QC 和真实账单。
- 注册表待发布差异、管理员确认和回滚审计尚未进入后台。
- 角色主资产到 Kling `element_id` 的供应商绑定和正式校验仍待完成。

## [WORK_SYNC_2026-07-15_V5] - 2026-07-15

### 新增

- 新增 `CharacterProviderBinding`，保存全局角色到 Kling 视频角色元素、多图元素和绑定声线的真实供应商映射。
- 新增8秒、1080P、16:9角色元素源视频入口，以及元素 ID 导入、90分质检审批和主版本管理页面。
- Generation Plan 冻结元素绑定；Kling Omni 正式请求同时提交真实 `element_list` 和顺序一致的 `<<<element_n>>>` Prompt 引用。
- S+ Kling Omni 镜头新增角色元素硬门，任一出场角色缺少已审批元素即在付费调用前阻断。

### 变更

- 新生产画幅统一为16:9；视频1920×1080、关键帧2560×1440、原生4K 3840×2160。
- 42个图片/视频 Provider 的 `production_aspect_ratio` 和允许画幅统一为16:9。
- Omni 无参考视频时按图片与元素合计最多7个动态分配图片输入，不再固定浪费参考位。
- 历史项目、素材和已冻结计划不原地改写；重新生成须冻结新的横屏修订。

### 数据库

- 迁移：`20260716003000_landscape_character_elements_v1`。
- Prisma Model 由68个增加到69个，迁移由39个增加到40个并已部署。
- 模型能力版本与参数 Schema 版本分别由114条增加到156条；价格未变化，仍为114条。

### 验证

- Prisma schema 校验与迁移：通过。
- Backend、User App 生产构建：通过。
- Generation Plan 与 Model Registry 定向测试：6/6通过。
- Prompt Builder 定向测试：7/7通过。
- 全量 Backend 测试：269通过、34失败，失败数未扩大。
- Backend 与 Worker 已受控重启并保持 `active`，后端健康检查返回 `ok`。
- 未触发真实付费生成；真实 Kling 元素创建、单镜头和账单对账待验收。

### 风险/后续

- Kling 官方公开资料目前只确认网页/App元素库创建流程；平台暂不实现未经验证的自动创建元素 API。
- LiveAction 历史测试仍有19条失败，主要是旧 Prisma mock 与既有导演策略断言漂移，需要单独清债。
- 当前角色供应商绑定表为0条，需要用首个真实元素完成端到端验收。

## [WORK_SYNC_2026-07-16_V6] - 2026-07-16

### 新增

- 使用全新 S+ 项目“诸葛亮与司马懿斗法”执行首批人物三视图真实 Provider 验收。
- 图片生成支持显式 `reference_asset_ids`，任务能够审计本轮实际参考来源。
- 新增 `reference_crop_mode=turnaround_face_panel`，可临时提取三视图左侧身份面板，不修改原始素材。
- 新增跨视图身份漂移、错误视图几何和现代鞋履的确定性视觉硬门。

### 变更

- 公共人物三视图模板升级为 `character_turnaround_public_v3_s_plus`，身份母版默认空手并强化年龄、鞋履和视图一致性。
- 三视图不再被错误自动晋升为角色主锚点，只有真实 `anchor` 类型图片可参与自动主锚点选择。
- 98分且参考模式一致的可信 Prompt 可复用，避免每轮视觉经验变化都重复执行多轮昂贵审稿。
- Prompt 审稿输入不再把独立负面约束作为待审正文，减少错误污染判定。

### 真实验收

- 共得到 #978、#979、#980、#981、#982、#983 六张候选；当前最佳为素材 #980，视觉分87。
- 所有候选均未达到 S+，没有标记 approved，也没有晋升角色主锚点。
- Seedream 5.0 整板递归、GPT Image 2 A/B 和身份面板裁切均未解决跨视图服装与鞋履拓扑漂移。
- 停止继续单画布递归，下一阶段采用“身份、正面、严格侧面、背面分别生成与质检，再程序化合成”的路线。

### 成本

- ProviderLog #1010-#1038 合计 $3.1663。
- TextProvider 审稿与视觉质检 $2.9753，ImageProvider $0.1910；文本相关成本约为图片成本的15.6倍。

### 验证

- ImagesService 定向测试：16/16通过。
- Backend 生产构建：通过。
- User App 生产构建：通过。

### 风险/后续

- 当前最高视觉分只有87，不能作为视频角色元素的 S+ 身份母版。
- 分面板生成、逐面板状态持久化、跨面板拓扑检查和确定性合成尚未实现。
- RenderTask 成功成本当前主要反映图片调用，完整生产成本仍应以 ProviderLog 汇总为准，后续需统一审计口径。

## [WORK_SYNC_2026-07-16_V7] - 2026-07-16

### 变更

- 公共人物三视图模板升级为 `character_turnaround_original_v4_s_plus`，以原创虚构数字角色和最高原生质量替代冲突的真人肖像限制与提示词式 8K 声明。
- 三视图负面约束压缩为六组，并新增非人、多头、多臂角色结构分支。
- 旧 V3 Prompt 即使已有 98 分也不能直接复用；活动 Prompt 必须同时满足当前版本、旗舰版式、参考模式和零冲突词。
- 历史高分经验增加画幅、角色名、专属道具、物种、时代和服装适用性过滤；新 reusable rules 写库前使用同一硬门。
- Asset Planner 身份母版示例改为原创虚构角色资产，历史候选不得污染新资产描述。
- Project #22 的蜀军将领和九幽鬼将角色描述去除跨角色点名。
- 网页复制包的通用角色负面模板移除五条压低脸部清晰度的冲突限制，并过滤旧角色描述的同类回流；明确隐藏脸的 Seedance 安全首帧分支保持隔离。
- 人物三视图固定工业版式由泛化“横版”收紧为显式 16:9 横版单一连续画布。
- 主锚点、表情锚点、服装锚点、三视图及平台复制文案统一移除提示词式 8K 声明；旧角色 Prompt 提交前自动改写为最高原生质量与后续 4K 放大准备。

### 验证

- 三视图、CharactersService、ImagesService、Production Kernel、资产计划 Prompt 与旧行为保护定向测试：60/60 通过。
- Backend 生产构建：通过。
- 四个橙色角色 V4 Prompt 预检：全部 16:9、当前版本、零冲突、无人名串线。
- 未触发真实付费 AI 生成。

### 风险/后续

- Prompt 收口不等于单画布三视图已经达到 S+；历史最佳视觉分仍为 87。
- 下一阶段继续执行分面板生成、分别质检、程序化合成和 96+ 总质检。

## [WORK_SYNC_2026-07-16_V8] - 2026-07-16

### 新增

- 用户端与管理端新增共享的全局 AI 请求参数检查器，默认收起并通过右侧抽屉查看。
- 统一展示路径参数、查询参数、明文请求体、Request ID 和请求状态。
- 请求预览/预检完整展示后端响应；正式生成提取 Task、Generation Plan、Provider 路由与成本证据。
- 新增敏感字段、Base64 与二进制摘要保护，以及最近 30 条会话历史、复制和清空能力。

### 验证

- AI 请求匹配、误捕获保护、参数快照、脱敏和预览证据测试：36/36 通过。
- User App 与 Admin 生产构建：通过，Nginx 已提供新构建资源。
- Backend 健康检查：`ok`。
- 未触发付费 AI 调用。

### 风险/后续

- 旧同步接口若不返回 Task、Generation Plan 或请求预览，只能保证展示页面提交事实；最终 Provider 载荷需后端统一 Trace 才能完整覆盖。

## [WORK_SYNC_2026-07-16_V9] - 2026-07-16

### 新增

- 实现人物身份特写、严格正面、严格90度右向侧面、严格180度背面独立生成与独立质检。
- 新增 FFmpeg 确定性 4K 四面板母版合成，避免最后一步重新绘制导致换脸。
- 新增断点续跑和 `regenerate_image_types` 指定面板返修；用户端提供“只重生此面板”。
- 新增诸葛亮真实小样 #984-#988 与实施验收报告。

### 变更

- 公共拆分面板模板升级为 `character_turnaround_split_panel_v1_1`，强化时代鞋履、年龄、手部、侧面几何和背面服装拓扑。
- 面板视觉质检输出上限由 2600 提高到 5000 tokens。
- 执行回执成本拆分为图片、视觉质检、本地合成和总成本，并补充质检 ProviderLog ID。
- 视觉质检以落盘尺寸元数据为权威，禁止将 3840x2160 留白资产误判为非 16:9。

### 修复

- 修复“严格90度右向侧面”被本地 Prompt 契约错误拦截。
- 修复质检 Provider 失败覆盖上一轮有效图片分数与状态的问题。
- 修复正面质检 JSON 因 token 上限过低被截断的问题输入配置。

### 真实验收

- 身份 #984 为91分，侧面 #986 为88分，背面 #987 为89分，母版 #988 为 A+ 88分。
- 严格侧面和严格背面成立；母版因现代白色橡胶鞋底命中一票否决，未晋升 S+ 或主锚点。
- 4张4K图片成本 $1.7386，5次成功视觉质检 $0.4652，本地合成 $0，总计 $2.2038。
- 补跑旧图质检遇到 OpenAI 429，两次失败调用成本为0，未继续发起付费生成。

### 验证

- 相关后端测试：29/29通过。
- Backend 与 User App 生产构建：通过。

### 风险/后续

- 当前账户配额阻断进一步付费质检与返修。
- 配额恢复后只返修未通过全身面板；四个面板和母版均达到96+且无一票否决，才可晋升视频身份母版。

## 追加模板

```markdown
## [WORK_SYNC_YYYY-MM-DD_Vn] - YYYY-MM-DD

### 新增
- ...

### 变更
- ...

### 修复
- ...

### 数据库
- 迁移：...

### 验证
- 构建：...
- 测试：...
- 冒烟：...

### 风险/回滚
- ...
```