更新经验清单，新增2026-03-10团队架构/运维约定，最后更新日期调整至2026-03-10。

.cursor/agent/团队/evolution/2026-03-10.md

@@ -0,0 +1,77 @@
+# 团队共享 经验记录 - 2026-03-10
+
+## 在 Windows 上一键启动 macOS 虚拟机（“龙虾”智能体经验）
+
+### 场景 / 问题
+
+- 成员希望在 **Windows 10/11** 上通过 **Docker** 一键安装 macOS，用于演示 / 测试。
+- 实际上：
+  - **macOS 不能在 Docker 中运行**（Docker 只跑 Linux 容器，没有合法的 macOS 镜像）。
+  - 唯一可行路径是：**WSL2 + Ubuntu + QEMU/KVM + OneClick-macOS-Simple-KVM**。
+
+### 关键决策
+
+1. **明确技术与法律边界**
+   - 不支持也不承诺在 Docker 中直接跑 macOS。
+   - 统一采用「**WSL2 + QEMU/KVM + OneClick**」这个方案，仅用于演示 / 测试。
+
+2. **固定目录与流程约定**
+   - Windows 侧统一放在：`C:\Users\{USERNAME}\Mycontent\macos-vm`
+   - WSL 侧路径：`/mnt/c/Users/{USERNAME}/Mycontent/macos-vm`
+   - 内部结构：
+     - `OneClick-macOS-Simple-KVM/`
+     - `BaseSystem.dmg` / `BaseSystem.img`
+     - `macOS.qcow2`
+
+3. **获取 OneClick 源码时优先走 zip，而不是 git clone**
+   - 直接 `git clone` 很容易在国内网络环境下触发 `GnuTLS recv error (-110)` 等 TLS 超时。
+   - 统一约定使用：
+     - `https://codeload.github.com/notAperson535/OneClick-macOS-Simple-KVM/zip/refs/heads/master`
+   - 然后在 WSL 中：
+     - `curl + unzip` → 解压 → 重命名为 `OneClick-macOS-Simple-KVM`。
+
+4. **依赖安装与 KVM 检查**
+   - 在 Ubuntu-24.04 内安装：
+     - `qemu-system qemu-utils python3 python3-pip cpu-checker`
+   - 使用 `kvm-ok` 检查：
+     - 期望输出：`/dev/kvm exists` + `KVM acceleration can be used`。
+   - 若 `nested` 为 `N` 且需要嵌套虚拟化，使用 `.wslconfig` 打开 nested。
+
+5. **下载 macOS Ventura 恢复镜像并生成 BaseSystem.img**
+   - 通过 `python3 fetch-macOS-v2.py -s ventura` 下载官方 Recovery 镜像。
+   - 将 `RecoveryImage.dmg` 重命名为 `BaseSystem.dmg`，再用 `qemu-img convert` 生成 `BaseSystem.img`。
+   - 验收标准：
+     - `BaseSystem.dmg` ≈ 678 MB
+     - `BaseSystem.img` ≈ 3.0 GB
+
+6. **以 HEADLESS + VNC 方式启动 VM**
+   - 使用 `sudo HEADLESS=1 ./basic.sh` 启动 QEMU。
+   - 在 Windows 中确认 `127.0.0.1:5900` 端口监听。
+   - 统一告知使用 VNC 客户端连接 `localhost:5900`，再在图形界面内完成 macOS 安装向导。**用户环境已采用 TightVNC**，与 RealVNC Viewer 等方式等效。
+
+7. **WSL 卡死与多 wsl 进程清理策略**
+   - 当 `wsl --shutdown` 卡住、或者有大量 `wsl` 进程残留时：
+     - 使用 PowerShell `Get-Process wsl | Stop-Process -Force` 清理。
+     - 再执行 `wsl --shutdown` + `wsl -l -v` 验证状态恢复。
+
+### 对应 Skill / 智能体
+
+- 新建 Skill：`.cursor/skills/lobster-macos-vm/SKILL.md`
+  - 技能名：`lobster-macos-vm`
+  - 智能体名（对外）：**“龙虾”**
+  - 职责：当用户在 Windows 上提出安装 / 维护 macOS 虚拟机的需求时，统一按该 Skill 流程执行：
+    - 解释 Docker 不可用 → 切换到 WSL2 + QEMU 方案。
+    - 固定目录 → 下载 OneClick → 安装依赖 → 下载 Ventura → 生成 `BaseSystem.img` → HEADLESS 启动 → 引导 VNC 安装。
+
+- 计划脚本化：
+  - 在 `开发文档/服务器管理/scripts/lobster_macos_vm.py` 中实现一键部署脚本，封装上述流程，供“龙虾”及人类成员复用。
+
+### 用户环境补充
+
+- **VNC 客户端**：当前环境使用 **TightVNC** 连接 `localhost:5900`，已写入龙虾 Skill，后续回复可一并推荐 TightVNC / RealVNC / TigerVNC 等。
+
+### 适用角色
+
+- 后端 / 运维：需要在本地或服务器上快速拉起 macOS VM 做兼容性验证或演示。
+- 团队：对外说明 **“我们不支持 Docker macOS，统一用龙虾方案”**。
+

.cursor/agent/开发助理/经验清单.md

@@ -25,6 +25,7 @@
 | 2026-02-27 | 小程序、团队 | 最佳实践 | SKILL-小程序开发 §6、SKILL-管理端开发 §4.1 | 输入框 padding 用 view/div 包裹 |
 | 2026-02-28 | 小程序、管理端 | 最佳实践 | miniprogram §6、admin §4.1 | input 边距口诀「外边包 view、内部 width 100%」；match 弹窗已修正 |
 | 2026-03-03 | 小程序 | 最佳实践 | miniprogram §8 | 我的页面卡片区边距 16rpx，个人中心类页面布局规范 |
+| 2026-03-10 | 团队 | 架构/运维约定 | lobster-macos-vm Skill | Windows 上统一使用 WSL2+QEMU+OneClick 的“龙虾”方案安装 macOS 虚拟机，禁止 Docker 直跑 macOS |
 
 ---
 
@@ -35,4 +36,4 @@
 
 ---
 
-**最后更新**：2026-03-03
+**最后更新**：2026-03-10