anycodes · Oct 19, 2026 · Oct 19, 2026 · Oct 19, 2026
diff --git 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
@@ -0,0 +1,11 @@
+# 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.
+
+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/.agents/notes/implemented/process/2026-10-19-canonical-guide-links.md 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
@@ -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/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

diff --git 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
@@ -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:<id> --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 <https://www.agent-sandbox.com>. The registry website is <https://registry.agent-sandbox.com>.
+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:<id> --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 <https://www.agent-sandbox.cn>. The registry website is <https://registry.agent-sandbox.cn>.
 
 | Id | Name | Kind | Default |
 |---|---|---|---|

diff --git 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
@@ -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:<id> --yes` 安装，索引是 `https://registry.agent-sandbox.cn/providers/index.json`。启动时会在后台对照这份索引检查更新，结果写到 `~/.abx/providers/updates.json`。`ABX_PROVIDER_UPDATE_CHECK=0` 关掉检查。`ABX_PROVIDER_REGISTRY` 可以改索引地址。官网是 <https://www.agent-sandbox.com>。提供方注册站是 <https://registry.agent-sandbox.com>。
+**提供方**就是一个沙箱后端。SDK 和 CLI 只内置 `alicloud-express`。其余提供方用 `python -m agent_sandbox.providers install registry:<id> --yes` 安装，索引是 `https://registry.agent-sandbox.cn/providers/index.json`。启动时会在后台对照这份索引检查更新，结果写到 `~/.abx/providers/updates.json`。`ABX_PROVIDER_UPDATE_CHECK=0` 关掉检查。`ABX_PROVIDER_REGISTRY` 可以改索引地址。官网是 <https://www.agent-sandbox.cn>。提供方注册站是 <https://registry.agent-sandbox.cn>。
 
 | Id | 名称 | 类型 | 默认 |
 |---|---|---|---|
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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)