lite-simulator-debug

在 DevEco Studio 仿真器（Simulator）上运行、调试轻量级智能穿戴（Lite Wearable）应用，并诊断仿真环境中的运行异常。核心方法：先区分"仿真器自身约束"与"应用自身问题"，再按场景加载离线参考文档执行。技能支持三种执行模式（Tier 0 指导 / Tier 1 半自动 / Tier 2 直接操作），模式选择见 Workflow 第 2 步。Lite Wearable 应用为 FA 模型 + JS UI（hml/css/js），支持产品为 HUAWEI WATCH GT 系列、Watch D 系列、Fit 系列等。

When to Use

• 要在仿真器（Huawei Lite Wearable Simulator / 仿真器 / Simulator）上运行或调试 Lite Wearable / 轻量级智能穿戴应用
• 应用在仿真器上白屏、黑屏、启动失败、装不上
• 虚拟传感器（心率、计步、气压、穿戴状态、地理位置）或虚拟电池数据不更新、与预期不符
• 调试 @system.sensor / @system.battery / @system.geolocation 相关业务
• 仿真器设置（分辨率、语言地区、屏幕常亮、屏幕坐标系）行为与预期不符
• 穿戴应用 HAP 安装报错误码（40/31/47/34/10/15/16/30）
• 用户询问仿真器/模拟器/预览器/真机在穿戴调试中如何选择
• 用户要求智能体代为运行/操作仿真器（如"帮我跑起来""把心率调到 120 看反应"）→ 按 Workflow 第 2 步进入 Tier 2 直接操作，能力探测不通过则降级 Tier 1 半自动

不适用：编译期报错（arkts-debug）、标准系统 Emulator 命令行运维（arkts-build）、真机 jscrash/faultlog 崩溃诊断（arkts-crash-diagnosis）、Stage 模型工程脚手架（create-hmos-project）。

Boundary with Other Skills

Workflow (Follow Strictly)

1. 读入口索引

先读 references/INDEX.md（唯一入口），按场景表确定要加载的文档，不要一次性通读全部参考。

2. 选择执行模式

• 默认 Tier 0 指导：用户咨询怎么做 → 按后续步骤产出指引与诊断。
• 用户要求代操作，且 references/06-direct-operation.md 的 Step 0 能力探测全部通过 → Tier 2 直接操作：按 06 的状态机运行环执行，严格遵循其验证纪律与降级出口。
• 用户要求代操作但探测不通过 → Tier 1 半自动：先完成代码/配置预检（config.json 三段结构、module.js[].pages 路由、reqPermissions、subscribe/unsubscribe 配对），把失败拦在 Run 之前；再给出最简操作步骤，并解读用户回贴的日志/截图。

3. 核对术语，确认载体

确认用户问题针对仿真器（Simulator，Lite Wearable 专用），而非模拟器（Emulator，标准系统）或预览器（Previewer）；三者对比与真机限制见 references/05-faq-and-limits.md。若实际需求是 Emulator 命令行操作，转 arkts-build。

4. 按文档执行运行/调试

Tier 2 按 references/06-direct-operation.md 的状态机运行环执行；Tier 0/1 按 references/01-run-debug-simulator.md 操作：设备框选 Huawei Lite Wearable Simulator → Run/Debug → 选择设备形状与分辨率。调试传感器/电池/位置业务时，用 More 面板虚拟硬件与 references/04-system-apis-simulator-testing.md 的映射表逐项核对。

5. 异常先查仿真器约束，再查应用

分辨率需停止运行后调整、语言地区仅运行模式可改等约束见 references/05-faq-and-limits.md；排除仿真器约束后，再按 05 的排查流程查应用侧（config.json 三段结构、module.js[].pages 路由、reqPermissions 权限、subscribe/unsubscribe 配对）。

6. 安装错误码走速查表

HAP 安装报 40/31/47/34/10/15/16/30 时，查 references/05-faq-and-limits.md 错误码速查表，细节回溯 references/02-lite-wearable-bpta-guide.md 常见问题章节。

7. 升级路径

本技能离线文档无法覆盖时（DevEco 新版本仿真器特性、@system.* 新接口、WearEngine 互联问题），用 harmony-fetch 在线拉取官方文档后再继续，并引用来源。

8. 引用来源

回答中引用所依据的参考文档，例如：

依据 references/01-run-debug-simulator.md（上游《使用仿真器运行轻量级智能穿戴应用》）。

Directory Structure

lite-simulator-debug/
├── SKILL.md                                # 本文件
├── references/
│   ├── INDEX.md                            # 唯一入口，必读
│   ├── 01-run-debug-simulator.md           # 官方：使用仿真器运行轻量级智能穿戴应用
│   ├── 02-lite-wearable-bpta-guide.md      # 官方：轻量级智能穿戴应用开发（V3）
│   ├── 03-fa-package-structure.md          # 官方：FA模型应用程序包结构（V220）
│   ├── 04-system-apis-simulator-testing.md # 原创：@system.* API 与仿真器虚拟硬件对照
│   ├── 05-faq-and-limits.md                # 原创：约束/错误码速查/排查清单
│   └── 06-direct-operation.md              # 原创：Tier 2 直接操作规程
└── evals/
    └── evals.json                          # 触发/行为评测用例

Documentation Source & Maintenance

• 官方快照（01/02/03）上游为华为开发者官网，见各文档头部来源头；抓取/核实于 2026-08-30，其中 02/03 经 harmony-fetch 的 REST 脚本抓取（lite-wearable-guides 目录不在 MCP 语料内）。
• 原创整理（04/05/06）注明依据的官方文档链接；修订时应同步核对上游是否更新。06 为 GUI 操作规程，DevEco 版本更新后需按 06 的首次校准程序重新核对锚点图谱。
• 更新方式：重跑 harmony-fetch 抓取流程覆盖对应文件，并更新来源头中的核实时间。