# 《我要当市长》Windows 虚拟机微信小游戏最小迁移验证 —— 交接提示词

> 交接时间：2026-10-08 15:12 (+08:00)
> 交接原因：上一会话执行通道验证完成后，模型出现重复输出故障，无法继续。
> 本文件自包含，新会话读完即可直接接手，无需重验通道。

---

## 一、任务目标（原样保留用户要求）

在**现有 Windows 虚拟机**里安装/启动**官方微信开发者工具**，用**独立测试项目**验证 DSH 的 Three.js 原型迁移到微信小游戏的能力。

### 允许
- 在该 VM 内下载、安装官方微信开发者工具。

### 禁止
- 安装 Cocos；修改 VM 硬件配置；进入游戏经济系统开发。

### 一、隔离与保护（红线）
1. 公网原型 `https://mayor3d.hynixing.cn/` 必须保持可用。
2. **不得**修改/停止/重建/重新发布 `/vol1/ai/projects/wyszz-new/3d-spike-ds/`。
3. 可**只读**该目录的「迁移所需源码 / 依赖锁 / 报告」，但**不得**读取其公网配置凭据或部署脚本。
4. **不得**读取/修改 MIMO 目录、`app/`、`little-town/`。
5. 新建测试目录：NAS `/vol1/ai/projects/wyszz-new/wechat-spike-ds/`，Windows `C:\projects\wyszz-wx-spike\`。
6. 目录若已存在，**先看内容**，不得覆盖已有结果。
7. 不得修改 Cloudflare / DNS / 隧道 / systemd / NAS 权限 / 共享。
8. 本轮不得新增任何公网服务。

### 二、先验证 Windows 执行通道 → **✅ 已完成，见第三节**
需记录：OS 版本；桌面是否可用；内存 + 剩余磁盘；微信开发者工具是否已安装；现有 NAS 文件传输通道。
不猜测路径或凭据，不输出密码/Token。通道不可用则停止并给真实错误。

### 三、安装和启动官方工具
- 优先复用已安装版本；否则**只从微信官方渠道**下载 Windows 稳定版。
- 记录：官方来源 / 版本 / 安装路径。
- 启动并**截真实窗口**，确认项目界面可达。
- Windows Server / 虚拟 GPU 兼容性问题，**按实际启动结果判断**，不要仅凭 OS 名称就判失败。
- 保留完整错误；最多尝试官方文档支持的修复；**不改硬件 / 不关安全功能 / 不打非官方补丁**。
- 若登录需**主控方扫码**：说明并等待 —— 不注册账号、不用他人身份、不伪造 AppID。
- 仅在工具明确支持时才用测试模式，并记录测试模式是否支持真机预览。

### 四、独立验证，按顺序推进
- **阶段 A**：最小原生小游戏（合法 `微信小游戏` 入口+配置、`wx.createCanvas`、简单绘制，确认在**小游戏模拟器**里跑起来，日志+截图）。
- **阶段 B**：Three.js 最小渲染（优先与原型**同版本 r186**；渲染一个立方体；检查 **WebGL 2** 能力 + 实际渲染；记录 adapter 来源/版本/许可/必要性；**不得**把「小程序 adapter」当「小游戏 adapter」；**不得**用浏览器页面嵌入或 WebView 替代小游戏运行时）。
  - 若 r186 失败：定位到确切的 API / adapter / WebGL 问题并报告；**不得**降级 Three.js、**不得**换引擎、**不得**覆盖原型；并**停止后续浮空岛迁移**。
- **阶段 C**：最小浮空岛（**仅在立方体通过后**）：把必要场景代码复制到独立测试目录；显示浮空岛/市政厅/一个居民；接微信触摸旋转 + 真实 raycast 点击；物体名称用 Canvas 或场景内文字，**不用 HTML/CSS**；按微信支持的方式处理画布尺寸/像素比/资源加载/前后台切换/渲染循环；**不得**复制公网部署脚本或浏览器调试接口。

### 五、验证与证据（分别记录）
1. 工具安装+启动结果；2. 原生小游戏是否显示；3. Three.js 立方体是否显示；4. WebGL 版本 + 实际渲染错误；5. 浮空岛是否显示；6. 旋转是否引起真实画面变化；7. 市政厅/居民点击是否正确；8. **模拟器结果与真机结果分开列**。
- **主控方扫码前，真机必须标「未验证」。**
- **模拟器通过不得写成手机微信兼容性通过。**
- 需要主控方扫码 / 合法 AppID / 其它信息时，列出最小必要操作并**停下依赖该信息的部分**。

### 六、交付
报告写进新测试目录，含：新文件绝对路径；工具/Three.js/adapter 实际版本；安装/构建/导入/复现步骤；每阶段结果、截图、完整错误；迁移改动 + 剩余阻塞；主控方真机扫码需要做什么；确认现有公网原型未受影响。
按交付规则给真实报告 + 源码下载链接。**不得**上传凭据、登录二维码或任何身份信息。

### 收尾
完成后停止。**不进入**金币、声望、升级、寻访奖励、存档或广告开发。

---

## 二、已验证事实（无需重验）

### Windows 执行通道 —— 可用

| 项目 | 值 |
|---|---|
| 通道 | CursorTouch/Windows-MCP **0.8.7**，transport `streamable-http`，stateless |
| 端点 | `http://127.0.0.1:18000/mcp/`（宿主 127.0.0.1:18000 → 客机 :8000） |
| 鉴权 | `Authorization: Bearer <43字符>`，键文件 `/vol1/ai/windows-mcp/.mcp-key`（mode 600，**只可用不可打印**） |
| 存活判据 | `/mcp/` 未鉴权返回 **401 = 在线**；`/health` 返回 404（正常） |
| 工具数 | **20**：`App, DisplayInventory, PowerShell, FileSystem, Snapshot, Screenshot, Click, Type, Scroll, Move, Shortcut, Wait, WaitFor, Scrape, MultiSelect, MultiEdit, Clipboard, Process, Notification, Registry` |
| 关键签名 | `PowerShell {"command":"..."}`；`Screenshot {}`（返回 1024×768 PNG base64）；`Snapshot {}`；`Click {"loc":[x,y],"clicks":1}`；`Type {"text":"...","loc":[x,y],"clear":true}`；`FileSystem {"mode":"list"/"read", "path":"..."}` |

### 目标虚拟机 —— 事实已采集

| 项目 | 值 |
|---|---|
| OS | Windows Server 2022 Standard Evaluation，10.0.20348，build 20348，中文桌面体验版 |
| 主机名 / 用户 | `MCMC-34V01H9BKF` / `mc` |
| **提权状态** | **IsAdmin=False**（当前 MCP 会话非提权） |
| 桌面 | ✅ 可用：`UserInteractive=True`，SessionId=1，`explorer` 在运行，桌面项 0 |
| 显示 | Microsoft 基本显示适配器，驱动 10.0.20348.1，**1024×768**，VirtualScreen 1024×768 |
| 内存 | **4095 MB 总量 / 剩余 2548 MB** |
| 磁盘 | C: **剩余 27.2 GB** / 40 GB |
| 微信开发者工具 | ❌ **未安装**（全机仅 Microsoft Edge；`C:\Program Files\Tencent`、`C:\Program Files (x86)\Tencent`、`%LOCALAPPDATA%\Tencent`、`%APPDATA%\Tencent`、`C:\Tencent` 均不存在） |
| 工具链 | node / npm / git / python **均无**；`uv` 有：`C:\Users\mc\.local\bin\uv.exe` |
| PowerShell | 5.1.20348.1366 |
| 网络 | 客机 `10.0.2.15/24`（QEMU user-mode NAT），主机名 `MCMC-34V01H9BKF` |
| 外网 | ✅ `https://developers.weixin.qq.com/` → **200**；`https://www.baidu.com/` → **200**；`https://servicewechat.com/` 根路径 → 404（正常，下载走 `download_redirect`） |
| 硬件 | 3 vCPU（`-cpu host`）、4096 MB、IDE 磁盘、e1000 网卡、**std VGA**、`-vnc 127.0.0.1:8`（仅本机） |
| 磁盘镜像 | `/mnt/ssd/winvm-mcp/win.qcow2`（qcow2，40G 上限，已用约 12G） |

### 文件传输通道（两条，均可用）

1. **MCP `FileSystem` 工具** + 本目录 `tools/wx.py` 的 `fswrite`/`fsread`（base64 传输，适合中小文件）。
2. **netsvc 通道**：VM 内 poller 每 **20 秒**拉 `http://192.168.1.38:8088/run.ps1`，写入 `%USERPROFILE%\wmcp\cur.ps1` 后执行，输出进 `%USERPROFILE%\wmcp\run.out`，并把 `poll.log` POST 到 `http://192.168.1.38:8089/up/hb.log`。
   - 宿主侧：`/mnt/ssd/winvm-mcp/serve/`（下发的脚本）、`/mnt/ssd/winvm-mcp/inbox/`（回传结果）。
   - 心跳文件 `%USERPROFILE%\wmcp\hb.txt`，宿主侧 `/mnt/ssd/winvm-mcp/inbox/hb.log`。

### 提权通道（安装工具大概率需要）

- 计划任务 **`wmcp-watchdog`**，`Principal.UserId = mc`，**RunLevel = Highest**（提权），每分钟执行 `C:\Users\mc\wmcp\watchdog.ps1`。
- 其它相关计划任务：`windows-mcp-server`（Running，Limited，跑 MCP 服务本体）、`wmcp-boot`、`wmcp-fw`、`wmcp-poll1`（均 Ready）。
- 宿主侧脚本 `serve/run.ps1` 是历史验证脚本，可作为**提权投递写法**的参考。
- **注意**：`wmcp-watchdog` 属既有基础设施，**不得破坏**；如使用，走既有投递约定，不要改动任务本身。

### 服务与公网状态（交接时实测）

| 服务 | 状态 |
|---|---|
| `winvm-mcp` | active + enabled |
| `wmcp-netsvc` | active + enabled |
| `wyszz-3d-spike-preview`（公网原型上游） | active + enabled |
| `https://mayor3d.hynixing.cn/` | **200**（未受影响） |
| `http://127.0.0.1:18000/mcp/` | **401**（在线） |

---

## 三、已完成 / 未完成

### ✅ 已完成
- 第二节「Windows 执行通道验证」全部内容，证据落盘。
- 建立测试目录骨架 `/vol1/ai/projects/wyszz-new/wechat-spike-ds/{docs,tools,win,evidence/{logs,screenshots}}`。
- 写好并**实测可用**的 MCP 调用助手与探测脚本。

### ❌ 未完成（新会话的起点）
- Windows 侧 `C:\projects\wyszz-wx-spike\` **尚未创建**。
- 微信开发者工具**未下载、未安装、未启动**。
- 阶段 A / B / C **全部未开始**。
- 报告与交付链接**未产出**。

---

## 四、现成工具与用法

工作目录：`/vol1/ai/projects/wyszz-new/wechat-spike-ds/`

```bash
# 解释器（必须用这个 venv，里面有 mcp SDK 与 httpx2）
PY=/vol1/ai/windows-mcp/.venv/bin/python

cd /vol1/ai/projects/wyszz-new/wechat-spike-ds

$PY tools/wx.py list                      # 列出工具
$PY tools/wx.py ps '<powershell 命令>'     # 执行一条命令
$PY tools/wx.py psf tools/probe.ps1       # 把本地 .ps1 base64 送进去执行（免转义，推荐）
$PY tools/wx.py shot 截图名               # 截屏到 evidence/screenshots/截图名.png
$PY tools/wx.py snap                      # 桌面状态 + UI 元素树
$PY tools/wx.py fslist 'C:\projects'      # 列目录
$PY tools/wx.py fsread 'C:\path\file.txt' # 读文本
$PY tools/wx.py fswrite 'C:\path\x.ps1' local.ps1   # 写文件
$PY tools/wx.py raw ToolName '{"k":v}'    # 直调任意工具
```

**重要经验**：
- 脚本一律走 `psf`（base64 → 临时文件 → 执行），可彻底避免引号转义问题。
- **VM 内 PowerShell 5.1 会把「无 BOM 的 UTF-8 中文」按 ANSI 误读** → 下发脚本的**源码必须纯 ASCII**（输出中文没问题）。
  - 自检：`LC_ALL=C grep -nP '[^\x00-\x7F]' tools/xxx.ps1` 必须无输出。
- `wx.py` 环境变量：`WMCP_URL`（默认 `http://127.0.0.1:18000`）、`WMCP_KEYFILE`、`WMCP_EVIDENCE`。

已落盘证据：
- `evidence/logs/probe-01.txt` — OS/桌面/磁盘/显示/已装程序/Tencent 搜索/工具链/网络/外网
- `evidence/logs/probe-02.txt` — 内存、提权通道文件清单
- `evidence/logs/probe-03.txt` — 计划任务与动作

---

## 五、建议的下一步顺序

1. **建 Windows 测试目录**（先查后建，不得覆盖）：
   `C:\projects\wyszz-wx-spike\`
2. **取官方下载信息**：从微信官方开发者工具下载页确认当前 **Windows 稳定版**版本号与下载地址。
   - 官方页：`https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html`
   - 下载走 `https://servicewechat.com/wxa-dev-logic/download_redirect?...` 形式，**不要**用任何第三方镜像。
   - 记录：官方来源 URL、版本号、安装路径。
3. **在 VM 内下载**（客机外网已通，约 200–300 MB，用 `Invoke-WebRequest` 或 `curl.exe`）。
4. **安装**：若因 `IsAdmin=False` 失败，走第三节的提权通道；**不得**改安全设置、**不得**打非官方补丁。
5. **启动 + 截真实窗口**，确认项目界面可达。若需登录扫码 → **停下，按第五节要求向主控方说明并等待**。
6. 依次做**阶段 A → B → C**，B 失败则停下浮空岛迁移并报确切原因。
7. 写报告进 `docs/`，截图进 `evidence/screenshots/`，日志进 `evidence/logs/`。
8. 所有实体成果用 `/vol1/ai/_scripts/deliver-link <绝对路径> "<标题>" "<说明>" ["<分类>"]` 登记，把 `https://files.hynixing.cn/dl/<id>` 给用户。

---

## 六、已知风险（务必先告知用户，不要默默绕开）

1. **无 GPU**：显卡是「Microsoft 基本显示适配器」，std VGA，驱动 10.0.20348.1，分辨率 1024×768。
   微信开发者工具的模拟器依赖图形渲染，**很可能无法正常渲染**。
   按用户规则：**必须报真实错误，不得绕过**（不得用浏览器页面嵌入或 WebView 冒充小游戏运行时）。
2. **内存偏紧**：仅剩约 **2.5 GB** 空闲，而开发者工具是 Electron 应用。宿主 NAS 总内存 15 GiB、已用约 12 GiB、可用约 2.9 GiB，**不要再开第二台虚拟机**。
3. **非提权会话**：安装大概率需要走提权通道，属既有基础设施，**不得破坏**。
4. **模拟器 ≠ 真机**：主控方扫码前，真机一律标「未验证」。

---

## 七、纪律

- **密钥**：`/vol1/ai/windows-mcp/.mcp-key` 只可使用，**不得打印、不得上传、不得写入任何交付物**。`/vol1/ai/windows-mcp/NAS接入配置.md`（含真 key）**不要读**。
- **不得上传**：凭据、登录二维码、任何身份信息。
- **不得改动**：Cloudflare / DNS / 隧道 / systemd / NAS 权限 / 共享 / 路由器 / 防火墙。
- **不得触碰**：`3d-spike-ds/`（含其部署脚本与公网配置凭据）、MIMO 目录、`app/`、`little-town/`。
- **本轮不新增任何公网服务**。
- 完成后停止，不进入经济系统开发。

---

## 八、交接时状态快照

```
/vol1/ai/projects/wyszz-new/wechat-spike-ds/
├── docs/                        （空）
├── evidence/
│   ├── logs/probe-01.txt
│   ├── logs/probe-02.txt
│   └── logs/probe-03.txt
├── evidence/screenshots/        （空）
├── tools/probe.ps1
├── tools/wx.py
└── win/                         （空）

公网原型   https://mayor3d.hynixing.cn/  -> 200
winvm-mcp  active/enabled     wmcp-netsvc  active/enabled
wyszz-3d-spike-preview  active/enabled
MCP 端点   http://127.0.0.1:18000/mcp/   -> 401（在线）
```
