用途：处理 HarmonyOS 设备避让区适配，统一应对系统栏、导航栏、挖孔区、软键盘与沉浸式布局带来的遮挡问题，适用于 phone / tablet / 2in1 / tv。不涉及与系统区域无关的普通间距调整和纯业务交互逻辑。
主要能力：按四个场景组织。AVOID-01 避让区域识别与动态获取，涉及 AvoidAreaType、TYPE_SYSTEM、TYPE_NAVIGATION_INDICATOR、TYPE_CUTOUT、TYPE_KEYBOARD；AVOID-02 安全区扩展与背景延伸，涉及 expandSafeArea、SafeAreaType、SafeAreaEdge；AVOID-03 沉浸式全屏布局，涉及 setWindowLayoutFullScreen、状态栏透明、列表沉浸；AVOID-04 软键盘避让与输入区稳定性，涉及 keyboardAvoidMode、avoidAreaChange。
使用方式：先明确避让区域类型，再选择动态检测、安全区扩展或沉浸式方案。禁止硬编码系统栏、挖孔区或键盘尺寸，应优先用 API 动态获取。沉浸式需同时说明背景延伸与内容避让策略；软键盘需覆盖弹出、收起、焦点变化三类时机。按 REQ、DEV、FIX、VAL 阶段输出对应字段，如 device_constraints、implementation_notes、fix_plan、verification_matrix 等，并引用对应资源文件（如 ./references/avoid_area_types.md、safe_area_api.md、immersive_layout.md、keyboard_handling.md、bug-fix-cases.md、scenario-development-cases.md）。
限制：关键内容与核心点击区不得放入挖孔区或不可交互区域；未说明异常回退策略前不得宣称方案完整；验证阶段需提供系统栏变化、键盘开闭或挖孔方向变化的截图或录屏证据。具体 API 用法与代码示例以官方文档为准，本资料未提供完整代码。