ai/docs/work-sync/SPLUS_PHASE_2_IMPLEMENTATION_REPORT.md

S+ 内核 Phase 2 实施报告

日期：2026-07-15
范围：原著分析、改编圣经、分集计划的结构化写路径
工程状态：已部署，真实新项目内容验收待执行
付费 AI 调用：无
数据迁移：20260715143000_splus_production_contracts_v1

1. 本轮结论

Phase 2 的工程链路已经形成，但尚未宣称通过内容生产验收。

当前系统已经可以安全执行：

连续原文快照
-> 原著分析合同
-> 改编圣经合同
-> 分集计划合同
-> 三集连续性检查
-> 人工只放行其中一集

新链路不会覆盖旧 StoryBible、Episode 或历史 Prompt。所有结构化结果均版本化保存，审核失败也保留为可诊断草稿。

2. 数据与状态

项目标记

Project 新增：

• engine_version：数据库默认 legacy_v1；应用创建的普通新项目写入 splus_v1。
• production_lifecycle：记录来源准备、合同写入、确认、三集检查和单集放行状态。

直接提示词实验项目继续标记为 tool_direct_v1，不伪装成 S+ 正式生产项目。

迁移后数据库中原有 20 个项目全部为 legacy_v1，没有自动迁移、改写或删除历史项目。

新增持久化对象

• ProductionSourceSnapshot：保存不可变原文、章节清单、内容哈希和版本。
• ProductionContract：保存合同类型、schema 版本、父版本、输入哈希、来源引用、正文、质量结果和下游状态。
• ProductionContractReview：保存 Reviewer 版本、轮次、问题清单、修复差异和评分。

当前迁移刚完成，三张新表均为 0 条记录；真实内容只会在用户明确创建新 S+ 项目后写入。

3. 唯一写路径

原著分析

1. 从项目小说源选择最多 20 个章节。
2. 章节号必须连续，单次正文最多 180,000 字。
3. 固化不可变来源快照和逐章哈希。
4. SourceAnalysisSpecV1 必须引用本次快照中的来源。
5. 不允许在原著分析阶段提前写改编结论。

改编圣经

1. 必须绑定一个已确认的原著分析版本。
2. 改编决策必须记录操作、来源、原因、影响、连续性风险和批准状态。
3. 未批准的改编决策不能被分集计划使用。
4. 修改时创建新版本，不覆盖已确认版本。

分集计划

1. 必须绑定一个已确认的改编圣经版本。
2. 第 2 集以后要求上一集已确认。
3. 每集必须包含开场钩子、目标、阻力、升级、高潮选择、不可逆变化和集尾钩子。
4. 连续三集必须同属一个改编版本、集号连续，并严格继承上一集退出状态。
5. 三集通过连续性检查后仍不会自动进入剧本；必须人工选择一集执行 release。

4. Reviewer 与修复

• Writer 负责输出完整结构化合同。
• 确定性验证器负责字段、来源、批准状态和跨集状态硬门。
• Reviewer 使用版本号记录，只输出问题与 StageReviewDeltaV1，不静默重写正文。
• 失败结果保存为 draft + blocked，通过硬门的结果保存为 validated。
• 确认时重新执行审核；同一范围旧确认版本会被标记为 superseded。

5. Prompt 构建

新增三个阶段的干净模板：

• Source Analyst
• Adaptation Showrunner
• Episode Planner

公共模板与项目正文分离，运行时才注入来源快照、已确认父合同和上一集状态。请求预览可在付费调用前查看和复制；本轮没有在 UI 暴露一键付费生成入口。

6. API 与界面

新增 ProductionKernelModule 及接口，覆盖：

• 创建/查询来源快照。
• 保存、查询、评审和确认合同。
• 预览阶段 Prompt。
• 三集连续性检查。
• 放行一个分集计划进入下一阶段。
• 保留受控的阶段 Provider 调用能力，但本轮未触发。

用户端新增 SplusProductionPipeline.vue：

• 原著分析、改编圣经、分集计划三个阶段标签。
• JSON 导入、确定性校验、版本列表和问题定位。
• Prompt 预览与复制。
• 评审、确认、三集检查和单集放行。

splus_v1 项目不再显示旧 StoryBible/旧分集写入口；历史项目仍走旧页面读取。旧 StoryBiblesService 和 EpisodesService 的写方法也增加了后端守卫，不能靠直接调用 API 绕过界面。

7. 部署与验证

部署

• 数据库和私有素材备份继续使用 Phase 0 已校验备份。
• Prisma 迁移从 33 个增加到 34 个，并成功部署。
• 后端已受控重启。
• GET /api/health 返回 status: ok。

自动验证

检查	结果
Phase 2 合同/Service 定向测试	13/13 通过
后端生产构建	通过
用户端生产构建	通过
Prisma schema 校验	通过
数据库迁移	34/34 已部署
后端全量测试	254 通过，34 失败，共 288 条

34 条失败与本轮开始前的既有失败面一致，主要是旧测试 mock 未补齐、旧质量断言和当前实现漂移。本轮没有批量改断言掩盖问题。

8. 尚未完成

1. 尚未选择一部全新项目和连续故事段实际写入三阶段合同。
2. 尚未产出并确认连续三集，也未执行“只放行一集”的真实内容验收。
3. 尚未开放前端一键付费阶段生成。
4. 尚未进入 SceneScriptSpecV1 场景剧本写路径。
5. 旧角色、记忆等下游页面仍可见，后续需要按阶段状态进一步收口。
6. 全仓 34 条历史测试失败仍需作为独立基线修复。

9. 进入 Phase 3 的条件

只有完成以下验收，才进入场景剧本：

1. 新建一个 splus_v1 项目。
2. 选取一个连续故事段并生成来源快照。
3. 原著分析与改编圣经通过审核并确认。
4. 连续三集分集计划通过状态继承检查。
5. 人工只放行其中一集。
6. 保存本次 Prompt、合同版本、Reviewer 问题和人工判断作为首个 Phase 2 样本。

在此之前不接视频生成，也不以“页面可操作”代替内容质量验收。