docs: add --version flag and version query API to TOOLS.md

2026-07-16 07:24:40 +00:00
parent 3a93f63dc3
commit 8974d571d2
1 changed files with 8 additions and 1 deletions
@@ -14,8 +14,13 @@ sudo dpkg -i latest.deb
 ## CLI 用法

 ```bash
-# 执行套件
+# 执行套件（最新版）
 agc run <work_dir> --suite-id <suite-id> --input key=value
+
+# 执行指定版本
+agc run <work_dir> --suite-id <suite-id> --version 1.0.0 --input key=value
+
+# 直接指定包地址
 agc run <work_dir> --package-url <url> --input key=value
 ```

@@ -25,6 +30,8 @@ agc run <work_dir> --package-url <url> --input key=value
 |------|------|
 | 浏览套件 | `GET https://suites.mercator.cn/api/v1/suites` |
 | 套件详情 | `GET https://suites.mercator.cn/api/v1/suites/{id}` |
+| 指定版本详情 | `GET https://suites.mercator.cn/api/v1/suites/{id}?version=1.0.0` |
+| 版本历史 | `GET https://suites.mercator.cn/api/v1/suites/{id}/versions` |
 | 发布套件（文件上传） | `POST https://suites.mercator.cn/publish/upload`（需 Gitea Token） |
 | 发布套件（Git 仓库） | `POST https://suites.mercator.cn/publish`（需 Gitea Token） |
 | API 文档 | `https://suites.mercator.cn/docs` |