---
docStatus: migration-only
---

# 旧 Git Bundle 清单（已退役历史格式）

仅用于识别历史内容；Git Bundle 作者入口已退役，当前定义统一由数据库维护。

> **Git Bundle 作者入口已退役。** Bundle Service 243.0.1 起，不再通过旧入口创建 Bundle Git 项目、绑定来源、从 Git 发布 Bundle 版本或解析 Git 作者引用。本页仅用于历史内容识别，不是可执行的开发流程。

当前可编辑定义和不可变发布内容统一使用 **BundleDefinition 23.0.0**，由 Bundle Service 数据库维护。完整流程见[定义与资源选择](/development/bundle-development/manifest/)及[Bundle 定义](/development/bundle-development/bundle-definition/)。资源自己的 Module、平台应用和后端源码项目继续使用各自的 Git 提交，不为 Bundle 创建空项目或伪造 Git 提交。

## 识别历史结构

历史 `BUNDLE` 项目曾以根目录 `baijimu.bundle.json` 保存作者文件。以下是 12.0.0 历史结构样本，保留它是为了读取归档和审计；它不是当前作者协议。

```json
{
  "schemaVersion": "12.0.0",
  "definition": {
    "resources": [
      {
        "resourceType": "MODULE",
        "resourceKey": "a054ef60-f64c-47cf-8b63-4dbdd05e5ef1",
        "semanticVersion": "1.3.0"
      },
      {
        "resourceType": "PLATFORM_APPLICATION",
        "resourceKey": "example-platform-app",
        "semanticVersion": "1.2.0"
      }
    ]
  }
}
```

历史字段规范见 [12.0.0 Schema](/contracts/bundle-project-manifest/12.0.0/schema.json)。历史文件根级 `definition.resources` 对应当前定义的根级 `resources`，`propertyDefinition` 与 `configuration` 同样移到当前定义根级；当前根级 `schemaVersion` 为 `23.0.0`。

资源仍使用 Owner 返回的准确 `resourceType`、`resourceKey`、`semanticVersion`；不能以名称、版本行 ID、latest 或版本范围替代。空资源集合只表示未选择资源，不会自动发现项目。历史字段、资源类型及非空配置必须按实际语义审查转换，不能只替换版本号或直接丢字段。

## 当前操作

使用 CLI 0.166.0 或更新版本，通过 `bundle definition read/update` 读取、修改完整数据库定义；更新带准确 `expectedRevision`。再使用 `bundle version create --definition-revision` 从准确修订创建不可变版本。参见[版本与交付](/development/bundle-development/version-and-delivery/)。数据库错误保持明确失败，不回退 Git。

旧 Git 新建、恢复绑定和发布命令会返回退役说明；不要创建新的 Bundle Git 项目绕过，也不要把应用自身必填的源码提交当作 Bundle 来源提交。

## 历史版本与未发布工作

历史不可变版本和来源元数据保持原样。按准确 BundleVersionId 读取 Owner 已冻结的内容；不能用当前 Git HEAD 或当前可编辑定义证明旧版本内容。管理员可用 `bundle maintenance version-source` 读取准确版本，不需要重新绑定项目。

仓库归档与当前定义切换分别处理。迁移前核对准确主线、所有分支、未提交及未推送内容；保留可恢复归档，再由项目 Owner 处理旧项目。未知归属、并发修改或无法确定语义的内容停止该对象，不覆盖数据库中后续合法变更。

Bundle 管理器是可选的来源关系，跨版本维护，不来自历史插件数组。当前关系操作见[Bundle 管理器](/development/bundle-development/advanced/lifecycle-plugins/)。