7.6 KiB
Beat6 有据环境修订前端交接
Git交付补充:用户已授权本轮全部前端改动集中提交并推送dev,本环境增量随 feat(short-drama-agent-front): 接入联合修订与图片费用审计 交付。下文未Commit/Push为功能验收时点,实际SHA和远端同步以本次仓库记录为准。
2026-11-16,前端根目录 dev,保留前几轮未提交改动,只增量修改前端,不新建 worktree。后端只读基线为已提交的 cde30f09464c152447bb0adcee8c670b6ba917a4,依据 docs/audits/v02-beat6-environment-review-frontend-prompt.md、公开 storyboard 契约及真实 Schema/路由/项目事务核对。
已有实现与新增范围
原摄影/开拍状态联合流程已经具备完整草案读取/保存、字段差异、本镜/邻镜版本、免费预检、冻结请求采用、幂等、409保护及固定底栏。此次只补环境四字段和本集原文依据,不创建新编辑器、API服务、任务/SSE、费用或质量流程。此前环境差异被白名单阻止属于旧基线,本轮扩展后不再作为越界;身份、Form、主体集合与正式动作仍不开放。
正式来源与接口
- 环境可变字段为 timeOfDay、weather、atmosphere、transientState,changes[] 使用 target=environment,before/after 均完整保留;天气未知保持空,不补晴天。
- 沿原 GET/PUT keyframe-review-draft 保存完整原稿及 expectedRevision、expectedCurrentFormalSourceFingerprint。保存不采用,不额外往草案中塞入无契约字段,原 current/stale 与 staleReason 保留。
- 沿原 POST keyframe/preview 免费取得草案、本镜派生和完整邻镜版本;草案指纹不提交生图。
- 存在环境差异时,原 confirm 的 jointRevision 另带 environmentSource:episodeId、expectedContentFingerprint、quote。预检与正式采用冻结同一原稿/差异/原文/版本,仅切换 preview;依旧必须分别执行和人工确认。
- 已核对现有 GET
/api/projects/:projectId的正式 ProjectEpisodeDto 及实际响应,确实公开本集 id/projectId/episode/content。按当前项目和集号取唯一正式集,校验 ID、归属、完整字符串正文,再用 TextEncoder + Web Crypto SHA-256 计算完整 content 的原字节版本;不使用 summary、截断正文、换行归一化或人工输入的哈希。 - Keyframe Spec 同时核对 projectId、shotId、episodeNo;最终 Storyboard 外键与源集、正文版本和引用存在性继续由原采用事务核验,前端不把项目集号匹配冒充外键已通过。
- 没有环境变化时不额外查询本集正文、不附 environmentSource,原请求形状保持。
- 新错误前缀 JOINT_REVISION_ENVIRONMENT_SOURCE_STALE 使用中文提示。409读取当前正式 D/VS/草案和本集原文,保留草案、原文片段及审核输入,清除旧预检/确认,不自动重复提交或绑定新版本采用。
UI
在原“摄影草案与审核 → 联合修订摄影与开拍状态”内,以 NCollapse 默认收起四项环境字段。环境变化后才出现“本集原文依据”;完整正文及技术版本按需展开,引用字段不预填。缺证、片段不匹配或读取失败时禁用联合预检与采用,仍允许单独保存草案。
提示明确“原文及版本匹配不等于机器语义审核通过”。原确认勾选复用,不再增加另一套确认或费用授权;任何字段、片段或源读取变化撤销旧确认。长内容只滚动正文,固定关闭/保存/采用底栏,沿用现有主题与表单间距。既有分镜浏览精简、无默认多选/弹窗、目录避让和工具栏布局未改。
本轮文件职责
| 文件 | 变更 |
|---|---|
| src/features/storyboard/derived-review.types.ts | 扩展 environment 差异联合类型和有据采用的 environmentSource |
| src/features/storyboard/joint-review.ts | 四环境字段加入完整差异声明,保留其它越界显示/阻断 |
| src/features/storyboard/components/JointDraftFields.vue | 原编辑区内的可选四环境字段,不填默认天气 |
| src/features/storyboard/components/JointDraftReviewPanel.vue | 按需读取源集全文/身份/原字节SHA、逐字片段、预检冻结、冲突刷新和原状态原因 |
| src/features/projects/types.ts | 补充公开 Episode.projectId 可选类型及正式集ID说明,不改变其它项目流程 |
| src/lib/user-facing-text.ts | 环境源版本冲突中文提示,保留原错误码判断 |
| tests/features/storyboard/joint-review.test.ts | 环境字段、精确正文SHA、缺证、源缺失/409、重复点击和旧模式回归 |
| tests/browser/review-billing.ts | 原全请求隔离页增加 environment 场景,模拟原文变更及严格环境证据核对 |
| docs/api-contract-sync.md | 最新环境来源契约索引,说明旧环境边界已扩展 |
| docs/audits/beat6-environment-frontend-2026-11-16.md | 本交接 |
本轮没有删除文件、没有修改依赖/锁文件、没有修改后端。前几轮文件仍保留为未提交状态,本表只统计本次环境增量职责。
验证
真实只读 GET 项目详情为200:项目 cmw02vpwi000005axrdtus3pa,第1集正式ID cmw02yfyb000505axhlvcp135,所属项目一致,完整content为656字符,UTF-8 SHA256为 08b58106a9c29cd1dbc5cf42f5cb95c0f0bfd6b4c15f01f5de2f1d4c10bd8f7f。这只证明读取能力,没有重新采用后端已确认的Beat6草案。
自动化:环境联合专项9项通过,原字节SHA用 Node createHash 独立核对 CRLF/换行和中文输入;缺证/他集片段不允许预检、缺正式全文不猜哈希、旧模式不带environmentSource、409保留输入重读、重复点击只发送一次正式采用均覆盖。
最终验证:相关5套38项Vitest通过;Vue TypeScript、8个实现/验收文件的Oxlint/Oxfmt、两处Vue组件的ESLint及生产构建通过,git diff --check通过。沿用前几轮其它已通过证据,没有重新执行无关全仓检查。后端工作区仍干净。
Chrome复用本地已有标签页,通过 localhost:4312/tests/browser/review-billing.html?environment=1 验收,全fetch拦截,未声明路由403且无正式服务回退:
- 打开原联合模式显示8项完整差异,四环境字段 before/after 全部保留,天气为空。
- 保存第7→8版后明确仍未采用;错误片段即使已免费预览,仍无法联合预检。
- 手填本集原样片段/审核人/理由后免费预检,正式采用仍需人工确认。
- 模拟预检后源正文变化:正式采用409,草案和片段保留,旧确认与预检失效;源全文刷新显示新增原文,没有自动第二次采用。
- 用户明确重读、重新预览/预检及确认后,Mock采用成功,正式D/VS/Preview刷新,完整差异归0,原草案stale和历史保留。
- 390×844检查完整原文、原文字段、长内容独立滚动、固定底栏、关闭与按钮禁用状态;验收后恢复桌面和原正式只读页面。全程模拟图片0、真实模型0。
截图在 /Users/goujun/.codex/visualizations/2026/11/15/01a1df1f-2851-7ff2-b840-d1a0f3154f74/environment-review/ 的 mobile.jpg、adopted-desktop.jpg。未使用Playwright。
交付边界
环境接入没有解除原项目图片 billingBlocked,也不改变 unknown、预留、授权余额、质量结果或Primary。未执行真实文字/图片/Vision/Repair/视频,未在正式项目保存草案或采用。没有未接入的必要公开接口,Storyboard外键和最终版本保护仍由服务端权威事务决定。
前端保持dev,未Commit、未Push;后端只读且工作区未改动。本轮功能验收不构成后续正式采用或付费生产授权。