hmos-multidevice-hardware-access

name	hmos-multidevice-hardware-access
description	Handle HarmonyOS hardware-capability adaptation through a declarative scene and resource index. Use when the task involves camera selection, camera rotation/stride/foldable adaptation, canIUse or SysCap checks, hardware fallback strategy, or multi-device hardware behavior differences.
metadata	{"version":"1.0.1","keywords":["硬件调用适配","硬件能力检测","SysCap","canIUse","module.json5","相机选择","camera selection","相机枚举","相机旋转","预览旋转","拍照旋转","stride花屏","硬件降级","能力降级","多设备硬件差异"]}

硬件调用适配

技能定义

字段	内容
skill_id	hardware-access
skill_name	硬件调用适配
one_line_purpose	为硬件能力检测与相机适配提供统一接入与降级策略。
device_scope	phone / tablet / 2in1 / wearable / tv
problem_scope	SysCap、canIUse、相机枚举、折叠态相机重建、预览旋转、拍照旋转、stride花屏
not_in_scope	与硬件无关的纯 UI 布局问题、无能力差异的普通业务逻辑、视频编解码与流媒体、第三方相机库
primary_outputs	primary_scene、device_constraints、code_touchpoints、fix_plan、verification_matrix

核心约束

通用硬件约束

1. 先做能力检测，再调用相关 API。

2. 涉及系统能力时，必须同时检查 canIUse() 和 module.json5 声明。

3. SysCap 粒度约束：SysCap 是设备级别的能力标识，不细分到具体传感器类型。canIUse 传入的字符串必须与 SDK device-define/*.json 中定义的完全一致，禁止自行拼接细粒度后缀。常见正确/错误对照：

   正确 SysCap	错误写法（不存在）
   SystemCapability.Sensors.MiscDevice	SystemCapability.Sensors.MiscDevice.Vibrator
   SystemCapability.Sensors.Sensor	SystemCapability.Sensors.Sensor.Accelerometer / SystemCapability.Sensors.Sensor.Gravity
   SystemCapability.Multimedia.Camera.Core	SystemCapability.Multimedia.Camera.Core.Front

   不确定 SysCap 字符串时，须查阅 SDK device-define/phone.json 等文件确认。

4. 涉及相机时优先枚举设备，不要硬编码相机 ID。

5. 输出方案必须包含"不支持时怎么降级、隐藏、替代或提示"。

6. VAL 阶段路由强制要求：当验证涉及折叠设备多形态验证、hidumper 模拟、分辨率阶梯验证时，不得在本 SKILL 内自行执行验证操作（如直接调用 hdc 截屏、尝试悬浮窗等），必须按以下步骤路由：

• 读取 ../hmos-multidevice-scenario-entry/references/multi-device-verification.md
• 按文档中的标准流程执行验证

相机专用约束

1. 折叠态切换必须重建相机：监听 foldStatusChange，重新枚举设备、重建 XComponent 与预览流。半折叠态（悬停态）为过渡状态，正常场景跳过，仅 HW-02-hover 场景处理。
2. stride 必须比对 width：ImageReceiver 取帧时 rowStride ≠ width 须去除无效像素防花屏，stride 不可硬编码。
3. Surface 宽高比匹配旋转后比例：display.rotation 0°/180° 时宽高比取倒数，90°/270° 时相同。拉伸/压缩归本约束，花屏堆叠归约束 2。
4. 预览旋转 = 安装角 + 屏幕旋转：推荐 getPreviewRotation()，后摄 90° + Display.rotation×90°，前摄 270° + Display.rotation×90°。
5. 拍照旋转依赖重力传感器：后摄 90° + 重力方向，前摄 270° - 重力方向；capture() 须设置 rotation。
6. 阔折叠外屏仅前置：外屏切换时须处理后置不可用回退。
7. 旋转策略按断点区分：sm 不旋转，md/lg 支持旋转（窗口最小维度 ≥ 600vp）。
8. 2in1 相机：大部分仅前置内置，外接摄像头不在此范围。

阶段标签

标签	阶段	当前模块关注点
REQ	需求分析设计	能力边界、设备差异、降级策略、相机能力与折叠态适配范围
DEV	开发	检测入口、枚举逻辑、生命周期绑定、折叠态相机重建、stride 处理、旋转角度计算
FIX	问题修复	无能力崩溃、相机选择错误、预览花屏、旋转异常
VAL	功能验证	canIUse 结果、设备枚举结果、降级行为、连接切换证据、相机功能全设备验证

输出规范

进行场景路由时，输出路由阶段字段。各场景按 phase_tags 继承对应阶段的交付物字段。deliverables: standard 时输出以下全部字段。

阶段	字段	说明
路由	primary_phase	当前主要聚焦阶段，决定输出主线方向
路由	primary_scene	命中的主场景 ID（如 HW-01、HW-02-stride 等）
路由	secondary_scenes	关联的协同分析场景 ID
路由	resources_used	实际加载的参考文档资源 ID 列表
REQ	device_constraints	硬件能力差异约束：哪些设备具备目标硬件、检测前置条件、降级/隐藏/替代策略；相机场景含 stride 值与折叠态限制
REQ	capability_boundary	当前方案支持与不支持的硬件能力组合，需枚举或声明校验的能力清单
REQ	acceptance_focus	需求验收时须确认的能力检测结果、降级路径与设备切换行为
DEV	code_touchpoints	需修改或新增的代码位置及文件路径（调用入口、枚举逻辑、生命周期绑定、module.json5 声明等）
DEV	reuse_resources	可直接复用或稍作扩展的现有代码、配置、工具函数
DEV	implementation_notes	API 调用顺序、线程安全、生命周期依赖等实现注意点
DEV	integration_risks	改动可能引发的跨模块联动影响（如影响其他页面相机生命周期）
FIX	problem_profile	缺陷完整画像：症状、复现步骤、影响设备和版本、是否必现
FIX	root_cause_hypothesis	基于日志/堆栈/代码审查的最可能根因
FIX	fix_plan	修复步骤与代码变更清单（含 module.json5 声明修改）
FIX	regression_watchlist	修复后须重点回归的功能点与设备组合
VAL	verification_matrix	覆盖多设备类型与多场景的测试用例矩阵
VAL	evidence_requirements	需采集的证据（canIUse 截图、枚举日志、预览效果、折叠切换日志等）
VAL	pass_criteria	可验证的验收基准（如"所有设备预览无花屏""折叠切换无崩溃"）
VAL	residual_risks	验证后仍存在的已知限制（如部分设备未覆盖）

决策树

decision_tree:
  entry_point: root
  matching_mode: depth_first_then_halt
  disambiguation: declaration_order

  nodes:
    root:
      branches:
        - condition: {type: keywords_any, values: [canIUse, SystemCapability, SysCap, module.json5, 不支持, 能力检测, 功能降级, 硬件能力, 功能入口], intent: 判断设备是否支持某硬件能力、不支持时功能入口展示/隐藏}
          action: {invoke_scene: HW-01}

        - condition: {type: keywords_any, values: [相机, 拍照, 预览, 摄像头, 前置, 后置, 折叠, 旋转, stride, 花屏, 枚举, 黑屏, 拍照旋转, 录像, 折叠屏, foldStatus, rowStride, getPreviewRotation, capture, 拉伸, ImageReceiver], intent: 相机选择、预览、旋转、折叠态切换或 stride 处理}
          action: {invoke_scene: HW-02, description: 命中后由 HW-02 子路由规则进一步分发}

        - condition: {type: fallback}
          action: {prompt_user: "无法自动判定，请确认：能力检测(HW-01) / 相机适配(HW-02) / 超出范围"}

  fallback_rules:
    - 场景不存在时回退至上一级节点重新匹配
    - root 回退耗尽时提示用户明确场景类型

场景索引

HW-01 能力检测与功能降级

scene_id: HW-01
scene_name: 能力检测与功能降级
phase_tags: [REQ, DEV, FIX, VAL]
intent_signals:
  - canIUse
  - SystemCapability
  - SysCap
  - module.json5
  - 不支持
applies_when:
  - 需要判断设备是否支持某硬件能力
  - 当前问题表现为不支持设备上仍显示功能入口或直接调用崩溃
not_applies_when:
  - 当前功能不依赖任何设备硬件差异
decisions:
  REQ:
    - 确认当前功能依赖哪些 SysCap，列出 must-have 与 nice-to-have 清单
    - 评估不支持设备上的降级路径（隐藏/置灰/替代/提示）的合理性与完整性
    - 检查 module.json5 声明与 canIUse() 调用点是否一一对应，杜绝无声明调用
  DEV:
    - 参考 syscap_mechanism.md 示例代码实现能力检测入口，遵循 canIUse() 调用时机规范
    - 在可能崩溃的调用路径之前完成检测，避免检测后置
    - 复用现有降级组件或工具函数，避免各页面重复实现不支持逻辑
  FIX:
    - 定位无能力崩溃的调用栈，反向追溯缺失的能力检测点
    - 比照正反例确认修复方案覆盖所有同类调用入口
    - 检查 module.json5 声明是否遗漏，补齐后再验证
  VAL:
    - 在声明的 device_scope 设备上验证 canIUse 结果与预期一致
    - 确认不支持设备上功能入口已按预期隐藏/置灰/替代/提示
    - 验证降级后其他功能路径无链式崩溃
deliverables: standard
resource_refs:
  - RSC_HW_01
  - RSC_HW_07

HW-02 相机选择、预览与形态切换

scene_id: HW-02
scene_name: 相机选择、预览与形态切换
phase_tags: [REQ, DEV, FIX, VAL]
intent_signals:
  - 相机枚举
  - 前置相机
  - 后置相机
  - 预览旋转
  - 折叠屏相机
  - 花屏
  - stride
  - 拍照旋转
  - 录像角度
applies_when:
  - 需要拍照、预览、切前后摄或适配不同设备形态下的相机行为
  - 当前问题表现为默认相机错误、预览角度不对或设备切换后相机失效
  - 折叠状态变化导致相机设备不可用、黑屏
  - 预览流花屏、堆叠状偏移
  - 预览/拍照/录像旋转角度异常
not_applies_when:
  - 当前功能不使用相机
decisions:
  REQ:
    - 梳理目标设备类型（phone/tablet/2in1/foldable）的相机硬件差异
    - 评估相机枚举策略在全场景下的覆盖度（前/后摄、折叠切换、外屏）
    - 确认相机约束文档的技术边界是否与当前需求对齐
  DEV:
    - 参考 camera-foldable-adaptation.md 实现相机枚举和设备重建逻辑
    - 遵循 stride 处理、旋转角度计算的 API 调用规范和最佳实践
    - 确保 XComponent 和预览流的生命周期与折叠态变化事件正确绑定
  FIX:
    - 通过日志/堆栈定位相机选择错误或切换崩溃的具体调用链
    - 参考正反例代码片段区分根因类别（折叠态/stride/旋转/枚举错误）
    - 确认修复不引入新的折叠态感知或方向感知问题
  VAL:
    - 在所有目标设备类型上验证相机枚举结果正确
    - 确认折叠切换后相机无黑屏、预览无花屏、旋转角度准确
    - 验证阔折叠外屏/2in1 回退策略按预期生效
sub_scenes:
  - HW-02-bugfix: 相机问题修复（含正反例代码片段）
  - HW-02-fold: 折叠屏相机设备选择与重建
  - HW-02-stride: 预览流 stride 处理防花屏
  - HW-02-rotation: 预览/拍照/录像旋转角度适配
deliverables: standard
resource_refs:
  - RSC_HW_02
  - RSC_HW_03
  - RSC_HW_04
  - RSC_HW_05
  - RSC_HW_06

HW-02 子场景说明

子场景	说明	关键验收点
HW-02-bugfix	完整问题修复场景（含正反例代码片段）。命中时根据根因关键词（折叠/花屏/旋转）按需触发对应子场景协同加载。无匹配时不加载	问题是否解决 + 匹配到的关联场景无回归
HW-02-fold	折叠状态变化时相机设备选择与重建。覆盖阔折叠外屏仅前置、2in1 内置相机等特殊场景	折叠态切换无黑屏、相机设备正确重建
HW-02-stride	通过 ImageReceiver 获取预览流每帧数据做二次处理时，正确处理 stride 内存对齐	stride ≠ width 时像素处理正确，无花屏堆叠
HW-02-rotation	预览/拍照/录像旋转角度获取与设置、Surface 宽高比计算	预览方向正确、无拉伸

HW-02 路由规则

routing_rules:
  - keywords: [相机, 问题, 修复]
    sub_scene: HW-02-bugfix
    auto_load_concepts: [RSC_HW_03]
    co_load_scenes:
      - scene_id: HW-02-fold
        trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]
      - scene_id: HW-02-stride
        trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]
      - scene_id: HW-02-rotation
        trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]
    co_load_strategy: keyword_triggered
    co_load_error_handling: partial_graceful
  - keywords: [折叠, 折叠屏, foldStatus, 相机切换, PuraX, 外屏, 折叠后相机不可用]
    sub_scene: HW-02-fold
    auto_load_concepts: [RSC_HW_02]
  - keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap, 预览花屏]
    sub_scene: HW-02-stride
    auto_load_concepts: [RSC_HW_04]
  - keywords: [旋转, 方向, 角度, getPreviewRotation, setPreviewRotation, capture(rotation), 预览拉伸, Surface宽高比, 预览画面压缩, 相机旋转]
    sub_scene: HW-02-rotation
    auto_load_concepts: [RSC_HW_05, RSC_HW_06]

HW-02-bugfix 相机问题修复

scene_id: HW-02-bugfix
scene_name: 相机问题修复
phase_tags: [DEV, FIX, VAL]
intent_signals:
  - 问题修复
  - bug
  - 正例
  - 反例
  - 崩溃
  - 异常
  - 黑屏
  - 花屏
  - 旋转异常
applies_when:
  - 相机相关功能出现 bug 需要定位修复
  - 需要参考正反例代码片段
  - 需要区分根因、问题场景和解决方案
not_applies_when:
  - 仅做需求分析阶段
  - 不涉及相机
co_load_scenes:
  - scene_id: HW-02-fold
    trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]
    reason: 根因涉及折叠态切换，需加载折叠屏适配场景确认无黑屏/设备未切换/回退策略回归
    on_failure: warn_continue
  - scene_id: HW-02-stride
    trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]
    reason: 根因涉及 stride 内存对齐，需加载 stride 处理场景确认无花屏/行偏移回归
    on_failure: warn_continue
  - scene_id: HW-02-rotation
    trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]
    reason: 根因涉及旋转角度适配，需加载旋转场景确认无方向错误/画面拉伸回归
    on_failure: warn_continue
co_load_strategy: keyword_triggered
co_load_match_rule: 根据用户提示词中的关键词与各子场景 trigger_keywords 做交集匹配，匹配即加载；无匹配时不加载任何协同场景
co_load_error_strategy: partial_graceful
co_load_error_message_template: "[HW-02-bugfix] 协同加载子场景 {scene_id} 失败: {reason}。已加载 {loaded_count}/{total_count} 个子场景，可继续修复但建议单独验证 {failed_scenes}。"
decisions:
  DEV:
    - 参考 camera-bug-fix-cases.md 中的正例代码实现修复，避免反例模式
    - 遵循相机核心约束中的 API 调用规范，确保修复不破坏现有设备兼容性
    - 对照最佳实践检查修复代码与现有架构的一致性
  FIX:
    - 归类问题根因（折叠态重建/stride 内存对齐/旋转角度/枚举错误）
    - 比照正反例代码片段选择对应修复策略
    - 排查同类问题是否在项目其他调用路径上存在
    - 触发修复时根据根因关键词匹配对应的协同加载子场景（撑→HW-02-fold / 花屏→HW-02-stride / 旋转→HW-02-rotation），执行匹配到的子场景 FIX 阶段 decisions 检查项作为回归验证基线
  VAL:
    - 在 bug 报告的设备型号和系统版本上验证修复生效
    - 回归验证关联子场景（折叠切换/旋转/stride）无新增问题
    - 确认正反例文档中列出的所有问题模式已覆盖验证
deliverables: standard
resource_refs:
  - RSC_HW_03

HW-02-fold 折叠屏相机设备选择与重建

scene_id: HW-02-fold
scene_name: 折叠屏相机设备选择与重建
phase_tags: [REQ, DEV, FIX, VAL]
intent_signals:
  - 折叠
  - 折叠屏
  - foldStatus
  - 相机切换
  - PuraX
  - 外屏
  - 折叠后相机不可用
  - 2in1
applies_when:
  - 折叠状态变化导致相机设备不可用、黑屏
  - 阔折叠外屏（如 PuraX）仅有前置相机
  - 2in1 设备相机适配
  - 热启动相机恢复
not_applies_when:
  - 当前功能不使用相机
  - 设备不支持折叠
decisions:
  REQ:
    - 梳理目标折叠设备（阔折叠/普通折叠/2in1）的相机硬件配置差异
    - 评估折叠态变化（展开→折叠→半折叠）时的相机设备切换方案可行性
    - 确认阔折叠外屏仅前置、2in1 内置相机等特殊约束边界
  DEV:
    - 参考 camera-foldable-adaptation.md 实现 foldStatusChange 监听与相机重建
    - 遵循半折叠态过渡处理规范，正常场景跳过、仅 HW-02-hover 场景处理
    - 实现阔折叠外屏后置不可用时的前置回退逻辑
  FIX:
    - 定位折叠切换后黑屏/不可用的具体触发路径
    - 区分根因：未监听 foldStatus / 重建时机错误 / 相机 ID 硬编码
    - 确认修复后热启动恢复功能正常
  VAL:
    - 在阔折叠和普通折叠设备上验证展开/折叠/半折叠全路径
    - 确认折叠切换后相机设备正确重建、预览无黑屏
    - 验证外屏仅前置场景的回退策略按预期生效
deliverables: standard
resource_refs:
  - RSC_HW_02

HW-02-stride 预览流 stride 处理防花屏

scene_id: HW-02-stride
scene_name: 预览流 stride 处理防花屏
phase_tags: [DEV, FIX, VAL]
intent_signals:
  - 花屏
  - stride
  - 堆叠状
  - 内存对齐
  - rowStride
  - PixelMap
  - 预览花屏
applies_when:
  - 通过 ImageReceiver 获取预览帧数据做二次处理
  - stride 与 width 不一致导致花屏堆叠
not_applies_when:
  - 不涉及 ImageReceiver 帧数据处理
  - 画面拉伸/压缩（归旋转约束）
decisions:
  DEV:
    - 参考 camera-stride-handling.md 实现 rowStride 与 width 比对逻辑
    - 遵循无效像素去除的最佳实践，避免硬编码 stride 值
    - 确保处理逻辑适配不同平台的 stride 差异
  FIX:
    - 定位花屏（堆叠状偏移）对应的 stride 处理缺失点
    - 区分根因：stride 硬编码 / 未比对 width / 未去除无效像素
    - 确认修复覆盖所有 ImageReceiver 帧数据处理入口
  VAL:
    - 在多设备上验证 stride ≠ width 时无花屏堆叠
    - 确认去除无效像素后图像质量符合预期
    - 验证 stride == width 时不引入额外处理开销
deliverables: standard
resource_refs:
  - RSC_HW_04

HW-02-rotation 相机旋转角度适配

scene_id: HW-02-rotation
scene_name: 相机旋转角度适配
phase_tags: [REQ, DEV, FIX, VAL]
intent_signals:
  - 旋转
  - 方向
  - 角度
  - getPreviewRotation
  - setPreviewRotation
  - capture(rotation)
  - 预览拉伸
  - Surface宽高比
  - 预览画面压缩
  - 相机旋转
  - 拍照旋转
  - 录像角度
applies_when:
  - 预览/拍照/录像旋转角度异常
  - Surface 宽高比不匹配导致画面拉伸
  - 拍照方向错误
not_applies_when:
  - 当前功能不使用相机
decisions:
  REQ:
    - 梳理预览旋转/拍照旋转/录像旋转三个层次的各自需求与依赖关系
    - 评估 Surface 宽高比与旋转角度的数学关系在不同设备上的适用性
    - 确认 sm/md/lg 断点旋转策略差异的约束边界
  DEV:
    - 参考 camera-rotation-adaptation.md 实现 getPreviewRotation/setPreviewRotation 调用
    - 遵循拍照旋转依赖重力传感器的计算规范，确保 capture() 时设置正确 rotation
    - 实现 Surface 宽高比随 display.rotation 动态调整逻辑
  FIX:
    - 定位旋转异常的具体表现：预览方向错误/拍照角度错误/画面拉伸
    - 区分根因：旋转角度计算错误/宽高比不匹配/capture 未传 rotation
    - 确认修复后预览、拍照、录像三个路径旋转一致
  VAL:
    - 在 0°/90°/180°/270° 四个方向上验证预览和拍照角度准确
    - 确认 Surface 宽高比随旋转动态调整，无画面拉伸或压缩
    - 验证 sm 断点设备不旋转行为符合预期
deliverables: standard
resource_refs:
  - RSC_HW_05
  - RSC_HW_06

资源索引

通用硬件资源

RSC_HW_01 能力检测参考

resource_id: RSC_HW_01
path: ./references/syscap_mechanism.md
used_for:
  - 定义 SysCap 和 canIUse 的检测边界
  - 设计功能展示、降级和异常提示策略
load_when:
  - 命中 HW-01
avoid_when:
  - 当前功能不依赖硬件差异

RSC_HW_07 传感器权限与类型映射参考

resource_id: RSC_HW_07
path: ./references/sensor-overview.md
used_for:
  - 传感器类型与权限名映射（ACCELEROMETER/GYROSCOPE/PEDOMETER/HEART_RATE 等）
  - 敏感级别判断（system_grant vs user_grant）决定运行时是否需动态请求权限
  - SensorId 枚举值速查，确保 sensor.on() 第一个参数使用正确枚举
  - 传感器坐标系与运作机制参考
  - API 接口速查（on/once/off/getSensorList/getSingleSensorSync 等）
  - 传感器动态上下线监听（sensorStatusChange），对应 syscap_mechanism.md 第 3 步
  - SensorInfoParam 多设备场景参数（deviceId/sensorIndex）
  - 采样周期 interval 约束与功耗关系
  - 完整开发步骤代码示例（权限配置→导入→查询→订阅→取消）
load_when:
  - 命中 HW-01 且涉及传感器能力检测
  - 涉及 sensor API 调用需确认权限声明
avoid_when:
  - 当前不涉及传感器

相机资源

RSC_HW_02 适配不同折叠状态的摄像头变更技术方案参考

resource_id: RSC_HW_02
path: ./references/camera-foldable-adaptation.md
used_for:
  - 设计相机枚举、默认选择和预览行为
  - 多设备环境下的相机设备选择逻辑
  - 阔折叠外屏/2in1 设备相机回退策略
  - 热启动相机恢复
load_when:
  - 命中 HW-02-fold
avoid_when:
  - 当前不涉及相机

RSC_HW_03 相机问题修复场景库

resource_id: RSC_HW_03
path: ./references/camera-bug-fix-cases.md
used_for:
  - 相机问题定位与修复
  - 正反例代码片段参考
  - 区分根因、问题场景和解决方案
load_when:
  - 命中 HW-02-bugfix
avoid_when:
  - 当前不涉及相机

RSC_HW_04 预览流 stride 处理参考

resource_id: RSC_HW_04
path: ./references/camera-stride-handling.md
used_for:
  - 处理预览流 stride 内存对齐导致的相机花屏
  - ImageReceiver 二次处理场景
load_when:
  - 命中 HW-02-stride
avoid_when:
  - 不涉及 ImageReceiver 帧数据处理

RSC_HW_05 相机旋转角度适配参考

resource_id: RSC_HW_05
path: ./references/camera-rotation-adaptation.md
used_for:
  - 预览旋转角度获取与设置
  - Surface 宽高比计算
  - 拍照旋转角度计算
  - 录像旋转角度设置
load_when:
  - 命中 HW-02-rotation
  - 出现预览拉伸、拍照方向异常
avoid_when:
  - 不涉及旋转角度问题

RSC_HW_06 相机旋转角度术语参考

resource_id: RSC_HW_06
path: ./references/camera-rotation-terms.md
used_for:
  - 理解相机旋转相关角度概念和术语
  - 作为角度适配的概念基线
  - 角度概念混淆排查
load_when:
  - 命中 HW-02-rotation
  - 需求分析阶段涉及相机旋转
avoid_when:
  - 仅需实现代码，不涉及角度问题