From beca3d8d52deead8bb8dc6a37f800b214b71ea8c Mon Sep 17 00:00:00 2001
From: HIsheR <shawn1440982358@163.com>
Date: Mon, 26 Oct 2026 23:22:36 +0800
Subject: [PATCH] =?UTF-8?q?iter(g293):=20=E6=B5=AE=E5=B1=82=E5=AE=9A?=
 =?UTF-8?q?=E4=BD=8D=E5=8F=A3=E5=BE=84=E5=86=99=E5=85=A5=E5=BC=BA=E5=88=B6?=
 =?UTF-8?q?=E7=BA=A6=E5=AE=9A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ARCHITECTURE.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 8edf46a..cf312dd 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -17,6 +17,11 @@ tools/*       工程层：只在构建期读各包 ua.manifest.json / tokens.jso
               不 import 任何运行时代码
 ```
 
+浮层定位是皮肤层内部的横切关注点，统一走 `packages/skin/ui/src/position.ts`：
+- `flip` / `flipSide`：按视口几何判定上下（四向）翻转，只在**打开那一刻**算一次；
+- `trackShift(onShift)`：展开期间的位移跟随——捕获阶段监听 scroll（容器滚动不冒泡）与 resize，rAF 节流，返回释放函数；
+- 各弹层（tooltip / select / autoComplete / cascader / colorPicker / datePicker / timePicker / menu / multiSelect）一律「打开算一次 + 展开期间 trackShift + 收起调释放函数」，只写「打开算一次」的版本会在用户滚动后把弹层压到视口边缘。
+
 ## 目录结构
 
 ```