V1.0 开发日志

概述

V1.0 标志着 ALICE 不再以“多个过渡性原型拼接在一起”的方式前进，而是开始作为一个正式基线版本来管理。这个阶段的目标不是“不计代价继续堆功能”，而是把运行体系、回放体系、世界版本、实验管理和文档体系全部收口到统一的正式主线。

核心原则很简单：历史归历史，当前系统必须有清晰的事实来源。

开发周期：自 2026 年 4 月 9 日起

阶段一：正式版本重置

V0.1 和 V0.2 为项目积累了大量有价值的原型成果，但活跃代码里仍然混杂着：

• 历史世界版本和当前默认版本
• 过渡性的回放兼容层和正式回放契约
• 零散的运行笔记与真正的 source of truth 文档

V1.0 的第一件事，就是把这些模糊状态收拢。新的正式基线统一为：

• world_id = uva_village/v1.0
• system_version = v1.0
• cognition_version = v1.0
• replay_runtime_version = v1.0
• replay_bundle_version = v1.0
• release_profile_id = uva_village_v1_0

这也是 ALICE 第一个以“正式版本线”而不是“滚动原型”来维护的版本。

阶段二：把回放视为产品表面

ALICE 的模拟本身是 headless 的，所以回放并不只是调试工具，它实际上就是观察这个世界的主要窗口。

因此，V1.0 把回放定义成正式契约：

• 实验一旦生成就不可变
• 回放 runtime 必须显式版本化
• 实验包必须自包含
• 地图、labels、sprite 都冻结在实验包中
• 启动器读取 manifest，而不是靠猜测兼容关系

这样回放系统才真正从“临时查看器”变成“过去世界的可靠观察窗口”。

阶段三：正式世界与地图基线

旧的 uva_village/v1 仍然保留在项目历史中，但正式开发主线迁移到 uva_village/v1.0。

这样做有两个作用：

1. 保留原型乌瓦村作为历史草稿。
2. 为下一步正式地图制作建立稳定锚点，尤其是后续和 RPG Maker MZ 制图流程的衔接。

在这一阶段，地图的重点仍然不是“豪华”，而是“结构正确、适合认知系统开发”：道路可达、sector 逻辑清晰、出生点明确、功能物体完整。

阶段四：把文档当作基础设施

原型阶段一个重要教训是：混杂的文档会制造混杂的假设。V1.0 开始引入更清晰的文档分层：

• History：历史开发日志与阶段记录
• Current：当前正式规范文档
• Operations：运行手册、工具链与维护流程

同时增加一份机器可读的 docs registry，让人和 agent 都能通过同一套入口找到正确文档，而不是继续靠文件名和旧习惯猜路径。

接下来

V1.0 下一步的工作重点是让这个正式基线真正可用：

• 完成 uva_village/v1.0 的正式地图生产链路
• 在视觉打磨之前，优先推进认知系统
• 让新的正式实验从重置后的编号体系开始生成
• 持续把关键变化同步到内部 V1.0 规范文档和这份开发日志中