[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75ZGSFM52YMHY5Y3WK379BR":3,"skill-same:01M75ZGSFM52YMHY5Y3WK379BR":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M75ZGSFM52YMHY5Y3WK379BR","hmos-multidevice-hardware-access",null,"Handle HarmonyOS hardware-capability adaptation through a declarative scene and resource index. Use when the task involves camera selection, camera rotation\u002Fstride\u002Ffoldable adaptation, canIUse or SysCap checks, hardware fallback strategy, or multi-device hardware behavior differences.","IsKenKenYa\u002Fskills","IsKenKenYa","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F92219680?v=4","01M75Z8AFJBVH1Y9JJWRT35P0Z","是小啃啃呀","01M75Z8AG6RVC5RF6KTJQ7PQKQ",3,"GPL-3.0","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: hmos-multidevice-hardware-access\ndescription: Handle HarmonyOS hardware-capability adaptation through a declarative scene and resource index. Use when the task involves camera selection, camera rotation\u002Fstride\u002Ffoldable adaptation, canIUse or SysCap checks, hardware fallback strategy, or multi-device hardware behavior differences.\nmetadata:\n  version: 1.0.1\n  keywords:\n    - 硬件调用适配\n    - 硬件能力检测\n    - SysCap\n    - canIUse\n    - module.json5\n    - 相机选择\n    - camera selection\n    - 相机枚举\n    - 相机旋转\n    - 预览旋转\n    - 拍照旋转\n    - stride花屏\n    - 硬件降级\n    - 能力降级\n    - 多设备硬件差异\n---\n\n# 硬件调用适配\n\n## 技能定义\n\n| 字段                 | 内容                                                                                       |\n| ------------------ | ---------------------------------------------------------------------------------------- |\n| `skill_id`         | `hardware-access`                                                                        |\n| `skill_name`       | `硬件调用适配`                                                                                 |\n| `one_line_purpose` | 为硬件能力检测与相机适配提供统一接入与降级策略。                                                        |\n| `device_scope`     | `phone \u002F tablet \u002F 2in1 \u002F wearable \u002F tv`                                      |\n| `problem_scope`    | `SysCap、canIUse、相机枚举、折叠态相机重建、预览旋转、拍照旋转、stride花屏`                 |\n| `not_in_scope`     | `与硬件无关的纯 UI 布局问题、无能力差异的普通业务逻辑、视频编解码与流媒体、第三方相机库`                                          |\n| `primary_outputs`  | `primary_scene`、`device_constraints`、`code_touchpoints`、`fix_plan`、`verification_matrix` |\n\n## 核心约束\n\n### 通用硬件约束\n\n1. 先做能力检测，再调用相关 API。\n2. 涉及系统能力时，必须同时检查 `canIUse()` 和 `module.json5` 声明。\n3. **SysCap 粒度约束**：SysCap 是设备级别的能力标识，不细分到具体传感器类型。canIUse 传入的字符串必须与 SDK `device-define\u002F*.json` 中定义的完全一致，禁止自行拼接细粒度后缀。常见正确\u002F错误对照：\n\n   | 正确 SysCap | 错误写法（不存在） |\n   |---|---|\n   | `SystemCapability.Sensors.MiscDevice` | ~~`SystemCapability.Sensors.MiscDevice.Vibrator`~~ |\n   | `SystemCapability.Sensors.Sensor` | ~~`SystemCapability.Sensors.Sensor.Accelerometer`~~ \u002F ~~`SystemCapability.Sensors.Sensor.Gravity`~~ |\n   | `SystemCapability.Multimedia.Camera.Core` | ~~`SystemCapability.Multimedia.Camera.Core.Front`~~ |\n\n   不确定 SysCap 字符串时，须查阅 SDK `device-define\u002Fphone.json` 等文件确认。\n4. 涉及相机时优先枚举设备，不要硬编码相机 ID。\n5. 输出方案必须包含\"不支持时怎么降级、隐藏、替代或提示\"。\n6. **VAL 阶段路由强制要求**：当验证涉及折叠设备多形态验证、hidumper 模拟、分辨率阶梯验证时，**不得在本 SKILL 内自行执行验证操作**（如直接调用 hdc 截屏、尝试悬浮窗等），必须按以下步骤路由：\n- 读取 `..\u002Fhmos-multidevice-scenario-entry\u002Freferences\u002Fmulti-device-verification.md`\n- 按文档中的标准流程执行验证\n\n### 相机专用约束\n\n1. **折叠态切换必须重建相机**：监听 `foldStatusChange`，重新枚举设备、重建 XComponent 与预览流。半折叠态（悬停态）为过渡状态，正常场景跳过，仅 HW-02-hover 场景处理。\n2. **stride 必须比对 width**：ImageReceiver 取帧时 `rowStride ≠ width` 须去除无效像素防花屏，stride 不可硬编码。\n3. **Surface 宽高比匹配旋转后比例**：`display.rotation` 0°\u002F180° 时宽高比取倒数，90°\u002F270° 时相同。拉伸\u002F压缩归本约束，花屏堆叠归约束 2。\n4. **预览旋转 = 安装角 + 屏幕旋转**：推荐 `getPreviewRotation()`，后摄 90° + `Display.rotation×90°`，前摄 270° + `Display.rotation×90°`。\n5. **拍照旋转依赖重力传感器**：后摄 `90° + 重力方向`，前摄 `270° - 重力方向`；`capture()` 须设置 `rotation`。\n6. **阔折叠外屏仅前置**：外屏切换时须处理后置不可用回退。\n7. **旋转策略按断点区分**：sm 不旋转，md\u002Flg 支持旋转（窗口最小维度 ≥ 600vp）。\n8. **2in1 相机**：大部分仅前置内置，外接摄像头不在此范围。\n\n## 阶段标签\n\n| 标签    | 阶段     | 当前模块关注点                                   |\n| ----- | ------ | ----------------------------------------- |\n| `REQ` | 需求分析设计 | 能力边界、设备差异、降级策略、相机能力与折叠态适配范围               |\n| `DEV` | 开发     | 检测入口、枚举逻辑、生命周期绑定、折叠态相机重建、stride 处理、旋转角度计算 |\n| `FIX` | 问题修复   | 无能力崩溃、相机选择错误、预览花屏、旋转异常        |\n| `VAL` | 功能验证   | canIUse 结果、设备枚举结果、降级行为、连接切换证据、相机功能全设备验证   |\n\n## 输出规范\n\n进行场景路由时，输出路由阶段字段。各场景按 `phase_tags` 继承对应阶段的交付物字段。`deliverables: standard` 时输出以下全部字段。\n\n| 阶段 | 字段 | 说明 |\n| --- | --- | --- |\n| 路由 | `primary_phase` | 当前主要聚焦阶段，决定输出主线方向 |\n| 路由 | `primary_scene` | 命中的主场景 ID（如 HW-01、HW-02-stride 等） |\n| 路由 | `secondary_scenes` | 关联的协同分析场景 ID |\n| 路由 | `resources_used` | 实际加载的参考文档资源 ID 列表 |\n| `REQ` | `device_constraints` | 硬件能力差异约束：哪些设备具备目标硬件、检测前置条件、降级\u002F隐藏\u002F替代策略；相机场景含 stride 值与折叠态限制 |\n| `REQ` | `capability_boundary` | 当前方案支持与不支持的硬件能力组合，需枚举或声明校验的能力清单 |\n| `REQ` | `acceptance_focus` | 需求验收时须确认的能力检测结果、降级路径与设备切换行为 |\n| `DEV` | `code_touchpoints` | 需修改或新增的代码位置及文件路径（调用入口、枚举逻辑、生命周期绑定、module.json5 声明等） |\n| `DEV` | `reuse_resources` | 可直接复用或稍作扩展的现有代码、配置、工具函数 |\n| `DEV` | `implementation_notes` | API 调用顺序、线程安全、生命周期依赖等实现注意点 |\n| `DEV` | `integration_risks` | 改动可能引发的跨模块联动影响（如影响其他页面相机生命周期） |\n| `FIX` | `problem_profile` | 缺陷完整画像：症状、复现步骤、影响设备和版本、是否必现 |\n| `FIX` | `root_cause_hypothesis` | 基于日志\u002F堆栈\u002F代码审查的最可能根因 |\n| `FIX` | `fix_plan` | 修复步骤与代码变更清单（含 module.json5 声明修改） |\n| `FIX` | `regression_watchlist` | 修复后须重点回归的功能点与设备组合 |\n| `VAL` | `verification_matrix` | 覆盖多设备类型与多场景的测试用例矩阵 |\n| `VAL` | `evidence_requirements` | 需采集的证据（canIUse 截图、枚举日志、预览效果、折叠切换日志等） |\n| `VAL` | `pass_criteria` | 可验证的验收基准（如\"所有设备预览无花屏\"\"折叠切换无崩溃\"） |\n| `VAL` | `residual_risks` | 验证后仍存在的已知限制（如部分设备未覆盖） |\n\n\n## 决策树\n\n```yaml\ndecision_tree:\n  entry_point: root\n  matching_mode: depth_first_then_halt\n  disambiguation: declaration_order\n\n  nodes:\n    root:\n      branches:\n        - condition: {type: keywords_any, values: [canIUse, SystemCapability, SysCap, module.json5, 不支持, 能力检测, 功能降级, 硬件能力, 功能入口], intent: 判断设备是否支持某硬件能力、不支持时功能入口展示\u002F隐藏}\n          action: {invoke_scene: HW-01}\n\n        - condition: {type: keywords_any, values: [相机, 拍照, 预览, 摄像头, 前置, 后置, 折叠, 旋转, stride, 花屏, 枚举, 黑屏, 拍照旋转, 录像, 折叠屏, foldStatus, rowStride, getPreviewRotation, capture, 拉伸, ImageReceiver], intent: 相机选择、预览、旋转、折叠态切换或 stride 处理}\n          action: {invoke_scene: HW-02, description: 命中后由 HW-02 子路由规则进一步分发}\n\n        - condition: {type: fallback}\n          action: {prompt_user: \"无法自动判定，请确认：能力检测(HW-01) \u002F 相机适配(HW-02) \u002F 超出范围\"}\n\n  fallback_rules:\n    - 场景不存在时回退至上一级节点重新匹配\n    - root 回退耗尽时提示用户明确场景类型\n```\n\n## 场景索引\n\n#### `HW-01` 能力检测与功能降级\n\n```yaml\nscene_id: HW-01\nscene_name: 能力检测与功能降级\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - canIUse\n  - SystemCapability\n  - SysCap\n  - module.json5\n  - 不支持\napplies_when:\n  - 需要判断设备是否支持某硬件能力\n  - 当前问题表现为不支持设备上仍显示功能入口或直接调用崩溃\nnot_applies_when:\n  - 当前功能不依赖任何设备硬件差异\ndecisions:\n  REQ:\n    - 确认当前功能依赖哪些 SysCap，列出 must-have 与 nice-to-have 清单\n    - 评估不支持设备上的降级路径（隐藏\u002F置灰\u002F替代\u002F提示）的合理性与完整性\n    - 检查 module.json5 声明与 canIUse() 调用点是否一一对应，杜绝无声明调用\n  DEV:\n    - 参考 syscap_mechanism.md 示例代码实现能力检测入口，遵循 canIUse() 调用时机规范\n    - 在可能崩溃的调用路径之前完成检测，避免检测后置\n    - 复用现有降级组件或工具函数，避免各页面重复实现不支持逻辑\n  FIX:\n    - 定位无能力崩溃的调用栈，反向追溯缺失的能力检测点\n    - 比照正反例确认修复方案覆盖所有同类调用入口\n    - 检查 module.json5 声明是否遗漏，补齐后再验证\n  VAL:\n    - 在声明的 device_scope 设备上验证 canIUse 结果与预期一致\n    - 确认不支持设备上功能入口已按预期隐藏\u002F置灰\u002F替代\u002F提示\n    - 验证降级后其他功能路径无链式崩溃\ndeliverables: standard\nresource_refs:\n  - RSC_HW_01\n  - RSC_HW_07\n```\n\n#### `HW-02` 相机选择、预览与形态切换\n\n```yaml\nscene_id: HW-02\nscene_name: 相机选择、预览与形态切换\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 相机枚举\n  - 前置相机\n  - 后置相机\n  - 预览旋转\n  - 折叠屏相机\n  - 花屏\n  - stride\n  - 拍照旋转\n  - 录像角度\napplies_when:\n  - 需要拍照、预览、切前后摄或适配不同设备形态下的相机行为\n  - 当前问题表现为默认相机错误、预览角度不对或设备切换后相机失效\n  - 折叠状态变化导致相机设备不可用、黑屏\n  - 预览流花屏、堆叠状偏移\n  - 预览\u002F拍照\u002F录像旋转角度异常\nnot_applies_when:\n  - 当前功能不使用相机\ndecisions:\n  REQ:\n    - 梳理目标设备类型（phone\u002Ftablet\u002F2in1\u002Ffoldable）的相机硬件差异\n    - 评估相机枚举策略在全场景下的覆盖度（前\u002F后摄、折叠切换、外屏）\n    - 确认相机约束文档的技术边界是否与当前需求对齐\n  DEV:\n    - 参考 camera-foldable-adaptation.md 实现相机枚举和设备重建逻辑\n    - 遵循 stride 处理、旋转角度计算的 API 调用规范和最佳实践\n    - 确保 XComponent 和预览流的生命周期与折叠态变化事件正确绑定\n  FIX:\n    - 通过日志\u002F堆栈定位相机选择错误或切换崩溃的具体调用链\n    - 参考正反例代码片段区分根因类别（折叠态\u002Fstride\u002F旋转\u002F枚举错误）\n    - 确认修复不引入新的折叠态感知或方向感知问题\n  VAL:\n    - 在所有目标设备类型上验证相机枚举结果正确\n    - 确认折叠切换后相机无黑屏、预览无花屏、旋转角度准确\n    - 验证阔折叠外屏\u002F2in1 回退策略按预期生效\nsub_scenes:\n  - HW-02-bugfix: 相机问题修复（含正反例代码片段）\n  - HW-02-fold: 折叠屏相机设备选择与重建\n  - HW-02-stride: 预览流 stride 处理防花屏\n  - HW-02-rotation: 预览\u002F拍照\u002F录像旋转角度适配\ndeliverables: standard\nresource_refs:\n  - RSC_HW_02\n  - RSC_HW_03\n  - RSC_HW_04\n  - RSC_HW_05\n  - RSC_HW_06\n```\n\n##### HW-02 子场景说明\n\n| 子场景            | 说明                                                | 关键验收点                        |\n| -------------- | ------------------------------------------------- | ---------------------------- |\n| HW-02-bugfix   | 完整问题修复场景（含正反例代码片段）。命中时根据根因关键词（折叠\u002F花屏\u002F旋转）按需触发对应子场景协同加载。无匹配时不加载 | 问题是否解决 + 匹配到的关联场景无回归 |\n| HW-02-fold     | 折叠状态变化时相机设备选择与重建。覆盖阔折叠外屏仅前置、2in1 内置相机等特殊场景        | 折叠态切换无黑屏、相机设备正确重建            |\n| HW-02-stride   | 通过 ImageReceiver 获取预览流每帧数据做二次处理时，正确处理 stride 内存对齐 | stride ≠ width 时像素处理正确，无花屏堆叠 |\n| HW-02-rotation | 预览\u002F拍照\u002F录像旋转角度获取与设置、Surface 宽高比计算                   | 预览方向正确、无拉伸                   |\n\n##### HW-02 路由规则\n\n```yaml\nrouting_rules:\n  - keywords: [相机, 问题, 修复]\n    sub_scene: HW-02-bugfix\n    auto_load_concepts: [RSC_HW_03]\n    co_load_scenes:\n      - scene_id: HW-02-fold\n        trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]\n      - scene_id: HW-02-stride\n        trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]\n      - scene_id: HW-02-rotation\n        trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]\n    co_load_strategy: keyword_triggered\n    co_load_error_handling: partial_graceful\n  - keywords: [折叠, 折叠屏, foldStatus, 相机切换, PuraX, 外屏, 折叠后相机不可用]\n    sub_scene: HW-02-fold\n    auto_load_concepts: [RSC_HW_02]\n  - keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap, 预览花屏]\n    sub_scene: HW-02-stride\n    auto_load_concepts: [RSC_HW_04]\n  - keywords: [旋转, 方向, 角度, getPreviewRotation, setPreviewRotation, capture(rotation), 预览拉伸, Surface宽高比, 预览画面压缩, 相机旋转]\n    sub_scene: HW-02-rotation\n    auto_load_concepts: [RSC_HW_05, RSC_HW_06]\n```\n\n###### `HW-02-bugfix` 相机问题修复\n\n```yaml\nscene_id: HW-02-bugfix\nscene_name: 相机问题修复\nphase_tags: [DEV, FIX, VAL]\nintent_signals:\n  - 问题修复\n  - bug\n  - 正例\n  - 反例\n  - 崩溃\n  - 异常\n  - 黑屏\n  - 花屏\n  - 旋转异常\napplies_when:\n  - 相机相关功能出现 bug 需要定位修复\n  - 需要参考正反例代码片段\n  - 需要区分根因、问题场景和解决方案\nnot_applies_when:\n  - 仅做需求分析阶段\n  - 不涉及相机\nco_load_scenes:\n  - scene_id: HW-02-fold\n    trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]\n    reason: 根因涉及折叠态切换，需加载折叠屏适配场景确认无黑屏\u002F设备未切换\u002F回退策略回归\n    on_failure: warn_continue\n  - scene_id: HW-02-stride\n    trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]\n    reason: 根因涉及 stride 内存对齐，需加载 stride 处理场景确认无花屏\u002F行偏移回归\n    on_failure: warn_continue\n  - scene_id: HW-02-rotation\n    trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]\n    reason: 根因涉及旋转角度适配，需加载旋转场景确认无方向错误\u002F画面拉伸回归\n    on_failure: warn_continue\nco_load_strategy: keyword_triggered\nco_load_match_rule: 根据用户提示词中的关键词与各子场景 trigger_keywords 做交集匹配，匹配即加载；无匹配时不加载任何协同场景\nco_load_error_strategy: partial_graceful\nco_load_error_message_template: \"[HW-02-bugfix] 协同加载子场景 {scene_id} 失败: {reason}。已加载 {loaded_count}\u002F{total_count} 个子场景，可继续修复但建议单独验证 {failed_scenes}。\"\ndecisions:\n  DEV:\n    - 参考 camera-bug-fix-cases.md 中的正例代码实现修复，避免反例模式\n    - 遵循相机核心约束中的 API 调用规范，确保修复不破坏现有设备兼容性\n    - 对照最佳实践检查修复代码与现有架构的一致性\n  FIX:\n    - 归类问题根因（折叠态重建\u002Fstride 内存对齐\u002F旋转角度\u002F枚举错误）\n    - 比照正反例代码片段选择对应修复策略\n    - 排查同类问题是否在项目其他调用路径上存在\n    - 触发修复时根据根因关键词匹配对应的协同加载子场景（撑→HW-02-fold \u002F 花屏→HW-02-stride \u002F 旋转→HW-02-rotation），执行匹配到的子场景 FIX 阶段 decisions 检查项作为回归验证基线\n  VAL:\n    - 在 bug 报告的设备型号和系统版本上验证修复生效\n    - 回归验证关联子场景（折叠切换\u002F旋转\u002Fstride）无新增问题\n    - 确认正反例文档中列出的所有问题模式已覆盖验证\ndeliverables: standard\nresource_refs:\n  - RSC_HW_03\n```\n\n###### `HW-02-fold` 折叠屏相机设备选择与重建\n\n```yaml\nscene_id: HW-02-fold\nscene_name: 折叠屏相机设备选择与重建\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 折叠\n  - 折叠屏\n  - foldStatus\n  - 相机切换\n  - PuraX\n  - 外屏\n  - 折叠后相机不可用\n  - 2in1\napplies_when:\n  - 折叠状态变化导致相机设备不可用、黑屏\n  - 阔折叠外屏（如 PuraX）仅有前置相机\n  - 2in1 设备相机适配\n  - 热启动相机恢复\nnot_applies_when:\n  - 当前功能不使用相机\n  - 设备不支持折叠\ndecisions:\n  REQ:\n    - 梳理目标折叠设备（阔折叠\u002F普通折叠\u002F2in1）的相机硬件配置差异\n    - 评估折叠态变化（展开→折叠→半折叠）时的相机设备切换方案可行性\n    - 确认阔折叠外屏仅前置、2in1 内置相机等特殊约束边界\n  DEV:\n    - 参考 camera-foldable-adaptation.md 实现 foldStatusChange 监听与相机重建\n    - 遵循半折叠态过渡处理规范，正常场景跳过、仅 HW-02-hover 场景处理\n    - 实现阔折叠外屏后置不可用时的前置回退逻辑\n  FIX:\n    - 定位折叠切换后黑屏\u002F不可用的具体触发路径\n    - 区分根因：未监听 foldStatus \u002F 重建时机错误 \u002F 相机 ID 硬编码\n    - 确认修复后热启动恢复功能正常\n  VAL:\n    - 在阔折叠和普通折叠设备上验证展开\u002F折叠\u002F半折叠全路径\n    - 确认折叠切换后相机设备正确重建、预览无黑屏\n    - 验证外屏仅前置场景的回退策略按预期生效\ndeliverables: standard\nresource_refs:\n  - RSC_HW_02\n```\n\n###### `HW-02-stride` 预览流 stride 处理防花屏\n\n```yaml\nscene_id: HW-02-stride\nscene_name: 预览流 stride 处理防花屏\nphase_tags: [DEV, FIX, VAL]\nintent_signals:\n  - 花屏\n  - stride\n  - 堆叠状\n  - 内存对齐\n  - rowStride\n  - PixelMap\n  - 预览花屏\napplies_when:\n  - 通过 ImageReceiver 获取预览帧数据做二次处理\n  - stride 与 width 不一致导致花屏堆叠\nnot_applies_when:\n  - 不涉及 ImageReceiver 帧数据处理\n  - 画面拉伸\u002F压缩（归旋转约束）\ndecisions:\n  DEV:\n    - 参考 camera-stride-handling.md 实现 rowStride 与 width 比对逻辑\n    - 遵循无效像素去除的最佳实践，避免硬编码 stride 值\n    - 确保处理逻辑适配不同平台的 stride 差异\n  FIX:\n    - 定位花屏（堆叠状偏移）对应的 stride 处理缺失点\n    - 区分根因：stride 硬编码 \u002F 未比对 width \u002F 未去除无效像素\n    - 确认修复覆盖所有 ImageReceiver 帧数据处理入口\n  VAL:\n    - 在多设备上验证 stride ≠ width 时无花屏堆叠\n    - 确认去除无效像素后图像质量符合预期\n    - 验证 stride == width 时不引入额外处理开销\ndeliverables: standard\nresource_refs:\n  - RSC_HW_04\n```\n\n###### `HW-02-rotation` 相机旋转角度适配\n\n```yaml\nscene_id: HW-02-rotation\nscene_name: 相机旋转角度适配\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 旋转\n  - 方向\n  - 角度\n  - getPreviewRotation\n  - setPreviewRotation\n  - capture(rotation)\n  - 预览拉伸\n  - Surface宽高比\n  - 预览画面压缩\n  - 相机旋转\n  - 拍照旋转\n  - 录像角度\napplies_when:\n  - 预览\u002F拍照\u002F录像旋转角度异常\n  - Surface 宽高比不匹配导致画面拉伸\n  - 拍照方向错误\nnot_applies_when:\n  - 当前功能不使用相机\ndecisions:\n  REQ:\n    - 梳理预览旋转\u002F拍照旋转\u002F录像旋转三个层次的各自需求与依赖关系\n    - 评估 Surface 宽高比与旋转角度的数学关系在不同设备上的适用性\n    - 确认 sm\u002Fmd\u002Flg 断点旋转策略差异的约束边界\n  DEV:\n    - 参考 camera-rotation-adaptation.md 实现 getPreviewRotation\u002FsetPreviewRotation 调用\n    - 遵循拍照旋转依赖重力传感器的计算规范，确保 capture() 时设置正确 rotation\n    - 实现 Surface 宽高比随 display.rotation 动态调整逻辑\n  FIX:\n    - 定位旋转异常的具体表现：预览方向错误\u002F拍照角度错误\u002F画面拉伸\n    - 区分根因：旋转角度计算错误\u002F宽高比不匹配\u002Fcapture 未传 rotation\n    - 确认修复后预览、拍照、录像三个路径旋转一致\n  VAL:\n    - 在 0°\u002F90°\u002F180°\u002F270° 四个方向上验证预览和拍照角度准确\n    - 确认 Surface 宽高比随旋转动态调整，无画面拉伸或压缩\n    - 验证 sm 断点设备不旋转行为符合预期\ndeliverables: standard\nresource_refs:\n  - RSC_HW_05\n  - RSC_HW_06\n```\n\n## 资源索引\n\n### 通用硬件资源\n\n#### `RSC_HW_01` 能力检测参考\n\n```yaml\nresource_id: RSC_HW_01\npath: .\u002Freferences\u002Fsyscap_mechanism.md\nused_for:\n  - 定义 SysCap 和 canIUse 的检测边界\n  - 设计功能展示、降级和异常提示策略\nload_when:\n  - 命中 HW-01\navoid_when:\n  - 当前功能不依赖硬件差异\n```\n\n#### `RSC_HW_07` 传感器权限与类型映射参考\n\n```yaml\nresource_id: RSC_HW_07\npath: .\u002Freferences\u002Fsensor-overview.md\nused_for:\n  - 传感器类型与权限名映射（ACCELEROMETER\u002FGYROSCOPE\u002FPEDOMETER\u002FHEART_RATE 等）\n  - 敏感级别判断（system_grant vs user_grant）决定运行时是否需动态请求权限\n  - SensorId 枚举值速查，确保 sensor.on() 第一个参数使用正确枚举\n  - 传感器坐标系与运作机制参考\n  - API 接口速查（on\u002Fonce\u002Foff\u002FgetSensorList\u002FgetSingleSensorSync 等）\n  - 传感器动态上下线监听（sensorStatusChange），对应 syscap_mechanism.md 第 3 步\n  - SensorInfoParam 多设备场景参数（deviceId\u002FsensorIndex）\n  - 采样周期 interval 约束与功耗关系\n  - 完整开发步骤代码示例（权限配置→导入→查询→订阅→取消）\nload_when:\n  - 命中 HW-01 且涉及传感器能力检测\n  - 涉及 sensor API 调用需确认权限声明\navoid_when:\n  - 当前不涉及传感器\n```\n\n### 相机资源\n\n#### `RSC_HW_02` 适配不同折叠状态的摄像头变更技术方案参考\n\n```yaml\nresource_id: RSC_HW_02\npath: .\u002Freferences\u002Fcamera-foldable-adaptation.md\nused_for:\n  - 设计相机枚举、默认选择和预览行为\n  - 多设备环境下的相机设备选择逻辑\n  - 阔折叠外屏\u002F2in1 设备相机回退策略\n  - 热启动相机恢复\nload_when:\n  - 命中 HW-02-fold\navoid_when:\n  - 当前不涉及相机\n```\n\n#### `RSC_HW_03` 相机问题修复场景库\n\n```yaml\nresource_id: RSC_HW_03\npath: .\u002Freferences\u002Fcamera-bug-fix-cases.md\nused_for:\n  - 相机问题定位与修复\n  - 正反例代码片段参考\n  - 区分根因、问题场景和解决方案\nload_when:\n  - 命中 HW-02-bugfix\navoid_when:\n  - 当前不涉及相机\n```\n\n#### `RSC_HW_04` 预览流 stride 处理参考\n\n```yaml\nresource_id: RSC_HW_04\npath: .\u002Freferences\u002Fcamera-stride-handling.md\nused_for:\n  - 处理预览流 stride 内存对齐导致的相机花屏\n  - ImageReceiver 二次处理场景\nload_when:\n  - 命中 HW-02-stride\navoid_when:\n  - 不涉及 ImageReceiver 帧数据处理\n```\n\n#### `RSC_HW_05` 相机旋转角度适配参考\n\n```yaml\nresource_id: RSC_HW_05\npath: .\u002Freferences\u002Fcamera-rotation-adaptation.md\nused_for:\n  - 预览旋转角度获取与设置\n  - Surface 宽高比计算\n  - 拍照旋转角度计算\n  - 录像旋转角度设置\nload_when:\n  - 命中 HW-02-rotation\n  - 出现预览拉伸、拍照方向异常\navoid_when:\n  - 不涉及旋转角度问题\n```\n\n#### `RSC_HW_06` 相机旋转角度术语参考\n\n```yaml\nresource_id: RSC_HW_06\npath: .\u002Freferences\u002Fcamera-rotation-terms.md\nused_for:\n  - 理解相机旋转相关角度概念和术语\n  - 作为角度适配的概念基线\n  - 角度概念混淆排查\nload_when:\n  - 命中 HW-02-rotation\n  - 需求分析阶段涉及相机旋转\navoid_when:\n  - 仅需实现代码，不涉及角度问题\n```\n","# 硬件调用适配\n\n## 技能定义\n\n| 字段                 | 内容                                                                                       |\n| ------------------ | ---------------------------------------------------------------------------------------- |\n| `skill_id`         | `hardware-access`                                                                        |\n| `skill_name`       | `硬件调用适配`                                                                                 |\n| `one_line_purpose` | 为硬件能力检测与相机适配提供统一接入与降级策略。                                                        |\n| `device_scope`     | `phone \u002F tablet \u002F 2in1 \u002F wearable \u002F tv`                                      |\n| `problem_scope`    | `SysCap、canIUse、相机枚举、折叠态相机重建、预览旋转、拍照旋转、stride花屏`                 |\n| `not_in_scope`     | `与硬件无关的纯 UI 布局问题、无能力差异的普通业务逻辑、视频编解码与流媒体、第三方相机库`                                          |\n| `primary_outputs`  | `primary_scene`、`device_constraints`、`code_touchpoints`、`fix_plan`、`verification_matrix` |\n\n## 核心约束\n\n### 通用硬件约束\n\n1. 先做能力检测，再调用相关 API。\n2. 涉及系统能力时，必须同时检查 `canIUse()` 和 `module.json5` 声明。\n3. **SysCap 粒度约束**：SysCap 是设备级别的能力标识，不细分到具体传感器类型。canIUse 传入的字符串必须与 SDK `device-define\u002F*.json` 中定义的完全一致，禁止自行拼接细粒度后缀。常见正确\u002F错误对照：\n\n   | 正确 SysCap | 错误写法（不存在） |\n   |---|---|\n   | `SystemCapability.Sensors.MiscDevice` | ~~`SystemCapability.Sensors.MiscDevice.Vibrator`~~ |\n   | `SystemCapability.Sensors.Sensor` | ~~`SystemCapability.Sensors.Sensor.Accelerometer`~~ \u002F ~~`SystemCapability.Sensors.Sensor.Gravity`~~ |\n   | `SystemCapability.Multimedia.Camera.Core` | ~~`SystemCapability.Multimedia.Camera.Core.Front`~~ |\n\n   不确定 SysCap 字符串时，须查阅 SDK `device-define\u002Fphone.json` 等文件确认。\n4. 涉及相机时优先枚举设备，不要硬编码相机 ID。\n5. 输出方案必须包含\"不支持时怎么降级、隐藏、替代或提示\"。\n6. **VAL 阶段路由强制要求**：当验证涉及折叠设备多形态验证、hidumper 模拟、分辨率阶梯验证时，**不得在本 SKILL 内自行执行验证操作**（如直接调用 hdc 截屏、尝试悬浮窗等），必须按以下步骤路由：\n- 读取 `..\u002Fhmos-multidevice-scenario-entry\u002Freferences\u002Fmulti-device-verification.md`\n- 按文档中的标准流程执行验证\n\n### 相机专用约束\n\n1. **折叠态切换必须重建相机**：监听 `foldStatusChange`，重新枚举设备、重建 XComponent 与预览流。半折叠态（悬停态）为过渡状态，正常场景跳过，仅 HW-02-hover 场景处理。\n2. **stride 必须比对 width**：ImageReceiver 取帧时 `rowStride ≠ width` 须去除无效像素防花屏，stride 不可硬编码。\n3. **Surface 宽高比匹配旋转后比例**：`display.rotation` 0°\u002F180° 时宽高比取倒数，90°\u002F270° 时相同。拉伸\u002F压缩归本约束，花屏堆叠归约束 2。\n4. **预览旋转 = 安装角 + 屏幕旋转**：推荐 `getPreviewRotation()`，后摄 90° + `Display.rotation×90°`，前摄 270° + `Display.rotation×90°`。\n5. **拍照旋转依赖重力传感器**：后摄 `90° + 重力方向`，前摄 `270° - 重力方向`；`capture()` 须设置 `rotation`。\n6. **阔折叠外屏仅前置**：外屏切换时须处理后置不可用回退。\n7. **旋转策略按断点区分**：sm 不旋转，md\u002Flg 支持旋转（窗口最小维度 ≥ 600vp）。\n8. **2in1 相机**：大部分仅前置内置，外接摄像头不在此范围。\n\n## 阶段标签\n\n| 标签    | 阶段     | 当前模块关注点                                   |\n| ----- | ------ | ----------------------------------------- |\n| `REQ` | 需求分析设计 | 能力边界、设备差异、降级策略、相机能力与折叠态适配范围               |\n| `DEV` | 开发     | 检测入口、枚举逻辑、生命周期绑定、折叠态相机重建、stride 处理、旋转角度计算 |\n| `FIX` | 问题修复   | 无能力崩溃、相机选择错误、预览花屏、旋转异常        |\n| `VAL` | 功能验证   | canIUse 结果、设备枚举结果、降级行为、连接切换证据、相机功能全设备验证   |\n\n## 输出规范\n\n进行场景路由时，输出路由阶段字段。各场景按 `phase_tags` 继承对应阶段的交付物字段。`deliverables: standard` 时输出以下全部字段。\n\n| 阶段 | 字段 | 说明 |\n| --- | --- | --- |\n| 路由 | `primary_phase` | 当前主要聚焦阶段，决定输出主线方向 |\n| 路由 | `primary_scene` | 命中的主场景 ID（如 HW-01、HW-02-stride 等） |\n| 路由 | `secondary_scenes` | 关联的协同分析场景 ID |\n| 路由 | `resources_used` | 实际加载的参考文档资源 ID 列表 |\n| `REQ` | `device_constraints` | 硬件能力差异约束：哪些设备具备目标硬件、检测前置条件、降级\u002F隐藏\u002F替代策略；相机场景含 stride 值与折叠态限制 |\n| `REQ` | `capability_boundary` | 当前方案支持与不支持的硬件能力组合，需枚举或声明校验的能力清单 |\n| `REQ` | `acceptance_focus` | 需求验收时须确认的能力检测结果、降级路径与设备切换行为 |\n| `DEV` | `code_touchpoints` | 需修改或新增的代码位置及文件路径（调用入口、枚举逻辑、生命周期绑定、module.json5 声明等） |\n| `DEV` | `reuse_resources` | 可直接复用或稍作扩展的现有代码、配置、工具函数 |\n| `DEV` | `implementation_notes` | API 调用顺序、线程安全、生命周期依赖等实现注意点 |\n| `DEV` | `integration_risks` | 改动可能引发的跨模块联动影响（如影响其他页面相机生命周期） |\n| `FIX` | `problem_profile` | 缺陷完整画像：症状、复现步骤、影响设备和版本、是否必现 |\n| `FIX` | `root_cause_hypothesis` | 基于日志\u002F堆栈\u002F代码审查的最可能根因 |\n| `FIX` | `fix_plan` | 修复步骤与代码变更清单（含 module.json5 声明修改） |\n| `FIX` | `regression_watchlist` | 修复后须重点回归的功能点与设备组合 |\n| `VAL` | `verification_matrix` | 覆盖多设备类型与多场景的测试用例矩阵 |\n| `VAL` | `evidence_requirements` | 需采集的证据（canIUse 截图、枚举日志、预览效果、折叠切换日志等） |\n| `VAL` | `pass_criteria` | 可验证的验收基准（如\"所有设备预览无花屏\"\"折叠切换无崩溃\"） |\n| `VAL` | `residual_risks` | 验证后仍存在的已知限制（如部分设备未覆盖） |\n\n\n## 决策树\n\n```yaml\ndecision_tree:\n  entry_point: root\n  matching_mode: depth_first_then_halt\n  disambiguation: declaration_order\n\n  nodes:\n    root:\n      branches:\n        - condition: {type: keywords_any, values: [canIUse, SystemCapability, SysCap, module.json5, 不支持, 能力检测, 功能降级, 硬件能力, 功能入口], intent: 判断设备是否支持某硬件能力、不支持时功能入口展示\u002F隐藏}\n          action: {invoke_scene: HW-01}\n\n        - condition: {type: keywords_any, values: [相机, 拍照, 预览, 摄像头, 前置, 后置, 折叠, 旋转, stride, 花屏, 枚举, 黑屏, 拍照旋转, 录像, 折叠屏, foldStatus, rowStride, getPreviewRotation, capture, 拉伸, ImageReceiver], intent: 相机选择、预览、旋转、折叠态切换或 stride 处理}\n          action: {invoke_scene: HW-02, description: 命中后由 HW-02 子路由规则进一步分发}\n\n        - condition: {type: fallback}\n          action: {prompt_user: \"无法自动判定，请确认：能力检测(HW-01) \u002F 相机适配(HW-02) \u002F 超出范围\"}\n\n  fallback_rules:\n    - 场景不存在时回退至上一级节点重新匹配\n    - root 回退耗尽时提示用户明确场景类型\n```\n\n## 场景索引\n\n#### `HW-01` 能力检测与功能降级\n\n```yaml\nscene_id: HW-01\nscene_name: 能力检测与功能降级\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - canIUse\n  - SystemCapability\n  - SysCap\n  - module.json5\n  - 不支持\napplies_when:\n  - 需要判断设备是否支持某硬件能力\n  - 当前问题表现为不支持设备上仍显示功能入口或直接调用崩溃\nnot_applies_when:\n  - 当前功能不依赖任何设备硬件差异\ndecisions:\n  REQ:\n    - 确认当前功能依赖哪些 SysCap，列出 must-have 与 nice-to-have 清单\n    - 评估不支持设备上的降级路径（隐藏\u002F置灰\u002F替代\u002F提示）的合理性与完整性\n    - 检查 module.json5 声明与 canIUse() 调用点是否一一对应，杜绝无声明调用\n  DEV:\n    - 参考 syscap_mechanism.md 示例代码实现能力检测入口，遵循 canIUse() 调用时机规范\n    - 在可能崩溃的调用路径之前完成检测，避免检测后置\n    - 复用现有降级组件或工具函数，避免各页面重复实现不支持逻辑\n  FIX:\n    - 定位无能力崩溃的调用栈，反向追溯缺失的能力检测点\n    - 比照正反例确认修复方案覆盖所有同类调用入口\n    - 检查 module.json5 声明是否遗漏，补齐后再验证\n  VAL:\n    - 在声明的 device_scope 设备上验证 canIUse 结果与预期一致\n    - 确认不支持设备上功能入口已按预期隐藏\u002F置灰\u002F替代\u002F提示\n    - 验证降级后其他功能路径无链式崩溃\ndeliverables: standard\nresource_refs:\n  - RSC_HW_01\n  - RSC_HW_07\n```\n\n#### `HW-02` 相机选择、预览与形态切换\n\n```yaml\nscene_id: HW-02\nscene_name: 相机选择、预览与形态切换\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 相机枚举\n  - 前置相机\n  - 后置相机\n  - 预览旋转\n  - 折叠屏相机\n  - 花屏\n  - stride\n  - 拍照旋转\n  - 录像角度\napplies_when:\n  - 需要拍照、预览、切前后摄或适配不同设备形态下的相机行为\n  - 当前问题表现为默认相机错误、预览角度不对或设备切换后相机失效\n  - 折叠状态变化导致相机设备不可用、黑屏\n  - 预览流花屏、堆叠状偏移\n  - 预览\u002F拍照\u002F录像旋转角度异常\nnot_applies_when:\n  - 当前功能不使用相机\ndecisions:\n  REQ:\n    - 梳理目标设备类型（phone\u002Ftablet\u002F2in1\u002Ffoldable）的相机硬件差异\n    - 评估相机枚举策略在全场景下的覆盖度（前\u002F后摄、折叠切换、外屏）\n    - 确认相机约束文档的技术边界是否与当前需求对齐\n  DEV:\n    - 参考 camera-foldable-adaptation.md 实现相机枚举和设备重建逻辑\n    - 遵循 stride 处理、旋转角度计算的 API 调用规范和最佳实践\n    - 确保 XComponent 和预览流的生命周期与折叠态变化事件正确绑定\n  FIX:\n    - 通过日志\u002F堆栈定位相机选择错误或切换崩溃的具体调用链\n    - 参考正反例代码片段区分根因类别（折叠态\u002Fstride\u002F旋转\u002F枚举错误）\n    - 确认修复不引入新的折叠态感知或方向感知问题\n  VAL:\n    - 在所有目标设备类型上验证相机枚举结果正确\n    - 确认折叠切换后相机无黑屏、预览无花屏、旋转角度准确\n    - 验证阔折叠外屏\u002F2in1 回退策略按预期生效\nsub_scenes:\n  - HW-02-bugfix: 相机问题修复（含正反例代码片段）\n  - HW-02-fold: 折叠屏相机设备选择与重建\n  - HW-02-stride: 预览流 stride 处理防花屏\n  - HW-02-rotation: 预览\u002F拍照\u002F录像旋转角度适配\ndeliverables: standard\nresource_refs:\n  - RSC_HW_02\n  - RSC_HW_03\n  - RSC_HW_04\n  - RSC_HW_05\n  - RSC_HW_06\n```\n\n##### HW-02 子场景说明\n\n| 子场景            | 说明                                                | 关键验收点                        |\n| -------------- | ------------------------------------------------- | ---------------------------- |\n| HW-02-bugfix   | 完整问题修复场景（含正反例代码片段）。命中时根据根因关键词（折叠\u002F花屏\u002F旋转）按需触发对应子场景协同加载。无匹配时不加载 | 问题是否解决 + 匹配到的关联场景无回归 |\n| HW-02-fold     | 折叠状态变化时相机设备选择与重建。覆盖阔折叠外屏仅前置、2in1 内置相机等特殊场景        | 折叠态切换无黑屏、相机设备正确重建            |\n| HW-02-stride   | 通过 ImageReceiver 获取预览流每帧数据做二次处理时，正确处理 stride 内存对齐 | stride ≠ width 时像素处理正确，无花屏堆叠 |\n| HW-02-rotation | 预览\u002F拍照\u002F录像旋转角度获取与设置、Surface 宽高比计算                   | 预览方向正确、无拉伸                   |\n\n##### HW-02 路由规则\n\n```yaml\nrouting_rules:\n  - keywords: [相机, 问题, 修复]\n    sub_scene: HW-02-bugfix\n    auto_load_concepts: [RSC_HW_03]\n    co_load_scenes:\n      - scene_id: HW-02-fold\n        trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]\n      - scene_id: HW-02-stride\n        trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]\n      - scene_id: HW-02-rotation\n        trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]\n    co_load_strategy: keyword_triggered\n    co_load_error_handling: partial_graceful\n  - keywords: [折叠, 折叠屏, foldStatus, 相机切换, PuraX, 外屏, 折叠后相机不可用]\n    sub_scene: HW-02-fold\n    auto_load_concepts: [RSC_HW_02]\n  - keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap, 预览花屏]\n    sub_scene: HW-02-stride\n    auto_load_concepts: [RSC_HW_04]\n  - keywords: [旋转, 方向, 角度, getPreviewRotation, setPreviewRotation, capture(rotation), 预览拉伸, Surface宽高比, 预览画面压缩, 相机旋转]\n    sub_scene: HW-02-rotation\n    auto_load_concepts: [RSC_HW_05, RSC_HW_06]\n```\n\n###### `HW-02-bugfix` 相机问题修复\n\n```yaml\nscene_id: HW-02-bugfix\nscene_name: 相机问题修复\nphase_tags: [DEV, FIX, VAL]\nintent_signals:\n  - 问题修复\n  - bug\n  - 正例\n  - 反例\n  - 崩溃\n  - 异常\n  - 黑屏\n  - 花屏\n  - 旋转异常\napplies_when:\n  - 相机相关功能出现 bug 需要定位修复\n  - 需要参考正反例代码片段\n  - 需要区分根因、问题场景和解决方案\nnot_applies_when:\n  - 仅做需求分析阶段\n  - 不涉及相机\nco_load_scenes:\n  - scene_id: HW-02-fold\n    trigger_keywords: [折叠, 折叠屏, foldStatus, 相机切换, 外屏, 2in1]\n    reason: 根因涉及折叠态切换，需加载折叠屏适配场景确认无黑屏\u002F设备未切换\u002F回退策略回归\n    on_failure: warn_continue\n  - scene_id: HW-02-stride\n    trigger_keywords: [花屏, stride, 堆叠状, 内存对齐, rowStride, PixelMap]\n    reason: 根因涉及 stride 内存对齐，需加载 stride 处理场景确认无花屏\u002F行偏移回归\n    on_failure: warn_continue\n  - scene_id: HW-02-rotation\n    trigger_keywords: [旋转, 方向, 角度, 预览拉伸, 拍照方向, Surface宽高比, 录像方向]\n    reason: 根因涉及旋转角度适配，需加载旋转场景确认无方向错误\u002F画面拉伸回归\n    on_failure: warn_continue\nco_load_strategy: keyword_triggered\nco_load_match_rule: 根据用户提示词中的关键词与各子场景 trigger_keywords 做交集匹配，匹配即加载；无匹配时不加载任何协同场景\nco_load_error_strategy: partial_graceful\nco_load_error_message_template: \"[HW-02-bugfix] 协同加载子场景 {scene_id} 失败: {reason}。已加载 {loaded_count}\u002F{total_count} 个子场景，可继续修复但建议单独验证 {failed_scenes}。\"\ndecisions:\n  DEV:\n    - 参考 camera-bug-fix-cases.md 中的正例代码实现修复，避免反例模式\n    - 遵循相机核心约束中的 API 调用规范，确保修复不破坏现有设备兼容性\n    - 对照最佳实践检查修复代码与现有架构的一致性\n  FIX:\n    - 归类问题根因（折叠态重建\u002Fstride 内存对齐\u002F旋转角度\u002F枚举错误）\n    - 比照正反例代码片段选择对应修复策略\n    - 排查同类问题是否在项目其他调用路径上存在\n    - 触发修复时根据根因关键词匹配对应的协同加载子场景（撑→HW-02-fold \u002F 花屏→HW-02-stride \u002F 旋转→HW-02-rotation），执行匹配到的子场景 FIX 阶段 decisions 检查项作为回归验证基线\n  VAL:\n    - 在 bug 报告的设备型号和系统版本上验证修复生效\n    - 回归验证关联子场景（折叠切换\u002F旋转\u002Fstride）无新增问题\n    - 确认正反例文档中列出的所有问题模式已覆盖验证\ndeliverables: standard\nresource_refs:\n  - RSC_HW_03\n```\n\n###### `HW-02-fold` 折叠屏相机设备选择与重建\n\n```yaml\nscene_id: HW-02-fold\nscene_name: 折叠屏相机设备选择与重建\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 折叠\n  - 折叠屏\n  - foldStatus\n  - 相机切换\n  - PuraX\n  - 外屏\n  - 折叠后相机不可用\n  - 2in1\napplies_when:\n  - 折叠状态变化导致相机设备不可用、黑屏\n  - 阔折叠外屏（如 PuraX）仅有前置相机\n  - 2in1 设备相机适配\n  - 热启动相机恢复\nnot_applies_when:\n  - 当前功能不使用相机\n  - 设备不支持折叠\ndecisions:\n  REQ:\n    - 梳理目标折叠设备（阔折叠\u002F普通折叠\u002F2in1）的相机硬件配置差异\n    - 评估折叠态变化（展开→折叠→半折叠）时的相机设备切换方案可行性\n    - 确认阔折叠外屏仅前置、2in1 内置相机等特殊约束边界\n  DEV:\n    - 参考 camera-foldable-adaptation.md 实现 foldStatusChange 监听与相机重建\n    - 遵循半折叠态过渡处理规范，正常场景跳过、仅 HW-02-hover 场景处理\n    - 实现阔折叠外屏后置不可用时的前置回退逻辑\n  FIX:\n    - 定位折叠切换后黑屏\u002F不可用的具体触发路径\n    - 区分根因：未监听 foldStatus \u002F 重建时机错误 \u002F 相机 ID 硬编码\n    - 确认修复后热启动恢复功能正常\n  VAL:\n    - 在阔折叠和普通折叠设备上验证展开\u002F折叠\u002F半折叠全路径\n    - 确认折叠切换后相机设备正确重建、预览无黑屏\n    - 验证外屏仅前置场景的回退策略按预期生效\ndeliverables: standard\nresource_refs:\n  - RSC_HW_02\n```\n\n###### `HW-02-stride` 预览流 stride 处理防花屏\n\n```yaml\nscene_id: HW-02-stride\nscene_name: 预览流 stride 处理防花屏\nphase_tags: [DEV, FIX, VAL]\nintent_signals:\n  - 花屏\n  - stride\n  - 堆叠状\n  - 内存对齐\n  - rowStride\n  - PixelMap\n  - 预览花屏\napplies_when:\n  - 通过 ImageReceiver 获取预览帧数据做二次处理\n  - stride 与 width 不一致导致花屏堆叠\nnot_applies_when:\n  - 不涉及 ImageReceiver 帧数据处理\n  - 画面拉伸\u002F压缩（归旋转约束）\ndecisions:\n  DEV:\n    - 参考 camera-stride-handling.md 实现 rowStride 与 width 比对逻辑\n    - 遵循无效像素去除的最佳实践，避免硬编码 stride 值\n    - 确保处理逻辑适配不同平台的 stride 差异\n  FIX:\n    - 定位花屏（堆叠状偏移）对应的 stride 处理缺失点\n    - 区分根因：stride 硬编码 \u002F 未比对 width \u002F 未去除无效像素\n    - 确认修复覆盖所有 ImageReceiver 帧数据处理入口\n  VAL:\n    - 在多设备上验证 stride ≠ width 时无花屏堆叠\n    - 确认去除无效像素后图像质量符合预期\n    - 验证 stride == width 时不引入额外处理开销\ndeliverables: standard\nresource_refs:\n  - RSC_HW_04\n```\n\n###### `HW-02-rotation` 相机旋转角度适配\n\n```yaml\nscene_id: HW-02-rotation\nscene_name: 相机旋转角度适配\nphase_tags: [REQ, DEV, FIX, VAL]\nintent_signals:\n  - 旋转\n  - 方向\n  - 角度\n  - getPreviewRotation\n  - setPreviewRotation\n  - capture(rotation)\n  - 预览拉伸\n  - Surface宽高比\n  - 预览画面压缩\n  - 相机旋转\n  - 拍照旋转\n  - 录像角度\napplies_when:\n  - 预览\u002F拍照\u002F录像旋转角度异常\n  - Surface 宽高比不匹配导致画面拉伸\n  - 拍照方向错误\nnot_applies_when:\n  - 当前功能不使用相机\ndecisions:\n  REQ:\n    - 梳理预览旋转\u002F拍照旋转\u002F录像旋转三个层次的各自需求与依赖关系\n    - 评估 Surface 宽高比与旋转角度的数学关系在不同设备上的适用性\n    - 确认 sm\u002Fmd\u002Flg 断点旋转策略差异的约束边界\n  DEV:\n    - 参考 camera-rotation-adaptation.md 实现 getPreviewRotation\u002FsetPreviewRotation 调用\n    - 遵循拍照旋转依赖重力传感器的计算规范，确保 capture() 时设置正确 rotation\n    - 实现 Surface 宽高比随 display.rotation 动态调整逻辑\n  FIX:\n    - 定位旋转异常的具体表现：预览方向错误\u002F拍照角度错误\u002F画面拉伸\n    - 区分根因：旋转角度计算错误\u002F宽高比不匹配\u002Fcapture 未传 rotation\n    - 确认修复后预览、拍照、录像三个路径旋转一致\n  VAL:\n    - 在 0°\u002F90°\u002F180°\u002F270° 四个方向上验证预览和拍照角度准确\n    - 确认 Surface 宽高比随旋转动态调整，无画面拉伸或压缩\n    - 验证 sm 断点设备不旋转行为符合预期\ndeliverables: standard\nresource_refs:\n  - RSC_HW_05\n  - RSC_HW_06\n```\n\n## 资源索引\n\n### 通用硬件资源\n\n#### `RSC_HW_01` 能力检测参考\n\n```yaml\nresource_id: RSC_HW_01\npath: .\u002Freferences\u002Fsyscap_mechanism.md\nused_for:\n  - 定义 SysCap 和 canIUse 的检测边界\n  - 设计功能展示、降级和异常提示策略\nload_when:\n  - 命中 HW-01\navoid_when:\n  - 当前功能不依赖硬件差异\n```\n\n#### `RSC_HW_07` 传感器权限与类型映射参考\n\n```yaml\nresource_id: RSC_HW_07\npath: .\u002Freferences\u002Fsensor-overview.md\nused_for:\n  - 传感器类型与权限名映射（ACCELEROMETER\u002FGYROSCOPE\u002FPEDOMETER\u002FHEART_RATE 等）\n  - 敏感级别判断（system_grant vs user_grant）决定运行时是否需动态请求权限\n  - SensorId 枚举值速查，确保 sensor.on() 第一个参数使用正确枚举\n  - 传感器坐标系与运作机制参考\n  - API 接口速查（on\u002Fonce\u002Foff\u002FgetSensorList\u002FgetSingleSensorSync 等）\n  - 传感器动态上下线监听（sensorStatusChange），对应 syscap_mechanism.md 第 3 步\n  - SensorInfoParam 多设备场景参数（deviceId\u002FsensorIndex）\n  - 采样周期 interval 约束与功耗关系\n  - 完整开发步骤代码示例（权限配置→导入→查询→订阅→取消）\nload_when:\n  - 命中 HW-01 且涉及传感器能力检测\n  - 涉及 sensor API 调用需确认权限声明\navoid_when:\n  - 当前不涉及传感器\n```\n\n### 相机资源\n\n#### `RSC_HW_02` 适配不同折叠状态的摄像头变更技术方案参考\n\n```yaml\nresource_id: RSC_HW_02\npath: .\u002Freferences\u002Fcamera-foldable-adaptation.md\nused_for:\n  - 设计相机枚举、默认选择和预览行为\n  - 多设备环境下的相机设备选择逻辑\n  - 阔折叠外屏\u002F2in1 设备相机回退策略\n  - 热启动相机恢复\nload_when:\n  - 命中 HW-02-fold\navoid_when:\n  - 当前不涉及相机\n```\n\n#### `RSC_HW_03` 相机问题修复场景库\n\n```yaml\nresource_id: RSC_HW_03\npath: .\u002Freferences\u002Fcamera-bug-fix-cases.md\nused_for:\n  - 相机问题定位与修复\n  - 正反例代码片段参考\n  - 区分根因、问题场景和解决方案\nload_when:\n  - 命中 HW-02-bugfix\navoid_when:\n  - 当前不涉及相机\n```\n\n#### `RSC_HW_04` 预览流 stride 处理参考\n\n```yaml\nresource_id: RSC_HW_04\npath: .\u002Freferences\u002Fcamera-stride-handling.md\nused_for:\n  - 处理预览流 stride 内存对齐导致的相机花屏\n  - ImageReceiver 二次处理场景\nload_when:\n  - 命中 HW-02-stride\navoid_when:\n  - 不涉及 ImageReceiver 帧数据处理\n```\n\n#### `RSC_HW_05` 相机旋转角度适配参考\n\n```yaml\nresource_id: RSC_HW_05\npath: .\u002Freferences\u002Fcamera-rotation-adaptation.md\nused_for:\n  - 预览旋转角度获取与设置\n  - Surface 宽高比计算\n  - 拍照旋转角度计算\n  - 录像旋转角度设置\nload_when:\n  - 命中 HW-02-rotation\n  - 出现预览拉伸、拍照方向异常\navoid_when:\n  - 不涉及旋转角度问题\n```\n\n#### `RSC_HW_06` 相机旋转角度术语参考\n\n```yaml\nresource_id: RSC_HW_06\npath: .\u002Freferences\u002Fcamera-rotation-terms.md\nused_for:\n  - 理解相机旋转相关角度概念和术语\n  - 作为角度适配的概念基线\n  - 角度概念混淆排查\nload_when:\n  - 命中 HW-02-rotation\n  - 需求分析阶段涉及相机旋转\navoid_when:\n  - 仅需实现代码，不涉及角度问题\n```\n",{"name":5,"metadata":24,"description":7},{"version":25,"keywords":26},"1.0.1",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"硬件调用适配","硬件能力检测","SysCap","canIUse","module.json5","相机选择","camera selection","相机枚举","相机旋转","预览旋转","拍照旋转","stride花屏","硬件降级","能力降级","多设备硬件差异","main","581098187aec1258c6d9e65e1b9866c2e7381167","skills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access",0,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills","https:\u002F\u002Fgithub.com\u002FIsKenKenYa","是小啃啃呀-一个初学者，中国开源共享推动者之一。\r\n未来，会涉及OpenHarmony、HarmonyOS（部分应用开源）、Android Open Sources Project等。\r\n\r\n目前正在学习中，欢迎友善的讨论。","2026-10-08 01:02:25",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-hardware-access",{"tool":56,"command":57},"bunx","bunx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-hardware-access",{"tool":59,"command":60},"pnpm","pnpm dlx skills add IsKenKenYa\u002Fskills --skill hmos-multidevice-hardware-access","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002FSKILL.md",true,[64,70,76,80,84],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"assets\u002FCameraFoldable.ets","ASSET","资产文件",14373,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002Fassets\u002FCameraFoldable.ets",{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"test-cases\u002Freal-world\u002Freal-world-hardware-access.json","REFERENCE","参考文档",18660,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002Ftest-cases\u002Freal-world\u002Freal-world-hardware-access.json",{"path":77,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":78,"sourceHtmlUrl":79},"test-cases\u002Fscene-functional\u002Fscene-functional-hardware-access.json",7688,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002Ftest-cases\u002Fscene-functional\u002Fscene-functional-hardware-access.json",{"path":81,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":82,"sourceHtmlUrl":83},"test-cases\u002Fsmoke\u002Fsmoke-hardware-access.json",9249,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002Ftest-cases\u002Fsmoke\u002Fsmoke-hardware-access.json",{"path":85,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":86,"sourceHtmlUrl":87},"test-cases\u002Ftest-promts.md",18777,"https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fharmonyos\u002Fsolutions\u002Fmulti-device\u002Fhmos-multidevice-hardware-access\u002Ftest-cases\u002Ftest-promts.md",[89,96,103,110,117,124],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M75ZN00W20TC7TJ40TDM7E4X","writing-for-agents","为 agent 撰写文档。当创建或编辑 skill、修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M75ZMZ63RYMNRTPEXW5T82S6","wait-what","停。上一条消息没讲明白：换个说法再讲一遍。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M75ZMXZT6MGCGFMKRTM6V6GW","to-questionnaire","把你无法独自回答的决策转化成一份问卷，交给别人填写。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M75ZMWQGNJW3E592V94ZYJMX","teach","在当前工作区内，教会用户一项新 skill 或概念。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M75ZMVQREJR3YDK0XED9AJHB","handoff","把当前对话压缩成一份交接（handoff）文档，供另一个代理接手。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":19},"01M75ZMTQAAFGA7QH26WK9Z936","grilling","就一个计划、决策或想法对用户进行无情的访谈。当用户想压力测试自己的思路，或使用任何 'grill' 触发短语时使用。","https:\u002F\u002Fgithub.com\u002FIsKenKenYa\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[]]