108 lines
3.7 KiB
Markdown
108 lines
3.7 KiB
Markdown
# M1/M2 第一并行波次状态
|
||
|
||
日期：2026-07-28
|
||
集成分支：`integration/v1`
|
||
契约基线：`3dacc92`
|
||
|
||
## 本波次目标
|
||
|
||
在不修改公共领域契约的前提下，同时推进：
|
||
|
||
- Core：确定性状态 reducer；
|
||
- Runtime：Turn 边界与确定性世界书选择；
|
||
- Experience：基于同一 `PlayerView` 的可交互假数据体验；
|
||
- Integrator：分支追加、恢复与回溯语义的存储接口。
|
||
|
||
游戏运行时仍为单模型。本波次使用 `FakeProvider` 和浏览器本地 adapter，
|
||
不引入导演 Agent 或其他运行时子智能体。
|
||
|
||
## 已集成
|
||
|
||
### State Engine
|
||
|
||
- `apply_delta` 是状态变化的唯一纯函数入口。
|
||
- 整个 delta 先作用于克隆状态，任一操作失败则不提交部分结果。
|
||
- 支持全部当前 `StateOp`。
|
||
- 六维关系使用有向键 `from->to`，数值范围为 `0..100`。
|
||
- 单个关系操作限制为 `±8`。
|
||
- 许诺 ID 唯一并执行生命周期约束。
|
||
- 知识、物品和判定记录 ID 唯一。
|
||
- 物品转移验证当前 holder，保留 owner。
|
||
- 判定按 `action_id` 复用：完全相同的记录幂等，冲突记录拒绝。
|
||
- 时钟推进不会超过上限。
|
||
|
||
### Store Seam
|
||
|
||
- `InMemoryStoryStore` 提供无数据库的确定性集成测试实现。
|
||
- 节点与物化状态的 story、branch 和 current node 必须一致。
|
||
- 同一分支只允许追加到当前 head。
|
||
- 新分支可以从同一故事的旧节点创建。
|
||
- 创建新分支不会移动原分支 head。
|
||
- 所有校验先于写入，失败不会留下部分节点或状态。
|
||
|
||
这不是 SQLite 的替代品。后续 SQLite 实现必须保持同一追加与分支语义。
|
||
|
||
### Runtime Seam
|
||
|
||
- `TurnRequest` 在调用 provider 前验证。
|
||
- `speak_or_act` 拒绝空白输入；`continue` 允许空输入。
|
||
- provider 返回后校验 story、branch、committed node 与 `PlayerView` 一致。
|
||
- provider 错误映射为稳定、脱敏的 `TurnFailure`。
|
||
- `FakeProvider` 按 FIFO 返回录制结果。
|
||
- 世界书通过 required flags、tags 和 keywords 确定性选择。
|
||
- 选择结果保持输入顺序、按 ID 去重并限制最多 8 条。
|
||
|
||
### Experience
|
||
|
||
- 自由输入和“继续”经过同一 `TurnRequest → TurnResult` 边界。
|
||
- 点击行动建议只填入输入框，不自动提交。
|
||
- 提交期间清空输入并显示忙碌状态。
|
||
- 最近的短演出节拍连续显示。
|
||
- 持有物/线索/许诺、模糊六维关系、故事回溯为互斥面板。
|
||
- 所有面板只读取 `PlayerView`。
|
||
- 回溯入口明确标记为尚未持久化，不伪装成已创建分支。
|
||
- Escape、ARIA 和键盘焦点具备基础支持。
|
||
|
||
## 已通过验证
|
||
|
||
```text
|
||
node scripts/verify-contracts.mjs
|
||
15 schemas and TypeScript DTO source hash verified
|
||
|
||
vue-tsc --noEmit
|
||
|
||
vitest run
|
||
3 test files passed
|
||
11 tests passed
|
||
|
||
vite build
|
||
```
|
||
|
||
Web 侧仍未发现契约漂移，生产构建成功。
|
||
|
||
## 尚未通过
|
||
|
||
当前 Work 环境仍没有 `cargo`、`rustc` 和 `rustfmt`。因此本波次新增的
|
||
Rust reducer、runtime 和 store 测试尚未实际编译或执行，M0 的 Rust/Tauri
|
||
门也仍然未关闭。
|
||
|
||
必须在 Rust 1.96 环境执行：
|
||
|
||
```text
|
||
cargo fmt --all -- --check
|
||
cargo clippy --workspace --all-targets -- -D warnings
|
||
cargo test --workspace
|
||
cargo run -p nana-contracts -- --check
|
||
pnpm tauri dev
|
||
```
|
||
|
||
在这些命令通过前，不把 M0 或 M1 标记为完成。
|
||
|
||
## 下一波次
|
||
|
||
1. 在 Rust 1.96 环境修正首次编译、格式和 Clippy 问题。
|
||
2. 为 `RuntimeState` 增加脱敏 `PlayerView` 投影实现和泄密测试。
|
||
3. 在同一 `StoryStore` 语义下实现 SQLite 事务、节点与检查点。
|
||
4. 将浏览器本地 Turn adapter 替换为 Tauri `submit_turn` 命令。
|
||
5. 用“天亮前一定回来”fixture 串起许诺、希望变化、保存、恢复和回溯分叉。
|