初始化项目并上传代码

docs/项目结构图与运行入口说明.md

@@ -0,0 +1,49 @@
+# 项目结构图与运行入口说明（1 分钟版）
+
+## 一、项目结构图
+
+```text
+test/
+├─ index.html                     # 页面入口（直接在浏览器打开）
+├─ styles.css                     # 页面样式
+├─ app.js                         # 生命游戏核心引擎 + UI 交互控制
+├─ tests/
+│  └─ life-demo.test.js           # Node 测试（核心规则与状态逻辑）
+└─ docs/
+   └─ 项目结构图与运行入口说明.md   # 本说明文档
+```
+
+## 二、运行入口
+
+### 1) 浏览器入口（交互演示）
+
+- 入口文件：`index.html`
+- 加载脚本：`index.html` 底部通过 `<script src="./app.js"></script>` 引入引擎与交互逻辑。
+- 打开方式：双击 `index.html`（或在浏览器中打开本地文件）。
+
+### 2) 脚本初始化入口
+
+- `app.js` 在 `DOMContentLoaded` 后执行 `initDemo()`，完成：
+  - 初始状态创建（默认预设、网格尺寸、暂停状态）
+  - 画布渲染与动画循环
+  - 控件事件绑定（开始/暂停、单步、清空、随机、重置预设、速度滑条）
+  - 画布点击/拖拽绘制
+
+## 三、关键代码定位
+
+- 预设图案定义：`app.js:4`
+- 交互初始化入口：`app.js:368`
+- 开始/暂停等主控事件：`app.js:430`
+- Node 导出（供测试复用）：`app.js:540`
+- 测试起始位置：`tests/life-demo.test.js:14`
+
+## 四、测试入口
+
+- 测试文件：`tests/life-demo.test.js`
+- 推荐命令（当前环境可用）：
+
+```bash
+node tests/life-demo.test.js
+```
+
+> 说明：在当前受限环境下，`node --test tests/life-demo.test.js` 可能因子进程权限报 `EPERM`，但直接执行测试文件可正常完成 9 项测试。