| name | openharmony-download |
| description | Interactive OpenHarmony source code download with mirror selection (GitCode/Gitee/GitHub), environment checking, branch selection, and real-time progress. Use when user requests:"下载 OpenHarmony", "download OpenHarmony", "下载源码", "获取源码", "拉取代码", "clone openharmony", or "repo init". |
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. 检查网络连接
