diff --git a/.gitignore b/.gitignore index 797d52f..9c28801 100644 --- a/.gitignore +++ b/.gitignore @@ -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. diff --git a/AGENTS.md b/AGENTS.md index 7c6fff6..29b6f14 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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；秘密、本机状态、运行数据和可再生缓存继续按各自规则排除。 diff --git a/发布更新相关/README.md b/发布更新相关/README.md index 56010f2..2524233 100644 --- a/发布更新相关/README.md +++ b/发布更新相关/README.md @@ -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 不再追补或重复提醒，原发布记录保留。 普通开发不需要读取大型镜像或导出目录。只有用户明确要求导出镜像、维护离线依赖或更新编辑器时才进入本流程；但新增或删除软件运行依赖时，必须在同一次功能修改中同步 `其他依赖/`。 diff --git a/发布更新相关/导出包/1.0.3/matrix-screen-controller-1.0.3.img b/发布更新相关/导出包/1.0.3/matrix-screen-controller-1.0.3.img deleted file mode 100644 index 4c06c21..0000000 --- a/发布更新相关/导出包/1.0.3/matrix-screen-controller-1.0.3.img +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:a5676576fb63a913ed9e40a02ce206e5ef71f47b1005a98a8758479b51413e0b -size 3307208704 diff --git a/发布更新相关/导出包/1.1.1/matrix-screen-controller-1.1.1.img b/发布更新相关/导出包/1.1.1/matrix-screen-controller-1.1.1.img deleted file mode 100644 index 08eba92..0000000 --- a/发布更新相关/导出包/1.1.1/matrix-screen-controller-1.1.1.img +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:8356b75ef970891db951a08429f8e2d21a6c0c4933065001778e10d74022c19d -size 3307208704 diff --git a/发布更新相关/核桃派镜像/2025-3-6_V2.5.1_WalnutPi-1B_6.1.31_debian12_server.img b/发布更新相关/核桃派镜像/2025-3-6_V2.5.1_WalnutPi-1B_6.1.31_debian12_server.img deleted file mode 100644 index 0e61aac..0000000 --- a/发布更新相关/核桃派镜像/2025-3-6_V2.5.1_WalnutPi-1B_6.1.31_debian12_server.img +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:04a27c5da2244eded7bbc3dfb967582957a9540c7d61ef51cfdbaebeaa70d789 -size 3307208704 diff --git a/发布更新相关/核桃派镜像/README.md b/发布更新相关/核桃派镜像/README.md index 8945701..d808d73 100644 --- a/发布更新相关/核桃派镜像/README.md +++ b/发布更新相关/核桃派镜像/README.md @@ -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。