chore: bootstrap nana-story M0

2026-07-28 12:51:00 +08:00
commit 3dacc92423
71 changed files with 6840 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 听娜娜讲故事
+
+`nana-story` 是一个本地优先、纯 BYOK 的 AI 对话游戏。V1 聚焦一段可回溯、可分支、状态可重放的单角色纵切。
+
+## 当前阶段
+
+M0：工程骨架与领域契约冻结。
+
+已建立：
+
+- Tauri 2 + Vue 3 + TypeScript 工程；
+- Rust workspace 与模块所有权边界；
+- Rust 领域类型作为契约唯一事实来源；
+- 生成的 JSON Schema 与 TypeScript DTO；
+- canonical `PlayerView` fixture；
+- 最小娜娜内容包；
+- 静态主演出屏与窄 Tauri 命令。
+
+## 开发
+
+要求：
+
+- Node.js 24+
+- pnpm 10.29.2
+- Rust 1.96
+- 与本仓库同级的 `lapp-rs`，固定到 `lapp-rs.lock` 中的提交
+
+```text
+workspace/
+├─ lapp-rs/
+└─ nana-story/
+```
+
+```bash
+pnpm install
+pnpm verify
+pnpm tauri dev
+```
+
+只验证前端和已提交契约时可运行：
+
+```bash
+pnpm verify:web
+```
+
+## 边界
+
+- 模型供应商协议与凭据处理属于 `lapp-rs`。
+- 前端只接收 `PlayerView`，不会得到完整 `RuntimeState`。
+- V1 不使用向量记忆库、导演 Agent 或多个完整角色。
+- 模型与前端都不能直接修改运行时状态。