wangbo
9547a027a2
Test deployment public URL (Linux) / test-linux (push) Canceled after 0s
Test start.ps1 (Windows) / test-windows (push) Canceled after 0s
Test deployment public URL (Linux) / test-linux (pull_request) Canceled after 0s
Test start.ps1 (Windows) / test-windows (pull_request) Canceled after 0s
51 lines
2.8 KiB
Markdown
51 lines
2.8 KiB
Markdown
# 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 提交记录用于确定修改人、时间、评审和内容差异；版本快照记录内容摘要及上一版本。
|