# game2

**Repository Path**: star_mark/game2

## Basic Information

- **Project Name**: game2
- **Description**: 包含程序化生成的战棋游戏
- **Primary Language**: Rust
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-09-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# `docs/` 索引

> **谁读这页**：想知道"这个仓库的文档里有什么、我该读哪份"时。
> ⚠️ **架构收口前，开工顺序是** [`handoff.md`](handoff.md) §二 → [`architecture-baseline.md`](architecture-baseline.md)（唯一现状真源）→ 再按需读下面的领域页。
> **现状**：根目录 **20 份**（含本页）+ [`archive/`](archive/README.md) **20 份**（冻结）。
> ⛔ 加新文档时**在下面补一行**（一行：解决什么问题 + 什么时候读）；**跨项目通用的约定写用户全局 `~/.dsh/AGENTS.md`，项目级写仓库根 `AGENTS.md`，包级写 `<包>/AGENTS.md`**，不要在这里新建页。
> 已归档的旧页在 [`archive/`](archive/README.md)（**冻结，不再维护**；要看"当时为什么这么设计"才去，且先读那份对照表）。

## 常读页（开工只读这些）

| 页 | 解决什么 |
| --- | --- |
| [`architecture-baseline.md`](architecture-baseline.md) | **架构现状快照（地基审计）**：还剩什么没做完（L1–L8）· 修复路线与依赖顺序（C1–C7）· **明确不做**。⛔ **架构收口前不做新功能**时，开工先读这一页 |
| [`handoff.md`](handoff.md) | **当前在哪 · 下一步 · 已知缺口**（开局先读这一页的标题 + §二/§三） |
| [`code-map.md`](code-map.md) | **文件级地图**（找"某个东西在哪个文件"、谁是再导出） |
| [`verification.md`](verification.md) | 冒烟 / 探针 / 截图 / 按键调试的**配方与判定口径**（§0 速查表：命令 + 判定） |
| [`dev-environment.md`](dev-environment.md) | 环境实测与坑：下载与代理、链接器、sccache、BRP、lsp、**实测耗时**、性能基线 |

## 领域页（改那块之前读对应页）

| 页 | 领域 |
| --- | --- |
| [`battle-architecture-contract.md`](battle-architecture-contract.md) · [`battle-implementation-log.md`](battle-implementation-log.md) | **战斗层契约（活跃口径）**：分层 / 18 步管线 / 决策记录 / 取数口径表 §5（**被测试直接读**）/ 硬约束 —— 逐片落地账在**实施记录 A1–A18** |
| [`architecture-review.md`](architecture-review.md) | 战斗系统架构检查：as-built 分层 / GAS 与行业对照 / **架构债 F1–F17** |
| [`migration-crate-split.md`](migration-crate-split.md) | 拆包边界与**该测放哪个包** / 物理层（avian2d）/ 怎么退回去 |
| [`hot-reload.md`](hot-reload.md) | 规则层热重载（回路、ABI 纪律、为什么 `rules` 只出 `rlib`） |
| [`ai-paradigms.md`](ai-paradigms.md) · [`ai-numeric-design.md`](ai-numeric-design.md) | AI 选型（效用/GOAP/行为树）+ 数值面切片与调参 |
| [`actor-intent-seam.md`](actor-intent-seam.md) | 意图缝：driver ↔ 执行层（`Intent` 只装连续量、一次性动作走消息） |
| [`debugging-toolbox.md`](debugging-toolbox.md) | **调试能力盘点**：该走哪条路（BRP / 调度图 / trace / stepping / 叠层） |
| [`persistence-checklist.md`](persistence-checklist.md) | **改存档 / 清场 / 换角色 / 往局内加资源或组件前必读**：persist + reset 两条义务 |
| [`audio-mapping.md`](audio-mapping.md) | 音频需求 → 文件映射 + 接线清单（哪条已接 / 哪条为什么没接） |
| [`font-pipeline.md`](font-pipeline.md) · [`ui-copy-cn.md`](ui-copy-cn.md) | 位图字体管线（字形集是**闭集**、烤图参数与三条坑）+ **中文文案唯一真相点** |
| [`content-index.md`](content-index.md) | **内容有什么 / 缺什么**（单位 · 技能 · 状态 + 悬空与断链）——**单向生成，别手改** |

## 写到哪儿 —— 一张表（**本页是这张表的唯一真源**；根 `AGENTS.md` 只留指针）

里程碑/下一步/缺口 → `handoff.md` · 环境实测 → `dev-environment.md` ·
冒烟与判定配方 → `verification.md` · 文件级地图 → `code-map.md` ·
战斗层活跃口径 → `battle-architecture-contract.md`（实施账 → `battle-implementation-log.md`）·
其余领域契约 → 对应的领域页 · **跨项目通用约定 → 用户全局 `~/.dsh/AGENTS.md`**；项目级 / 包级约定 → 对应的 `AGENTS.md`
（别在这里新建页；新建页要在上面补一行）。
设计稿 / 派工模板 / 一次性调研 → 写进 `archive/`（**不进上面两张表**：它们不再是活文档）。