test change

.github/workflows/i18n-translate.yml

@@ -62,8 +62,10 @@ jobs:
         if: steps.guard.outputs.skip != 'true'
         run: |
           BASE="${{ github.event.pull_request.base.sha }}"
-          pages=$(git diff --name-only --diff-filter=ACMR "$BASE"...HEAD -- 'docs/pages/en/**/*.mdx' \
-            | sed 's#^docs/pages/en/##')
+          # Directory pathspec + grep, not 'en/**/*.mdx': git's `**` glob requires an
+          # intermediate dir, so the latter silently misses top-level pages (e.g. index.mdx).
+          pages=$(git diff --name-only --diff-filter=ACMR "$BASE"...HEAD -- 'docs/pages/en' \
+            | grep '\.mdx$' | sed 's#^docs/pages/en/##')
           {
             echo 'pages<<EOF'
             echo "$pages"

ADRs/DR003_Page_Filename_Index_Constraint.md

@@ -74,6 +74,18 @@ end in `index` (e.g. `-guides`, `-overview`). Do not reach for `-index` as a
 
 ## Related
 
+- **Multi-sidebar keys must be slash-less, or locale-index pages lose their
+  sidebar.** Our `docs/sidebar.json` is a per-locale multi-sidebar object keyed
+  `/en`, `/cn`, `/ko`. Vocs selects the sidebar with
+  `pathname.startsWith(key)` (`useSidebar.js`). A locale index page renders at
+  the bare path `/cn`, so a key of `/cn/` (trailing slash) does **not** match
+  (`'/cn'.startsWith('/cn/')` is `false`) — `useSidebar` returns no items,
+  `showSidebar` is false, and the page renders with an empty sidebar. Deep pages
+  (`/cn/explanation/…`) still match, so the breakage is invisible except on the
+  index. Keep the keys slash-less (`/en`, `/cn`, `/ko`). The generator
+  (`docs/lib/i18n-sidebar.mjs`) emits slash-less keys, so this holds across
+  regeneration — do not reintroduce trailing slashes when hand-editing the `/en`
+  section. Same Vocs path-matching family as the filename rule above.
 - **Node ≥ 22 is required to build.** Vocs uses `globSync` from `node:fs`, which
   does not exist on Node 20 (`docs:build` throws
   `does not provide an export named 'globSync'`). Pinned in `.nvmrc` (`22`) and

docs/pages/cn/index.mdx

@@ -1,34 +1,34 @@
 ---
 source_path: index.mdx
-source_sha: 899caf6421a737820d81656975cdbd97b48a25d9
+source_sha: 4f3855b4d75c262f0f87dc286a2dce4c7b7ba36a
 title: "集成 Stable"
-description: "选择你正在构建的能力。每条路径都能在几分钟内引导你进入可在测试网运行的指南。"
+description: "选择你正在构建的功能。下面的每条路径都能在几分钟内引导你完成一份可在测试网运行的指南。"
 diataxis: "explanation"
 ---
 
 # 集成 Stable
 
-Stable 是一条 Layer 1，其中 USDT0 既是原生 gas 代币，也是 ERC-20 代币。具备单槽最终性、亚秒级出块时间，以及完整的 EVM 兼容性。你只需带上你的钱包、助记词和 USDT0——无需单独的 gas 资产，无需账户迁移，也无需学习新的 SDK。
+Stable 是一个 Layer 1，其中 USDT0 既是原生 gas 代币，也是一种 ERC-20。单槽最终性、亚秒级出块时间，以及完整的 EVM 兼容性。你只需带上你的钱包、助记词和 USDT0。
 
-选择你正在构建的能力。下面的每条路径都能在几分钟内引导你进入可在测试网运行的指南。
+选择你正在构建的功能。下面的每条路径都能在几分钟内引导你完成一份可在测试网运行的指南。
 
 ## 选择你的路径
 
-- [**账户**](/cn/explanation/accounts-overview) — 钱包、EIP-7702 委托、会话密钥和支出限额。对用户账户和代理账户提供一流支持。
-- [**支付**](/cn/explanation/payments-overview) — 发送 USDT0、构建 P2P 钱包、周期性订阅、发票结算以及按次调用 API。
-- [**合约**](/cn/explanation/contracts-overview) — 部署、验证并索引合约。从 Solidity 调用 Bank、Distribution 和 Staking 预编译合约。
-- [**AI / 代理**](/cn/explanation/agent-settlement) — 将 MCP 服务器和代理技能接入 AI 编辑器。为自主代理按请求对 API 定价。
+- [**账户**](/cn/explanation/accounts-overview) — 钱包、EIP-7702 委托、会话密钥和支出限额。一流地支持用户账户和代理账户。
+- [**支付**](/cn/explanation/payments-overview) — 发送 USDT0，构建 P2P 钱包、周期性订阅、发票结算以及按调用付费的 API。
+- [**合约**](/cn/explanation/contracts-overview) — 部署、验证和索引合约。从 Solidity 调用 Bank、Distribution 和 Staking 预编译合约。
+- [**AI / 代理**](/cn/explanation/agent-settlement) — 将 MCP 服务器和代理技能接入 AI 编辑器。为自主代理按请求为 API 定价。
 - [**基础设施**](/cn/explanation/integrate-overview) — Gas 豁免服务、生态系统提供商（桥、预言机、出入金通道）、网络信息和节点运维。
-- [**学习**](/cn/explanation/learn-overview) — 架构、USDT0 行为、用例叙述，以及 Ethereum 到 Stable 的参考。
+- [**学习**](/cn/explanation/learn-overview) — 架构、USDT0 行为、用例叙述，以及 Ethereum 到 Stable 的参考资料。
 
 ## 五分钟上手
 
 - [**快速开始**](/cn/tutorial/quick-start) — 连接、从水龙头为钱包注资，并原生发送 0.001 USDT0。
 - [**连接到 Stable**](/cn/reference/connect) — 链 ID、RPC 端点、水龙头和区块浏览器。
-- [**与 Ethereum 的差异**](/cn/explanation/ethereum-comparison) — 从 Ethereum 移植时哪些保持不变，哪些会发生变化。
+- [**与 Ethereum 的区别**](/cn/explanation/ethereum-comparison) — 从 Ethereum 移植时哪些保持不变、哪些会改变。
 
-## 其他所有内容
+## 其他内容
 
-- **网络状态和版本**：[测试网](/cn/reference/testnet-information) · [主网](/cn/reference/mainnet-information) · [版本历史](/cn/reference/testnet-version-history)。
-- **代币经济学和路线图**：[STABLE 代币经济学](/cn/reference/tokenomics) · [技术路线图](/cn/explanation/technical-roadmap)。
-- **FAQ**：[开发者 FAQ](/cn/reference/faq) · [开发者支持](/cn/reference/developer-assistance)。
+- **网络状态与版本**：[测试网](/cn/reference/testnet-information) · [主网](/cn/reference/mainnet-information) · [版本历史](/cn/reference/testnet-version-history)。
+- **代币经济学与路线图**：[STABLE 代币经济学](/cn/reference/tokenomics) · [技术路线图](/cn/explanation/technical-roadmap)。
+- **常见问题**：[开发者常见问题](/cn/reference/faq) · [开发者支持](/cn/reference/developer-assistance)。

docs/pages/en/index.mdx

@@ -6,7 +6,7 @@ diataxis: "explanation"
 
 # Integrate Stable
 
-Stable is a Layer 1 where USDT0 is both the native gas token and an ERC-20. Single-slot finality, sub-second block times, and full EVM compatibility. You bring your wallet, seed phrase, and USDT0 — there's no separate gas asset, no account migration, no new SDK to learn.
+Stable is a Layer 1 where USDT0 is both the native gas token and an ERC-20. Single-slot finality, sub-second block times, and full EVM compatibility. You bring your wallet, seed phrase, and USDT0.
 
 Pick the capability you're building. Every path below leads to a runnable guide on testnet within minutes.
 

docs/pages/ko/index.mdx

@@ -1,34 +1,34 @@
 ---
 source_path: index.mdx
-source_sha: 899caf6421a737820d81656975cdbd97b48a25d9
+source_sha: 4f3855b4d75c262f0f87dc286a2dce4c7b7ba36a
 title: "Stable 통합하기"
 description: "구축하려는 기능을 선택하세요. 모든 경로는 몇 분 안에 테스트넷에서 실행 가능한 가이드로 이어집니다."
 diataxis: "explanation"
 ---
 
 # Stable 통합하기
 
-Stable은 USDT0가 네이티브 가스 토큰이자 ERC-20인 레이어 1입니다. 단일 슬롯 완결성, 1초 미만의 블록 시간, 그리고 완전한 EVM 호환성을 제공합니다. 지갑, 시드 문구, USDT0만 준비하면 됩니다 — 별도의 가스 자산도, 계정 마이그레이션도, 새로 배워야 할 SDK도 없습니다.
+Stable은 USDT0가 네이티브 가스 토큰이자 ERC-20인 레이어 1입니다. 단일 슬롯 완결성, 1초 미만의 블록 타임, 그리고 완전한 EVM 호환성을 갖추고 있습니다. 지갑, 시드 문구, USDT0만 준비하면 됩니다.
 
 구축하려는 기능을 선택하세요. 아래의 모든 경로는 몇 분 안에 테스트넷에서 실행 가능한 가이드로 이어집니다.
 
-## 경로 선택하기
+## 경로 선택
 
-- [**계정**](/ko/explanation/accounts-overview) — 지갑, EIP-7702 위임, 세션 키, 그리고 지출 한도. 사용자 및 에이전트 계정에 대한 일급 지원.
-- [**결제**](/ko/explanation/payments-overview) — USDT0 전송, P2P 지갑 구축, 정기 구독, 인보이스 정산, 그리고 호출당 과금 API.
+- [**계정**](/ko/explanation/accounts-overview) — 지갑, EIP-7702 위임, 세션 키, 지출 한도. 사용자 및 에이전트 계정에 대한 최고 수준의 지원.
+- [**결제**](/ko/explanation/payments-overview) — USDT0 전송, P2P 지갑 구축, 정기 구독, 인보이스 정산, 호출당 과금 API.
 - [**컨트랙트**](/ko/explanation/contracts-overview) — 컨트랙트 배포, 검증, 인덱싱. Solidity에서 Bank, Distribution, Staking 프리컴파일 호출.
 - [**AI / 에이전트**](/ko/explanation/agent-settlement) — MCP 서버와 에이전트 스킬을 AI 에디터에 연결. 자율 에이전트를 위한 요청당 API 과금.
-- [**인프라**](/ko/explanation/integrate-overview) — 가스 면제 서비스, 생태계 제공자(브리지, 오라클, 램프), 네트워크 정보, 그리고 노드 운영.
-- [**학습**](/ko/explanation/learn-overview) — 아키텍처, USDT0 동작, 유스케이스 내러티브, 그리고 Ethereum-to-Stable 레퍼런스.
+- [**인프라**](/ko/explanation/integrate-overview) — 가스 면제 서비스, 생태계 제공자(브리지, 오라클, 램프), 네트워크 정보, 노드 운영.
+- [**학습**](/ko/explanation/learn-overview) — 아키텍처, USDT0 동작, 사용 사례 시나리오, 그리고 Ethereum-to-Stable 레퍼런스.
 
 ## 5분 안에 시작하기
 
 - [**빠른 시작**](/ko/tutorial/quick-start) — 연결하고, 포셋에서 지갑에 자금을 충전하고, 0.001 USDT0를 네이티브로 전송하세요.
-- [**Stable에 연결하기**](/ko/reference/connect) — 체인 ID, RPC 엔드포인트, 포셋, 그리고 블록 익스플로러.
-- [**Ethereum과의 차이점**](/ko/explanation/ethereum-comparison) — Ethereum에서 포팅할 때 유지되는 것과 변경되는 것.
+- [**Stable에 연결하기**](/ko/reference/connect) — 체인 ID, RPC 엔드포인트, 포셋, 블록 탐색기.
+- [**Ethereum과의 차이점**](/ko/explanation/ethereum-comparison) — Ethereum에서 포팅할 때 동일하게 유지되는 것과 변경되는 것.
 
 ## 그 외 모든 것
 
 - **네트워크 상태 및 버전**: [테스트넷](/ko/reference/testnet-information) · [메인넷](/ko/reference/mainnet-information) · [버전 기록](/ko/reference/testnet-version-history).
-- **토큰노믹스 및 로드맵**: [STABLE 토큰노믹스](/ko/reference/tokenomics) · [기술 로드맵](/ko/explanation/technical-roadmap).
+- **토크노믹스 및 로드맵**: [STABLE 토크노믹스](/ko/reference/tokenomics) · [기술 로드맵](/ko/explanation/technical-roadmap).
 - **FAQ**: [개발자 FAQ](/ko/reference/faq) · [개발자 지원](/ko/reference/developer-assistance).