Files
GSRL/README.md

2.7 KiB
Raw Blame History

GSRL — Global Source Release Lock

全局源码发行规范 v1.0

GSRL 是一套适用于所有独立 Git 项目的轻量发行约定,不是程序、包管理器或集中管理平台。无论项目使用哪种语言、运行在哪台设备、是否与 NavSea 有关,都遵守相同的正式交付规则。

核心规则

  1. 日常开发自由:普通改代码、调试、实验不强制执行 GSRL。
  2. 交付方负责发行:正式交付前,确认源码已 Commit / Push、可从 Git 恢复,并发布附有 SOURCE_LOCK.json 的固定版本。
  3. 使用方负责验收:只从项目公布的发行入口选择版本,检查 Source Lock、依赖、使用说明,并重新计算收到文件的 SHA-256。
  4. 版本不得偷换:同一正式版本不得改为不同的代码或交付文件;内容变化就发布新版本。

每个项目的发行入口

每个独立 Git 项目自行维护 release/README.md,列明版本系列、推荐版本、下载地址、兼容性与使用方法。发行包可以放在项目 Git、Gitea Releases 或其他稳定文件服务器,不要求大文件进入 Git。

示意目录:

project/
└── release/
    ├── README.md              # 版本目录与取用说明
    ├── 1.0.0/
    │   ├── SOURCE_LOCK.json   # 本次发行的来源与校验记录
    │   └── 使用说明.md
    └── 1.1.0/
        ├── SOURCE_LOCK.json
        └── 使用说明.md

一个仓库发行多个组件时,可按 release/<组件名>/<版本>/ 组织。单个 APK、AAR、数据包等产物可以把 SOURCE_LOCK.json 作为伴随文件提供。

规范与示例

可直接复制的 GPT 指令

两份 TXT 文件均为可直接全选复制的纯文本,不包含额外说明或 Markdown 代码围栏;它们是维护者的设置模板,不属于对外发行规范。

本仓库:https://git.eyaku.jp/tei/GSRL

本仓库公开可阅读;修改与发布规范必须使用获得授权的 Git/Gitea 账号。采用 GSRL 的其他项目无需公开其自身代码或发行包。