OpenHarmony Download Skill
OpenHarmony 源码下载 Skill - 对话式信息收集 + 环境检查 + 前台实时下载。
工作流程
选择镜像源
（AskUserQuestion 单选）
环境检查
（逐项对话式检查，失败时引导解决）
选择分支
（AskUserQuestion 单选）
选择目录
（AskUserQuestion 单选）
执行下载
（Bash 工具，前台实时输出）
对话流程
步骤 1：选择镜像源
AskUserQuestion
(
{
questions
:
[
{
header
:
"镜像源"
,
question
:
"请选择 OpenHarmony 镜像源"
,
options
:
[
{
label
:
"GitCode"
,
description
:
"推荐国内用户，速度最快"
}
,
{
label
:
"Gitee"
,
description
:
"国内用户"
}
,
{
label
:
"GitHub"
,
description
:
"国际用户"
}
]
,
multiSelect
:
false
}
]
}
)
步骤 2：环境检查
镜像源选择后，使用 Bash 工具逐项检查环境：
Bash
(
{
command
:
"bash scripts/check_env.sh git"
,
description
:
"Check git installation"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh git-lfs"
,
description
:
"Check git-lfs installation"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh python3"
,
description
:
"Check python3 installation"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh curl"
,
description
:
"Check curl installation"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh repo"
,
description
:
"Check repo installation"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh git-config"
,
description
:
"Check git configuration"
}
)
Bash
(
{
command
:
"bash scripts/check_env.sh disk-space"
,
description
:
"Check available disk space"
}
)
检查失败时
：显示错误 + 提供安装命令 + 等待用户修复 + 重新检查
常用安装命令
：
git:
sudo apt-get install git
(Ubuntu/Debian)
git-lfs:
sudo apt-get install git-lfs && git lfs install
repo: 见脚本输出的安装指引
Git 配置:
git config --global user.name "Your Name" && git config --global user.email "your-email@example.com"
步骤 3：选择分支
AskUserQuestion
(
{
questions
:
[
{
header
:
"分支"
,
question
:
"请选择 OpenHarmony 分支"
,
options
:
[
{
label
:
"master"
,
description
:
"主分支（最新开发代码）"
}
,
{
label
:
"OpenHarmony-5.1.0-Release"
,
description
:
"5.1.0 版本"
}
,
{
label
:
"OpenHarmony-5.0.3-Release"
,
description
:
"5.0.3 版本"
}
,
{
label
:
"OpenHarmony-5.0.2-Release"
,
description
:
"5.0.2 版本"
}
,
{
label
:
"OpenHarmony-5.0.1-Release"
,
description
:
"5.0.1 版本"
}
,
{
label
:
"OpenHarmony-4.1-Release"
,
description
:
"4.1 版本"
}
,
{
label
:
"自定义分支"
,
description
:
"输入自定义分支名"
}
]
,
multiSelect
:
false
}
]
}
)
步骤 4：选择目录
AskUserQuestion
(
{
questions
:
[
{
header
:
"目录"
,
question
:
"请选择下载目录"
,
options
:
[
{
label
:
"默认位置"
,
description
:
"~/OpenHarmony/[branch]/"
}
,
{
label
:
"自定义路径"
,
description
:
"指定其他位置"
}
]
,
multiSelect
:
false
}
]
}
)
步骤 5：确认并执行下载
显示配置摘要，使用
AskUserQuestion
确认是否开始：
// 显示配置摘要
Claude
:
好的，准备下载
OpenHarmony
源码：
配置摘要
:
-
镜像源
:
$
{
MIRROR
}
-
分支
:
$
{
BRANCH
}
-
目录
:
$
{
DOWNLOAD_DIR
}
-
并行任务
:
CPU
核心数
/
4
（自动计算）
下载将在前台运行，进度实时显示。
这将需要
30
分钟到数小时。
AskUserQuestion
(
{
questions
:
[
{
header
:
"确认"
,
question
:
"是否开始下载？"
,
options
:
[
{
label
:
"开始下载"
,
description
:
"立即开始下载 OpenHarmony 源码"
}
,
{
label
:
"返回重新配置"
,
description
:
"返回步骤1，重新选择配置"
}
]
,
multiSelect
:
false
}
]
}
)
如果选择"开始下载"
：
使用 Bash 工具执行下载脚本，传入用户选择的镜像源、分支和目录参数：
Bash
(
{
command
:
bash scripts/download_openharmony.sh -m
${
MIRROR
}
-b
${
BRANCH
}
${
CUSTOM_DIR
?
-d
${
CUSTOM_DIR
}
:
''
}
,
description
:
Download OpenHarmony
${
BRANCH
}
from
${
MIRROR
}
}
)
下载将在前台运行，进度实时显示。
如果选择"返回重新配置"
：
返回步骤1，重新选择镜像源、分支、目录。
脚本说明
download_openharmony.sh
必需参数:
-m
MIRROR 镜像源（gitcode
|
gitee
|
github）
-b
BRANCH 分支名
可选参数:
-d
DIR 下载目录（绝对路径）
-j
JOBS 并行任务数（默认: CPU核心数/4）
check_env.sh
用法: check_env.sh
<
check_type
检查类型: git | git-lfs | python3 | curl | repo | git-config | disk-space | all verify_download.sh 自动验证下载完整性（下载脚本自动调用）： 目录结构检查 foundation 子系统检查 ACE Engine 组件检查 关键文件检查 repo 状态检查 仓库完整性验证 验证结果处理 验证通过 ✓ 验证通过！OpenHarmony 源码完整。 后续步骤: 1. 配置编译环境 2. 全量编译代码: ./build.sh --ccache --product-name rk3568 验证失败 ✗ 验证发现问题 建议: 1. 同步缺失仓库: repo sync -c 2. 拉取 LFS 文件: repo forall -c 'git lfs pull' 3. 检查网络连接