# 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. 冲突处理

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

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

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

## 7. 当前限制

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