ap-client 0.5.1.dev5__tar.gz → 0.6.0.dev1__tar.gz

{ap_client-0.5.1.dev5 → ap_client-0.6.0.dev1}/PKG-INFO

@@ -1,17 +1,18 @@
 Metadata-Version: 2.5
 Name: ap-client
-Version: 0.5.1.dev5
+Version: 0.6.0.dev1
 Summary: Agent Platform API Client & CLI
 Requires-Python: >=3.10
+Requires-Dist: irepo-artifact==0.2.1
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: requests>=2.28.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: websockets>=13.0
 Provides-Extra: all
-Requires-Dist: instance-repo[oss]==1.3.2.dev5; extra == 'all'
+Requires-Dist: instance-repo[oss]<2.0.0,>=1.3.2; extra == 'all'
 Provides-Extra: dataset
-Requires-Dist: instance-repo[oss]==1.3.2.dev5; extra == 'dataset'
+Requires-Dist: instance-repo[oss]<2.0.0,>=1.3.2; extra == 'dataset'
 Description-Content-Type: text/markdown
 
 A lightweight Python SDK and command line interface for Agent Platform. It provides helpers for configuring API access and managing templates, datasets, jobs, and groups.

{ap_client-0.5.1.dev5 → ap_client-0.6.0.dev1}/ap_client/api.py

@@ -539,11 +539,11 @@ class APIClient:
 
     def _post(self, path: str, data: Any, timeout: TimeoutType = None) -> Any:
         """Send a POST request."""
-        from .managed_ak import parameter_ak_ids, require_parameter_ak_ack
+        from .managed_ak import parameter_ak_usage, require_parameter_ak_ack
 
-        references = parameter_ak_ids(data) if path == "/jobs" else set()
+        references, selectors = parameter_ak_usage(data) if path == "/jobs" else (set(), set())
         result = self._request("POST", path, json_body=data, timeout=timeout)
-        require_parameter_ak_ack(result, references)
+        require_parameter_ak_ack(result, references, selectors)
         return result
 
     def _delete(self, path: str, *, params: Optional[dict] = None) -> Any:
@@ -709,13 +709,16 @@ class APIClient:
         request_id: str,
         duration_ms: float,
         exc: Exception,
+        *,
+        error_detail: str | None = None,
     ) -> None:
+        detail = str(exc) if error_detail is None else error_detail
         _write_stderr(
             [
                 f"!! Error {method} {url}",
                 f"   request_id={request_id}",
                 f"   duration_ms={duration_ms:.1f}",
-                f"   error={type(exc).__name__}: {exc}",
+                f"   error={type(exc).__name__}: {detail}",
             ]
         )
 

{ap_client-0.5.1.dev5 → ap_client-0.6.0.dev1}/ap_client/cli.py

@@ -25,7 +25,7 @@ from ap_client.api import (
 )
 from ap_client.config import ENV_VAR_SPECS, ConfigurationError, _parse_bool, normalize_output_format
 from ap_client.dataset_commands import register as _register_dataset_commands
-from ap_client.exporter import export_group, export_job
+from ap_client.exporter import export_group, export_job, export_jobs
 from ap_client.fs_commands import register as _register_fs_commands
 from ap_client.instance_commands import register as _register_instance_commands
 from ap_client.managed_ak import (
@@ -359,6 +359,22 @@ def _emit_error(message: str) -> None:
     error_console.print(f"[red]error: {message}[/]")
 
 
+def _read_client(share_token: Optional[str] = None, group_id: Optional[str] = None):
+    if group_id and not share_token:
+        raise typer.BadParameter("--group-id requires --share-token")
+    client = get_client()
+    if share_token is None:
+        return client
+    from ap_client.share_api import ShareAPIClient
+
+    # Typer verbose tracebacks must not render the share token in locals.
+    app.pretty_exceptions_show_locals = False
+    try:
+        return ShareAPIClient.from_client(client, share_token, group_id=group_id)
+    except ValueError as exc:
+        raise typer.BadParameter(str(exc)) from exc
+
+
 def _reject_account_pool_template_credential_cli(
     account_pool: Optional[str],
     *credential_types: Any,
@@ -3564,8 +3580,8 @@ def job_create(
         if dry_run:
             _emit_dry_run_warnings(dry_run_warnings)
             body["dry_run"] = True
-            result = client._post("/jobs", body, timeout=timeout)
             try:
+                result = client._post("/jobs", body, timeout=timeout)
                 require_managed_ak_ack(result, ak_id)
             except ManagedAKProtocolError as exc:
                 _emit_error(str(exc))
@@ -4427,6 +4443,9 @@ def job_create(
 @job_app.command("get")
 def job_get(
     job_id: str = typer.Argument(..., help="Job ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     include_params: bool = typer.Option(
         False,
         "--include-params",
@@ -4463,7 +4482,7 @@ def job_get(
         include_spec = include_spec or _field_path_requires_spec(field)
         if field == "job_spec_data.spec_yaml":
             spec_format = "yaml"
-    client = get_client()
+    client = _read_client(share_token)
     result = client.get_job(
         job_id,
         include_params=include_params,
@@ -4489,6 +4508,9 @@ def job_get(
 @job_app.command("containers")
 def job_containers(
     job_id: str = typer.Argument(..., help="Job ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     output_format: str = typer.Option(
         None,
         "--format",
@@ -4497,7 +4519,7 @@ def job_containers(
 ):
     """List container names for a job."""
     output_format = _normalize_output_format(output_format, keep_table=True)
-    client = get_client()
+    client = _read_client(share_token)
     result = client.get_job_containers(job_id)
     if output_format == "table":
         _print_records_table(result)
@@ -4559,6 +4581,9 @@ def _print_tail_logs(logs, tail: int) -> None:
 @job_app.command("logs")
 def job_logs(
     job_id: str = typer.Argument(..., help="Job ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     container: Optional[str] = typer.Option("main", "--container", "-c", help="Container name"),
     tail: Optional[int] = typer.Option(None, "--tail", "-n", help="Show only the last N log lines"),
     follow: bool = typer.Option(
@@ -4570,7 +4595,7 @@ def job_logs(
     ),
 ):
     """Show job logs."""
-    client = get_client()
+    client = _read_client(share_token)
 
     if tail is not None:
         if tail <= 0:
@@ -4634,6 +4659,9 @@ def job_logs(
 @job_app.command("events")
 def job_events(
     job_id: str = typer.Argument(..., help="Job ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     container: Optional[str] = typer.Option(None, "--container", "-c", help="Container name"),
     output_format: str = typer.Option(
         None,
@@ -4643,7 +4671,7 @@ def job_events(
 ):
     """Show job events."""
     output_format = _normalize_output_format(output_format)
-    client = get_client()
+    client = _read_client(share_token)
     result = client.get_job_events(job_id, container=container)
     if output_format == "plain":
         _print_job_events_plain(result)
@@ -4654,6 +4682,9 @@ def job_events(
 @job_app.command("metrics")
 def job_metrics(
     job_id: str = typer.Argument(..., help="Job ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     output_format: str = typer.Option(
         None,
         "--format",
@@ -4662,7 +4693,7 @@ def job_metrics(
 ):
     """Show job metrics."""
     output_format = _normalize_output_format(output_format)
-    client = get_client()
+    client = _read_client(share_token)
     result = client.get_job_metrics(job_id)
     if output_format == "plain":
         _print_json(result)
@@ -4859,6 +4890,9 @@ def job_retry(
 @job_app.command("artifacts")
 def job_artifacts(
     job_ids: str = typer.Argument(..., help="Job IDs (comma-separated for multiple)"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     output_format: str = typer.Option(
         None,
         "--format",
@@ -4867,7 +4901,7 @@ def job_artifacts(
 ):
     """Show job artifact download links."""
     output_format = _normalize_output_format(output_format, keep_table=True)
-    client = get_client()
+    client = _read_client(share_token)
     ids = [jid.strip() for jid in job_ids.split(",")]
     results = client.get_job_artifacts(ids)
     if output_format == "table":
@@ -4876,10 +4910,50 @@ def job_artifacts(
         _print_formatted(results, output_format)
 
 
+def _validate_export_timeout(value: float) -> float:
+    import math
+
+    if not math.isfinite(value) or value <= 0:
+        raise typer.BadParameter("Timeout must be a finite number greater than zero")
+    return value
+
+
+def _export_channel_reporter(emit):
+    """Report completed Jobs, including callbacks from Group worker threads."""
+    from threading import Lock
+
+    from rich.text import Text
+
+    counts = {"oss": 0, "proxy": 0}
+    lock = Lock()
+
+    def report(job_id, status, channel):
+        with lock:
+            suffix = ""
+            if status == "downloaded" and channel in counts:
+                counts[channel] += 1
+                suffix = f"  channel={channel}"
+            emit(Text(f"{job_id}  {status}{suffix}"))
+
+    return report, counts
+
+
 @job_app.command("export")
 def job_export(
-    job_id: str = typer.Argument(..., help="Job ID"),
+    job_id: str = typer.Argument(..., help="Job ID or comma-separated Job IDs"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Export with a share token"
+    ),
     output: Optional[Path] = typer.Option(None, "--output", "-o", help="Export directory"),
+    workers: int = typer.Option(
+        1, "--workers", "-w", min=1, help="Number of concurrent export workers"
+    ),
+    timeout: float = typer.Option(
+        300,
+        "--timeout",
+        callback=_validate_export_timeout,
+        help="SDK request timeout in seconds, not the total export duration",
+    ),
     logs: bool = typer.Option(False, "--logs", help="Include container logs"),
     events: bool = typer.Option(False, "--events", help="Include events"),
     no_extract_artifacts: bool = typer.Option(
@@ -4889,17 +4963,50 @@ def job_export(
     ),
 ):
     """Export job artifacts to a local directory. Use --logs/--events to include logs and events."""
-    client = get_client()
+    ids = list(dict.fromkeys(value.strip() for value in job_id.split(",")))
+    if not all(ids):
+        raise typer.BadParameter("Job IDs must not be empty", param_hint="job_id")
+    client = _read_client(share_token)
+    if len(ids) > 1:
+        report, channels = _export_channel_reporter(print)
+        dest, summary = export_jobs(
+            client,
+            ids,
+            output,
+            workers=workers,
+            result_callback=report,
+            timeout=timeout,
+            include_logs=logs,
+            include_events=events,
+            extract_artifacts=not no_extract_artifacts,
+        )
+        print(
+            f"Jobs exported: downloaded={summary.downloaded} "
+            f"skipped={summary.skipped} failed={len(summary.failures)}"
+        )
+        print(f"channels: oss={channels['oss']} proxy={channels['proxy']}")
+        print(f"  path: {dest}")
+        for failed_id, error in summary.failures.items():
+            print(f"[red]Failed job {failed_id}:[/] {error}")
+        if summary.failures:
+            raise typer.Exit(code=1)
+        return
+    job_id = ids[0]
+    result = {}
     dest = export_job(
         client,
         job_id,
         output,
+        result_callback=lambda jid, status, channel: result.update(status=status, channel=channel),
+        timeout=timeout,
         include_logs=logs,
         include_events=events,
         extract_artifacts=not no_extract_artifacts,
     )
     print(f"[green]Job exported:[/] {job_id}")
     print(f"  path: {dest}")
+    if result.get("channel") in {"oss", "proxy"} and result.get("status") == "downloaded":
+        print(f"  channel: {result['channel']}")
 
 
 @job_app.command("wait")
@@ -5674,6 +5781,9 @@ def group_list(
 @group_app.command("get")
 def group_get(
     group_id: str = typer.Argument(..., help="Group ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     output_format: str = typer.Option(
         None,
         "--format",
@@ -5682,7 +5792,7 @@ def group_get(
 ):
     """Show Group details."""
     output_format = _normalize_output_format(output_format, keep_table=True)
-    client = get_client()
+    client = _read_client(share_token, group_id if share_token else None)
     result = client.get_group(group_id)
     if output_format == "table":
         _print_detail(result)
@@ -6162,6 +6272,9 @@ def group_resume(
 @group_app.command("jobs")
 def group_jobs(
     group_id: str = typer.Argument(..., help="Group ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     tag: Optional[list[str]] = typer.Option(
         None, "--tag", help="Filter by tag (repeatable; multiple tags are combined with AND)"
     ),
@@ -6200,17 +6313,36 @@ def group_jobs(
     if cursor and skip > 0:
         raise typer.BadParameter("--cursor cannot be used with --skip greater than 0")
     cursor_request = bool(next_token) or cursor
-    client = get_client()
-    result = client.list_group_jobs(
-        group_id,
-        tag=tag,
-        include_post_process=include_post_process,
-        skip=skip,
-        limit=limit,
-        **({"next_token": next_token} if next_token else {}),
-        **({"pagination": "cursor"} if cursor_request else {}),
-        include_total=not no_total,
-    )
+    if share_token is not None:
+        unsupported = (
+            ("--tag", bool(tag)),
+            ("--include-post-process", include_post_process),
+            ("--next-token", bool(next_token)),
+            ("--cursor", cursor),
+            ("--no-total", no_total),
+        )
+        for option, used in unsupported:
+            if used:
+                _emit_error(f"{option} is not supported with --share-token")
+                raise typer.Exit(1)
+        if skip < 0 or not 1 <= limit <= 500:
+            raise typer.BadParameter(
+                "share pagination requires --skip >= 0 and 1 <= --limit <= 500"
+            )
+        client = _read_client(share_token, group_id if share_token else None)
+        result = client.list_jobs(group_id=group_id, skip=skip, limit=limit)
+    else:
+        client = get_client()
+        result = client.list_group_jobs(
+            group_id,
+            tag=tag,
+            include_post_process=include_post_process,
+            skip=skip,
+            limit=limit,
+            **({"next_token": next_token} if next_token else {}),
+            **({"pagination": "cursor"} if cursor_request else {}),
+            include_total=not no_total,
+        )
     if output_format == "table":
         _print_job_list_plain(result, rich=True)
     elif output_format == "plain":
@@ -6225,6 +6357,9 @@ def group_jobs(
 @group_app.command("stats")
 def group_stats(
     group_id: str = typer.Argument(..., help="Group ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     output_format: str = typer.Option(
         None,
         "--format",
@@ -6233,7 +6368,7 @@ def group_stats(
 ):
     """Show Group progress."""
     output_format = _normalize_output_format(output_format, keep_table=True)
-    client = get_client()
+    client = _read_client(share_token, group_id if share_token else None)
     result = client.get_group_stats(group_id)
     if output_format == "table":
         _print_detail(result)
@@ -6244,6 +6379,9 @@ def group_stats(
 @group_app.command("eval")
 def group_eval(
     group_id: str = typer.Argument(..., help="Group ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Read with a share token"
+    ),
     summary_only: bool = typer.Option(
         False,
         "--summary-only",
@@ -6257,7 +6395,7 @@ def group_eval(
 ):
     """Show Group aggregated evaluation results."""
     output_format = _normalize_output_format(output_format)
-    client = get_client()
+    client = _read_client(share_token, group_id if share_token else None)
     result = (
         client.get_group_eval_summary(group_id) if summary_only else client.get_group_eval(group_id)
     )
@@ -6370,10 +6508,19 @@ def group_access_list(group_id: str = typer.Argument(..., help="Group ID")):
 @group_app.command("export")
 def group_export(
     group_id: str = typer.Argument(..., help="Group ID"),
+    share_token: Optional[str] = typer.Option(
+        None, "--share-token", help="Export with a share token"
+    ),
     output: Optional[Path] = typer.Option(None, "--output", "-o", help="Export directory"),
     workers: int = typer.Option(
         4, "--workers", "-w", min=1, help="Number of concurrent export workers"
     ),
+    timeout: float = typer.Option(
+        300,
+        "--timeout",
+        callback=_validate_export_timeout,
+        help="SDK request timeout in seconds, not the total export duration",
+    ),
     logs: bool = typer.Option(False, "--logs", help="Include container logs"),
     events: bool = typer.Option(False, "--events", help="Include events"),
     no_extract_artifacts: bool = typer.Option(
@@ -6405,7 +6552,11 @@ def group_export(
         _emit_error("--include-files/--exclude-files cannot be used with --no-extract-artifacts")
         raise typer.Exit(1)
 
-    client = get_client()
+    if share_token is not None and (include_file_selectors or exclude_file_selectors):
+        _emit_error("--include-files/--exclude-files are not supported with --share-token")
+        raise typer.Exit(1)
+
+    client = _read_client(share_token, group_id if share_token else None)
     from rich.progress import BarColumn, Progress, TaskProgressColumn, TextColumn
 
     with Progress(
@@ -6434,12 +6585,15 @@ def group_export(
                 current_stage=current_stage,
             )
 
+        report, channels = _export_channel_reporter(progress.console.print)
         dest, summary = export_group(
             client,
             group_id,
             output,
             progress_callback=_on_progress,
             workers=workers,
+            result_callback=report,
+            timeout=timeout,
             include_logs=logs,
             include_events=events,
             extract_artifacts=not no_extract_artifacts,
@@ -6452,6 +6606,7 @@ def group_export(
         f"  [green]{summary.downloaded}[/] jobs downloaded, "
         f"[yellow]{summary.skipped}[/] jobs skipped (no artifact)"
     )
+    print(f"channels: oss={channels['oss']} proxy={channels['proxy']}")
     if summary.skipped_job_names:
         print(f"  Skipped: {', '.join(summary.skipped_job_names)}")
 

{ap_client-0.5.1.dev5 → ap_client-0.6.0.dev1}/ap_client/dataset_commands.py

@@ -15,6 +15,9 @@ from typing import TYPE_CHECKING, Any, List, Optional
 
 import typer
 
+from .repo_read_guard import STORAGE_SIDES as _STORAGE_SIDES
+from .repo_read_guard import oss_fallback_kwargs
+
 if TYPE_CHECKING:  # pragma: no cover - 仅用于类型标注,运行时不 import
     from datetime import datetime
 
@@ -316,13 +319,8 @@ def _env_kwargs(environment: str) -> dict:
     return {"environment": environment} if environment and environment != "auto" else {}
 
 
-#: 集群绑定存储 → 环境侧(dev 三个变体都是 pre 侧;元数据层它们归并到同一个 pre 集合)。
-_STORAGE_SIDES = {
-    "dev": "pre",
-    "internal-dev": "pre",
-    "external-dev": "pre",
-    "prod": "online",
-}
+def _read_env_kwargs(repo: Any, client: Any, method: str, environment: str) -> dict:
+    return {**_env_kwargs(environment), **oss_fallback_kwargs(repo, client, method, environment)}
 
 
 def _check_storage_side(repo: Any, environment: str) -> None:
@@ -419,7 +417,9 @@ def _model_dict(record: Any) -> dict:
         key: value
         for key, value in payload.items()
         if value is not None
-        and (key == "registered" or not (value is False or value == "" or value == [] or value == {}))
+        and (
+            key == "registered" or not (value is False or value == "" or value == [] or value == {})
+        )
     }
 
 
@@ -609,7 +609,7 @@ def _fetch_version(
         detail = repo.versions.get(
             dataset,
             version,
-            **_env_kwargs(env),
+            **_read_env_kwargs(repo, repo.versions, "get", env),
             **({"metadata_model": metadata_model} if metadata_model else {}),
         )
     except Exception as exc:  # noqa: BLE001 - 统一走设计 §5.1 的映射
@@ -646,19 +646,30 @@ def _unversioned_splits(
     env = _environment(environment)
     repo = _dataset_repo()
     try:
-        result = repo.splits.list(
-            dataset,
-            # CLI 语义:省略 --version 就是无版本空间。SDK 的缺省是 all(跨全部版本),不一样。
-            version_scope="unversioned",
-            page_size=_SPLIT_PAGE_SIZE,
-            **_env_kwargs(env),
-        )
+        records: list[dict] = []
+        page = 1
+        while True:
+            result = repo.splits.list(
+                dataset,
+                version_scope="unversioned",
+                page_size=_SPLIT_PAGE_SIZE,
+                **({"page": page} if page > 1 else {}),
+                **_read_env_kwargs(repo, repo.splits, "list", env),
+            )
+            items = getattr(result, "items", None) or []
+            for item in items:
+                record = _model_dict(item)
+                if not _version_value(record.get("version")):
+                    records.append(record)
+            if not items or getattr(result, "has_more", False) is not True:
+                break
+            page += 1
     except Exception as exc:  # noqa: BLE001 - 统一走设计 §5.1 的映射
         raise _fail(
             f"dataset {dataset} (no version space): {stage} failed: {_reason(exc)}",
             f"Check the dataset name and permission: ap dataset get {dataset}",
         ) from exc
-    return [_model_dict(item) for item in (getattr(result, "items", None) or [])]
+    return records
 
 
 def _unversioned_split(
@@ -670,13 +681,14 @@ def _unversioned_split(
     env = _environment(environment)
     repo = _dataset_repo()
     try:
-        record = repo.splits.get(dataset, split, **_env_kwargs(env))
+        record = repo.splits.get(dataset, split, **_read_env_kwargs(repo, repo.splits, "get", env))
     except Exception as exc:  # noqa: BLE001
         raise _fail(
             f"dataset {dataset} (no version space) split {split}: query failed: {_reason(exc)}",
             f"Check the dataset name and permission: ap dataset get {dataset}",
         ) from exc
-    return _model_dict(record) if record is not None else None
+    detail = _model_dict(record) if record is not None else None
+    return detail if detail is not None and not _version_value(detail.get("version")) else None
 
 
 def _split_records(detail: dict) -> list[dict]:
@@ -1120,7 +1132,11 @@ def _print_dataset_environments(repo: "Repo", dataset: str, detail: dict) -> Non
     rows: list[dict] = []
     for env in envs:
         try:
-            env_detail = _model_dict(repo.datasets.get_detail(dataset, environment=env))
+            env_detail = _model_dict(
+                repo.datasets.get_detail(
+                    dataset, **_read_env_kwargs(repo, repo.datasets, "get_detail", env)
+                )
+            )
         except Exception:  # noqa: BLE001 - 摘要尽力而为
             rows.append({"environment": env, "versions": "?", "splits": "?", "latest_version": "?"})
             continue
@@ -1155,7 +1171,9 @@ def dataset_get(
     env = _environment(environment)
     repo = _dataset_repo()
     try:
-        detail = repo.datasets.get_detail(dataset, **_env_kwargs(env))
+        detail = repo.datasets.get_detail(
+            dataset, **_read_env_kwargs(repo, repo.datasets, "get_detail", env)
+        )
     except Exception as exc:  # noqa: BLE001 - 统一走设计 §5.1 的映射
         if _business_code(exc) not in (92001, 94021):
             raise _fail(
@@ -1164,13 +1182,13 @@ def dataset_get(
             ) from exc
         detail = None
     if detail is None:
-        l1, _, l2 = dataset.partition("/")
         rendered = {
             "dataset_name": dataset,
-            "dataset_l1": l1,
-            "dataset_l2": l2,
             "registered": False,
         }
+        parts = dataset.split("/")
+        if len(parts) == 2 and all(parts):
+            rendered.update(dataset_l1=parts[0], dataset_l2=parts[1])
     else:
         rendered = _registered_dict(detail)
     _emit_detail(rendered, output_format, order=_DATASET_DETAIL_ORDER, always=("status",))
@@ -1294,7 +1312,11 @@ def dataset_claim(
     env = _environment(environment)
     repo = _dataset_repo()
     try:
-        detail = _model_dict(repo.datasets.get_detail(dataset, **_env_kwargs(env)))
+        detail = _model_dict(
+            repo.datasets.get_detail(
+                dataset, **_read_env_kwargs(repo, repo.datasets, "get_detail", env)
+            )
+        )
     except Exception as exc:  # noqa: BLE001 - 统一走设计 §5.1 的映射
         raise _fail(
             f"dataset {dataset}: pre-claim query failed: {_reason(exc)}",
@@ -1372,7 +1394,11 @@ def dataset_claim(
             owner = str(detail.get("owner") or "").strip()
             if not owner:
                 try:
-                    fresh = _model_dict(repo.datasets.get_detail(dataset, **_env_kwargs(env)))
+                    fresh = _model_dict(
+                        repo.datasets.get_detail(
+                            dataset, **_read_env_kwargs(repo, repo.datasets, "get_detail", env)
+                        )
+                    )
                     owner = str(fresh.get("owner") or "").strip()
                 except Exception:  # noqa: BLE001 - 取不到 owner 不影响幂等退出
                     owner = ""
@@ -1658,7 +1684,7 @@ def dataset_version_list(
             page=page,
             page_size=page_size,
             **({"metadata_model": model} if model else {}),
-            **_env_kwargs(env),
+            **_read_env_kwargs(repo, repo.versions, "list_paged", env),
         )
     except Exception as exc:  # noqa: BLE001 - 统一走设计 §5.1 的映射
         raise _fail(