instance-repo 1.1.1.dev0__tar.gz → 1.1.2__tar.gz

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instance-repo
-Version: 1.1.1.dev0
+Version: 1.1.2
 Summary: InstanceRepo SDK — 评测 Instance 统一存储客户端（SDK-only；控制面由 apiserver 承载）
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -149,9 +149,10 @@ keys = repo.list_user_data(uid)
 irepo --help
 # 全局参数：--api-env / --api-base / --cluster / --storage-env / --metadata-model / --profile
 # 无 --api-key：凭据只从 AP_API_KEY（旧别名 INSTANCEREPO_TOKEN）读取，避免进 shell history
-# 18 个子命令：validate / push / push-many / deliver / pull / list / get
+# 20 个子命令：validate / push / push-many / deliver / pull / list / get
 #              publish / grant / feedback / report / whoami / user-data
 #              repo-config / create / claim / version / image
+#              split（list/get/set-run-type）/ dataset（list/get/update/access/revoke/benchmarks/workflows）
 irepo image ref --dataset alibaba/mybench --instance-id inst-1 --split test
 irepo image pull '<acr>/<ns>/mybench:test-inst-1' ./out.tar
 ```

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/README.md

@@ -136,9 +136,10 @@ keys = repo.list_user_data(uid)
 irepo --help
 # 全局参数：--api-env / --api-base / --cluster / --storage-env / --metadata-model / --profile
 # 无 --api-key：凭据只从 AP_API_KEY（旧别名 INSTANCEREPO_TOKEN）读取，避免进 shell history
-# 18 个子命令：validate / push / push-many / deliver / pull / list / get
+# 20 个子命令：validate / push / push-many / deliver / pull / list / get
 #              publish / grant / feedback / report / whoami / user-data
 #              repo-config / create / claim / version / image
+#              split（list/get/set-run-type）/ dataset（list/get/update/access/revoke/benchmarks/workflows）
 irepo image ref --dataset alibaba/mybench --instance-id inst-1 --split test
 irepo image pull '<acr>/<ns>/mybench:test-inst-1' ./out.tar
 ```

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/__init__.py

@@ -18,7 +18,7 @@ from .errors import (
     TransportError,
 )
 
-__version__ = "1.1.1.dev0"
+__version__ = "1.1.2"
 
 __all__ = [
     "Repo", "load_instances",

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/artifacts.py

@@ -160,15 +160,19 @@ def fetch_job_info(api_key: str, job_id: str, cluster: str,
 
 def fetch_group_job_ids(api_key: str, group_id: str, cluster: str,
                         ap_endpoint: str | None = None) -> list[str]:
-    """调 AP GET /groups/{group_id}/jobs 分页收集全部 job_id。"""
-    endpoint = (ap_endpoint or os.environ.get("INSTANCE_REPO_AP_ENDPOINT")
-                or DEFAULT_AP_ENDPOINT).rstrip("/")
+    """调 AP GET /api/groups/{group_id}/jobs 分页收集全部 job_id。
+
+    endpoint 解析与 fetch_job_info 完全一致（复用 _ap_endpoint），
+    且 URL 必须带 /api 前缀：AP 网关的裸 /groups/{id}/jobs 路径返回
+    控制台 HTML 页（HTTP 200），json 解析会报错（真机实测）。
+    """
+    endpoint = _ap_endpoint(ap_endpoint)
     job_ids: list[str] = []
     skip = 0
     limit = 500
 
     while True:
-        url = (f"{endpoint}/groups/{group_id}/jobs"
+        url = (f"{endpoint}/api/groups/{group_id}/jobs"
                f"?skip={skip}&limit={limit}&include_post_process=false")
         headers = {
             "X-API-Key": api_key,

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/cli.py

@@ -284,24 +284,27 @@ def build_parser() -> argparse.ArgumentParser:
     gt.add_argument("--split", default=None,
                     help="实例所在 split；缺省为跨 split 检索")
 
-    ver = sub.add_parser("version", help="版本管理（create/list/status/update/set-run-type）")
+    ver = sub.add_parser("version", help="版本管理（create/list/status/update/set-run-type/ingest）")
     ver.add_argument("action",
                      choices=["create", "list", "status", "update",
-                              "set-run-type", "get"])
+                              "set-run-type", "get", "ingest"])
     ver.add_argument("ref", nargs="?",
-                     help="create/list: {L1}/{L2}；"
+                     help="create/list/ingest: {L1}/{L2}；"
                           "status/update/set-run-type: {L1}/{L2}/{version}"
                           "（或用 --dataset[/--version]）")
     ver.add_argument("--dataset", default=None, help="{L1}/{L2}")
     ver.add_argument("--version", default=None,
-                     help="create: 要创建的版本号；"
+                     help="create/ingest: 要处理的版本号（split_first 可省略）；"
                           "status/update/set-run-type: 目标版本（寻址用）")
     ver.add_argument("--storage-path", default=None,
                      help="create 用：oss://{bucket}/{prefix}")
     ver.add_argument("--storage-type", choices=["oss"], default="oss")
-    ver.add_argument("--splits", default=None, help="逗号分隔 split 名")
+    ver.add_argument("--splits", default=None,
+                     help="逗号分隔 split 名（create/ingest 用；ingest 与 --split 互斥）")
     ver.add_argument("--split", default=None,
-                     help="status 用：查 split 级真实记录（split_first 发布状态/目标路径）")
+                     help="status 用：查 split 级真实记录；"
+                          "ingest 用：只 ingest 该 split（与 --splits 互斥）——"
+                          "version 下 split 很多时强烈建议传，避免全量扫描拖垮事务")
     ver.add_argument("--status", choices=_STATUS_CHOICES, default=None,
                      help="update 用：版本状态流转")
     ver.add_argument("--run-type", choices=["train", "eval"], default=None,
@@ -309,19 +312,36 @@ def build_parser() -> argparse.ArgumentParser:
     ver.add_argument("--split-run-types", default=None,
                      help="split 级打标，格式 name=train,name2=eval（与 --run-type 互斥）")
     ver.add_argument("--environment", default=None,
-                     help="get 用：覆盖 profile 派生的 environment（pre/online）")
+                     help="get/ingest 用：覆盖 profile 派生的 environment（pre/online）")
+    ver.add_argument("--metadata-model", default=None,
+                     help="ingest 用：显式指定元数据模型（split_first/version_first）")
+    ver.add_argument("--dry-run", action="store_true",
+                     help="ingest 用：只预览扫描结果不落库")
+    ver.add_argument("--publish", action="store_true",
+                     help="ingest 用：完成后把 version 置 published")
+    ver.add_argument("--no-wait", action="store_true",
+                     help="ingest 用：立即返回 job 不轮询终态")
+    ver.add_argument("--poll-sec", type=float, default=5.0, dest="poll_sec",
+                     help="ingest 用：轮询间隔（秒）")
+    ver.add_argument("--timeout", type=float, default=1800.0, dest="timeout_sec",
+                     help="ingest 用：轮询超时（秒）")
+    ver.add_argument("--allow-layout-inference", action="store_true",
+                     help="ingest 用：放弃「split_first 无 version 必须给 splits」"
+                          "前置检查，交给服务端推断布局")
+    ver.add_argument("--cluster", default=None,
+                     help="ingest 用：运行时 cluster slug（覆盖 profile）")
 
     # ── 1.0.10 控制面管理子命令 ─────────────────────────────────────────────────
-    sp = sub.add_parser("split", help="split 记录管理（list/get/set-run-type）")
-    sp.add_argument("action", choices=["list", "get", "set-run-type"])
+    sp = sub.add_parser("split", help="split 记录管理（list/get/create/set-run-type）")
+    sp.add_argument("action", choices=["list", "get", "create", "set-run-type"])
     sp.add_argument("ref", nargs="?",
-                    help="list: {L1}/{L2}；get/set-run-type: {L1}/{L2}/{split}"
-                         "（或用 --dataset/--split）")
+                    help="list: {L1}/{L2}；get/set-run-type: {L1}/{L2}/{split}；"
+                         "create: {L1}/{L2}/{split}（或用 --dataset/--split）")
     sp.add_argument("--dataset", default=None, help="{L1}/{L2}")
     sp.add_argument("--split", default=None,
                     help="目标 split 名（get/set-run-type 用）")
     sp.add_argument("--version", default=None,
-                    help="list 按 version 精确过滤；get 可选定位版本")
+                    help="list 按 version 精确过滤；get 可选定位版本；create 必填")
     sp.add_argument("--scope", choices=["unversioned", "exact", "all"], default=None,
                     help="list 跨版本策略：缺省无 version → all（SDK 取全量哲学），"
                          "有 version 省略（服务端只接受 exact）")
@@ -329,9 +349,13 @@ def build_parser() -> argparse.ArgumentParser:
                     help="list 按状态过滤")
     sp.add_argument("--run-type", choices=["train", "eval", ""], default=None,
                     dest="run_type",
-                    help="set-run-type 用：train/eval 或空串清除")
+                    help="set-run-type/create 用：train/eval 或空串清除")
+    sp.add_argument("--storage-path", default=None, dest="storage_path",
+                    help="create 用：split 壳的 storage_path（缺省自动计算）")
     sp.add_argument("--page", type=int, default=1)
     sp.add_argument("--page-size", type=int, default=50, dest="page_size")
+    sp.add_argument("--environment", default=None,
+                    help="create 覆盖 profile 派生的 environment（pre/online）")
 
     ds = sub.add_parser("dataset",
                         help="数据集/基准/工作流管理（list/get/update/access/"
@@ -449,7 +473,7 @@ def _resolve_split_ref(args) -> tuple[str, str]:
     if args.ref:
         segs = _split_ref(args.ref, 3)
         return f"{segs[0]}/{segs[1]}", segs[2]
-    raise SystemExit("split get/set-run-type 需要 {L1}/{L2}/{split} 或 "
+    raise SystemExit("split get/create/set-run-type 需要 {L1}/{L2}/{split} 或 "
                      "--dataset/--split")
 
 
@@ -870,6 +894,17 @@ def main(argv=None, *, repo: Repo | None = None, out=None) -> int:
         return 0
 
     if args.cmd == "version":
+        # 非法 flag 组合显式报错（此前静默忽略，用户传了却不生效极难自查）：
+        # --splits 只有 create/ingest 消费；--split 只有 status/ingest 消费
+        # （ingest 的 --split/--splits 互斥由 SDK 层拦截）。
+        if args.splits is not None and args.action in (
+                "status", "get", "set-run-type", "update"):
+            raise SystemExit(
+                f"argument --splits: not allowed with version action {args.action}")
+        if args.split is not None and args.action in (
+                "create", "update", "list", "get", "set-run-type"):
+            raise SystemExit(
+                f"argument --split: not allowed with version action {args.action}")
         srt = (_parse_split_run_types(args.split_run_types)
                if args.split_run_types else None)
         if args.action in ("create", "list"):
@@ -889,6 +924,32 @@ def main(argv=None, *, repo: Repo | None = None, out=None) -> int:
             print(f"created version {dv.dataset}/{dv.version} status={dv.status}",
                   file=out)
             return 0
+        if args.action == "ingest":
+            # ingest 寻址与 create/list 同为 parts=2（split_first 下 version 可省略）；
+            # --version 是业务参数不是寻址参数，故不能走 parts=3 的 _resolve_target。
+            dataset, _, _ = _resolve_target(args, 2)
+            splits = ([s.strip() for s in args.splits.split(",") if s.strip()]
+                      if args.splits else None)
+            job = r.versions.ingest(
+                dataset, args.version or None,
+                storage_path=args.storage_path, splits=splits,
+                split=args.split, metadata_model=args.metadata_model,
+                environment=args.environment,
+                allow_layout_inference=args.allow_layout_inference,
+                publish=args.publish, dry_run=args.dry_run,
+                wait=not args.no_wait, poll_sec=args.poll_sec,
+                timeout_sec=args.timeout_sec, cluster=args.cluster)
+            if args.dry_run:
+                for dv in job.get("versions") or []:
+                    print(f"version\t{dv.get('version', '')}\t"
+                          f"instances={dv.get('instance_count') or 0}"
+                          f"\tsplits={len(dv.get('splits') or [])}", file=out)
+                return 0
+            print(f"ingest {job.get('ingest_id', '')} "
+                  f"status={job.get('status', '')} "
+                  f"instances={job.get('stats', {}).get('instance_count') or 0}",
+                  file=out)
+            return 0
         dataset, version, _ = _resolve_target(args, 3)
         if args.action == "status":
             if args.split:
@@ -903,19 +964,17 @@ def main(argv=None, *, repo: Repo | None = None, out=None) -> int:
             # 1.0.10：取版本完整详情（splits 明细 + manifest + 时间戳）。
             # split_first 分支时服务端聚合 legacy 投影。
             dv = r.versions.get(dataset, version, environment=args.environment)
-            print(f"version\t{dv.get('version','')}\tstatus={dv.get('status','')}"
-                  f"\tstorage_path={dv.get('storage_path','')}", file=out)
-            print(f"published_at={dv.get('published_at') or ''}"
-                  f"\tlast_ingested_at={dv.get('last_ingested_at') or ''}",
-                  file=out)
-            print(f"dataset_version_id={dv.get('dataset_version_id','')}",
-                  file=out)
-            splits = dv.get("splits") or []
-            for s in splits:
-                print(f"  split\t{s.get('name','')}\tstatus={s.get('status','')}"
-                      f"\toss_prefix={s.get('oss_prefix','')}"
+            # versions.get 返回 DatasetVersion dataclass（字段访问，非 dict 取值）。
+            print(f"version\t{dv.version}\tstatus={dv.status}"
+                  f"\tstorage_path={dv.storage_path or ''}", file=out)
+            print(f"published_at={dv.published_at or ''}"
+                  f"\tlast_ingested_at={dv.last_ingested_at or ''}", file=out)
+            print(f"dataset_version_id={dv.dataset_version_id or ''}", file=out)
+            for s in dv.splits:
+                print(f"  split\t{s.get('name', '')}\tstatus={s.get('status', '')}"
+                      f"\toss_prefix={s.get('oss_prefix', '')}"
                       f"\tinstance_count={s.get('instance_count') or 0}", file=out)
-            manifest = dv.get("manifest") or {}
+            manifest = dv.manifest or {}
             print(f"manifest\tinstance_count={manifest.get('instance_count') or 0}"
                   f"\tfile_count={manifest.get('file_count') or 0}"
                   f"\tsize_bytes={manifest.get('size_bytes') or 0}", file=out)
@@ -952,6 +1011,22 @@ def main(argv=None, *, repo: Repo | None = None, out=None) -> int:
                       file=out)
             print(f"page={res.page}/{_page_count(res)} total={res.total}", file=out)
             return 0
+        if args.action == "create":
+            dataset, split_name = _resolve_split_ref(args)
+            if not (args.version or "").strip():
+                raise SystemExit(
+                    "split create 需要 --version（apiserver CreateVersion 硬约束）")
+            sp = r.splits.create(dataset, split_name,
+                                 version=args.version,
+                                 run_type=args.run_type,
+                                 storage_path=args.storage_path,
+                                 environment=args.environment)
+            src = "projected" if sp.projected else "record"
+            print(f"created split\t{sp.name}\tversion={sp.version or ''}"
+                  f"\tstatus={sp.status}\trun_type={sp.run_type or ''}"
+                  f"\t[{src}]", file=out)
+            print(f"storage_path={sp.storage_path}", file=out)
+            return 0
         # get / set-run-type：需要定位到具体 split
         dataset, split_name = _resolve_split_ref(args)
         if args.action == "get":

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/clients/instances.py

@@ -39,6 +39,21 @@ def _registry_overrides(environment: str | None,
     return overrides
 
 
+def _validate_custom_asset_rel(rel: str) -> None:
+    """白名单校验 custom 资产相对路径（防元数据被篡改造成 pull 路径穿越）。
+
+    push 侧用 ``Path.relative_to`` 生成 ``assets`` 清单是安全的；pull 侧**不能**
+    信任元数据：拒绝绝对路径、拒绝含 ``..`` 段、拒绝空。非法即抛 SchemaError，
+    不静默跳过。
+    """
+    if not rel:
+        raise SchemaError("custom 资产清单含空路径")
+    if rel.startswith("/") or rel.startswith("\\"):
+        raise SchemaError(f"custom 资产清单含绝对路径: {rel!r}")
+    if ".." in rel.replace("\\", "/").split("/"):
+        raise SchemaError(f"custom 资产清单含 '..' 段: {rel!r}")
+
+
 class InstancesClient:
     # registry 的 BASE 同值；此处独立声明使 list_paged/update 等纯控制面方法
     # 不依赖注入的 registry（直构客户端亦可调用）。
@@ -497,12 +512,19 @@ class InstancesClient:
             # 目录输入：生成最小元数据 JSON + 原样上传资产
             now_iso = _dt.datetime.now(_dt.timezone.utc).isoformat(
                 timespec="seconds").replace("+00:00", "Z")
+            # 先枚举资产相对路径并写入元数据 ``assets`` 字段：pull 还原时据此逐对象
+            # GetObject，免去 bucket LIST——普通用户的 dataset-RBAC STS 不含
+            # oss:ListObjects，靠 LIST 枚举资产会 403/DatasetIdentifierRequired。
+            asset_rels = sorted(
+                child.relative_to(local_path).as_posix()
+                for child in local_path.rglob("*") if child.is_file())
             meta_doc = {
                 "instance_id": instance_id,
                 "metadata_model": "custom",
                 "schema_version": CUSTOM_SCHEMA_VERSION,
                 "created_at": now_iso,
                 "updated_at": now_iso,
+                "assets": asset_rels,
             }
             raw_bytes = json.dumps(meta_doc, ensure_ascii=False).encode("utf-8")
             meta_digest = "sha256:" + hashlib.sha256(raw_bytes).hexdigest()
@@ -515,10 +537,8 @@ class InstancesClient:
             asset_prefix = (f"{lay.dataset_root(dataset)}"
                             f"{split}-assets/{instance_id}/")
             asset_digests = {}
-            for child in sorted(local_path.rglob("*")):
-                if not child.is_file():
-                    continue
-                rel = child.relative_to(local_path).as_posix()
+            for rel in asset_rels:
+                child = local_path / rel
                 key = asset_prefix + rel
                 data = child.read_bytes()
                 digest = "sha256:" + hashlib.sha256(data).hexdigest()
@@ -764,9 +784,22 @@ class InstancesClient:
                 self._content.get_object(
                     idx_key, dest, expected_digest=expected,
                     sts_prefix=sts_prefix, dataset=dataset)
-            # 下载资产目录（{split}-assets/{id}/ 前缀下的所有文件）
+                meta_bytes = dest.read_bytes()
+            # 从元数据 ``assets`` 字段还原资产清单，逐对象 GetObject——普通用户的
+            # dataset-RBAC STS 不含 oss:ListObjects，不能靠 LIST 枚举资产。
+            # 旧数据无 ``assets`` 字段时 asset_rels=None，由下游回退到 LIST。
+            asset_rels = None
+            if meta_bytes is not None:
+                try:
+                    meta_doc = json.loads(meta_bytes)
+                except (json.JSONDecodeError, UnicodeDecodeError):
+                    meta_doc = None
+                if isinstance(meta_doc, dict) and isinstance(
+                        meta_doc.get("assets"), list):
+                    asset_rels = [str(x) for x in meta_doc["assets"]]
             self._download_custom_assets(
-                dataset, instance_id, split, dest_dir, lay, sts_prefix)
+                dataset, instance_id, split, dest_dir, lay, sts_prefix,
+                asset_rels=asset_rels)
             return dest
 
         if fmt == "swe":
@@ -787,27 +820,49 @@ class InstancesClient:
                                  expected_digest=expected, layout=lay)
 
     def _download_custom_assets(self, dataset: str, instance_id: str,
-                                split: str, dest_dir, lay, sts_prefix: str
+                                split: str, dest_dir, lay, sts_prefix: str,
+                                asset_rels: list[str] | None = None
                                 ) -> list[Path]:
         """下载 custom 格式的资产目录（{split}-assets/{id}/ 前缀下的所有文件）。
 
         资产文件按相对路径还原到 ``{dest_dir}/{instance_id}/`` 下。返回已下载
         的本地文件路径列表。无资产时返回空列表（不报错）。
+
+        ``asset_rels`` 为元数据 ``assets`` 字段记录的资产相对路径清单：非 None 时
+        逐对象 GetObject 还原（普通用户的 dataset-RBAC STS 不含 oss:ListObjects，
+        不能靠 LIST 枚举）；为 None（旧数据无该字段）时回退到 LIST 枚举。
         """
         asset_prefix = (f"{lay.dataset_root(dataset)}"
                         f"{split}-assets/{instance_id}/")
+        dest_root = Path(dest_dir) / instance_id
+        downloaded: list[Path] = []
+
+        if asset_rels is not None:
+            # 元数据记录了资产清单：逐对象下载，免 LIST。
+            for rel in asset_rels:
+                if rel.endswith("/"):
+                    continue  # 目录占位符（push 侧不生成；兼容历史数据）
+                _validate_custom_asset_rel(rel)
+                local_path = dest_root / rel
+                local_path.parent.mkdir(parents=True, exist_ok=True)
+                self._content.get_object(
+                    asset_prefix + rel, local_path,
+                    sts_prefix=sts_prefix, dataset=dataset)
+                downloaded.append(local_path)
+            return downloaded
+
+        # 回退：旧数据无 assets 清单，用 LIST 枚举（仅 system 调用方有 LIST 权限）。
         list_fn = getattr(self._content, "list_objects", None)
         if list_fn is None:
             return []
         keys = list_fn(asset_prefix)
         if not keys:
             return []
-        downloaded: list[Path] = []
-        dest_root = Path(dest_dir) / instance_id
         for key in keys:
             rel = key[len(asset_prefix):]
-            if not rel or rel.endswith("/"):
-                continue  # 跳过空键和目录占位符
+            if rel.endswith("/"):
+                continue  # 目录占位符（push 侧不生成；兼容历史数据）
+            _validate_custom_asset_rel(rel)
             local_path = dest_root / rel
             local_path.parent.mkdir(parents=True, exist_ok=True)
             self._content.get_object(

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/clients/splits.py

@@ -222,6 +222,58 @@ class SplitsClient:
 
     # ── 写 ──
 
+    def create(self, dataset: str, split: str, *,
+               version: str, run_type: str | None = None,
+               storage_path: str | None = None,
+               environment: str | None = None) -> DatasetSplit:
+        """创建 split 记录——组合 versions.create(splits=[split]) 的便利封装。
+
+        apiserver **没有** split create 端点（``POST /datasets/splits`` 不存在）：
+        split 记录由 ingest 扫描 OSS 或 versions.create/update(splits=[...])
+        间接产生（pre 集合 find-or-upsert ensure 真实 split record）。本方法是
+        "先建空 split 壳"的官方路径升级为 SDK 直接 API：
+
+        1. ``versions.create(dataset, version, splits=[split])``（version **必填**
+           ——apiserver CreateVersion 硬约束；storage_path 缺省自动计算）；
+        2. 可选 ``run_type``：create 后经 versions.update(split_run_types) 打标；
+        3. 读回 ``splits.get``（同 environment）返回记录。
+
+        参数:
+          dataset      : dataset 名（必填）。
+          split        : split 名（必填）。
+          version      : version（必填——CreateVersion 硬约束）。
+          run_type     : 可选，train/eval（create 后打标）。
+          storage_path : 可选，缺省按 profile 自动计算（与 versions.create 同源）。
+          environment  : 可选，缺省由 profile 派生（pre/online）。
+
+        返回 :class:`~instance_repo.models.DatasetSplit`（读回；pre 集合 ensure
+        的 record 或 version 内嵌投影）。
+        """
+        from .versions import VersionsClient
+        if not (dataset or "").strip():
+            raise SchemaError("dataset is required for splits.create")
+        if not (split or "").strip():
+            raise SchemaError("split is required for splits.create")
+        if not (version or "").strip():
+            raise SchemaError(
+                "version is required for splits.create (apiserver CreateVersion "
+                "requires version; split records are created via versions.create)")
+        rt = (run_type or "").strip()
+        if rt and rt not in RUN_TYPE_VALUES:
+            raise SchemaError(
+                f"invalid run_type {rt!r}; must be one of "
+                f"{', '.join(RUN_TYPE_VALUES)} or None")
+        env = self._env(environment)
+        vc = VersionsClient(self._t, self._p)
+        vc.create(dataset, version, splits=[split],
+                  storage_path=storage_path, environment=env or None)
+        if rt:
+            # run_type 打标与 create 互斥字段：经 split_run_types 单独打（apiserver
+            # UpdateVersion 的 run_type/split_run_types/splits 两两互斥）。
+            vc.update(dataset, version, split_run_types={split: rt})
+        return self.get(dataset, split, version=version,
+                        environment=env or None)
+
     def update(self, dataset: str, split: str | None = None, *,
                version: str | None = None, run_type: str = "",
                dataset_split_id: str | None = None,

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo/models.py

@@ -124,7 +124,7 @@ class DatasetSeries:
     available_envs: list[str] = field(default_factory=list)
     # 服务端 `DatasetSeriesStatus`（"" 正常 / "deprecated"）；列表项
     # `DatasetListItem.Status` 带 `omitempty`，正常态不出现。
-    # 与 class 开头 status 字段合并到此位置。
+    status: str = ""
 
     def validate(self) -> None:
         if self.visibility not in VISIBILITY_VALUES:
@@ -139,11 +139,12 @@ class DatasetSeries:
         """create 请求体：剔除服务端派生/服务端分配的字段。
 
         teacher_direction / teacher_type 由 apiserver 从 benchmark 派生（传了也被忽略），
-        dataset_id 由服务端分配；dataset_l1 / dataset_l2 由 dataset_name 推导。都不发送，
+        dataset_id 由服务端分配；dataset_l1 / dataset_l2 由 dataset_name 推导。status
+        是服务端 DatasetSeriesStatus（deprecated 打标），create 不接受。都不发送，
         避免让调用方误以为这些值能由客户端决定。
         """
         drop = {"teacher_direction", "teacher_type", "dataset_id",
-                "dataset_l1", "dataset_l2"}
+                "dataset_l1", "dataset_l2", "status"}
         return {k: v for k, v in self.to_dict().items() if k not in drop}
 
 

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/instance_repo.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instance-repo
-Version: 1.1.1.dev0
+Version: 1.1.2
 Summary: InstanceRepo SDK — 评测 Instance 统一存储客户端（SDK-only；控制面由 apiserver 承载）
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -149,9 +149,10 @@ keys = repo.list_user_data(uid)
 irepo --help
 # 全局参数：--api-env / --api-base / --cluster / --storage-env / --metadata-model / --profile
 # 无 --api-key：凭据只从 AP_API_KEY（旧别名 INSTANCEREPO_TOKEN）读取，避免进 shell history
-# 18 个子命令：validate / push / push-many / deliver / pull / list / get
+# 20 个子命令：validate / push / push-many / deliver / pull / list / get
 #              publish / grant / feedback / report / whoami / user-data
 #              repo-config / create / claim / version / image
+#              split（list/get/set-run-type）/ dataset（list/get/update/access/revoke/benchmarks/workflows）
 irepo image ref --dataset alibaba/mybench --instance-id inst-1 --split test
 irepo image pull '<acr>/<ns>/mybench:test-inst-1' ./out.tar
 ```

{instance_repo-1.1.1.dev0 → instance_repo-1.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "instance-repo"
-version = "1.1.1.dev0"
+version = "1.1.2"
 description = "InstanceRepo SDK — 评测 Instance 统一存储客户端（SDK-only；控制面由 apiserver 承载）"
 requires-python = ">=3.10"
 readme = "README.md"