# little-town · 项目文件夹索引

> 本文件由 Lead 于 **2026-10-12** 整理生成。
> 整理前：本目录混放着**老版本 2D 游戏「临湖小镇」**（23 个条目）和**当前项目「我要当市长」的 6 份规划文档**。
> 整理后：当前项目在外层，老版本整体移入隔离区并加了标注。

---

## 1. 现在长这样

```
/vol1/ai/projects/little-town/
├── README.md                        ← 本文件（总索引）
├── AGENTS.md                        ← 工作区约定（2026-10-12 重写，见 §5）
├── 当前项目-我要当市长/                ← 【当前项目】6 份规划文档（2026-10-06 原始版）
│   ├── 我要当市长-游戏企划书.md / .docx
│   ├── 我要当市长-0.1至1.0版本迭代计划.md
│   ├── 我要当市长-0.1-步骤1-画面与规则规格.md
│   └── 我要当市长-开发路线调研-2026-10-06.md / .docx
├── _隔离-旧版2D临湖小镇/               ← 【隔离区】已放弃的老版本，只读归档
│   ├── 00-废弃说明与标注.md            ← ⭐ 隔离区索引与标注（先看这个）
│   └── little-town-godot/             ← 旧 Godot 4.7 + Python 项目全部内容（524 文件 / 91 MB）
└── .deliver-queue/                   ← 系统目录（deliver-link 的历史投递记录），保留原位
```

**顶层现在只有 3 个实体目录 + 2 个索引文件 + 1 个系统目录。**

---

## 2. 两条一句话结论

1. **旧版 2D「临湖小镇」已被新项目取代**，不是崩溃 —— 它的 MVP 当年已跑通验证，是 2026-10-06 的技术方向调研后**主动放弃**的。详见 [_隔离-旧版2D临湖小镇/00-废弃说明与标注.md](_隔离-旧版2D临湖小镇/00-废弃说明与标注.md) §2。
2. **当前项目「我要当市长」的活文档不在本目录**，在 `/vol1/ai/projects/wyszz-new/`。本目录的 6 份是 2026-10-06 的**原始版**，演进版见 §4。

---

## 3. ⚠ 三条重要提醒

1. **`_隔离-旧版2D临湖小镇/` 里含在用的 API 凭据。**
   `little-town-godot/server/config.json` 存着 `api.key` 与 `image_api.key`，被 **3 个仍在用的出图脚本**（`gen_image.py`、`gen_grass_firework.py`、`gen_grass_firework_v2.py`）读取。
   **⇒ 不要整目录删除**；要清理请先看标注文件 §4。

2. **`/vol1/ai/projects/wyszz-new/` 是当前游戏项目，本次整理完全没有触碰**（里面有 L1–L5、H1、H2 等工作副本，可能有智能体在跑）。

3. **`.godot/` 是 39 MB 的纯构建缓存**，保留只为可回滚，随时可删。

---

## 4. 文档谱系（拿最新版请去 `wyszz-new/docs/`）

| 本目录（2026-10-06 原始版） | 演进版（以这份为准） |
| --- | --- |
| `我要当市长-游戏企划书.md` | `wyszz-new/docs/我要当市长-游戏企划书-v0.3-3D有限扩岛-2026-10-09.md` |
| `我要当市长-0.1至1.0版本迭代计划.md` | `wyszz-new/docs/我要当市长-0.1至1.0版本迭代计划-v2-3D有限扩岛-2026-10-09.md` |
| `我要当市长-开发路线调研-2026-10-06.md` | `wyszz-new/docs/`（Cocos 可行性结论、环境检查报告等） |
| `我要当市长-0.1-步骤1-画面与规则规格.md` | 已落地为 `wyszz-new/frontend-rebuild-contract-v1/`（契约包）与实现 |

另有 `wyszz-new/docs/我要当市长-计划修改报告-3D有限扩岛-2026-10-09.md` 记录了从 Cocos 转向 3D 的决策。

---

## 5. 本次整理做了什么

| 动作 | 明细 |
| --- | --- |
| 建立索引 | 本文件（总索引）+ 隔离区的 `00-废弃说明与标注.md`（含逐项标注、废弃原因、依赖关系、回滚方法） |
| 隔离老版本 | 旧 Godot+Python 项目的 **23 个顶层条目整体移入** `_隔离-旧版2D临湖小镇/little-town-godot/`，**保持内部相对路径不变** |
| 当前项目归位 | 6 份「我要当市长」文档移入 `当前项目-我要当市长/` |
| 完整性校验 | 移动前后**逐文件 SHA256 比对**：**532 文件零丢失、零篡改**（隔离区 524 + 当前项目 6 + 系统目录 2） |
| 同步改路径 | **6 个脚本**里被移动文件的路径已同步更新（清单见标注文件 §7） |
| 重写约定 | 顶层 `AGENTS.md` 从「旧 Godot 项目约定」改为「当前工作区结构说明」 |

**没有做的事**：没有删除任何文件；没有搬迁凭据；没有触碰 `wyszz-new/` 及 `/vol1/ai/projects/` 下任何兄弟目录；没有改 Godot 工程内部任何内容。

---

## 6. 相关但不属于本目录的位置

| 位置 | 是什么 | 本次是否触碰 |
| --- | --- | --- |
| `/vol1/ai/projects/wyszz-new/` | **当前项目**（我要当市长）源码、契约包、各级工作副本 | ❌ 未触碰 |
| `/vol1/ai/projects/project/littletownglm` | 旧项目**迁移前**的原版（见旧项目 `接手提示词.md` §两个文件夹） | ❌ 未触碰 |
| `/vol1/ai/projects/project/little town/` | 含 `我要当市长-3D方向规划修改报告-2026-10-08.md`（**路径带空格**，疑似散落文件） | ❌ 未触碰，仅记录 |
| `/vol1/ai/_scripts/` | 被同步改路径的 6 个脚本所在处 | ✅ 改了 6 个脚本的路径常量 |
| `/vol1/ai/vault/AI记忆库/01-项目/我要当市长.md` | 长期记忆库的项目页 | ✅ 已回写本次整理 |

---

## 7. 回滚

本次是**纯 `mv`（同盘同文件系统）**，可原样搬回。命令与移动前清单（`/tmp/lt-before-top.txt`、`/tmp/lt-before-hashes.txt`）见标注文件 §8。

---

*索引由 Lead 于 2026-10-12 生成；所有数字均为实测。*
