From 9da9c2d828e028c5adb5389e6e310568984e0de5 Mon Sep 17 00:00:00 2001 From: anycodes <21079031+anycodes@users.noreply.github.com> Date: Mon, 19 Oct 2026 09:16:26 +0000 Subject: [PATCH 1/2] docs: use canonical public sites in active guides --- .agents/README.md | 2 ++ .../2026-10-19-canonical-guide-links.md | 9 +++++++ .../2026-10-19-canonical-guide-links.md | 24 +++++++++++++++++++ CHANGELOG.md | 4 ++++ docs/en/README.md | 4 ++-- docs/en/guide/providers.md | 2 +- docs/zh/README.md | 4 ++-- docs/zh/guide/providers.md | 2 +- 8 files changed, 45 insertions(+), 6 deletions(-) create mode 100644 .agents/evidence/verify/2026-10-19-canonical-guide-links.md create mode 100644 .agents/notes/implemented/process/2026-10-19-canonical-guide-links.md diff --git a/.agents/README.md b/.agents/README.md index 7becc14..db23e2e 100644 --- a/.agents/README.md +++ b/.agents/README.md @@ -93,3 +93,5 @@ Builtin transport: [direct HTTP](notes/implemented/architecture/2026-10-18-nativ - [Conditional Express acceptance](notes/proposed/feature/2026-10-19-conditional-acceptance.md) · [verification](evidence/verify/2026-10-19-conditional-acceptance.md) - [Dispatch native server startup before readiness](notes/implemented/feature/2026-10-19-server-start-acknowledgement.md) · [verification](evidence/verify/2026-10-19-server-start-acknowledgement.md) + +- [Canonical guide links](notes/implemented/process/2026-10-19-canonical-guide-links.md) · [verification](evidence/verify/2026-10-19-canonical-guide-links.md) diff --git a/.agents/evidence/verify/2026-10-19-canonical-guide-links.md b/.agents/evidence/verify/2026-10-19-canonical-guide-links.md new file mode 100644 index 0000000..0f84eb1 --- /dev/null +++ b/.agents/evidence/verify/2026-10-19-canonical-guide-links.md @@ -0,0 +1,9 @@ +# Verification: canonical active-guide links — 2026-10-19 + +Result: PASS for public destinations and documentation scope; current-head hosted gates required before merge. + +Canonical https://www.agent-sandbox.cn/ and https://registry.agent-sandbox.cn/ independently return HTTP200. Updated active English/Chinese documentation indexes/provider references and CLI installation/engine references where present. The .com registry does not resolve from this environment; .com website returns different/older content. No DNS, runtime endpoint, dependency, credential, repository visibility or historical evidence changed. + +The change follows the release-readiness review. Repository health/hygiene, exact changed paths and latest-head CI are recorded before delivery. Existing installed artifact/cloud results remain linked from the accepted release records, without claiming a new E2E run for link-only edits. + +Local gates: repository health 106 PASS/1 WARN/0 FAIL; hygiene and diff whitespace PASS. Only docs/records/CHANGELOG change. Current-head hosted gates remain required. diff --git a/.agents/notes/implemented/process/2026-10-19-canonical-guide-links.md b/.agents/notes/implemented/process/2026-10-19-canonical-guide-links.md new file mode 100644 index 0000000..8914e7f --- /dev/null +++ b/.agents/notes/implemented/process/2026-10-19-canonical-guide-links.md @@ -0,0 +1,24 @@ +# Decision: Use verified canonical site links in active guides + +Status: implemented + +## Problem +Root README links were corrected, but bilingual documentation indexes and provider guides still send visitors to the older website or the unresolvable .com registry. + +## Decision +Use the current canonical .cn website and registry in active guidance. Preserve historical design/archive evidence and all runtime endpoints. + +## API Design +N/A — public documentation links only; configuration/API contracts do not change. + +## Alternatives considered +Leaving only README correct still breaks guide navigation. Changing DNS or repository visibility is unnecessary and not authorized by this correction. + +## Dependencies +Canonical www.agent-sandbox.cn and registry.agent-sandbox.cn were independently read HTTP200 during the release-readiness audit. Related consumer update: https://github.com/Alibaba-Agent-Sandbox/website/pull/13 . + +## Test Strategy +Verify actual URLs, both language counterparts, hygiene/health and existing hosted documentation gates. No cloud/model test is needed for prose links. + +## Acceptance criteria +Active documentation uses working canonical destinations, both languages match, owner evidence and current-head checks pass before merge. Later catalog aggregation reads the accepted source. diff --git a/CHANGELOG.md b/CHANGELOG.md index d19c4c7..ef8db8e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/). ## [Unreleased] +### Documentation + +- Use the verified canonical website and registry links in active English/Chinese guides. + ### Fixed - Start native SandboxServer processes before reporting readiness; bound startup acknowledgement, drain output without accumulation and release local readers while retaining remote ownership. / 原生 SandboxServer 启动先确认进程，限制等待并释放本地读取连接，保留远程资源所有权。 diff --git a/docs/en/README.md b/docs/en/README.md index 76cfbcf..093a573 100644 --- a/docs/en/README.md +++ b/docs/en/README.md @@ -8,8 +8,8 @@ Agent Sandbox is a sandbox SDK with pluggable providers. The default provider is | Site | URL | |---|---| -| Official site | https://www.agent-sandbox.com | -| Provider registry | https://registry.agent-sandbox.com | +| Official site | https://www.agent-sandbox.cn | +| Provider registry | https://registry.agent-sandbox.cn | The installer fetches the catalog index at `https://registry.agent-sandbox.cn/providers/index.json`. `ABX_PROVIDER_REGISTRY` overrides that URL. diff --git a/docs/en/guide/providers.md b/docs/en/guide/providers.md index 6f319b8..31a66a4 100644 --- a/docs/en/guide/providers.md +++ b/docs/en/guide/providers.md @@ -4,7 +4,7 @@ This guide describes asynchronous `ProviderSandbox` provider extensions. Root `S > **Note:** The `abx provider ...` commands on this page are provided by the Node.js CLI in the `cli` repository. Python-only users get the same operations from `python -m agent_sandbox.providers ...`. Both use the same install directory, the same receipts and the same tree digest. -A **provider** is a sandbox backend. The SDK and the CLI ship only `alicloud-express`. The others install with `python -m agent_sandbox.providers install registry: --yes` from `https://registry.agent-sandbox.cn/providers/index.json`. A background check writes newer versions to `~/.abx/providers/updates.json`. `ABX_PROVIDER_UPDATE_CHECK=0` turns the check off. `ABX_PROVIDER_REGISTRY` changes the index URL. The official site is . The registry website is . +A **provider** is a sandbox backend. The SDK and the CLI ship only `alicloud-express`. The others install with `python -m agent_sandbox.providers install registry: --yes` from `https://registry.agent-sandbox.cn/providers/index.json`. A background check writes newer versions to `~/.abx/providers/updates.json`. `ABX_PROVIDER_UPDATE_CHECK=0` turns the check off. `ABX_PROVIDER_REGISTRY` changes the index URL. The official site is . The registry website is . | Id | Name | Kind | Default | |---|---|---|---| diff --git a/docs/zh/README.md b/docs/zh/README.md index 4fc8e37..5ee6192 100644 --- a/docs/zh/README.md +++ b/docs/zh/README.md @@ -8,8 +8,8 @@ Agent Sandbox 是可切换提供方的沙箱 SDK。默认提供方是阿里云 | 网站 | 地址 | |---|---| -| 官网 | https://www.agent-sandbox.com | -| 提供方注册站 | https://registry.agent-sandbox.com | +| 官网 | https://www.agent-sandbox.cn | +| 提供方注册站 | https://registry.agent-sandbox.cn | 安装器拉取的目录索引是 `https://registry.agent-sandbox.cn/providers/index.json`。`ABX_PROVIDER_REGISTRY` 可以改这个地址。 diff --git a/docs/zh/guide/providers.md b/docs/zh/guide/providers.md index f9cdff4..5cfb613 100644 --- a/docs/zh/guide/providers.md +++ b/docs/zh/guide/providers.md @@ -4,7 +4,7 @@ > **说明：** 本页的 `abx provider ...` 命令由 `cli` 仓库中的 Node.js CLI 提供。只用 Python 的用户可以用 `python -m agent_sandbox.providers ...` 完成同样的操作。两者使用相同的安装目录、相同的回执和相同的目录树摘要。 -**提供方**就是一个沙箱后端。SDK 和 CLI 只内置 `alicloud-express`。其余提供方用 `python -m agent_sandbox.providers install registry: --yes` 安装，索引是 `https://registry.agent-sandbox.cn/providers/index.json`。启动时会在后台对照这份索引检查更新，结果写到 `~/.abx/providers/updates.json`。`ABX_PROVIDER_UPDATE_CHECK=0` 关掉检查。`ABX_PROVIDER_REGISTRY` 可以改索引地址。官网是 。提供方注册站是 。 +**提供方**就是一个沙箱后端。SDK 和 CLI 只内置 `alicloud-express`。其余提供方用 `python -m agent_sandbox.providers install registry: --yes` 安装，索引是 `https://registry.agent-sandbox.cn/providers/index.json`。启动时会在后台对照这份索引检查更新，结果写到 `~/.abx/providers/updates.json`。`ABX_PROVIDER_UPDATE_CHECK=0` 关掉检查。`ABX_PROVIDER_REGISTRY` 可以改索引地址。官网是 。提供方注册站是 。 | Id | 名称 | 类型 | 默认 | |---|---|---|---| From 1f50a1facaf0196591146792beecb430db643f0e Mon Sep 17 00:00:00 2001 From: anycodes <21079031+anycodes@users.noreply.github.com> Date: Mon, 19 Oct 2026 09:17:13 +0000 Subject: [PATCH 2/2] docs: align provider catalog introduction with canonical sites --- .agents/evidence/verify/2026-10-19-canonical-guide-links.md | 2 ++ client-sdk/src/agent_sandbox/providers/catalog.py | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/.agents/evidence/verify/2026-10-19-canonical-guide-links.md b/.agents/evidence/verify/2026-10-19-canonical-guide-links.md index 0f84eb1..9312020 100644 --- a/.agents/evidence/verify/2026-10-19-canonical-guide-links.md +++ b/.agents/evidence/verify/2026-10-19-canonical-guide-links.md @@ -7,3 +7,5 @@ Canonical https://www.agent-sandbox.cn/ and https://registry.agent-sandbox.cn/ i The change follows the release-readiness review. Repository health/hygiene, exact changed paths and latest-head CI are recorded before delivery. Existing installed artifact/cloud results remain linked from the accepted release records, without claiming a new E2E run for link-only edits. Local gates: repository health 106 PASS/1 WARN/0 FAIL; hygiene and diff whitespace PASS. Only docs/records/CHANGELOG change. Current-head hosted gates remain required. + +The provider catalog module introductory docstring had the same stale human-site URLs and is corrected as documentation too. REGISTRY_INDEX was already canonical .cn and is unchanged; no executable statement or endpoint behavior changes. diff --git a/client-sdk/src/agent_sandbox/providers/catalog.py b/client-sdk/src/agent_sandbox/providers/catalog.py index 291088e..7212752 100644 --- a/client-sdk/src/agent_sandbox/providers/catalog.py +++ b/client-sdk/src/agent_sandbox/providers/catalog.py @@ -1,7 +1,7 @@ """Provider catalog. -The human registry site is https://registry.agent-sandbox.com. The official -site is https://www.agent-sandbox.com. The installer fetches ``REGISTRY_INDEX`` +The human registry site is https://registry.agent-sandbox.cn. The official +site is https://www.agent-sandbox.cn. The installer fetches ``REGISTRY_INDEX`` on registry.agent-sandbox.cn. The SDK ships only ``alicloud-express``. Every other provider is installed from this index. A background check compares installed versions and writes ``~/.abx/providers/updates.json``. It never