docs: document pnpm EACCES issue on WSL2 Windows filesystem

pnpm fails with permission denied during atomic rename on /mnt/d/ (NTFS).
Solution: keep app/ on WSL2 native fs (~/fire_goal/app/).

- 04-风险与避坑.md: add as 三级坑 with cause, fix, and principle
- 03-架构设计.md: add WSL2 native path requirement with HBuilderX access path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs/04-风险与避坑.md

@@ -35,6 +35,10 @@ rpx 换算、iOS 安全区、状态栏、**键盘顶起输入框**、滚动穿
 
 ## 🟢 三级坑：知道即可
 
+- **pnpm 在 /mnt/d/ 上权限报错（已踩）**：WSL2 挂载的 Windows NTFS 磁盘（`/mnt/d/`）不支持原子重命名操作，pnpm install 时报 `EACCES: permission denied, rename ...`。
+  - **解决**：把 `app/` 移到 WSL2 原生文件系统（`~/fire_goal/app/`），pnpm 在原生 fs 上无此问题；Windows 侧通过 `\\wsl$\Ubuntu\home\用户名\fire_goal\app` 访问（HBuilderX 云打包用此路径）。
+  - **原则**：开发目录放 WSL2 原生 fs（`~`），文档/配置等只读文件可留 `/mnt/d/`。
+
 - **nvue 陷阱**：只支持 flex、CSS 受限、与 vue 混用割裂 → **全程用普通 vue 页面，不碰 nvue**。
 - **插件市场质量参差**：收费/失修/文档差，跨端 bug 难定位 → 少依赖第三方原生插件。
 - **HBuilderX 耦合**：云打包/原生插件偏 GUI；CLI 项目导入偶有适配问题 → 用 HBuilderX 友好的结构搭项目。