# wyszz-new · 0.1 第一步：环境配置与最小验证报告

> 完成日期：2026-10-08
> 技术路线（本轮已变更）：**TypeScript + Canvas 2D**，Docker 内 Node.js 编译；浏览器仅用于开发预览；正式发布目标仍为**微信小游戏**。不使用 Cocos / Phaser / Godot / Unity，不做依赖 HTML/DOM 的普通网页游戏。
> 旧项目 `/vol1/ai/projects/little-town` **未修改**（mtime 仍为 2026-10-06 23:24:02）。

## 一、目录结构（本轮新增，均已在 /vol1/ai/projects/wyszz-new 下）

```
/vol1/ai/projects/wyszz-new/
├── docker-compose.yml              # 探针容器编排（LAN 绑定 + 资源限制）
├── docs/环境配置报告-0.1-2026-10-08.md  # 本报告
├── config/
│   ├── probe-screenshot.png            # 探针初始画面截图（计数 0）
│   ├── probe-screenshot-final.png      # 交互后截图（计数 12）
│   └── ...
└── probe/                          # 环境探针（独立目录，后续正式游戏代码不混入）
    ├── Dockerfile                  # （备用镜像构建文件，本轮直接用官方镜像）
    ├── package.json
    ├── package-lock.json           # 依赖锁定 ✓
    ├── tsconfig.json
    ├── vite.config.ts
    ├── index.html
    ├── src/main.ts                 # Canvas 2D 环境验证页（无任何游戏玩法）
    ├── node_modules/               # 容器内安装
    └── dist/                       # 生产构建产物 ✓
```

## 二、版本与镜像摘要（实测）

| 项 | 值 |
| --- | --- |
| Docker 镜像 | `node:22-bookworm-slim`（本地 tag 自 `docker.m.daocloud.io/library/node:22-bookworm-slim`） |
| 镜像摘要 | `sha256:c3de60bf2f9dd0ac6370e6117950ff62d6e339527e7472301c9c78a017978392`（amd64） |
| Node | **v22.23.3**（容器内实测） |
| npm | **10.9.9** |
| TypeScript | **5.9.3** |
| Vite | **6.4.4** |
| Docker / Compose | 28.5.2 / v2.40.3（宿主已有） |

> 拉取说明：`registry-1.docker.io` 直连超时（配镜像源也不通），通过 daocloud 镜像源拉取成功；摘要可在 daocloud 源核对，与官方 library/node 该 tag 一致性由 digest 校验保证。

## 三、组件用途

| 组件 | 用途 |
| --- | --- |
| Node 22 LTS（Docker） | 构建与开发服务器运行时，不污染 NAS 宿主系统 |
| TypeScript（tsc） | 静态类型检查；`npm run build` 中先于 vite 执行 |
| Vite | 开发服务器（LAN 预览）+ 生产打包 |
| Canvas 2D | 探针渲染（后续正式游戏共用同一绘制栈） |

未引入：游戏引擎、UI 框架、数据库、广告 SDK、后端服务、code-server、Phaser/Godot/Unity。

## 四、操作说明（在 /vol1/ai/projects/wyszz-new 下）

```bash
# 启动探针容器（首次需 probe/node_modules 存在；见下方"依赖安装"）
docker compose up -d

# 查看日志（Vite ready 即成功）
docker compose logs -f probe

# 类型检查 + 生产构建
docker compose exec probe npm run build

# 停止（保留项目文件）
docker compose down

# 彻底移除容器和本地 tag 镜像
docker compose down --rmi local 2>/dev/null; docker rmi node:22-bookworm-slim

# 依赖重装（如 node_modules 被清空）
docker run --rm --user node -v "$PWD/probe:/app" -w /app node:22-bookworm-slim npm install
```

容器内进程：`npm run dev`（Vite 6.4.4，监听 0.0.0.0:5173）。

## 五、局域网访问

- 探针（开发预览）：**http://192.168.1.38:5173/**
- 端口绑定方式：compose 中 `192.168.1.38:5173:5173`（仅 NAS 局域网地址，非 0.0.0.0/公网/反代）
- 生产产物预览可用 `docker compose exec probe npx vite preview --host 0.0.0.0 --port 5173`（需先停 dev 或换端口）

## 六、验证记录与证据

| 项 | 结果 | 证据 |
| --- | --- | --- |
| 目录可写 | ✅ | 本轮所有文件写入成功 |
| 旧项目未动 | ✅ | little-town mtime = 2026-10-06 23:24:02 |
| 镜像拉取 | ✅ | digest c3de60bf…，227MB，amd64 |
| 容器启动 | ✅ | `wyszz-probe Up`（compose 资源限制 mem 512m / cpus 1.0） |
| Node/npm/tsc 版本 | ✅ | v22.23.3 / 10.9.9 / 5.9.3（容器内实测） |
| 依赖锁定 | ✅ | package-lock.json（lockfileVersion 3） |
| TypeScript 检查 | ✅ | `tsc` 0 错误（修复 1 处全局类型声明后通过） |
| 生产构建 | ✅ | `dist/`：index.html 0.60 kB + assets/index-*.js 1.45 kB（gzip 0.83 kB） |
| LAN HTTP | ✅ | `curl http://192.168.1.38:5173/` → 200 且返回探针 HTML |
| 浏览器画面 | ✅ | 真实 Chromium (154, CDP) 渲染并截图：'环境验证'+计数+底部说明清晰无乱码 |
| 鼠标点击 | ✅ | CDP Input 单击：计数 11→12（精确 +1） |
| 触摸语义 | ✅（模拟） | CDP 触摸模拟（pointerType=touch）：一次触摸=一次 pointerdown，计数 +1，无重复计数 |
| 手机触摸实测 | ⏳ 待用户验收 | 上面为桌面浏览器触摸模拟，非真机；请手机打开 http://192.168.1.38:5173/ 验证 |
| 微信小游戏 | 未做 | 本轮不实现微信适配，无 AppID，未经验收 |

> HTTP 200 未被当作画面正常的证据 —— 画面用 Chromium 实际渲染 + 截图 + 视觉确认。
> 触摸计数设计：统一监听 `pointerdown` 一个事件源，并在移动端用 `touch-action: none` 防止双触发；真机验收时如有浏览器兼容问题（老安卓 WebView 无 PointerEvent）需反馈补丁。

## 七、边界声明

- 仅改动 `/vol1/ai/projects/wyszz-new`，旧项目与 NAS 配置（权限/共享/虚拟机/公网）零改动。
- 探针目录 `probe/` 独立于后续正式游戏代码，不混入。
- 未进入 0.1 第二步：无市政厅、居民、资源栏、升级面板，无任何游戏数值。
- 未安装 code-server（按要求用现有 DSH 写代码）。

## 八、权限说明（容器写入方案）

- `wyszz-new` 由 root 创建（root:root 755），容器内以 `node` (uid 1000) 运行不能直写；
- 采用 **POSIX ACL**（`setfacl -m u:1000:rwx`）仅对 `probe/` 子目录授权，属主未变、 未递归 chown/chmod 宿主目录、容器未用 root。

## 九、本次容器移除（保留项目文件）

```bash
cd /vol1/ai/projects/wyszz-new
docker compose down          # 容器与网络移除，probe/ 全部文件保留
docker rmi node:22-bookworm-slim   # 可选：释放 227MB 镜像
```

## 十、后续架构说明（本轮不实现）

- **共用层**：Canvas 2D 绘制、布局、游戏逻辑、存档数据结构。
- **平台适配层**（浏览器 / 微信各自实现，不共用 DOM 假设）：
  - 画布创建：`document.createElement('canvas')` vs `wx.createCanvas()`
  - 输入：PointerEvent/MouseEvent/TouchEvent vs `wx.onTouchStart/...`
  - 存档：localStorage vs `wx.setStorageSync()`
  - 生命周期：`visibilitychange` vs `wx.onShow/wx.onHide`
- 微信小游戏仍为正式发布目标；本轮无微信适配、无 AppID、未通过微信验收。
