Stop tracking distributable IMG files

This commit is contained in:
2026-09-13 17:53:12 +08:00
parent a493fe1757
commit 912ba432cf
7 changed files with 12 additions and 18 deletions
+6 -3
View File
@@ -46,6 +46,9 @@ Desktop.ini
/.playwright-cli/
/output/playwright/
# Flashable disk images are distributed outside Git. Keep release metadata tracked.
*.img
# Image editor build caches. Released executables remain tracked elsewhere.
/发布更新相关/镜像编辑器/编辑器源代码/.build-venv/
/发布更新相关/镜像编辑器/编辑器源代码/.build/
@@ -53,6 +56,6 @@ Desktop.ini
/发布更新相关/镜像编辑器/编辑器源代码/dist/
/发布更新相关/镜像编辑器/编辑器源代码/*.spec
# Intentionally not ignored: 发布更新相关/核桃派镜像, 导出包, OTA数据包,
# 其他依赖, 镜像编辑器/编辑器程序, and 各种归档. This private repository
# stores those release and historical artifacts as ordinary Git objects.
# Intentionally not ignored: OTA数据包, 其他依赖, 镜像编辑器/编辑器程序,
# and 各种归档. Release README, manifests, checksums, and records remain tracked;
# IMG files are distributed separately and ignored above.
+1 -1
View File
@@ -91,4 +91,4 @@
- `发布更新相关/OTA数据包/` 中的 OTA 今后长期保留,不按可删除缓存清理;已缺失的 OTA 1.0.1 是用户接受的历史例外,不再追补、提醒或阻塞开发及使用。保留原发布记录,后续构建仍不得依赖历史包。
- 普通开发不检查历史 IMG 是否齐全;只有用户明确要求处理某个镜像时,才核对该任务实际需要的输入文件。官方基线和其他离线依赖按各自规则管理。
- 仓库内描述工作区文件时使用相对路径或 `<仓库根目录>`、`<受保护临时目录>` 等文字占位符,不固化盘符、Windows 用户目录、macOS 用户目录或开发者 home。核桃派上的 `/opt`、`/var/lib`、`/run`、`/boot`、`/usr/local` 等固定部署路径不属于此限制。
- 私有 Git 仓库保留正式 IMG、OTA、离线依赖、编辑器程序和历史归档;大体积二进制允许使用 Git LFS,不能通过扩大 `.gitignore` 省略应保留内容。只有秘密、本机状态、运行数据和可再生缓存由根 `.gitignore` 排除。
- 正式 IMG 通过仓库外的发行渠道保存,根 `.gitignore` 必须忽略所有 `*.img`;Git 只保留对应 README、manifest、SHA-256、发布记录等元数据,不得让源码、文档命令或后续构建依赖仓库中存在 IMG。OTA、离线依赖、编辑器程序和历史归档仍由私有 Git 仓库保留,大体积二进制可使用 Git LFS;秘密、本机状态、运行数据和可再生缓存继续按各自规则排除。
+3 -3
View File
@@ -4,13 +4,13 @@
| 目录 | 内容 | 生命周期 |
|---|---|---|
| `核桃派镜像/` | 未修改的官方 RAR、IMG 和摘要 | 稳定基线,不得原地修改 |
| `导出包/<版本>/` | Rufus 可写入的版本化 IMG | 用户可随时删除以节省空间;缺失默认正常,不影响开发,项目不得引用 |
| `核桃派镜像/` | 官方镜像说明、摘要及本地镜像暂存位置 | IMG 由仓库外渠道发行,不进入 Git;本地副本不得原地修改 |
| `导出包/<版本>/` | 版本化 IMG 的说明、manifest、摘要及本地产物位置 | IMG 由仓库外渠道发行,不进入 Git;缺失默认正常,不影响开发 |
| `其他依赖/` | AArch64 wheel、Debian 包、预编译内核、固定内核源码和依赖生命周期 | 随软件依赖同步维护 |
| `OTA数据包/<版本>/` | 版本化 OTA 更新包 | 今后长期保留,不作为后续构建输入;1.0.1 缺失为已接受的历史例外 |
| `镜像编辑器/` | Windows 编辑器源码和绿色程序 | 编辑器使用独立版本并覆盖旧程序 |
导出 IMG 缺失默认视为用户主动清理,不报故障、不追补、不自动重建,也不阻塞开发、常规测试或后续构建。OTA 今后保留;已缺失的 1.0.1 不再追补或重复提醒,原发布记录保留。
所有 `*.img` 均由仓库外渠道发行并被 Git 忽略;仓库只保留对应 README、manifest、SHA-256 和发布记录。官方基础 IMG 或导出 IMG 缺失默认视为本机尚未取得或用户主动清理,不报故障、不追补、不自动重建,也不阻塞开发、常规测试或后续构建。OTA 今后保留;已缺失的 1.0.1 不再追补或重复提醒,原发布记录保留。
普通开发不需要读取大型镜像或导出目录。只有用户明确要求导出镜像、维护离线依赖或更新编辑器时才进入本流程;但新增或删除软件运行依赖时,必须在同一次功能修改中同步 `其他依赖/`。
+2 -2
View File
@@ -1,8 +1,8 @@
# 核桃派官方原始镜像
本目录只保存未经项目修改的 WalnutPi Debian 12 V2.5.1 官方归档和解包 IMG。镜像导出器必须先复制 IMG,再修改副本;不得在这里直接写入软件、网络、账户或首次启动配置。
本目录保存 WalnutPi Debian 12 V2.5.1 官方镜像的说明与摘要,并作为仓库外取得的原始归档和解包 IMG 的本地暂存位置。`*.img` 不进入 Git;镜像导出器必须先复制本地 IMG,再修改副本,不得在这里直接写入软件、网络、账户或首次启动配置。
- RAR 是官方原始归档,不直接写卡。
- IMG 是构建可刷项目镜像的只读基线。
- IMG 是构建可刷项目镜像的只读基线,由仓库外渠道取得并仅保存在本地。
- 搬运或构建前使用 `SHA256SUMS` 校验。
- ZeroW 与 1B 使用同一官方镜像;项目真实硬件仍固定为 ZeroW/H618。