name: harmonyos-linux-cli-dev description: 在 Linux 下使用 HarmonyOS Command Line Tools + SDK CLI 进行应用开发、构建、打包、安装、调试与日志排查。内置命令全集、文档刷新流程，以及可重复执行的一键环境安装/校验脚本。
HarmonyOS Linux CLI Dev Skill
Scope
用于以下场景：
- 纯命令行开发 HarmonyOS 应用（不依赖 IDE 图形界面）
- 设备连接、安装、启动、调试、日志抓取
- HAP/HSP/App/HQF/APPQF 打包与拆包
- Linux CI 环境的自动化构建与部署
Canonical References
- 入口页：
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-commandline-get - 已抓取子页 Markdown（技能内置）：
skills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs/*.md - 子页索引：
skills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs/README.md - 命令全集：
skills/harmonyos-linux-cli-dev/COMMANDS.md
Re-runnable Environment Scripts
- 环境安装脚本：
skills/harmonyos-linux-cli-dev/scripts/setup_harmonyos_env.sh - 环境校验脚本：
skills/harmonyos-linux-cli-dev/scripts/verify_harmonyos_env.sh
示例：
bash skills/harmonyos-linux-cli-dev/scripts/setup_harmonyos_env.sh
bash skills/harmonyos-linux-cli-dev/scripts/verify_harmonyos_env.sh
说明：
- 默认目标目录是
/home/ares/yyshm。 setup_harmonyos_env.sh会写入source /home/ares/yyshm/env.sh到~/.zshrc（幂等）。- 会配置
npm/ohpm镜像仓库与ohpmtrace 目录。
Refresh Workflow (Must Run First)
- 抓取入口页及命令行子页：
python3 skills/harmonyos-linux-cli-dev/scripts/fetch_harmonyos_commandline_pages.py --out-dir skills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs
- 重新生成自动提取索引（可选）：
python3 skills/harmonyos-linux-cli-dev/scripts/extract_harmonyos_cli_commands.py --docs-dir skills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs --out skills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs/COMMANDS.md
- 人工以
skills/harmonyos-linux-cli-dev/COMMANDS.md为准进行命令归档（去噪后版本）。
Linux Baseline Setup
# 1) 配置 Command Line Tools 到 PATH
export PATH=${COMMAND_LINE_TOOLS}/command-line-tools/bin:$PATH
# 2) 检查工具可见性
hdc version
bm help
aa help
hilog -h
param -h
Standard App Dev Pipeline (CLI)
- 构建：
./hvigorw clean
./hvigorw assembleHap # 或 assembleApp
- 安装：
hdc list targets
hdc install <path/to/app.hap>
# 或设备端 bm
hdc shell bm install -p /data/local/tmp/app.hap
- 启动 Ability：
hdc shell aa start -b <bundleName> -a <abilityName>
- 日志排查：
hilog -x
# 或
hdc shell hilog -w start
hdc file recv /data/log/hilog <local_path>
- 卸载：
hdc uninstall <bundleName>
# 或
hdc shell bm uninstall -n <bundleName>
Command Coverage Requirement
执行任务时，默认可调用并优先覆盖以下工具命令：
hdc,aa,bm,hilog,param,atm,anm,cem,edm,devicedebug,mediatoolapp_packing_tool.jar,app_unpacking_tool.jarhvigorw,ohpm,codelinter,hstack
详细参数与示例命令必须从以下文件引用：
skills/harmonyos-linux-cli-dev/COMMANDS.mdskills/harmonyos-linux-cli-dev/references/harmonyos-commandline-docs/*.md
Response Rules For This Skill
- 先给可直接执行的 Linux 命令，不先讲原理。
- 涉及设备操作时，先给
hdc list targets检查步骤。 - 命令不确定时，先输出
tool --help再给保守执行方案。 - 涉及打包签名时，明确区分 debug/release。
- 输出中必须标注命令适用工具（例如
bm或aa），避免混淆。