# 《我要当市长》NAS 开发环境检查报告

> 检查日期：2026-10-07
> 检查范围：**只做环境检查与目录准备，不做任何游戏开发**
> 新项目路径：`/vol1/ai/projects/wyszz-new`
> 旧项目路径：`/vol1/ai/projects/little-town`（本次**未修改**，仅只读查看）
> 检查方式：全部使用系统自带命令，**未安装任何检查工具**

---

## 一、结论速览

| 项目 | 结果 |
| --- | --- |
| 系统与硬件 | ✅ 满足开发辅助环境要求（Debian 12 / x86_64 / 16 核 / 15Gi 内存 / 5.2T 可用） |
| 建议工具链 | ✅ **全部已存在，无需安装任何软件** |
| 新项目目录 | ✅ 已创建 `wyszz-new/{docs,tools,config}` |
| Cocos Creator 编辑器 | ❌ **官方无 Linux 版本**，无法在 NAS 上运行编辑器 |
| 微信开发者工具 | ❌ **官方无 Linux 版本**，无法在 NAS 上运行 |
| 本次实际安装的软件 | **0 个** |

**一句话结论：NAS 可以作为项目文件、脚本、资源与构建辅助环境，但 Cocos Creator 编辑器与微信开发者工具都需要在 Windows 或 macOS 上运行。**

---

## 二、系统检查（第 1–10 项）

### 1. Linux 发行版和版本

```
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
```

- 内核：`Linux homeNAS 6.18.18.c1032-trim #1032 SMP PREEMPT_DYNAMIC Fri Aug 21 01:49:29 UTC 2026 x86_64 GNU/Linux`
- 飞牛系统版本：**fnOS 1.2.0604**（来源 `/usr/trim/etc/version`）
- 主机名：`homeNAS`
- 说明：fnOS 底层是 Debian 12，因此**完全兼容 Debian 的软件包与命令**。

### 2. CPU 架构

```
x86_64
```

- 集成显卡：`Intel Corporation Alder Lake-S GT1 [UHD Graphics 730]`（存在 `/dev/dri/card0`、`/dev/dri/renderD128`）

### 3. CPU 核心数

```
nproc            = 16
/proc/cpuinfo 处理器数 = 16
```

### 4. 内存总量和可用内存

| 项目 | 数值 |
| --- | --- |
| 内存总量 | 15 GiB |
| 已用 | 10 GiB |
| 空闲 | 1.2 GiB |
| buff/cache | 3.6 GiB |
| **可用** | **4.5 GiB** |
| Swap 总量 / 已用 / 空闲 | 8.0 GiB / 1.9 GiB / 6.1 GiB |

> 提示：已用内存偏高（NAS 常驻服务），当前可用 4.5 GiB。作为项目文件与脚本环境足够；若将来在此机器上跑重构建任务，需注意内存余量。

### 5. 磁盘空间

| 挂载点 | 设备 | 容量 | 已用 | 可用 | 使用率 |
| --- | --- | --- | --- | --- | --- |
| `/` | `/dev/nvme0n1p2` | 98 G | 21 G | 73 G | 22% |
| `/mnt/ssd` | `/dev/nvme0n1p3` | 359 G | 37 G | 304 G | 11% |
| `/fs` | `trimafs` | 5.5 T | 286 G | 5.2 T | 6% |
| **`/vol1`** | `/dev/mapper/trim_...-0` | **5.5 T** | **286 G** | **5.2 T** | **6%** |
| `/dev/shm` | tmpfs | 7.7 G | 1.4 M | 7.7 G | 1% |

- 新项目所在文件系统：`/vol1`，**可用 5.2 T，空间充足**。
- `/vol1/ai/projects` 实际挂载：`/dev/nvme0n1p3[/projects]`，`ext4`，选项 `rw,noatime`。

### 6. 当前用户和权限

```
uid=0(root) gid=0(root) groups=0(root)
HOME=/vol1/ai/home
```

- 当前以 **root** 身份运行，具备完整读写权限。
- `/vol1` 目录权限为 `d---------`（000），但 root 不受该限制。
- `/vol1/ai/projects` 权限为 `drwxr-xr-x`，属主 `197609:197121`（fnOS 文件管理层映射的 Windows 风格 UID，**不存在于 `/etc/passwd`**）。
- 系统真实用户：`homeNAS`（uid 1000, gid 1001）。

### 7. 可用包管理器

| 包管理器 | 路径 | 状态 |
| --- | --- | --- |
| `apt` | `/usr/bin/apt` | ✅ 可用 |
| `apt-get` | `/usr/bin/apt-get` | ✅ 可用 |
| `dpkg` | `/usr/bin/dpkg` | ✅ 可用 |

未发现：`yum` / `dnf` / `rpm` / `apk` / `pacman` / `zypper` / `snap` / `flatpak`。

> 即 **Debian 官方 apt 是唯一包管理器**，符合「优先使用飞牛系统或 Linux 官方包管理器」的要求。

### 8. 是否有 Docker

| 项目 | 版本 |
| --- | --- |
| Docker | **28.5.2**（build ecc6942） |
| Docker Compose | **v2.40.3**（`docker compose` 子命令） |
| `docker-compose`（独立命令） | 未安装（v1 风格命令不可用） |

> ⚠️ 按你的要求，**本次未创建任何容器、未拉取任何镜像、未启动任何服务**。仅记录其存在。

### 9. 是否有图形界面或远程桌面

| 检查项 | 结果 |
| --- | --- |
| `DISPLAY` / `WAYLAND_DISPLAY` / `XDG_SESSION_TYPE` | 全部未设置 |
| 显示管理器（gdm3 / lightdm / sddm / xdm） | **一个都没有** |
| `/usr/share/xsessions/` 内容 | 仅 `openbox.desktop`（一个会话描述文件） |
| `systemctl get-default` | `graphical.target` |
| `graphical.target` 状态 | `active`（但**没有显示管理器接管**，实际为无桌面状态） |
| Xvfb（虚拟帧缓冲） | ✅ 已装 `2:21.1.7-3+deb12u13` |
| xserver-common / x11-xserver-utils | ✅ 已装 |
| Mesa GL / EGL / Vulkan 库 | ✅ 已装（`libgl1`、`libegl-mesa0`、`mesa-vulkan-drivers` 等） |
| xrdp（远程桌面） | ❌ 未安装 |
| VNC Server（vncserver / x11vnc） | ❌ 未安装 |
| 桌面环境（GNOME / XFCE / KDE / LXDE / MATE） | ❌ 未安装 |

**结论：当前 NAS 没有可用的图形桌面，也没有远程桌面服务。** 只有 Xvfb 这类「无头虚拟显示」组件，它不能提供可交互的图形界面。GPU 设备节点存在，但缺少桌面会话与远程桌面通道。

### 10. `/vol1/ai/projects` 是否存在且可写

| 检查项 | 结果 |
| --- | --- |
| 是否存在 | ✅ 存在（`drwxr-xr-x 14 root root`，属主显示 `197609:197121`） |
| 文件系统 | `ext4`，`rw,noatime` |
| 可写测试 | ✅ **通过** — 成功创建临时文件并删除（`touch` + `rm` 均成功） |
| 结论 | **存在且可写** |

---

## 三、已有软件检查（第 3 节）

| 程序 | 是否安装 | 版本 | 路径 |
| --- | --- | --- | --- |
| git | ✅ | **2.39.5** | `/usr/bin/git` |
| curl | ✅ | **7.88.1**（OpenSSL 3.0.22） | `/usr/bin/curl` |
| wget | ✅ | **1.21.3** | `/usr/bin/wget` |
| unzip | ✅ | **6.00** (Debian) | `/usr/bin/unzip` |
| zip | ✅ | **3.0** | `/usr/bin/zip` |
| python3 | ✅ | **3.11.2** | `/usr/bin/python3` |
| node | ✅ | **v24.15.0** | `/mnt/ssd/apps/nodejs_v24/bin/node` |
| npm | ✅ | **11.12.1** | `/mnt/ssd/apps/nodejs_v24/bin/npm` |
| pnpm | ✅ | **12.6.0** | `/mnt/ssd/apps/nodejs_v24/bin/pnpm` |
| jq | ✅ | **1.6** | `/usr/bin/jq` |
| docker | ✅ | **28.5.2** | `/usr/bin/docker` |
| docker compose | ✅ | **v2.40.3** | `docker compose` 子命令 |

**12 项全部已安装，无一项缺失。**

补充事实：

- Node.js 并非由 apt 安装，而是独立部署在 `/mnt/ssd/apps/nodejs_v24`，且已加入 `PATH`（`/mnt/ssd/apps/nodejs_v24/bin`）。
- npm 全局前缀：`/mnt/ssd/apps/nodejs_v24`；npm 源：`https://registry.npmjs.org/`。
- 同目录下还预装了 `tsc`、`tsx`、`eslint`、`prettier`、`corepack` 等前端工具。
- 系统内另有一份备用 Node：`/mnt/ssd/apps/nodejs_v22/bin/node` = **v22.18.0**（npm 10.9.3）。
- apt 仓库中 `nodejs` 候选版本为 **18.20.4**（**未安装**，仅查询）。
- 未安装 nvm / fnm / volta 等版本管理器。

### 网络可达性（供后续安装参考，本次未下载任何东西）

| 目标 | 结果 |
| --- | --- |
| `https://registry.npmjs.org/` | HTTP 200 ✅ |
| `https://deb.debian.org/` | HTTP 200 ✅ |

---

## 四、安装原则执行情况（第 4 节）

### 4.1 本次安装的软件：**0 个**

你建议准备的工具清单，经检查**全部已存在可用版本**，因此按「如果系统已有可用版本，不要重复安装」的原则，**没有执行任何安装、升级或卸载操作**。

| 建议工具 | 现状 | 本次动作 |
| --- | --- | --- |
| Git | 已有 2.39.5 | 不安装 |
| Node.js LTS | 已有 v24.15.0 | **不安装**（版本兼容性见下） |
| npm | 已有 11.12.1 | 不安装 |
| Python 3 | 已有 3.11.2 | 不安装 |
| curl | 已有 7.88.1 | 不安装 |
| unzip | 已有 6.00 | 不安装 |
| zip | 已有 3.0 | 不安装 |
| jq | 已有 1.6 | 不安装 |

### 4.2 明确未安装的东西（按你的要求）

Unity ❌ ｜ Godot ❌ ｜ 数据库 ❌ ｜ Redis ❌ ｜ Nginx ❌ ｜ Kubernetes ❌ ｜ Docker 容器 ❌ ｜ 广告 SDK ❌ ｜ 支付 SDK ❌ ｜ 后端服务 ❌

> 说明：Docker 本身**早已存在于系统中**（非本次安装），本次也**没有使用它**。系统内 `/usr/trim/nginx` 是 fnOS 自带组件，非本次安装。

### 4.3 Node.js 版本兼容性核查（按你的要求：不凭印象）

你要求：**如果安装 Node.js，必须确认版本与 Cocos Creator 和微信小游戏工具链兼容；无法确认就保留现状并报告。** 本次未安装 Node.js，但既然系统已有 v24.15.0，我做了兼容性核查：

**已核实的事实：**

1. **Cocos Creator 编辑器自带独立的 Node/Electron 运行时**，不依赖系统 Node.js。
   - 官方更新说明：3.8.5 起「升级编辑器的 electron 版本到 31.3.1，提升了性能和 node 的版本」。
   - 因此**系统 Node 版本不影响编辑器本身的运行**。
2. **官方文档/论坛给出的 Node.js 要求，均低于 v24：**
   - Cocos 官方论坛（3.8 定制引擎报错帖）：编译依赖项需要 NodeJS，**要求 v12.0 以上**。
   - Cocos Creator 3.8.2 LTS 发布说明：「引擎仓库开发环境适配到 **NodeJS 18.x**」。
   - Cocos Creator 3.8.4 更新说明：「升级小米打包工具，支持 **node 18 以上**版本编译小米」。
3. **微信开发者工具同样自带运行时**（基于 NW.js；Nightly 版基于 NW.js 0.54.1 / 0.81.1，其中 0.81.1 内置 node 20.7.0），**不依赖系统 Node.js**。

**核查结论：**

- 对于**日常项目依赖**（TypeScript 类型、lint、格式化、脚本），Node v24.15.0 可用。
- 对于**引擎级工具链**（定制引擎编译、引擎仓库开发），官方明确适配/验证到 **Node 18.x**，**没有任何官方资料确认支持 Node 24**。
- 因此：**无法确认 Node 24 与 Cocos 引擎级工具链完全兼容** → 按你的要求 **保留现状，不安装、不降级**，并在此如实报告。
- 若后续确实需要引擎级编译，可用的降级选项（**本次未执行**）：系统已备有 Node v22.18.0（`/mnt/ssd/apps/nodejs_v22`）；apt 仓库可装 Node 18.20.4。

---

## 五、Cocos Creator 可行性检查（第 5 节）

> 详细论证见同目录 `Cocos Creator 可行性结论-2026-10-07.md`。以下为六问逐条回答。

| # | 问题 | 结论 |
| --- | --- | --- |
| 1 | 是否有官方 Linux 版本 | ❌ **没有**。Cocos 官方文档《安装和启动》明确：「Cocos Dashboard 所支持的系统环境是：Mac OS X 最低 10.9；Windows 最低 Windows 7 64 位」。官方下载页仅提供 Windows / macOS 安装包。社区存在**非官方 Linux 移植版**，但按你的要求**不使用、不安装第三方修改版**。 |
| 2 | 当前 CPU 架构是否支持 | ⚠️ **x86_64 本身是 Cocos 官方支持的架构**（Windows 64 位 / macOS Intel 均为 x86_64），但**因为没有 Linux 编辑器，架构支持在这里不构成可行路径**。 |
| 3 | 是否需要图形界面 | ✅ **需要**。编辑器是 GUI 程序，且官方文档明确「编辑器依赖 GPU 渲染」，显卡驱动不支持 WebGL 会直接报错。 |
| 4 | 是否可以通过远程桌面运行 | ❌ **当前不行**。本机既无 Linux 版编辑器可跑，也**没有安装任何远程桌面服务**（xrdp / VNC 均无，显示管理器也没有）。仅 Xvfb 不足以提供可交互桌面。 |
| 5 | 是否可在当前环境完成项目创建和预览 | ❌ **不能**。项目创建与浏览器预览都由编辑器提供；预览服务器由编辑器进程拉起。官方**命令行构建**（`CocosCreator.exe --project ... --build ...`）也**必须调用编辑器可执行文件**，官方文档只给出 Windows 与 Mac 两种调用路径。 |
| 6 | 是否需要在 Windows/macOS 上运行编辑器，再把项目文件放到 NAS | ✅ **这是唯一可行方案**。 |

### 按要求给出的结论表述

> **NAS 可作为项目文件、脚本和构建辅助环境，但 Cocos Creator 编辑器需要其他系统运行。**

同时补充一条同等重要的事实（超出 Cocos 本身，但直接决定首发路径）：

> **微信开发者工具同样只有 Windows 与 macOS 版本**，官方下载页当前仅列出 `Windows 64 / Windows 32 / macOS x64 / macOS ARM64`。微信开放社区已有开发者提交「Linux 版本缺失」的反馈帖，官方**未提供 Linux 版**。因此**微信小游戏的调试、预览与提审也必须在一台 Windows 或 macOS 机器上完成**。

### 后续可选方案（**仅列出，本次未执行任何一项**）

| 方案 | 说明 | 代价 |
| --- | --- | --- |
| **A. 双机分工（推荐）** | Windows/macOS 装 Cocos Creator + 微信开发者工具；NAS 通过 SMB/网络盘承载项目目录，负责版本管理、资源、脚本与文档 | 需要一台 Windows/macOS 机器；编辑器跨网络盘读写大项目时可能有延迟 |
| **B. 编辑器本地 + NAS 做版本库** | 项目在 Windows/macOS 本地开发，用 Git 推送到 NAS 上的裸仓库做备份与协作 | 需要维护同步流程 |
| **C. 保留 Godot 路线** | 旧项目 `little-town` 已用 Godot 4.7，而 **Godot 官方提供 Linux 版编辑器**，是当前 NAS 上**唯一能原生跑编辑器**的候选 | 与已定的 Cocos + 微信小游戏首发方向不一致，**需你明确决定**，我不会擅自切换 |
| **D. 等待/评估官方 Linux 版** | Cocos 社区有 Linux 版诉求（官方论坛有投票帖），但目前无官方 Linux 版发布计划 | 时间不可控 |

> ⚠️ 以上方案**均未自动执行**。引擎选型属于你的决策，我不会擅自替换引擎、也不会安装第三方修改版。

---

## 六、环境目录创建（第 6 节）

已创建（创建前均不存在）：

```
/vol1/ai/projects/wyszz-new
/vol1/ai/projects/wyszz-new/docs
/vol1/ai/projects/wyszz-new/tools
/vol1/ai/projects/wyszz-new/config
```

实际结果：

```
drwxr-xr-x root:root /vol1/ai/projects/wyszz-new
drwxr-xr-x root:root /vol1/ai/projects/wyszz-new/docs
drwxr-xr-x root:root /vol1/ai/projects/wyszz-new/tools
drwxr-xr-x root:root /vol1/ai/projects/wyszz-new/config
```

### ⚠️ 一个待你确认的权限事项

- 本目录由 root 创建，属主为 `root:root`，权限 `755`。
- 而 `little-town`、`ds_project` 等由飞牛文件管理器创建的目录属主是 `197609:197121`，权限 `700`。
- 另有 `voice-memory-card-dsh` 是 `root:root 755`，说明这种组合在本机也能正常工作。
- **我未擅自改动权限**。若你通过飞牛 Web 文件管理器或 SMB 访问 `wyszz-new` 时遇到权限问题，可执行（**需你确认后我再做**）：

```bash
chown -R 197609:197121 /vol1/ai/projects/wyszz-new
chmod 700 /vol1/ai/projects/wyszz-new
```

---

## 七、本次操作的完整清单（可审计）

### 已执行

| 操作 | 对象 |
| --- | --- |
| 只读检查 | 系统信息、硬件、磁盘、权限、包管理器、Docker、图形界面、已有软件版本 |
| 可写性测试 | `/vol1/ai/projects`（创建并立即删除一个临时文件 `.dsh_write_test_1076502`） |
| 只读查看 | `/vol1/ai/projects/little-town` 目录列表与 `我要当市长-开发路线调研-2026-10-06.md` |
| 创建目录 | `/vol1/ai/projects/wyszz-new` 及 `docs`、`tools`、`config` 子目录 |
| 创建文件 | 本报告及同目录另 2 份文档、1 份 JSON 快照、1 个检查脚本 |

### 明确未执行（严格遵守禁止项）

- ❌ 未修改 `/vol1/ai/projects/little-town` 的**任何**文件（该目录 mtime 仍为 `2026-10-06 23:24:02`，未变动）
- ❌ 未修改旧 Godot 工程（`project.godot`、`scenes/`、`scripts/` 等均未触碰）
- ❌ 未创建任何游戏场景
- ❌ 未编写任何游戏代码
- ❌ 未制作任何 UI
- ❌ 未安装广告、支付、后端或数据库
- ❌ 未注册任何微信小游戏账号
- ❌ 未下载任何软件（网络仅做了 2 次 HTTP 可达性探测）
- ❌ 未写入任何密钥、Token、密码或账号信息
- ❌ 未把 Godot 设为新项目引擎
- ❌ 未把项目改成 Unity 或纯网页项目
- ❌ 未安装任何第三方修改版 Cocos Creator

---

## 八、下一步建议（**待你决定，不自动执行**）

1. **先定编辑器机器**：确认是否有可用的 Windows 或 macOS 机器（这是 Cocos + 微信小游戏路线的硬前提）。
2. **确认目录权限方案**：是否需要把 `wyszz-new` 的属主改成 `197609:197121`。
3. **确认 Node 策略**：是否接受现状 v24.15.0（编辑器不受影响），还是为引擎级编译准备 Node 18/22 环境。
4. **确认是否需要远程桌面**：若希望在 NAS 上远程操作那台编辑器机器，那是另一套方案，需单独评估。
5. 以上任何一项确认后，再进入项目初始化（创建 Cocos 工程骨架）——**本轮不做**。
