chore: checkpoint pi lab rust integration work

scripts/TESTING_REFERENCE.md

@@ -10,6 +10,7 @@
 - 2026-05-20 起，默认主入口固定按 `http://127.0.0.1:3000` 理解；历史记录里的 `3001` 只代表当时临时 mnote-web 实例，不再作为默认验收入口。
 - 历史 smoke 分为 `current` 与 `retired/debug` 两类维护；退役脚本不应进入默认回归，除非脚本自身要求显式环境变量。
 - 2026-05-27 起，默认 smoke 基线只覆盖 `3000 Rust SSR + leptos-tiptap + local-first` 主路径；Convex export、Convex 兼容、Next、3104、BlockNote 默认路径脚本不再放在默认候选里。
+- 依赖 `/api/dev/seed` 的 browser smoke 默认使用 `npm run dev:hot`；`dev:hot` 默认启用 `MNOTE_WEB_ALLOW_DEV_FIXTURES=1`，`desktop:hot` 与生产启动仍默认关闭。修改 Node 启动脚本或环境变量后必须重启 `dev:hot` 主进程，不能只等待 cargo-watch 重载 Rust。
 
 ## 0. 当前 smoke 状态清单
 
@@ -152,6 +153,13 @@ node scripts/task490-runtime-surfaces-smoke.js
 
 后续新脚本优先复用这些 helper，不要在每个任务里再复制一套登录和清理逻辑。
 
+#### Dev seed 启动契约
+
+- 需要 `setupWorkspaceAccess`、`seedAiPolicy`、`seedAiRuntime` 等测试数据准备能力时，先确认服务由 `npm run dev:hot` 启动。
+- `npm run dev:hot` 默认开启 dev fixtures；可用 `MNOTE_WEB_ALLOW_DEV_FIXTURES=0 npm run dev:hot` 显式关闭。
+- `npm run desktop:hot` 保持生产近似的安全默认，不自动开放 `/api/dev/seed`；确需复用时显式执行 `MNOTE_WEB_ALLOW_DEV_FIXTURES=1 npm run desktop:hot`。
+- smoke 遇到 `dev_seed_disabled` 时不得标记为“功能未验证后跳过”；应先按上述契约重启服务，再重新执行完整 smoke。
+
 ## 2. 当前推荐测试顺序
 
 对本项目，推荐不要一上来就跑最重的 UI 对标脚本，而是按下面顺序推进。