用途:面向 HarmonyOS 原生应用的开发、调试、重构与设计,覆盖 ArkTS、ArkUI、Stage 模型和 HarmonyOS Kits,强调以仓库证据和当前官方文档为依据,优先做小而可验证的改动,而非大范围推测性重写。
工作流程:先建立项目上下文,检查仓库说明与相关文件,定位 build-profile.json5、oh-package.json5、module.json5、app.json5 及模块级配置,据此推导编译/兼容/目标 SDK、Stage 或 FA 模型、设备类型、状态管理代际、Kits、权限与构建命令;搜索附近已有实现并沿用既有架构。全新项目仅询问影响结果的关键决策,不臆造默认 API 版本或设备类型。其次核对版本敏感事实,来源优先顺序为仓库 SDK 配置与编译器诊断、当前华为 API 参考、华为开发指南与官方示例,本地参考仅作导航清单,不可当作权威。设计最小连贯改动时说明兼容与设备假设,同一组件边界内保持 V1 与 V2 状态管理一致,选择 Kit API 前检查 API 级别、设备、SysCap、权限与应用形态约束,规划订阅、定时器、网络句柄、ResultSet、文件和控制器等资源的归属与清理,保留错误语义,处理 BusinessError 与 promise 拒绝,优先使用资源与自适应布局。实现时沿用仓库风格,不新建无依据的并行抽象,保持 ArkTS 类型明确且符合编译规则,API 迁移时分离机械兼容改动与行为变更,不改动无关代码与生成产物。验证时先运行最窄相关检查再扩展:编译受影响模块、运行单元/集成/UI/Hvigor 测试、检查 API 兼容与 ArkTS 约束诊断;UI 工作验证涉及设备类别、方向、主题、字体缩放与空/错/加载态;生命周期工作覆盖创建、前后台、导航离开与销毁路径。若环境、SDK、设备、账号或服务不可用,明确报告未验证边界,不得将未运行的检查描述为通过。
限制:技术断言应仅限官方华为来源;本地参考为快照,不可作为权威;缺失官方材料时说明未验证内容,避免把推断当作事实;未要求时不应修改仓库。