From caf353387283363aff1dc874e2add40c101089fd Mon Sep 17 00:00:00 2001 From: mofeng-git Date: Wed, 20 Aug 2025 19:28:39 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 在 .gitignore 中添加 CLAUDE.md 排除规则 - 删除 AUTO_DOWNLOAD.md 文件 --- .gitignore | 1 + AUTO_DOWNLOAD.md | 137 ----------------------------------------------- 2 files changed, 1 insertion(+), 137 deletions(-) delete mode 100644 AUTO_DOWNLOAD.md diff --git a/.gitignore b/.gitignore index e3fcca5e..712f1a76 100644 --- a/.gitignore +++ b/.gitignore @@ -21,3 +21,4 @@ /venv/ .vscode/settings.j/son kvmd_config/ +CLAUDE.md diff --git a/AUTO_DOWNLOAD.md b/AUTO_DOWNLOAD.md deleted file mode 100644 index d0e7682b..00000000 --- a/AUTO_DOWNLOAD.md +++ /dev/null @@ -1,137 +0,0 @@ -# 自动下载功能说明 - -## 概述 - -构建脚本现在支持自动下载缺失的文件。当构建过程中发现所需的镜像文件、DTB文件、配置文件或工具不存在时，系统会自动尝试从远程服务器下载。 - -## 功能特性 - -### 1. 智能下载策略 -- **首先尝试直接下载**：使用原始文件名从远程服务器下载 -- **失败后尝试压缩版本**：如果直接下载失败，自动尝试添加 `.xz` 后缀下载压缩版本 -- **自动解压**：如果下载的是 `.xz` 压缩文件，会自动解压 - -### 2. 支持的文件类型 -- **镜像文件**：各种设备的 Armbian 镜像 -- **DTB 文件**：设备树二进制文件 -- **配置文件**：JSON、CONF 等配置文件 -- **工具文件**：如 AmlImg 工具 - -### 3. 错误处理 -- 文件已存在时跳过下载 -- 下载失败时提供详细的错误信息 -- 解压失败时自动清理临时文件 - -## 配置 - -### 环境变量 -```bash -# 远程文件服务器前缀（默认值） -REMOTE_PREFIX="https://files.mofeng.run" - -# 本地源码路径（默认值） -SRCPATH="/mnt/src" -``` - -### 文件路径映射 -本地文件路径：`$SRCPATH/image/device/filename` -远程下载URL：`$REMOTE_PREFIX/image/device/filename` - -## 使用示例 - -### 1. 构建特定设备 -```bash -# 构建 Cumebox2（会自动下载所需文件） -./build/build_img.sh cumebox2 -``` - -### 2. 构建所有设备 -```bash -# 构建所有设备（会自动下载所有所需文件） -./build/build_img.sh all -``` - -### 3. 自定义远程服务器 -```bash -# 使用自定义的远程服务器 -REMOTE_PREFIX="https://your-server.com/files" ./build/build_img.sh cumebox2 -``` - -## 支持的文件列表 - -### Onecloud 设备 -- `image/onecloud/AmlImg_v0.3.1_linux_amd64` - AmlImg 工具 -- `image/onecloud/Armbian_by-SilentWind_24.5.0-trunk_Onecloud_bookworm_legacy_5.9.0-rc7_minimal_support-dvd-emulation.burn.img` - 源镜像 -- `image/onecloud/meson8b-onecloud-fix.dtb` - DTB 文件 - -### Cumebox2 设备 -- `image/cumebox2/Armbian_25.2.2_Khadas-vim1_bookworm_current_6.12.17_minimal.img` - 源镜像 -- `image/cumebox2/v-fix.dtb` - DTB 文件 -- `image/cumebox2/ssd` - SSD 脚本 -- `image/cumebox2/config.json` - OLED 配置文件 - -### Chainedbox 设备 -- `image/chainedbox/Armbian_24.11.0_rockchip_chainedbox_bookworm_6.1.112_server_2024.10.02_add800m.img` - 源镜像 -- `image/chainedbox/rk3328-l1pro-1296mhz-fix.dtb` - DTB 文件 - -### VM 设备 -- `image/vm/Armbian_25.2.1_Uefi-x86_bookworm_current_6.12.13_minimal.img` - 源镜像 - -### E900V22C 设备 -- `image/e900v22c/Armbian_23.08.0_amlogic_s905l3a_bookworm_5.15.123_server_2023.08.01.img` - 源镜像 - -### Octopus-Planet 设备 -- `image/octopus-flanet/Armbian_24.11.0_amlogic_s912_bookworm_6.1.114_server_2024.11.01.img` - 源镜像 -- `image/octopus-flanet/model_database.conf` - 配置文件 - -## 技术实现 - -### 核心函数 -```bash -download_file_if_missing(file_path) -``` - -### 工作流程 -1. 检查文件是否已存在 -2. 计算相对于 SRCPATH 的路径 -3. 确保目标目录存在 -4. 尝试直接下载 -5. 如果失败，尝试下载 .xz 版本 -6. 如果是 .xz 文件，自动解压 -7. 返回成功或失败状态 - -### 依赖工具 -- `curl` - 用于下载文件 -- `xz` - 用于解压 .xz 文件 -- `mkdir` - 用于创建目录 - -## 注意事项 - -1. **网络连接**：确保构建环境能够访问远程服务器 -2. **磁盘空间**：下载的文件可能很大，确保有足够的磁盘空间 -3. **权限**：确保脚本有权限创建目录和文件 -4. **防火墙**：确保防火墙允许 HTTP/HTTPS 连接 - -## 故障排除 - -### 常见问题 - -1. **下载失败** - - 检查网络连接 - - 验证 REMOTE_PREFIX 是否正确 - - 确认远程文件是否存在 - -2. **解压失败** - - 检查 xz 工具是否安装 - - 验证下载的文件是否完整 - -3. **权限错误** - - 确保脚本有足够的权限 - - 检查目标目录的权限设置 - -### 调试模式 -可以通过设置环境变量来启用更详细的输出： -```bash -export DEBUG=1 -./build/build_img.sh cumebox2 -``` \ No newline at end of file