# 隔离区说明与标注 · 旧版 2D「临湖小镇」

> 本文件由 Lead 于 **2026-10-12** 生成，用于标注本隔离区的来历、内容、废弃原因与依赖关系。
> **本目录内的文件一律视为「归档只读」**，不要再基于它继续开发。

---

## 1. 一句话

这里放的是**老版本的 2D 小游戏项目「临湖小镇」（AI 小镇）** —— Godot 4.7 画面层 + Python 模拟引擎，2026-09-01 开工、2026-09-28 最后一次改动，**已被新项目「我要当市长」取代**，故整体移入本隔离区。

---

## 2. 为什么被隔离（**准确表述：是「方向切换」，不是「崩溃」**）

必须说清楚，避免以后误读：

- 旧项目**并不是做失败了**。它的 MVP **已经跑通并通过验证** —— 见 `little-town-godot/对话记录.md` 最后一轮记录：headless `--quit-after 500` 退出码 0、零报错、打印 `[godot] 已接入后端：5 位居民 / 8 座建筑`；地图切片、贴图化、气泡、用量面板都已完成。
- 真正的原因是 **2026-10-06 做了技术方向调研**（结论见 `../当前项目-我要当市长/我要当市长-开发路线调研-2026-10-06.md` §1.1）：新游戏按**全新项目**立项，改走 **Cocos Creator + TypeScript、首发微信小游戏**（后续又演进为 3D 有限扩岛方案）。旧 Godot 客户端与这条路线不兼容。
- 于是旧项目被**主动放弃**，代码与素材整体冻结。此后所有开发都在新项目 `/vol1/ai/projects/wyszz-new/` 进行。

> 用户本轮的口径是「之前失败的结果」。按上面对照，更准确的标注是：**「已放弃 / 被取代」**。这里如实写出，不美化也不贬低。

---

## 3. 内容清单（`little-town-godot/`）

| 路径 | 体积 | 文件数 | 是什么 | 标注 |
| --- | --- | --- | --- | --- |
| `project.godot` | 859 B | 1 | Godot 4.7 工程文件，`config/name="little-town"` | 主入口（已废弃） |
| `scenes/main.tscn` | 8 KB | 1 | 主场景（Main / World / UI） | |
| `scripts/` | 44 KB | 6 | `main.gd`（轮询+渲染+控制）、`building.gd`、`resident.gd` + `.uid` | 占位形象：色块建筑、彩色圆点居民 |
| `addons/godot_ai/` | 2.7 MB | 267 | godot-ai MCP 编辑器插件 | 第三方插件，非自研 |
| `assets/` | 44 MB | 57 | `art/`（切片素材）、`data/`（`map.json`、`residents.json`）、`fonts/`（msyh.ttc 等） | **最大的一块**，素材可复用参考 |
| `.godot/` | 39 MB | 150 | Godot 导入缓存 | **纯构建缓存，可安全删除**；保留只为可回滚 |
| `server/` | 5.5 MB | 19 | Python 模拟引擎：`main.py`、`town/`（clock/world/brain/llm/db/sim/dashboard）、`data/`、`logs/`、`town.db`、`config.json` | ⚠ **见 §4，含在用凭据** |
| `tools/` | 436 KB | 7 | 地图工具：`slice_atlas.py`、`derive_tiles.py`、`gen_map.py`、`check_map.py` + 预览图 | 纯 Python，可复用 |
| `docs/TOOLS.md` | 28 KB | 1 | godot-ai MCP 的 ~43 个工具 / 120+ 操作清单 | |
| `logs/` | 12 KB | 2 | `import.log`、`run.log`（2026-09-01） | |
| `.zcode/` | 8 KB | 1 | `config.json`（编辑器配置） | |
| `README.md` | 3.2 KB | 1 | 旧项目的启动说明（一键 `start_game.bat`） | |
| `AGENTS.md` | 818 B | 1 | 旧项目的智能体约定（**要求走 godot-ai MCP 操作 Godot 编辑器**） | 已随项目一起隔离；工作区顶层另有新的 AGENTS.md |
| `start_game.bat` | 524 B | 1 | Windows 一键启动（起 Python 后端 + 开 Godot） | 依赖 Windows 上的 Godot 4.7.2 exe |
| `icon.svg` / `icon.svg.import` | 2 KB | 2 | 工程图标 | |
| `.editorconfig` / `.gitattributes` / `.gitignore` | 159 B | 3 | 编辑器/仓库约定 | |
| `对话记录.md` | 22 KB | 1 | **旧项目的完整开发史**（按轮次记录，含踩坑与决策） | ⭐ 最有史料价值 |
| `接手提示词.md` | 5.9 KB | 1 | 交接文档：项目是什么、架构一图、快速上手、待办路线 | ⭐ 接手必读 |
| `对话记录.md.rewrite-bak-20260928045413.` | 21.9 KB | 1 | 上一份的重写备份 | 冗余，可删 |
| `接手提示词.md.rewrite-bak-20260928045413.` | 5.9 KB | 1 | 上一份的重写备份 | 冗余，可删 |

**合计：524 个文件 / 179 个目录 / 91 MB**（其中 `.godot/` 缓存 39 MB、`assets/` 44 MB）。

**时间跨度**：文件时间从 **2026-09-01** 到 **2026-09-28**（`server/logs/server.log` 为 2026-09-04）。

---

## 4. ⚠ 重要：本隔离区里有**在用的凭据**，不要整目录删除

`little-town-godot/server/config.json` 里存着**仍然在用**的 API 配置，包括：

| 键 | 用途 |
| --- | --- |
| `api.key`（67 字符） | 文本大模型（旧项目用 mimo-v2.5 驱动居民决策/对话） |
| `api.base_url`、`api.model`、`api.temperature`、`api.max_tokens`、`api.extra_body` | 同上的连接参数 |
| `image_api.key`（51 字符） | **图片生成**（apinebula.ai / gpt-image-2.5） |
| `image_api.base_url`、`image_api.model` | 同上 |
| `clock` / `simulation` / `cost` / `server` | 旧项目自己的时钟、调度、预算、端口配置 |

**依赖它的脚本（仍在用，路径已同步改到本隔离区）**：

| 脚本 | 引用的键 |
| --- | --- |
| `/vol1/ai/_scripts/gen_image.py` | `image_api.*` |
| `/vol1/ai/_scripts/gen_grass_firework.py` | `image_api.*` |
| `/vol1/ai/_scripts/gen_grass_firework_v2.py` | `image_api.*` |

**⇒ 结论：**
1. **不要删除 `little-town-godot/server/config.json`**，否则上面 3 个出图脚本会失效。
2. 本文件**不复制、不打印任何密钥值**；凭据仍只存在于原文件里（权限未变）。
3. 如果将来想彻底清理旧项目，**必须先把 `config.json` 挪到隔离区之外**（例如 `/vol1/ai/_scripts/config/`）并同步改那 3 个脚本，再考虑删除本目录。**这一步本次没有做**（属于凭据搬迁，需用户确认）。

---

## 5. 与新项目的关系

| | 旧版（本隔离区） | 新版（当前项目） |
| --- | --- | --- |
| 名字 | 临湖小镇 / AI 小镇 | **我要当市长** |
| 位置 | `little-town/_隔离-旧版2D临湖小镇/little-town-godot/` | `/vol1/ai/projects/wyszz-new/` |
| 引擎 | Godot 4.7（2D，`canvas_items` 拉伸）+ Python 后端 | Three.js / TypeScript → 微信小游戏（3D 有限扩岛） |
| 玩法 | AI 居民生活模拟（决策/对话/好感度/天气/用量面板） | 挂机城市经营（金币/声望/寻访/升级/存档） |
| 状态 | **已放弃（归档只读）** | 进行中（0.1 收尾） |

**规划文档的谱系**（重要，避免拿旧版当最新）：

- `当前项目-我要当市长/` 里那 6 份是 **2026-10-06 的原始版**。
- **演进版在 `wyszz-new/docs/`**：`我要当市长-游戏企划书-v0.3-3D有限扩岛-2026-10-09.md`、`我要当市长-0.1至1.0版本迭代计划-v2-3D有限扩岛-2026-10-09.md`、`我要当市长-计划修改报告-3D有限扩岛-2026-10-09.md`。
- **以 `wyszz-new/docs/` 为准**，本目录的 6 份只作留档。

**更早的原版**：旧项目迁移前的版本（`littletownglm`）留在 `/vol1/ai/projects/project/littletownglm`（见 `接手提示词.md` §两个文件夹）。**本次未触碰该目录**（不在整理范围内）。

---

## 6. 本次整理做了什么 / 没做什么

**做了：**
- 把旧项目的 23 个顶层条目（10 个目录 + 13 个文件）**整体**移入 `little-town-godot/`，**保持内部相对路径不变**（`project.godot`、`res://scenes/main.tscn`、`server/` 引用都仍然成立）。
- 把「我要当市长」6 份文档移入 `../当前项目-我要当市长/`（属于当前项目，故不隔离）。
- 同步修改 **6 个脚本**里被移动文件的路径（见 §7）。
- 移动前后做**逐文件 SHA256 比对**：**532 个文件零丢失、零篡改**。

**没做：**
- **没有删除任何文件**（`.godot/` 39 MB 缓存和 2 个 `.rewrite-bak-*` 都保留了，只是移入隔离区）。
- 没有搬迁凭据（见 §4）。
- 没有触碰 `/vol1/ai/projects/wyszz-new/`（当前游戏项目，有智能体在工作）。
- 没有触碰 `/vol1/ai/projects/project/`、`/vol1/ai/projects/` 下任何其它兄弟目录。
- 没有改 Godot 工程内部任何一行内容。

---

## 7. 因本次移动而同步修改的脚本

| 脚本 | 改动 |
| --- | --- |
| `/vol1/ai/_scripts/gen_image.py` | `CFG` → `…/little-town/_隔离-旧版2D临湖小镇/little-town-godot/server/config.json` |
| `/vol1/ai/_scripts/gen_grass_firework.py` | 同上 |
| `/vol1/ai/_scripts/gen_grass_firework_v2.py` | 同上 |
| `/vol1/ai/_scripts/extract-mayor-doc.py` | `out` → `…/little-town/当前项目-我要当市长/我要当市长-游戏企划书.md` |
| `/vol1/ai/_scripts/send-mayor-docx.sh` | `F` → `…/当前项目-我要当市长/我要当市长-游戏企划书.docx` |
| `/vol1/ai/_scripts/verify-weixin-send.sh` | `cp` 源 → 同上 |

其余提到 `little-town` 的脚本（`cdp-add-project.js`、`codex-set-workspace-roots.py`）只在**注释/示例**里出现，无需改动。

---

## 8. 如何回滚

本次移动是**纯 `mv`，同盘同文件系统，可原样搬回**：

```bash
L=/vol1/ai/projects/little-town
# 搬回旧项目
mv "$L/_隔离-旧版2D临湖小镇/little-town-godot"/* "$L/"     # 含隐藏文件需另行处理
mv "$L/_隔离-旧版2D临湖小镇/little-town-godot"/.[!.]* "$L/"
# 搬回 6 份文档
mv "$L/当前项目-我要当市长"/* "$L/"
# 再把 6 个脚本的路径改回去
```

移动前清单留存：`/tmp/lt-before-top.txt`（顶层 32 条目）、`/tmp/lt-before-hashes.txt`（532 文件哈希）。

---

*本标注由 Lead 于 2026-10-12 生成。所有事实均来自实际读取与实测，未验证项已写明。*
