同步资源画布当前文档合同

修正 PRD 详情态保留的现役画布动作

更新自由画板 viewport 与资源 extent 的无限画布语义

docs/project-memory/shared-memory/pitfalls.md

@@ -4827,10 +4827,10 @@
 - 画布内部 absolute overlay 只能覆盖宿主网格，嵌在左右分栏时不会遮住整个窗口。阻断性失败必须 portal 到 `document.body`，并用 fixed inset 覆盖整个 WebView；测试应验证 portal 的直接宿主和 fullscreen modifier。
 
 
-## 自由画板只限制缩放比例不能防止资源整体离屏（2026-08-21）
+## 自由画板 viewport 与资源 extent 分离（2026-08-24）
 
-- 只依赖共享画布的全局 `MIN_SCALE/MAX_SCALE`，或只在“复位”时 fit，不会约束滚轮和平移拖拽；用户仍能把整个资源世界移到视口外。每一个 viewport 写入口都必须经过同一个边界函数，容器尺寸和资源 extent 改变后也要重新约束。
-- 隐藏边界不能从搜索后的 `visibleResources` 派生，否则输入搜索词会突然收缩边界并跳动 viewport。应使用全项目布局 positions、真实卡片尺寸和分区世界 extent，搜索只控制渲染与连线可见性。
+- 非空资源栏目使用无限画布：普通平移的 `x / y` 不按资源 extent 夹取，窗口 resize、媒体测量和资源 extent 变化也不得把用户 viewport 拉回内容边界；共享 `MIN_SCALE/MAX_SCALE` 只约束缩放比例。只有首次进入组合或用户显式复位时，才用真实卡片包围盒计算 fit。
+- 持久化布局坐标仍受 `-1_000_000..=1_000_000` 合同限制，负坐标必须进入真实内容包围盒和显式 fit；这与 viewport 能否继续平移是两层独立语义。搜索只控制卡片与连线可见性，不删除、压缩或重排布局坐标，也不能让 viewport 随 `visibleResources` 收缩跳动。
 
 ## 素材画布旧提交不能只按当前状态猜测恢复（2026-08-22）