Genarrative/docs/audits/VN12_FULL_CHAIN_ACCEPTANCE_REPORT_2026-05-07.md

VN-12 全链路联调与自动化验收报告

生成日期：2026-05-07

结论

• 状态：通过
• 失败项：0
• 收口说明：VN-12 本次只补验收门禁、关键路径测试和报告记录，未扩展新玩法功能。

自动化验收清单

• docs/prd/AI_NATIVE_VISUAL_NOVEL_TEMPLATE_PRD_2026-05-05.md
• docs/audits/VN11_NEGATIVE_SCAN_REPORT_2026-05-07.md
• src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx
• src/components/visual-novel-result/VisualNovelResultView.test.tsx
• src/components/visual-novel-runtime/VisualNovelRuntimeShell.test.tsx
• src/services/visual-novel-runtime/visualNovelRuntimeClient.test.ts
• src/services/visual-novel-runtime/visualNovelRuntimeSse.test.ts
• server-rs/crates/api-server/src/visual_novel.rs
• server-rs/crates/module-visual-novel/src/application.rs
• server-rs/crates/shared-contracts/src/visual_novel.rs
• package.json
• server-rs/crates/api-server/src/app.rs
• src/services/visual-novel-runtime/visualNovelRuntimeClient.ts
• src/services/visual-novel-runtime/visualNovelRuntimeClient.test.ts
• src/services/visual-novel-runtime/visualNovelRuntimeSse.test.ts
• src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx
• src/components/visual-novel-result/VisualNovelResultView.test.tsx
• src/components/visual-novel-runtime/VisualNovelRuntimeShell.test.tsx

API smoke

• /api/creation/visual-novel/sessions
• /api/creation/visual-novel/works
• /api/runtime/visual-novel/gallery
• /api/runtime/visual-novel/works/{profile_id}/runs
• /api/runtime/visual-novel/runs/{run_id}/actions/stream
• /api/runtime/visual-novel/runs/{run_id}/history
• /api/runtime/visual-novel/runs/{run_id}/regenerate
• /api/profile/save-archives
• /api/profile/save-archives/{world_key}
• /api/runtime/save/snapshot

本次实测：

• npm run api-server 可启动 Rust api-server。
• GET http://127.0.0.1:3100/healthz 返回 200，响应为 {"ok":true,"service":"genarrative-api-server"}。
• GET /api/runtime/visual-novel/gallery 在当前本地环境返回超时 / 502，日志显示 api-server 连接 127.0.0.1:3101 SpacetimeDB 数据库 xushi-p4wfr 被拒绝；该项按本地 SpacetimeDB 未完整就绪记录为环境阻塞，不新增工程实现。

前端关键路径

• 创作工作台：VisualNovelAgentWorkspace
• 结果页：VisualNovelResultView
• 运行时：VisualNovelRuntimeShell
• 运行时 SSE：visualNovelRuntimeSse / visualNovelRuntimeClient

桌面 / 移动端检查

• 桌面端：已用 Edge headless 截取 /creation/visual-novel/agent，文件为 docs/audits/VN12_VISUAL_NOVEL_DESKTOP_2026-05-07.png。
• 移动端：已用 Edge headless 截取 /creation/visual-novel/agent，文件为 docs/audits/VN12_VISUAL_NOVEL_MOBILE_2026-05-07.png。
• in-app browser 插件本次未发现可用 IAB backend，截图使用本机 Edge headless 兜底完成。

校验摘要

• package.json scripts: 通过
• api-server visual novel routes: 通过
• visual novel runtime client routes: 通过
• visual novel runtime client tests: 通过
• visual novel SSE tests: 通过
• visual novel creation tests: 通过
• visual novel result tests: 通过
• visual novel runtime tests: 通过

执行命令

npm run check:visual-novel-vn12 -- --write-report
npm run test -- src/components/visual-novel-creation/VisualNovelAgentWorkspace.test.tsx src/components/visual-novel-result/VisualNovelResultView.test.tsx src/components/visual-novel-runtime/VisualNovelRuntimeShell.test.tsx src/services/visual-novel-runtime/visualNovelRuntimeClient.test.ts src/services/visual-novel-runtime/visualNovelRuntimeSse.test.ts
npm run check:encoding
npm run typecheck
cd server-rs
cargo test -p shared-contracts
cargo test -p module-visual-novel
cargo check -p api-server

未覆盖风险

• 当前本地 SpacetimeDB 连接未完整就绪，公开 gallery API 的真实数据返回未在本次环境完成；/healthz 与编译 / 单测已通过。
• 若接口路由或测试名称后续调整，需要同步更新本门禁脚本与报告模板。