harmonyos-ai-workspace

鸿蒙 ArkTS / ArkUI 代码审查 + 10 大类 75 条规则扫描 + 优先级报告。 **激活条件**（满足任一即激活）： - 用户说"review 这段鸿蒙代码" / "审一下 PR" / "审计 .ets 文件" - 用户问"上线前检查" / "提审前自查" / "技术债梳理" - 多文件 .ets 改动需要做整体性安全 / 性能 / 规范扫描 - 引用了 SEC-* / ARKTS-* / STATE-* / PERF-* / KIT-* / AGC-RJ-* 等规则编号 **不激活**：单纯写一个新组件（用 arkts-rules / state-management）；非鸿蒙代码 review。

HarmonyOS / ArkTS 严格语法规则。 **激活条件**（满足任一即激活）： - 用户在写 / 改 .ets 或 .ts 文件，且文件路径含 entry/ / .arkui / harmonyos / ohos - 用户在迁移 TypeScript 代码到 ArkTS - 用户问 arkts-no-* 编译错误 - 用户提到 @kit.* / @ohos.* / Stage 模型 / ArkUI 装饰器 **不激活**：纯 TypeScript / 浏览器 / Node.js 项目（即使语法相似）；React / Vue / 小程序代码。

HarmonyOS Hvigor / OHPM / hdc 工具链 + 错误码诊断。 **激活条件**（满足任一即激活）： - 用户跑 hvigorw / ohpm / hdc 命令时出错 - 用户问构建产物（.hap / .app / .har / .hsp）的差异 / 选型 - 错误码 201 / 202 / 401 / 801 / 9568297 / 9568305 / 9568322 等鸿蒙特定数字 - hilog 日志解读 / hdc fport 端口转发 / NAPI 调试 - 装包到模拟器或真机失败 **不激活**：Android adb / iOS Xcode / Web devtools 调试问题（即使概念相似）。

在鸿蒙 ArkTS 里调多模态 LLM API（OpenAI Vision / Whisper / DALL-E、Anthropic Vision、Gemini 等）的领域专项。 **激活条件**（满足任一即激活）： - 用户写"调 GPT-4 Vision / Claude Vision / Gemini Vision" - 用户写"上传音频转文字 / Whisper / 语音识别 API" - 用户写"DALL-E / Stable Diffusion / 图像生成 API" - 代码里出现 `ChatMessage.content`、`role: 'user'`、`stream: true` 等 LLM payload 字段 - 代码涉及 SSE 流式解析（`text/event-stream` / `data: ` 前缀行） - 涉及 multipart/form-data 上传（音频 / 视频 / 大文件给 LLM 服务） **不激活**：纯文本 LLM 单轮问答（用普通 @kit.NetworkKit http POST 即可）；本地推理（不调云端 API）。

鸿蒙工程**运行时装配陷阱**——ArkTS 语法无错但项目跑不起来 / 行为不正确的工程层坑。 来源：真实 LLM 对话客户端 app M3-M13 + paseo-harmony Phase A/B 实战反馈。 **激活条件**（满足任一即激活）： - 修改 `build-profile.json5` / `module.json5` / `oh-package.json5` 任意一个 - 改 `resources/*/element/string.json` 或其他资源文件 - 实现主题切换 / 跟随系统外观（涉及 `@StorageLink('appearanceTheme')`） - 在 Web 组件上注册 `javaScriptProxy` / 实现 H5 ↔ ArkTS 桥 - 写多模态 LLM 调用（OpenAI Vision / Whisper / DALL-E 等） - 多模块工程（feature 拆分）+ 模块改名 - HUKS 加密集成（API key / 用户敏感数据落盘） - 替换品牌图标 / 修改 `AppScope/resources/base/media/{background,foreground}.png`（layered icon） - 改 `NavPathStack` 路由 / 在 `build()` 写多个根 container / 实现长列表 timeline - 多 host 共享存储（per-host store 按 serverId 分桶）/ daemon workspaceId 字段消费 **不激活**：纯 UI 组件、纯算法逻辑、单 module hello world。

HarmonyOS 应用签名 + AppGallery Connect 上架流程。 **激活条件**（满足任一即激活）： - 用户提到 .p12 / .cer / .csr / .p7b（签名三件套） - 用户问"自动签名失败" / "签名校验失败 9568322" / "调试证书" - 用户问 AGC / AppGallery Connect / 实名认证 / ICP 备案 - 用户准备提审 / 上架被拒（AGC-RJ-* 编号） - hvigorw assembleApp -p buildMode=release 相关 **不激活**：Android 签名（keytool / jarsigner）；iOS 证书；普通 Web 部署。

ArkUI V1 / V2 状态管理装饰器选型 + "数据变了 UI 不刷新" 诊断。 **激活条件**（满足任一即激活）： - 代码中出现 @State / @Local / @Prop / @Param / @Link / @Provide / @Consume / @Observed / @ObservedV2 / @ObjectLink / @Trace / @Watch / @Monitor / @Computed / @Provider / @Consumer - 用户报告 UI 不刷新 / 状态没生效 / 数据改了视图没动 / push/splice 后列表没更新 - 用户问 V1 vs V2 / @ComponentV2 / `$$x` 双向绑定 **不激活**：React/Vue/Svelte 状态问题（即使关键词相似）；非 ArkUI 的 MVVM 讨论。

鸿蒙应用测试 + 质量评估：hypium 单元测试 / UiTest UI 自动化 / `aa test` 命令行 / 上架前质量工位（AGC 云测·SmartPerf·wukong·Profiler）。 **激活条件**（满足任一即激活）： - 用户说"写测试 / 单元测试 / UI 测试 / 自动化测试 / 测试覆盖率" - 代码或依赖出现 `@ohos/hypium`、`@ohos/hamock`、`@kit.TestKit`、`Driver`、`ON.`、`ohosTest` - 用户跑 `hdc shell aa test` / DevEco "Run Tests" 出错 - 用户问"上架前怎么自测 / 怎么评估 app 质量 / 性能摸底 / 稳定性测试 / 云测" **不激活**：本仓库自身的 tools/test-suite.sh（那是工具包回归，不是鸿蒙 app 测试）；Web/Node 项目的 jest/vitest。

ArkUI Web 组件 + H5 ↔ ArkTS 双向桥（javaScriptProxy / runJavaScript / postMessage）的领域专项。 **激活条件**（满足任一即激活）： - 用户写"ArkUI Web 组件 / 嵌入 H5 / WebView" - 代码出现 `Web({ src: ... })`、`webview.WebviewController`、`javaScriptProxy`、`runJavaScript` - 涉及把 markdown / HTML / 富文本渲染到鸿蒙 app（用 H5 离线渲染器代替原生） - H5 调用 ArkTS（如 `window.reporter.log(...)`）或反向调用 **不激活**：纯 ArkUI 原生组件渲染；Web 浏览器 app（用 Web Browser Kit 而非 ArkUI Web）。

HarmonyOS Hvigor / OHPM / hdc 工具链 + 错误码诊断。 **激活条件**（满足任一即激活）： - 用户跑 hvigorw / ohpm / hdc 命令时出错 - 用户问构建产物（.hap / .app / .har / .hsp）的差异 / 选型 - 错误码 201 / 202 / 401 / 801 / 9568297 / 9568305 / 9568322 等鸿蒙特定数字 - hilog 日志解读 / hdc fport 端口转发 / NAPI 调试 - 装包到模拟器或真机失败 **不激活**：Android adb / iOS Xcode / Web devtools 调试问题（即使概念相似）。