deveco_hmigbot 0.1.0

package/skills/migrate-core/references/topics/library-migration/ohpm-search-guide.md

@@ -0,0 +1,73 @@
+# ohpm 搜索渠道与质量评估
+
+> 查找 OpenHarmony/HarmonyOS 三方库的完整指南。
+
+---
+
+## 搜索渠道（按优先级）
+
+### 1. ohpm 官方仓库
+- **地址**：https://ohpm.openharmony.cn
+- **搜索方式**：关键词搜索（如 "image"、"http"、"json"）
+- **优势**：官方收录，质量有一定保证
+
+### 2. OpenHarmony TPC (Third Party Components)
+- **地址**：https://gitee.com/openharmony-tpc
+- **特点**：社区维护的三方组件集合（556+ 仓库）
+- **搜索方式**：在 gitee 组织页面搜索
+
+### 3. HarmonyOS TPC
+- **地址**：https://gitee.com/HarmonyOS-tpc
+- **特点**：华为主导的三方组件迁移
+- **搜索方式**：在 gitee 组织页面搜索
+
+### 4. GitCode openharmony-tpc
+- **地址**：https://gitcode.com/openharmony-tpc
+- **特点**：部分库迁移到此平台
+
+### 5. GitHub/Gitee 直接搜索
+- **搜索关键词**：`"harmonyos" OR "openharmony" OR "ohos" + 功能关键词`
+- **注意**：需要自行评估质量
+
+---
+
+## 质量评估清单
+
+找到候选库后，按以下清单评估是否可用：
+
+| 检查项 | 通过标准 | 权重 |
+|-------|---------|------|
+| 最近更新时间 | 6 个月内有提交 | 高 |
+| 兼容 API 版本 | 支持 API 12+ | 高 |
+| Star/Fork 数 | Star > 50 | 中 |
+| 下载量 | > 100 | 中 |
+| 文档完整性 | 有 README + 使用示例 | 中 |
+| Issue 响应率 | 有人回复 issue | 中 |
+| 开源许可 | 与项目许可兼容 | 中 |
+| 仓库状态 | 未标记 archived | 高 |
+
+---
+
+## 安装与验证
+
+```bash
+# 安装 ohpm 包
+ohpm install @ohos/imageknife
+
+# 验证安装
+cat entry/oh-package.json5  # 检查 dependencies 中是否有该包
+```
+
+---
+
+## 已验证常用库列表
+
+以下库经实战项目验证可用：
+
+| 库 | 安装命令 | 用途 | 验证项目 |
+|----|---------|------|---------|
+| `@ohos/imageknife` | `ohpm install @ohos/imageknife` | 图片加载+缓存（类似 Glide） | Gallery |
+| `@ohos/lottie` | `ohpm install @ohos/lottie` | Lottie 动画 | 通用 |
+| `@ohos/axios` | `ohpm install @ohos/axios` | HTTP 请求（类似 Retrofit） | 通用 |
+| `@ohos/pulltorefresh` | `ohpm install @ohos/pulltorefresh` | 下拉刷新 | 通用 |
+| `@ohos/largeimage` | `ohpm install @ohos/largeimage` | 大图缩放（类似 SubsamplingScaleImageView） | Gallery |

package/skills/migrate-core/references/topics/library-migration/stdlib-mapping-table.md

@@ -0,0 +1,34 @@
+# 标准库原语 → ArkTS 映射（JDK / Kotlin stdlib）
+
+> 三方库走 gradle 依赖扫描；**标准库原语（`java.*`/`kotlin.*`）不是依赖、扫描看不见**，最易被实现期误判"平台缺失"而**手造**（反面实证：实测应用把 `java.math.BigDecimal` 手造 500 行，而鸿蒙自带 `@arkts.math.Decimal`）。本表堵这个洞。
+
+## 核心原则：查询优先，禁止重造平台原语
+**任何标准库原语，未经"官方检索/文档查询证明缺失"，禁止判定需要自研重造。** 默认动作是**映射**，不是重写。顺序：
+
+1. **命中本表种子** → 直接用映射。
+2. **未命中** → 用官方查询机制（下）查等价物，命中即映射、**回写本表/lib-equivalence 缓存**（source: official-map）。
+3. **查询 MISS（确证无等价）** → 才进入自研，且记 `degradations`，按实现量拆分（见 unit-breakdown）。
+
+## 查询机制（deveco 原生、离线、随 SDK/工具链——不依赖外部 skill）
+1. **grep/ls 本机 SDK 声明（最准，SDK 自带的权威索引）**：
+   - `ls <SDK>/openharmony/ets/arkts/` **一次列出整个 ArkTS 基础库面**（`@arkts.math.Decimal.d.ets`、`@arkts.collections` 等）——模型直接看见平台提供了什么，杜绝瞎判"缺失"。
+   - `<SDK>/openharmony/ets/api/`（`@ohos.*`/`@kit.*` 的 `.d.ts`）+ `ets/arkts/`（`@arkts.*` 的 `.d.ets`）。grep 类/方法名即得权威签名。SDK 路径经 DevEco 环境解析（`hmos-env-doctor`）。
+   - 实证：`<SDK>/openharmony/ets/arkts/@arkts.math.Decimal.d.ets` 就在——BigDecimal 有原生等价，无需手造。
+2. **`devecocli docs search <关键词>` / `docs read <id>`**：官方文档全量检索（API 参考+指南+FAQ），离线。实证："BigDecimal 高精度"秒中 `@arkts.math.Decimal`。用法/语义看这里。
+3. **锚文档一次读全平台面**：`从TypeScript到ArkTS的适配规则`、`ArkTS基础类库概述`。
+
+> **可选增强（在场才用、缺失即跳过、不依赖）**：`hmos-arkts-knowledge-retriever` 官方 skill（RAG 检索）——它是外部件（`skills add` 安装），**不作依赖**；本套件已把方法吸收进上面的原生机制。
+
+## 确认种子（高置信，直接用）
+| JDK/Kotlin 原语 | ArkTS 等价 | Level | 用法 | 备注 |
+|---|---|---|---|---|
+| `java.math.BigDecimal` | `Decimal`（`@arkts.math.Decimal`） | L2 原生 | `import { Decimal } from '@kit.ArkTS'` | 舍入模式 ROUND_UP/DOWN/HALF_UP/HALF_DOWN/HALF_EVEN… 与 BigDecimal.RoundingMode **1:1**；precision 可配（默认20）；构造收 string/number。**仅 .ets** |
+| `java.math.BigInteger` | `BigInt` | L2 原生 | `123n` / `BigInt(x)` | 任意精度整数，原生 |
+| `java.util.regex.Pattern/Matcher` | `RegExp` | L2 原生 | `new RegExp()`、`.test/.exec` | ArkTS 禁正则**字面量**、部分引擎不支持 lookbehind——用构造函数、避 lookbehind |
+| `java.util.UUID.randomUUID` | `util.generateRandomUUID()` | L2 | `import { util } from '@kit.ArkTS'` | |
+| `java.security.MessageDigest` / `javax.crypto` | Crypto Architecture Kit | L1 Kit | `@kit.CryptoArchitectureKit`（cryptoFramework Md/Cipher） | 摘要/加解密统一走此 Kit |
+| `Gson`/`Jackson`/`kotlinx.serialization` | `JSON.parse/stringify` | L2 原生 | 原生 | 需手写类型；复杂多态另裁决 |
+| `java.util` 容器（HashMap/ArrayList/HashSet） | 原生 `Map/Array/Set` 或 `@arkts.collections` | L2 | 原生优先；高性能/Sendable 用 `@arkts.collections` | |
+
+## 长尾（本表未列）
+`java.time`/`java.text.SimpleDateFormat`/`DecimalFormat`（→ `@ohos.intl` Intl.\*/native Date）、`java.util.concurrent`/线程池（→ taskpool/worker）、`java.io`/okio 文件（→ `@kit.CoreFileKit` file.fs）、kotlin coroutines（→ async/await + Promise / taskpool）等——**一律走上面查询机制确认后再落**，命中回写缓存，MISS 才自研。**不在此表现补条目，靠检索器/文档现查现缓存。**

package/skills/migrate-core/references/topics/resources/aar-decompile.md

@@ -0,0 +1,25 @@
+# 取"合并后资源集"：APK 反编（apktool）
+
+适用：源工程的 `res/` 不完整（资源来自 AAR/Maven 依赖、构建期生成），且 `.aar` 也拿不到。
+`.aar` 拿得到时不用本页：`.aar` 即 zip，解开取其 `res/` 直接传给 `convert-resources.mjs`。
+
+## 步骤
+
+1. 构建 APK（含源码 + 依赖 + 生成资源的合并集）：
+   ```bash
+   cd <android_project> && ./gradlew assembleDebug        # 变体按工程实际；失败就用已有的 app/build/outputs/apk/**/*.apk
+   ```
+2. 反编（apktool 系统级安装：`brew install apktool` 或官方发布页；需要 Java；不随套件分发）：
+   ```bash
+   apktool d <apk_path> -o <decompiled_dir>
+   ```
+   `<decompiled_dir>/res/` 即完整合并资源集（values*/drawable*/mipmap*/layout*…）。
+3. 喂给转换器（2a 同一条命令，多传 `--extra-res`）：
+   ```bash
+   node $HMIG/scripts/convert/convert-resources.mjs --src $SRC --dst $DST --out $SPEC/front --extra-res <decompiled_dir>/res
+   ```
+   反编产物里带依赖库的资源（`abc_*`、`mtrl_*`、`design_*` 等），只搬本应用引用到的：以 `check-resources` 的悬空账为准补，不整目录搬。
+
+## 记账
+
+`feasibility.json` / 收尾报告注明 `resource_source = decompiled_apk` 与 APK 来源（构建变体或缓存路径），供复现。