refactor: 收口公共AppBar组件

AGENTS.md

@@ -8,6 +8,7 @@
 
 - 保持项目结构简单、易懂、易修改
 - 使用 `Taro + React + TypeScript` 作为核心技术栈
+- 明确这是“微信小程序”项目，不是原生 App 或 H5 项目
 - 所有说明尽量使用中文
 - 在保证可运行的前提下，减少复杂依赖
 
@@ -51,9 +52,27 @@
   - 底部导航
   - 列表项
   - 状态块
+- 图标使用保持语义统一：
+  - 如果页面有“返回上一级页面”操作，优先使用 `back.svg`
+  - 如果页面有“加号/新增”操作，优先使用 `add.svg`
 - 如果一个结构或样式在两个及以上页面/区域重复出现，优先抽成可复用组件，而不是复制粘贴。
 - 组件设计尽量保持“样式可配置、职责单一、命名清晰”，避免做过度复杂的大而全组件。
 
+## 小程序设计适配约定
+
+- 本项目是微信小程序，后续收到的设计稿即使来自 App，也不能直接按 App 页面生搬硬套。
+- 设计稿如果是 App 视觉稿，落地时必须同时考虑：
+  - 手机系统状态栏安全区
+  - 微信小程序原生胶囊按钮区域
+  - 微信小程序页面顶部 appbar 的可用空间
+- 顶部按钮、标题、搜索框、头像、返回区等靠近页面顶部的元素，优先基于小程序原生 `statusBarHeight`、`getMenuButtonBoundingClientRect()` 等信息定位，而不是只按设计稿静态像素值摆放。
+- 当 App 设计稿顶部结构与微信小程序原生导航区域冲突时，优先保证小程序可用性和对齐关系，再尽量还原设计视觉。
+- 页面评审时，顶部区域要重点检查这几项：
+  - 是否遮挡原生胶囊
+  - 是否与原生胶囊水平对齐
+  - 是否预留了不同机型的顶部安全区
+  - 是否在真机上仍然成立
+
 ## 修改边界
 
 - 可以新增或修改当前工作区内与本项目直接相关的文件。