[ai] AIOS-5522 推理模板一键导入 — SDK/ApiHelper 占位

[zstack-robot-1]

说明

与 premium!13787 配对的占位 PR。

本 PR 目前无实质代码变更，待 premium 侧合并后在 Docker 环境执行以下步骤补齐：

./runMavenProfile premium
./runMavenProfile sdk
cd sdk && mvn install -DskipTests=true && cd ..
./runMavenProfile apihelper
# 将生成的 ApiHelper 覆盖 testlib/src/main/java/org/zstack/testlib/ApiHelper.groovy
./runMavenProfile docpremium

生成的 SDK + ApiHelper + API 文档模板将在后续 commit 补入本分支。

关联 premium PR：http://dev.zstack.io:9080/zstackio/premium/-/merge_requests/13787

sync from gitlab !9785

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: http://open.zstack.ai:20001/code-reviews/zstack-cloud.yaml (via .coderabbit.yaml)

Review profile: CHILL

Plan: Pro

Run ID: bead89c1-9e39-4c55-b44b-7924a9a6645c

📥 Commits

Reviewing files that changed from the base of the PR and between 1418759 and 3ba5085.

⛔ Files ignored due to path filters (10)

• sdk/src/main/java/SourceClassMap.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/CdnTemplateEntry.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromCdnAction.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromCdnResult.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromUploadAction.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromUploadResult.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromUrlAction.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/ImportModelServiceTemplateFromUrlResult.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/QueryCdnModelServiceTemplateListAction.java is excluded by !sdk/**
• sdk/src/main/java/org/zstack/sdk/QueryCdnModelServiceTemplateListResult.java is excluded by !sdk/**

📒 Files selected for processing (2)

• conf/db/upgrade/V5.5.22__schema.sql
• testlib/src/main/java/org/zstack/testlib/ApiHelper.groovy

---

概览

数据库架构迁移添加hasNewVersion列到ModelServiceVO表，以支持模板版本跟踪。测试库新增四个Groovy DSL助手方法，用于导入和查询模型服务模板。

变更说明

模型服务模板支持

层级 / 文件	说明
数据库架构 conf/db/upgrade/V5.5.22__schema.sql	ModelServiceVO表新增hasNewVersion TINYINT(1)列，默认为NULL，用于标记模板是否有新版本。
测试DSL助手 testlib/src/main/java/org/zstack/testlib/ApiHelper.groovy	添加四个Groovy方法：importModelServiceTemplateFromCdn、importModelServiceTemplateFromUpload、importModelServiceTemplateFromUrl和queryCdnModelServiceTemplateList。每个助手从Test.currentEnvSpec?.session?.uuid注入会话ID，配置并执行闭包，在启用apipath系统属性时条件性跟踪API路径。

预估代码审查工作量

🎯 2 (简单) | ⏱️ ~12 分钟

兔子的诗

🐰 版本追踪入数据库，
模板导入四般路。
CDN、上传、网址通，
查询模板一个命令，
测试辅助闭包灵，
助手们欢呼跳跃！

---

Important

Pre-merge checks failed

Please resolve all errors before merging. Addressing warnings is optional.

❌ Failed checks (1 error)

Check name	Status	Explanation	Resolution
Title check	❌ Error	PR标题不符合规定格式。应为 '[scope]: ' 格式且不超过72字符，但实际使用了中文标题和非标准格式。	修改标题为符合格式要求的英文标题，例如：'[feat][sdk]: Add model service template import helpers' (不超过72字符)。

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description check	✅ Passed	PR描述清晰地说明了这是一个占位PR，与premium!13787配对，并说明了后续需要执行的步骤来生成SDK和ApiHelper代码。
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch sync/zstackio/feat/AIOS-5522-import-template@@2

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}