feat(catalog): 将官方模型目录迁入公开Git仓库

model-catalog/official/README.md

@@ -0,0 +1,50 @@
+# EasyAI 官方模型目录
+
+本目录是官方基础模型定义的唯一维护位置。平台后端与独立 AI Gateway 只读消费，不另存维护源。目录内容不包含客户密钥、账号、平台绑定、价格、权限或运行策略。
+
+- 维护 JSON：`catalog.source.json`
+- 公开维护源：[catalog.source.json](https://git.51easyai.com/wangbo/easyai/raw/branch/main/model-catalog/official/catalog.source.json)
+- 消费端入口：[latest.json](https://git.51easyai.com/wangbo/easyai/raw/branch/main/model-catalog/official/latest.json)
+- Git 历史：[目录提交记录](https://git.51easyai.com/wangbo/easyai/commits/branch/main/model-catalog/official)
+
+公开地址免登录。只有进入 `main` 的 Git 内容才会对外生效；未提交文件、临时 JSON 和普通分支不会替换正式目录。旧 OSS/CDN 上传流程已停用。
+
+## 修改和发布
+
+使用 Node 22.22.0、Yarn 1.22.22，在最新主线创建工作分支：
+
+```bash
+cd model-catalog/official
+yarn install --frozen-lockfile --ignore-scripts
+# 编辑 catalog.source.json
+yarn format
+yarn validate
+yarn test
+yarn prepare-release --note "本次模型变更说明"
+yarn run check
+git diff
+```
+
+`prepare-release` 只生成 Git 文件，不上传、不推送，也不切换任何线上对象。它会对照当前 Git 提交的上一版目录，默认拒绝缺少已有模型的候选。新增、能力修改和下线分别审查；正常下线保留原 `catalogKey`，将 `status` 设为 `offline`，不要通过删记录表达退役。确需物理移除时，必须同时声明 `--allow-removals --removal-reason "具体原因"`，原因及移除项会进入版本快照。
+
+确认差异后，将维护源、`latest.json` 和本次 `releases/<版本>/catalog.json` 一起提交，经 PR 合入 `main`：
+
+```bash
+git add catalog.source.json latest.json releases/
+git commit -m 'feat(catalog): 说明本次模型变更'
+git push -u origin HEAD
+```
+
+平台后端配置项为 `CONFIG_OFFICIAL_MODEL_CATALOG_URL`，独立网关为 `AI_GATEWAY_OFFICIAL_MODEL_CATALOG_URL`，均使用上面的 `latest.json` 地址。目录同步后还须验收模型状态、身份和本地绑定、价格、权限不变；收录模型不代表上游账号已经可用。
+
+## 回退
+
+使用 `git log -- catalog.source.json` 查看历史，恢复选定提交中的定义，再准备一个新版本：
+
+```bash
+git restore --source=<历史提交> -- catalog.source.json
+yarn prepare-release --note "恢复指定历史提交的模型定义"
+yarn run check
+```
+
+审查差异、测试、提交并合入 `main` 后生效。回退也必须审查模型移除；历史中没有的新模型不会被静默删除。保留所有历史版本快照，不覆盖旧文件，不强推或重置公开分支。Git 提交记录用于确定修改人、时间、评审和内容差异；版本快照记录内容摘要及上一版本。