القائمة
HarmonyOS应用多设备交互适配开发方案skill，提供触摸、鼠标、键盘、手写笔等多输入方式的交互方案和事件归一策略。当涉及触摸、鼠标、键盘、手写笔等设备的交互以及实现交互归一化、悬停效果、右键菜单、焦点导航、键盘快捷键、手写板输入和压感等功能时调用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | hmos-multidevice-interaction-methods |
| description | HarmonyOS应用多设备交互适配开发方案skill，提供触摸、鼠标、键盘、手写笔等多输入方式的交互方案和事件归一策略。当涉及触摸、鼠标、键盘、手写笔等设备的交互以及实现交互归一化、悬停效果、右键菜单、焦点导航、键盘快捷键、手写板输入和压感等功能时调用。 |
| metadata | {"version":"1.0.1","keywords":["交互方式适配","多输入方式","触摸","鼠标","键盘","手写笔","交互归一","鼠标悬停","右键菜单","焦点导航","键盘快捷键","手写笔压感","拖拽归一"]} |
HarmonyOS应用交互方式适配skill，为触摸、鼠标、键盘、手写笔等多输入方式提供交互方案和交互事件归一策略 适用设备(device types)： phone / tablet / 2in1 / tv 适用范围：交互归一化、鼠标悬浮、右键菜单、焦点导航、键盘快捷键、手写笔输入` 不适用范围： 纯视觉动画微调、与输入方式无关的业务流程改造
../hmos-multidevice-scenario-entry/references/multi-device-verification.mdSCENE-09）：
hdsEffect.PressShadowType（按压阴影：BLEND_WHITE / BLEND_GRADIENT）hdsEffect.PointLight（点光源效果，支持边框/内容/羽化受光）HdsSnackBar（常驻/定时两种模式）HdsActionBar（内置 hoverTips 支持鼠标悬停提示）../hmos-multidevice-scenario-entry/references/hds-ui-design-kit.md。| 标签 | 阶段 | 当前模块关注点 |
|---|---|---|
REQ | 需求分析设计 | 主输入方式、兼容输入方式、交互边界 |
DEV | 开发 | 事件归一处理、焦点链路、悬浮和快捷键实现 |
FIX | 问题修复 | 焦点不连续、鼠标无反馈、快捷键冲突、手写笔异常 |
VAL | 功能验证 | 输入矩阵、焦点路径、悬浮效果验证、快捷键验证 |
active_phases、primary_phase、primary_scene、secondary_scenes、resources_usedREQ：device_constraints、capability_boundary、acceptance_focusDEV：code_touchpoints、reuse_resources、implementation_notes、integration_risksFIX：problem_profile、root_cause_hypothesis、fix_plan、regression_watchlistVAL：verification_matrix、evidence_requirements、pass_criteria、residual_risksdevice_constraints：指由触摸、鼠标、键盘、手写笔或外接输入设备差异带来的交互硬约束。在 interaction-methods 中，通常是哪些输入方式必须支持、是否必须有 hover 或 focus、快捷键是否是必选能力。capability_boundary：指当前交互方案覆盖哪些输入方式，哪些输入路径可以降级，哪些行为只在特定设备上生效。acceptance_focus：指需求阶段验收时必须确认的焦点链路、悬浮反馈、快捷键行为和多输入回退策略。deliverables.REQ 出现 device_constraints，表示“该交互场景命中后，需求阶段必须先明确输入适配边界”，不是对字段重新命名。开始
│
├─→ 步骤1: 分析是否涉及鼠标交互(右键菜单，鼠标悬浮)
│ └─→ 涉及 → 命中 `INPUT-01` -> 步骤2
│ └─→ 不涉及 → 步骤3
│
├─→ 步骤2: 分析是否涉及交互归一化，即一套组件同时支持触摸和鼠标
│ └─→ 涉及 → 命中 `INPUT-02` -> 步骤3
│ └─→ 不涉及 → 步骤3
│
├─→ 步骤3: 分析是否涉及键盘交互（焦点导航、样式或键盘快捷键）
│ └─→ 涉及 → 命中 `INPUT-03` -> 步骤4
│ └─→ 不涉及 → 步骤4
│
└─→ 步骤4: 分析是否涉及手写笔交互（手写笔交互，压感）
└─→ 涉及 → 命中 `INPUT-04` -> 结束
└─→ 不涉及 → 结束
INPUT-01 鼠标设备交互（点击，悬浮，右键菜单）scene_id: INPUT-01
scene_name: 鼠标设备交互
phase_tags: [REQ, DEV, FIX]
intent_signals:
- 鼠标
- 右键菜单
- 鼠标悬浮反馈
applies_when:
- 页面需要面向 PC 或平板外接鼠标
- 当前问题表现为鼠标悬浮无反馈或右键无菜单
not_applies_when:
- 页面只面向纯触摸设备
decisions:
REQ:
- 判断是否支持鼠标设备
- 判断是否设计左键点击，右键点击，悬浮反馈，右键菜单功能
DEV:
- 明确鼠标左键点击、悬浮态反馈、右键菜单的实现方式
FIX:
- 明确鼠标左键点击、悬浮态反馈、右键菜单的实现方式
resource_refs:
- RSC_INPUT_01
INPUT-02 交互归一化scene_id: INPUT-02
scene_name: 交互归一化
phase_tags: [REQ, DEV, FIX]
intent_signals:
- 鼠标左键点击和触摸点击交互归一
- 鼠标右键点击和触摸长按交互归一
- 拖拽归一
applies_when:
- 同一组件需要兼容触摸和鼠标，鼠标左键点击和触摸点击归一，右键和长按菜单归一，拖拽归一
- 当前问题表现为不同输入方式走了不同主流程
not_applies_when:
- 当前页面只支持单一输入方式
decisions:
REQ:
- 判断是否同时支持触摸和鼠标设备
- 决定点击、右键、拖拽是否涉及交互归一
DEV:
- 选择交互归一策略
FIX:
- 选择交互归一策略
resource_refs:
- RSC_INPUT_02
INPUT-03 键盘焦点导航与快捷键scene_id: INPUT-03
scene_name: 交互归一化
phase_tags: [REQ, DEV, FIX]
intent_signals:
- 键盘
- 焦点导航
- 焦点样式
- 键盘快捷键
applies_when:
- 页面需要焦点导航、方向键切换焦点、键盘快捷键时
- 当前问题表现为焦点顺序错乱或快捷键冲突
not_applies_when:
- 页面完全不支持键盘输入
decisions:
REQ:
- 判断是否涉及键盘设备
- 判断是否涉及焦点和键盘快捷键
DEV:
- 选择焦点功能，样式、方向键导航实现方式
- 选择键盘快捷键及组合键实现方式
FIX:
- 选择焦点功能，样式、方向键导航实现方式
- 选择键盘快捷键及组合键实现方式
resource_refs:
- RSC_INPUT_03
INPUT-04 手写笔输入与笔态交互scene_id: INPUT-04
scene_name: 交互归一化
phase_tags: [REQ, DEV, FIX]
intent_signals:
- 手写笔
- 手写笔事件区分
- 压感
applies_when:
- 页面需要支持手写笔触碰和按压
- 当前问题表现为笔输入和手指触摸输入混淆
not_applies_when:
- 目标设备不支持手写笔
decisions:
REQ:
- 判断是否涉及手写笔设备
- 判断手写笔功能是否涉及笔触区分和压感应用
DEV:
- 区分笔触输入与普通触摸输入
- 决定按压反馈方式
FIX:
- 区分笔触输入与普通触摸输入
- 决定按压反馈方式
resource_refs:
- RSC_INPUT_04
RSC_INPUT_01 鼠标适配指南resource_id: RSC_INPUT_01
resource_type: reference
path: ./references/mouse.md
phase_tags: [REQ, DEV, FIX]
used_for:
- 页面需要面向 PC 或平板外接鼠标
- 当前问题表现为鼠标悬浮无反馈或右键无菜单
load_when:
- 命中 INPUT-01
avoid_when:
- 设备没有接入鼠标设备
RSC_INPUT_02 交互归一化指南resource_id: RSC_INPUT_02
resource_type: reference
path: ./references/interaction_normalization.md
phase_tags: [REQ, DEV, FIX]
used_for:
- 定义统一点击、长按、右键和拖拽的策略
- 排查多输入走不同主流程的问题
load_when:
- 命中 INPUT-02
avoid_when:
- 设备没有接入鼠标设备
RSC_INPUT_03 键盘适配指南resource_id: RSC_INPUT_03
resource_type: reference
path: ./references/keyboard.md
phase_tags: [REQ, DEV, FIX]
used_for:
- 定义焦点顺序、方向键和快捷键边界
- 排查焦点缺失和快捷键冲突
load_when:
- 命中 INPUT-03
avoid_when:
- 页面不支持键盘输入
RSC_INPUT_04 手写笔输入指南resource_id: RSC_INPUT_04
resource_type: reference
path: ./references/stylus.md
phase_tags: [REQ, DEV, FIX]
used_for:
- 区分笔触和手指触摸
- 手写笔压力检测和应用
load_when:
- 命中 INPUT-04
avoid_when:
- 目标设备不支持手写笔
**MUST** use 'devecocli' for HarmonyOS apps (scaffold, build, run, debug, devices, emulators, logs, docs, 鸿蒙开发文档, skills). **REQUIRED** and **MANDATORY** if workspace has build-profile.json5 or oh-package.json5, or user mentions HarmonyOS, 鸿蒙, DevEco, ArkTS, ArkUI, docs, 鸿蒙文档, 知识, 搜索, or skills.
检查 HarmonyOS 项目中的废弃 SDK 接口并提供修复建议。当需要清理废弃 API、升级 API 版本、优化代码质量或进行静态语法检查时使用。提供详细的迁移方案、修复优先级分类和代码示例。
检索 ArkTS 语言指南文档，为代码开发、审查和调试提供语法参考。当需要查找 ArkTS 语法规则、库使用方法或代码示例时使用。提供基于索引的高效检索和可追溯的文档引用。
检查并修复 HarmonyOS 项目的 ArkTS 语法错误，自动化构建项目。当需要编译项目、修复编译错误、生成 HAP/App 产物时使用。提供静态语法检查、错误自动修复、循环构建直到成功的完整工作流程。支持错误优先级分类（P0/P1/P2）、最大重试机制、构建产物自动定位。
编写、审查或改进ArkUI代码，遵循状态管理(V1/V2)、组件结构、布局选择、性能优化的最佳实践。触发场景：构建新页面或组件、实现状态管理、开发布局(列表/网格/瀑布流)、添加动画手势、搭建导航路由、处理弹窗模态、MVVM架构设计、V1迁移V2。
帮助开发者将ArkUI状态管理从V1迁移到V2。触发场景：(1) V1项目升级到V2；(2) 迁移@Component/@State/@Prop/@Link/@Observed/@ObjectLink/@Provide/@Consume/@Watch/@Reusable装饰器；(3) 迁移LocalStorage/AppStorage/PersistentStorage/Environment应用级状态；(4) 将ForEach/LazyForEach迁移到Repeat；(5) 解决animateTo在V2中的兼容问题；(6) 处理V1与V2混用场景；(7) 询问V1和V2装饰器对应关系或差异。