@deveco-test/deveco-code-darwin-arm64 0.1.0-TD.24.test2 → 0.1.0-TD.24.test4

package/CHANGELOG.md

@@ -0,0 +1,217 @@
+# Changelog
+
+## v0.1.7 (2026-08-03)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 地区访问策略新增 UTC+8 偏移回退与系统区域检测，扩展中国时区白名单（`bc637c8`）
+
+### TUI 终端界面
+
+#### 缺陷修复
+
+- 修复流式编辑/写入字数统计因 JSON 转义未解码导致计数虚高（`a6e432e`）
+- 修复启动时布局竞争导致的偶现启动失败问题（`c17c895`）
+
+## v0.1.6 (2026-08-01)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增地区访问策略，基于时区与实名国籍限制中国大陆区域使用（`5810c71`、`2e408b5`）
+- 集成 Magpie 埋点：采集工具调用链路，复用端点配置，过滤非 DevEco 事件，优化归因精度与统一同意管理（`8a0413a`、`6e6043e`、`1776688`、`766509a`、`fbfd228`、`4a888ee`）
+- 新增 GitCode CI/CD 工作流，涵盖发版、类型检查与测试（`7df5df8`）
+
+#### 缺陷修复
+
+- 安全加固：密码采用恒定时间比对、登录 URL 防命令注入、工具参数限制为 JSON（`20e4567`、`9fb4045`、`273b7d7`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 编辑流式输出时实时显示字数统计（`af0d72d`）
+
+#### 优化
+
+- 移除 `/btw` 命令说明文本（`c0191d1`）
+
+## v0.1.5 (2026-07-27)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 启动前弹出工作区信任确认，防止在不受信目录下误执行（`e4c18b6`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增通知设置对话框，支持全局开关、音量调节及 6 类事件的独立音效选择（`c3f91a6`）
+
+#### 优化
+
+- 移除日志收集菜单与崩溃后自动上报弹窗（`0483e25`）
+
+#### 缺陷修复
+
+- 规范化 btw 浮层错误展示：按错误码映射 i18n 文案，修复出错时提示键误显示（`1f0e98e`）
+
+## v0.1.4 (2026-07-24)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增崩溃检测与日志自动上传，上传前对敏感信息做脱敏处理（`a7d9157`、`17e1bc4`、`99dafcc`、`3722c14`）
+- 新增 TUI 使用遥测与会话级 AI 追踪打点（`0e9ff88`、`ab5d917`、`5f0ec58`）
+- 同步会话级调试能力，增强 debug 命令的会话诊断（`2e41d04`）
+
+#### 优化
+
+- 清理冗余 `.ts` 技能脚本源文件（`af8bf56`）
+- 修复斜杠命令需额外空格才能退出搜索模式的问题（`8754402`）
+- 技能默认资源新增 `customize-deveco`，修复 `deveco-create-project` 的 codeCheck 校验规则（`89f9fd0`、`21a76ef`）
+- 0-1 技能新增 `AGENTS.md` 配置引导，修复 goal 模式 `plan.md` 未指定 v2 状态管理（`845fa8d`、`7cd45ac`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 新增 `/btw` 浮层，支持会话中随时提追问（`3902edf`）
+- 智能 Esc 中断：单击中断生成，再按确认取消对话（`510cbca`）
+- 登录页展示错误信息，未通过时即时反馈原因（`29afa10`）
+
+#### 缺陷修复
+
+- 修复 JetBrains Terminal 下鼠标悬停异常（`806bd0a`）
+- 修复反复 `Ctrl+C` 重启后终端黑屏（`cefa9a8`）
+
+## v0.1.3 (2026-07-17)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增离线发版说明查看器，登录后可在 TUI 内直接浏览历史版本的更新内容（`44540db`）
+- 登录流程增加实名校验环节，未通过时引导用户完成实名（`a8671f2`）
+- 协议需重新签署时显示 toast 提示，及时告知用户协议状态变更（`dff7998`）
+- 适配 API >= 26 的 `sdkVersion` 格式，确保新版本 API 元数据与构建链一致（`9ce4d1f`）
+- 过滤技能加载时引入的冗余 `skill_files`，仅保留运行所需文件（`25acb4d`）
+- OpenAI 兼容 provider 支持 `user_id` 透传，便于追踪与会话关联（`4ed0b88`）
+
+#### 优化
+
+- 缓存认证检查结果，执行 `/new` 命令时跳过重复校验，提升新建会话响应速度（`82eb48d`）
+- 升级版本时，patch 版本（x.y.z → x.y.z+1）的更新无需用户确认（`e4d57ef`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 终端支持双击选词，便于按词粒度复制或编辑（`8f7b12c`）
+- `Ctrl+C` / `Ctrl+D` 退出改为两段式确认，避免误触导致会话意外终止（`14a16c3`）
+- 替换 AI 提示的警告图标，并补齐对应 i18n 文案（`a292d16`）
+
+#### 缺陷修复
+
+- 优化 onboarding 页面间距与滚动条可见性，改善长内容场景下的浏览体验（`70f52b5`）
+
+## v0.1.2 (2026-07-09)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 全面更新 `arkts` 技能知识库，扩展 ArkUI 组件参考与 API 护栏，提升代码生成准确性（`638c180`）
+
+#### 优化
+
+- goal 模式 `plan.md` 工程结构输出对齐 ArkUI 最佳实践（`3b11304`）
+
+#### 缺陷修复
+
+- 加固认证链路：改进 token 刷新错误处理，启动时自动检测 JWT 过期并提示重登录（`802431c`、`b45c586`）
+- 修复 `arkts-check` 对 `$$` / `$` 绑定语法糖的假阳性告警（`f427e94`）
+- plan 模式阶段评审检测需求范围变化并强制回溯（`16e4024`）
+
+#### 重构
+
+- 登录与 `DEVECO_HOME` 检测迁移至 TUI onboarding，统一引导入口（`7c26d1e`）
+- 清理过时 `arkui-knowledge` 技能引用（`43b826e`）
+- 提示词补充 DevEco Studio 签名配置手动操作提醒（`6cc90ad`）
+
+### TUI 终端界面
+
+#### 优化
+
+- `/feedback` 跳转修正为 GitCode issues 页面（`a8ba6c8`）
+
+#### 缺陷修复
+
+- 恢复主视图选中即复制（copy-on-select）功能（`5901beb`）
+
+## v0.1.1 (2026-07-02)
+
+### DevEco Code 核心
+
+#### 新特性
+
+- 新增 `arkts_check` 静态检查工具，于项目构建前置执行，并替代原有的 `check_ets_files` 校验（`30ebb05`、`f7afb1b`、`471fd82`）
+- 新增 `debug` 调试命令，并完善其中文使用说明（`32bfb77`、`0ea5493`）
+- 为 DevEco Code 推理模型启用 `thinking` 参数，支持推理过程输出（`766e2d6`）
+- 默认启用后台 subagent 运行时开关，提升并行任务处理能力（`7eb2c42`）
+- 模板复制脚本（`copy-template.mjs`）执行完成后，会话工作目录自动切换至生成的项目根目录（`44a56b1`）
+- 新增 Windows baseline 版本包发布，以兼容不支持 AVX2 指令集的 CPU（`f198b45`）
+
+#### 优化
+
+- 强化 goal 模式需求澄清能力，并在 spec-implementation 阶段抽离专用 subagent 承载实现（`615b731`、`4963e0d`）
+- 工具调用支持并行执行，缩短多工具场景耗时（`9c89cc1`）
+- 加固 `arkts_check` 的 `ensureScriptOnDisk` 校验，提升脚本落盘检查的稳健性（`b6790b0`）
+- 主包打包纳入 `README.md` 与 `assets/` 资源，保障安装后文档与素材随包可用（`1d54cef`）
+- 调整一项 runtime flag 默认值为 `false`，收敛默认行为（`0fdb5fc`）
+
+#### 缺陷修复
+
+- 加固 token 刷新链路：整合刷新逻辑、防御空 `accessToken`、新增 `SESSION_EXPIRED` 状态并在刷新时同步更新内存态 token，避免会话因令牌失效而中断（`b545602`、`17ad7a5`、`cb71b79`）
+- `deveco-create-project` 的 SDK 错误改为立即终止而非回退兜底，并完善 SDK 版本确认逻辑（含 codeCheck），防止错误被静默吞没（`c185817`、`8b3270b`、`2277984`）
+- 修复复制模板时 `modelVersion` 与 `EntryAbility_label` 字段未正确同步的问题（`d438216`）
+- 修复内置技能提取与开发模式加载失效的问题（`0e9dee5`）
+- 升级 `@deveco-codegenie/mcp-bridge` 至 1.1.11，并将其从 `minimumReleaseAge` 发布门禁中豁免（`f60775a`、`c93e1cc`）
+- 恢复 deveco-code 打包的自定义构建配置，并补回 ripgrep / mcp-bridge 下载的 postinstall 钩子，保障安装期二进制就位（`5ff55b5`、`107cfb8`）
+- 对齐 `build.ts` 与 `pipeline-build.ts` 中的 vendor 路径，消除本地与流水线构建产物差异（`7dded29`）
+- 修复 PowerShell 下中文输出乱码，保障 Windows 终端中文可读（`5d72cbb`）
+
+#### 重构
+
+- 将全部 `Log.create` 调用迁移至 `Effect.log*`，并移除旧版 Log 模块，统一日志体系（`d169b1c`）
+
+#### 文档
+
+- 上线离线文档站点，并于 README 中补充访问入口（`42b361f`）
+- 移除冗余的 overview 条目与 Releases 下载说明，精简文档表述（`6c7e6a5`）
+- 在 UI 校验文档中澄清多模态模型的使用方式，避免误用（`4453391`）
+
+### TUI 终端界面
+
+#### 新特性
+
+- 落地中英文国际化首版，覆盖命令菜单、权限提示、`/init`、`/review` 等交互节点，支持运行时语言切换（`999e6df`、`89d5698`、`093451b`、`80b4eb7`、`ba3701d`）
+- 点击 logo 时新增交互式爆破动效，增强启动时刻的视觉反馈（`bace2c3`）
+- `@` 弹层新增「输入即过滤」提示，提升智能体 / 文件检索的引导性（`d86ac61`）
+
+#### 优化
+
+- 默认启用会话滚动条，改善长会话浏览体验（`05e6a93`）
+
+#### 缺陷修复
+
+- 移除 `/language` 斜杠命令（保留调色板入口）并清理冗余的 `prompt.*` i18n 键（`fac0737`、`57ed63b`）
+- 退出尾声 logo 配色与 CLI banner 调色板对齐，统一视觉收尾（`f0a93b4`）
+- 恢复 `DEVECO_HOME` 自动检测与登录检查（含 `requireLogin` 前置校验），避免未登录态误入主界面（`b33e8d4`、`cd4a560`）
+- 修复 `unknown component type: spinner` 运行报错，消除启动期组件渲染异常（`912ab20`）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deveco-test/deveco-code-darwin-arm64",
-  "version": "0.1.0-TD.24.test2",
+  "version": "0.1.0-TD.24.test4",
   "preferUnplugged": true,
   "os": [
     "darwin"
@@ -11,7 +11,7 @@
   "files": [
     "bin/**/*",
     "vendor/**/*",
-    "assets/**/*",
+    "CHANGELOG.md",
     "README.md"
   ]
 }

package/vendor/android2harmony/README.md

@@ -0,0 +1,407 @@
+# 安卓应用迁移鸿蒙指导
+
+**a2h工具用于辅助鸿蒙开发者完成原生安卓应用迁移到鸿蒙应用，为应用迁移的各个环节提供能力支持。**
+
+**本文档为使用a2h工具进行应用迁移的流程指导。**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022.18-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/en/download)
+
+[![Claude Code](https://img.shields.io/badge/Claude_Code-supported-blueviolet.svg)](#选择本地editor)
+[![Cursor](https://img.shields.io/badge/Cursor-supported-blueviolet.svg)](#选择本地editor)
+[![OpenCode](https://img.shields.io/badge/OpenCode-supported-blueviolet.svg)](#选择本地editor)
+[![DevEco Code](https://img.shields.io/badge/DevEco_Code-supported-blueviolet.svg)](#选择本地editor)
+[![Codex](https://img.shields.io/badge/Codex-supported-blueviolet.svg)](#选择本地editor)
+[![CodeBuddy](https://img.shields.io/badge/CodeBuddy-supported-blueviolet.svg)](#选择本地editor)
+
+---
+
+## 安装DevEco Studio以及Android Studio
+
+1. **安装DevEco Studio** — 下载地址:<https://developer.huawei.com/consumer/cn/download/>。安装完成后,配置以下 **PATH环境变量**:
+
+   | 工具 | PATH中加入的目录 |
+   |------|------------------|
+   | java | `<DevEco安装目录>\jbr\bin` |
+   | hdc | `<DevEco安装目录>\sdk\default\openharmony\toolchains` |
+
+   验证方式:执行 `java -version`、`hdc -v` 均返回正常
+
+
+2. **安装Android Studio** — 下载地址:<https://developer.android.com/studio>,并在 **SDK Manager** 中安装SDK。
+
+   验证方式:执行 `adb version` 返回正常
+
+   被依赖:
+   - 步骤1.1UI迁移(可选,仅自动抓取页面快照时需要)
+   - 步骤1.2UI对齐(必需)
+   
+   注：也可用真机替代模拟器用于UI迁移和对齐。但当前工具不支持部分系统(Android API 16及更早版本、华为emui、部分车机.IOT设备)
+
+## 安装Node.js
+
+安装 **Node.js(版本需 >= 22.18)** — 下载地址:<https://nodejs.org/en/download>。
+
+验证方式:执行 `node -v`、`npm -v`、`npx -v` 均返回正常,且 `node -v` 显示版本不低于 22.18
+
+## 安装a2h
+
+执行 `npm install -g android2harmony`。
+
+验证方式:执行 `a2h --version` 返回正常
+
+## 环境初始化
+
+执行 `a2h init`。
+
+> 如果在PowerShell下运行,命令需要加上 `.cmd` 后缀,如 `a2h.cmd --version`、`a2h.cmd init`。
+
+### 选择本地editor:
+![choose_editor.png](https://raw.gitcode.com/yang237/a2h/raw/main/resource/choose_editor.png)
+
+### 参数配置:
+
+#### 配置鸿蒙SDK:
+![set_sdk.png](https://raw.gitcode.com/yang237/a2h/raw/main/resource/set_sdk.png)
+
+#### 配置多模态模型(不执行UI对齐以及集成测试可以跳过该配置):
+![set_multimodel.png](https://raw.gitcode.com/yang237/a2h/raw/main/resource/set_multimodel.png)
+
+  | 参数             | 含义             |
+  |-----------------|---------|
+  | `model_api_key` | 用于模型API请求认证的令牌   |
+  | `model_name`      | 多模态(视觉)模型的名字   |
+  | `model_base_url`       | 模型API服务的基础地址 |
+
+##### 配置参考
+
+前往[阿里云百炼平台](https://bailian.console.aliyun.com/)开通服务并申请 API Key,选用 Qwen 系列多模态(视觉)模型(如 `qwen3.5-plus`)。
+
+| 参数 | 取值                                                  |
+|---|-----------------------------------------------------|
+| `model_api_key` | 百炼控制台申请的 API Key(形如 `sk-xxxxxxxx`)                  |
+| `model_name` | `qwen3.5-plus`                                      |
+| `model_base_url` | `https://dashscope.aliyuncs.com/compatible-mode/v1` |
+
+#### 将配置信息添加到环境变量:
+![set_environment.png](https://raw.gitcode.com/yang237/a2h/raw/main/resource/set_environment.png)
+
+### 准备项目
+
+准备 **Android源项目** 与 **HarmonyOS目标项目目录**。
+
+---
+## 迁移流程
+![migration_process.svg](https://raw.gitcode.com/yang237/a2h/raw/main/resource/migration_process.svg)
+
+---
+
+## 步骤1:UI迁移
+
+### 1.1 UI迁移
+
+> 📦 依赖:Android Studio + 安卓真机/模拟器(可选,仅自动抓取页面快照时需要)。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-batch-ui-align，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-batch-ui-align android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> ui_info_root=<页面快照目录> apk_path=<安卓apk路径>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-batch-ui-align完成安卓应用页面到鸿蒙应用的迁移，传递的参数是 android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> ui_info_root=<页面快照目录> apk_path=<安卓apk路径>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明                                                                                                          |
+|------|------|-------------------------------------------------------------------------------------------------------------|
+| `android_project_dir` | **必选** | Android项目根目录路径                                                                                             |
+| `harmony_project_dir` | **必选** | HarmonyOS项目输出路径                                                                                            |
+| `ui_info_root` | 可选 | 包含 `page_NNNN_ActivityName` 格式子目录的父目录(每子目录含 `meta.json` + `view.xml` + 可选 `screenshot.png`);不提供时自动通过adb抓取 |
+| `pages` | 可选 | 显式列出的页面子集(不提供则处理所有页面)                                                                                       |
+| `apk_path` | 可选 | Android APK文件路径;透传给内部的 `hmos-resources-convert`,提供后跳过Gradle构建,直接用apktool解包该APK提取资源 |
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| ArkTS页面文件 | HarmonyOS项目下 | 由Android Activity转换生成的ArkTS页面 |
+| 资源文件 | HarmonyOS项目下 | 页面所需资源(含UI迁移内部触发的资源转换产物) |
+| 批量转换报告 | HarmonyOS项目下 | 各页面转换结果、缺陷与统计 |
+
+### 1.2 UI对齐(按需)
+
+> 📦 依赖:DevEco Studio、Android Studio(必需);安卓真机/模拟器 + 鸿蒙真机/模拟器(必需)。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-incremental-ui-align，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-incremental-ui-align android_project_dir=<安卓工程路径> harmony_project_dir=<鸿蒙工程路径>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-incremental-ui-align完成安卓和鸿蒙应用的页面对齐，传递的参数是 android_project_dir=<安卓工程路径> harmony_project_dir=<鸿蒙工程路径>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `android_project_dir` | 必填 | 安卓源码根目录;用于自动解析安卓app名/包名 |
+| `harmony_project_dir` | 必填 | 鸿蒙工程根目录(会被直接修改);用于自动解析鸿蒙app名/包名 |
+| `capture_output_dir` | 可选 | 采集产物输出目录,默认 `<harmony_project_dir>/.hometrans/capture_output` |
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| 修改后的ArkTS页面文件 | HarmonyOS项目下 | 对齐目标页面后的代码改动 |
+| 双端页面截图与视图树 | `capture_output_dir` | Android/HarmonyOS两侧 `screenshot.png` + 视图树文件 |
+| 对齐差异/修复报告 | `capture_output_dir` | 差异分析与修复说明 |
+
+---
+
+## 步骤2:生成需求规格
+
+> 📦 依赖:homegraph(必需)。
+
+> 👤 前置:用户编写 `REQ.txt` 文件 — 以自然语言描述原始需求，如有多个需求则在文件中使用空行进行分隔，需求中建议包含页面跳转路径的说明以及业务逻辑的描述。
+
+`REQ.txt` 示例:
+
+```text
+设置-歌词-歌词界面-卡拉OK歌词动画兼容策略（播放页歌词设置同步实现）
+逐字歌词效果，默认是当前行
+    1,当前行：只为前歌曲的歌词中有单字时间戳的歌词行显示逐字特效
+    2,扩展全部：当前歌曲的歌词中只要有一行歌词带单字时间戳，所有歌词行都显示逐字特效
+    3,总是：当前歌曲所有歌词行都显示逐字特效
+
+设置-用户界面-圆形播放封面（圆形支持旋转）
+开关，默认关闭，打开后，在播放页以圆形展示封面，并且自动旋转
+
+设置-用户界面-允许不规则封面（支持长方形封面，参考无归）
+开关，默认打开，播放页封面以大小一致的正方形展示，打开后，在播放页封面以原始样式展示
+
+设置-歌词-悬浮窗状态栏歌词
+开关 ，默认关闭，打开前需要申请悬浮窗权限，打开后在悬浮窗滚动展示歌词
+    1,左右位置：默认0%
+    2,上下位置：默认0px
+    3,宽度：默认150dp
+    4,大小：默认14.0dp
+    5,选择颜色：默认蓝色
+    6,歌词文本居左对齐：开关 默认关闭，歌词在设置的宽度内中对齐
+    7,状态栏歌词不显示翻译：开关 默认关闭
+    8,在播放界面隐藏：开关 默认关闭 打开后如果切换到播放页，则不在悬浮窗区域显示歌词
+```
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-spec-generate，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-spec-generate requirement_description_file=<需求描述文件路径> android_project_dir=<安卓项目路径> spec_output_dir=<规格输出目录>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-spec-generate生成需求spec文档，传递的参数是 requirement_description_file=<需求描述文件路径> android_project_dir=<安卓项目路径> spec_output_dir=<规格输出目录>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `requirement_description_file` | **必选** | 需求描述 `.txt` 文件路径(每段以 `REQ` 开头,空行分隔) |
+| `android_project_dir` | **必选** | Android项目根目录路径(必须位于Git仓库内) |
+| `spec_output_dir` | **必选** | 规格文档输出目录(自动创建;每个REQ生成 `<feature>-SPEC.md` + `.trace/<feature>.md`) |
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| `<feature>-SPEC.md` | `spec_output_dir` | 每个REQ对应一份原子场景规格文档 |
+| `.trace/<feature>.md` | `spec_output_dir/.trace/` | 每个REQ对应的代码trace(homegraph探索结果) |
+
+---
+
+## 步骤3:逻辑代码转换流水线
+
+> 📦 依赖:DevEco Studio(必需,构建/评审修复);Node.js (≥ 18,运行 `self-test-runner.js` 等编译后的入口) + 鸿蒙真机(集成测试阶段需要,可经 `skip_test` 跳过)。
+
+> 👤 前置:
+> 1. 如果执行集成测试，需要**准备测试用例文档**:可由 [`hmos-test-case-generation` skill](#测试用例生成可独立运行产出喂给集成测试) 自动生成,其产出的 `test_case.md` 作为 `test_case_path` 传入;`pre_test_case.md` 为前置测试用例(非必须,用于测试用例的环境准备等),作为 `pre_test_case_path` 传入。
+> 2. 如果执行集成测试，需要**连接HarmonyOS真机**并且在DevEco Studio中[**配置签名**](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/networkboost-preparations#%E9%85%8D%E7%BD%AE%E7%AD%BE%E5%90%8D)。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-convert-pipeline，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-convert-pipeline android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> spec_file_path=<需求规格文档路径>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-convert-pipeline完成逻辑代码开发，代码检视，集成测试，传递的参数是 android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> spec_file_path=<需求规格文档路径>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `android_project_dir` | **必选** | Android项目根目录路径 |
+| `harmony_project_dir` | **必选** | HarmonyOS项目根目录路径 |
+| `spec_file_path` | **必选** | 需求规格文档路径(各阶段直接读取,无需复制到输出目录) |
+| `assets_output_path` | 可选 | 输出/报告文件存放目录(默认鸿蒙工程下 `.hometrans`,自动创建) |
+| `test_case_path` | 可选 | 自测用例文件路径(默认读输出目录下 `test_case.md`;不存在则跳过自测循环) |
+| `pre_test_case_path` | 可选 | 前置用例文件路径(默认读输出目录下 `pre_test_case.md`;存在才传给自测) |
+| `max_rounds_review` | 可选 | 代码检视循环最大轮数(正整数 `>= 1`,默认 `2`) |
+| `max_rounds_test` | 可选 | 自测循环最大轮数(正整数 `>= 1`,默认 `2`) |
+| `skip_test` | 可选 | `true` 跳过集成测试阶段(无真机验证环境时设为 `true`,默认 `false`) |
+
+> 参数按位置传递:要传某个可选参数,需先显式给出它前面的所有可选参数。
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| 已签名HAP | HarmonyOS项目下 `build/` | 通过自测/评审循环后的最终发布包 |
+| `pipeline-manifest.md` | `assets_output_path` | 流水线清单:阶段耗时、轮数、缺陷统计 |
+| 构建阶段报告 | `assets_output_path` | 编译错误与修复记录 |
+| 评审阶段报告 | `assets_output_path` | 代码检视报告与修复记录 |
+| 自测阶段报告 | `assets_output_path` | 测试结果、失败用例与修复记录 |
+
+---
+
+## 步骤4:人工验收
+
+**输入**
+
+| 输入 | 说明 |
+|------|------|
+| `pipeline-manifest.md` | 流水线清单与缺陷统计 |
+| 自测报告 | 集成测试skill/步骤3自测阶段产出的测试报告 |
+| 已签名HAP | 步骤3流水线产出的最终发布包 |
+
+**输出**
+
+| 产物 | 说明 |
+|------|------|
+| 可发布的HarmonyOS应用 | 已处理报告中的遗留缺陷/TODO,通过核心场景走查 |
+
+通读 `pipeline-manifest.md` 与自测报告,真机走查核心场景,处理报告中的遗留缺陷/TODO后发布。
+
+---
+
+## 独立skill能力
+
+以下能力包含在迁移流程中也可按需独立调用。
+
+### 资源转换
+
+> 📦 依赖:DevEco Studio中的java(可选,缺失时回退读取源码 `res/`)。
+
+> ⚠️ 提示:如果步骤1采用 **UI迁移**(`hmos-batch-ui-align`),则跳过当前能力(UI迁移内部已包含资源转换)。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-resources-convert，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-resources-convert android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> resource_mapping_path=<资源映射文档路径>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-resources-convert完成安卓应用到鸿蒙应用的资源转换，传递的参数是 android_project_dir=<安卓项目路径> harmony_project_dir=<鸿蒙项目路径> resource_mapping_path=<资源映射文档路径>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `android_project_dir` | **必选** | Android项目根目录路径(含 `build.gradle` 或 `build.gradle.kts`) |
+| `harmony_project_dir` | **必选** | HarmonyOS项目输出路径 |
+| `resource_mapping_path` | **必选** | Android ↔ HarmonyOS资源映射文档的完整输出路径(`.md`) |
+| `apk_path` | 可选 | Android APK文件路径;提供后跳过Gradle构建,直接用apktool解包该APK提取资源 |
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| `resources/` 目录 | HarmonyOS项目下 | 转换后的HarmonyOS资源(strings、colors、dimensions、images等) |
+| 资源映射文档 | `resource_mapping_path` | Android ↔ HarmonyOS资源条目映射(`.md`) |
+| 转换报告 | HarmonyOS项目下 | 资源转换过程与统计 |
+
+### 测试用例生成(可独立运行;产出喂给集成测试)
+
+> 📦 依赖:Node.js ≥ 22.18 / 23.6(必需,非LLM校验脚本 `validate.ts`、BFS crawler 和 mapping 转换脚本经 Node 原生类型擦除运行,无需编译、无依赖);ADB + Android 设备/模拟器(可选,仅在需 TCG 自动产 `ui_elements.json` 时需要);其余由LLM编排。
+
+TCG 的主流程是测试用例生成:输入 spec-generate 产出的 `<feature>-SPEC.md`(`## 场景N` 原子场景块),输出自带四诚实证据的 `test_case.md` / `pre_test_case.md`,可直接作为集成测试skill的 `test_case_path` / `pre_test_case_path`。
+
+`ui_elements.json` 是这个生成流程的可选软参照,用于把操作具化为真实控件路径。若没有传入 `ui-elements-path`,但提供了 `package` 或 `android-project-dir`,TCG 会先运行 viewtree-based UI elements mapping 生成:使用 `tools/bfs-crawl/android_viewtree_bfs_crawler.ts` 采集 Android 运行时 viewtree dump,再通过转换脚本生成 mapping。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-test-case-generation，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-test-case-generation spec-path=<SPEC文档路径> package=<包名>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-test-case-generation基于规格文档生成测试用例，传递的参数是 spec-path=<SPEC文档路径> package=<包名>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `spec-path` | **必选** | `<feature>-SPEC.md`(spec-generate 产出,含 `## 场景N` 原子场景块) |
+| `ui-elements-path` | 可选 | `ui_elements.json`(软参照,不保真、可缺;缺但给了 `package` 或 `android-project-dir` 时 TCG 自动产) |
+| `package` | 可选 | Android 应用包名(如 `com.example.app`);`ui-elements-path` 缺时直接用它跑 dump,优先于 `android-project-dir` |
+| `android-project-dir` | 可选 | Android 源码工程根目录;`package` 也缺时从 `build.gradle` 推导包名再跑 dump(需 ADB + 设备) |
+| `references-dir` | 可选 | 参考资料(操作定义/页面描述/模板/可复用前置用例库/特殊测试数据) |
+| `output-path` | 可选 | 输出目录;默认 `spec-path` 同级的 `testcase-output/` |
+
+**主要交付产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| `test_case.md` | `<output-path>/` 顶层 | 主测试用例(固定文件名,自带四诚实证据,作为下游 `hmos-integration-test` 的 `test_case_path`) |
+| `pre_test_case.md` | `<output-path>/` 顶层 | 前置用例(从「见前置用例」前提反向组装;无命中则不出) |
+| `review_notes.md` | `<output-path>/` 顶层 | 单一人工伴随件(阻塞区 + 非阻塞区合一;不得另产 `manual-intervention.md`) |
+
+> `output-path` 只放上表中的交付产物。运行时会在其同级创建 `{output-path}.work/`,保存 `_bfs_dump/`、`cases-report.json`、`md-report.json` 等过程产物。
+
+> 完成时 stdout 最后一行 `TCG_COMPLETE specs={N} ok={K} failed={A} output={output-path}`(N=场景数,K=两门均放行的场景数,A=留记号/FATAL的场景数)。
+
+### 集成测试(已包含在步骤3的流水线,也可以单独运行)
+
+> 📦 依赖:DevEco Studio(必需,真机调试);鸿蒙真机(必需)。
+
+打开本地editor(claude code,open code等),在会话中通过 `斜杠/ `或者 `自然语言 `的方式调用skill--hmos-integration-test，并且传递相关参数)
+
+斜杠调用方式举例
+```
+/hmos-integration-test test_case_path=<测试用例路径> hap_path=<签名HAP路径>
+```
+自然语言调用方式举例
+```
+帮我使用skill：hmos-integration-test基于测试用例完成鸿蒙应用的集成测试，传递的参数是 test_case_path=<测试用例路径> hap_path=<签名HAP路径>
+```
+
+**输入参数**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `test_case_path` | **必选** | `test_case.md` 测试用例文件路径 |
+| `hap_path` | **必选** | 已签名的HAP文件路径 |
+| `output_path` | 可选 | 报告输出目录 |
+| `pre_test_case_path` | 可选 | 前置用例文件路径 |
+| `android_project_dir` | 可选 | Android项目路径(修复时参考) |
+| `max_rounds` | 可选 | 测试-修复循环最大轮数(默认 `3`) |
+
+**输出产物**
+
+| 产物 | 位置 | 说明 |
+|------|------|------|
+| 测试报告 | `output_path` | 测试结果、通过/失败用例统计 |
+| 失败用例详情 | `output_path` | 失败用例的复现步骤与日志 |
+| 修复建议 | `output_path` | 针对失败用例的修复方向(进入测试-修复循环时生效) |