ai/docs/work-sync/99_历史设计/README.md

历史设计使用说明

docs/system_a/、docs/system_b/、根目录旧架构文档和早期进度记录保留了项目演进过程，但不能直接代表当前实现。

1. 默认不上传全量历史文档

原因：

• 旧文档假定用户端是 uni-app，当前实际为 Vue 3 H5。
• 旧文档假定管理端采用 GeekerAdmin，当前实际是自研单页后台。
• 旧数据库、Provider、队列和视频能力与当前代码差异明显。
• 同一能力可能在系统 A/B 中重复定义，容易让 Work 得出相互冲突的结论。

2. 可按需查阅的历史资料

历史资料	适合回答	使用条件
docs/system_a/	小说、漫剧和早期平台业务设想	必须与当前状态文档对照
docs/system_b/	真人动态视频的早期需求与合并思路	不得推断已全部实现
CURRENT_ARCHITECTURE.md	某阶段架构演进	先核对日期和源码
NOVEL_IP_SYSTEM_DESIGN.md	小说/IP 资产设计来源	只采纳未过时的规则
CODEX_PROGRESS.md	开发过程和阶段记录	不作为验收结果
AI_VIDEO_TEST_LESSONS.md	视频生产经验	已复制版本化快照到同步包

3. 上传历史文档的格式

如 Work 需要某份旧文档，应在文件顶部增加外部说明或上传备注：

状态：历史参考
不代表当前实现
当前基线：WORK_SYNC_2026-07-15_V1
需要对照：PROJECT_STATUS_V1.md
讨论目的：<为什么需要这份旧文档>

不要直接修改原历史文件来伪装成当前设计；有价值的结论应提炼到新的 FEATURE、ADR 或当前领域文档。

4. 何时归档当前文档

当前领域文档升级版本后，旧版移入此区的对应子目录，并在新文档和 CHANGELOG 中说明替代关系。状态快照不移除，持续保留 V1、V2、V3。