www
97 lines
4.2 KiB
Markdown
97 lines
4.2 KiB
Markdown
# 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 为准。
|