ai/docs/work-sync

AI 内容生产平台 Work 同步包

当前批次：WORK_SYNC_2026-07-19_V11
适用对象：用于 Work 的项目知识库同步
代码仓库：/www/wwwroot/ai

1. 这个目录解决什么问题

本目录把“当前代码事实”和“产品设计意图”分开维护，避免 Work 继续依据旧系统 A/B 文档推演已经变化的系统。

• Work 负责产品定位、业务规则、架构决策、功能方案和路线。
• Git + Codex 负责当前代码、数据库迁移、测试、部署和运行事实。
• 本目录是两者之间的可上传同步包，不是完整源码备份。

2. 首次上传顺序

1. 00_文档索引.md
2. 01_项目现状/PROJECT_STATUS_V1.md
3. S_PLUS_BATCH_AUTOMATED_PRODUCTION_PIPELINE_V2.md
4. S_PLUS_PRODUCTION_FLOW_AUDIT_V1.md
5. 02_架构设计/SYSTEM_ARCHITECTURE_V1.md
6. 05_AI流水线/AI_PIPELINE_V1.md
7. 06_数据库/DATABASE_CURRENT_V1.md
8. 03_小说引擎/NOVEL_ENGINE_V1.md
9. 04_短剧引擎/DRAMA_ENGINE_V1.md
10. 04_短剧引擎/AI_VIDEO_TEST_LESSONS_V1.md
11. S_PLUS_SHORT_DRAMA_CODEX_OPTIMIZATION_V1_1.md
12. PROMPT_RULE_AUDIT_V1.md
13. SPLUS_PHASE_0_1_IMPLEMENTATION_REPORT.md
14. SPLUS_PHASE_2_IMPLEMENTATION_REPORT.md
15. KLING_S_PLUS_MODEL_ROUTING_SPEC_V1.0.md
16. SPLUS_GENERATION_PLAN_IMPLEMENTATION_REPORT_V1.md
17. SPLUS_MODEL_REGISTRY_AND_PLAN_DIFF_IMPLEMENTATION_REPORT_V1.md
18. KLING_V3_OMNI_API_UPDATE_V1.md
19. LANDSCAPE_CHARACTER_ELEMENT_IMPLEMENTATION_REPORT_V1.md
20. SPLUS_CHARACTER_TURNAROUND_ITERATION_REPORT_V1.md
21. SPLUS_CHARACTER_TURNAROUND_PROMPT_V4_AUDIT.md
22. AI_REQUEST_INSPECTOR_IMPLEMENTATION_REPORT_V1.md
23. SPLUS_CHARACTER_TURNAROUND_SPLIT_PANEL_IMPLEMENTATION_REPORT_V1.md
24. SPLUS_EXECUTION_BRIDGE_EXTERNAL_ASSET_WORKFLOW_V1.md
25. 07_版本记录/CHANGELOG.md
26. 08_维护规范/WORK_SYNC_PROTOCOL.md
27. SYNC_MANIFEST.md

若 Work 只支持少量资料，优先上传 1-10；实施报告和维护模板可以第二批上传。

3. 不要默认上传的内容

• backend/、workers/、user-app/、admin/ 完整源码。
• .env、API Key、JWT、数据库密码和 Worker Secret。
• storage/、tmp/、用户上传素材和 Provider 临时 URL。
• 数据库导出中的用户明细、支付信息和私有内容。
• docs/system_a/、docs/system_b/ 全量历史设计。
• 未审阅的对话记录、临时 Prompt 和生成日志。

历史文档需要讨论某项旧决策时，再按 99_历史设计/README.md 单独选取，并明确标记“历史参考，不代表当前实现”。

4. 文档类型

类型	是否可改	用途
状态快照	不改，新增 V2/V3	某个时间点的代码、数据和运行事实
当前设计	可修订并升版本	当前有效的稳定边界和业务规则
变更记录	只追加	记录从上一同步批次发生的变化
经验总结	可修订并升版本	经多次生产验证的可复用结论
历史设计	不作为当前事实	解释旧决策和演进背景

5. 日常维护

小改动只需更新受影响领域文档和 CHANGELOG.md。以下变化必须生成新的项目状态快照：

• 顶层模块、数据库模型或部署拓扑变化。
• 生产 Provider、队列或存储策略变化。
• 新增完整业务流程或修改关键状态机。
• 发布基线、测试结果或重大风险变化。
• Work 与代码对同一事实出现分歧。

详细流程见 08_维护规范/WORK_SYNC_PROTOCOL.md。

6. 冲突处理

当文档互相冲突时，按以下优先级判断事实：

当前源码/迁移/运行验证
> 最新 PROJECT_STATUS
> 最新当前设计文档
> CHANGELOG
> 历史设计文档

产品未来目标不按上述顺序覆盖，应由 Work 形成独立 FEATURE_*.md 或 ADR，再交给 Codex 实现。

7. 当前限制

PROJECT_STATUS_V1 是项目状态基线；各实施报告记录其对应阶段的代码事实。S_PLUS_BATCH_AUTOMATED_PRODUCTION_PIPELINE_V2.md 是新项目的目标流程，不代表其 P0-P5 已经全部上线。当前测试、Git 基线、队列覆盖、备份和真实内容验收风险，均以状态快照、现状审计、实施报告和 CHANGELOG 为准。