easyai/model-catalog/official/README.md

EasyAI 官方模型目录

本目录是官方基础模型定义的唯一维护位置。平台后端与独立 AI Gateway 只读消费，不另存维护源。目录内容不包含客户密钥、账号、平台绑定、价格、权限或运行策略。

• 维护 JSON：catalog.source.json
• 公开维护源：catalog.source.json
• 消费端入口：latest.json
• Git 历史：目录提交记录

公开地址免登录。只有进入 main 的 Git 内容才会对外生效；未提交文件、临时 JSON 和普通分支不会替换正式目录。旧 OSS/CDN 上传流程已停用。

修改和发布

使用 Node 22.22.0、Yarn 1.22.22，在最新主线创建工作分支：

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：

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 查看历史，恢复选定提交中的定义，再准备一个新版本：

git restore --source=<历史提交> -- catalog.source.json
yarn prepare-release --note "恢复指定历史提交的模型定义"
yarn run check

审查差异、测试、提交并合入 main 后生效。回退也必须审查模型移除；历史中没有的新模型不会被静默删除。保留所有历史版本快照，不覆盖旧文件，不强推或重置公开分支。Git 提交记录用于确定修改人、时间、评审和内容差异；版本快照记录内容摘要及上一版本。