From 22325d3d51c3ad43596525b83cf7dd5a7d85fd48 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Thu, 23 Jul 2026 16:17:19 +0800
Subject: [PATCH] docs(site): publish Chinese Cordis primer

---
 scripts/project-doc-site.spec.ts |  4 ++--
 website/docs.ts                  | 23 +++++++++++++++++------
 2 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/scripts/project-doc-site.spec.ts b/scripts/project-doc-site.spec.ts
index 7d1c3c1550..b9872432a5 100644
--- a/scripts/project-doc-site.spec.ts
+++ b/scripts/project-doc-site.spec.ts
@@ -172,13 +172,13 @@ describe('rewriteMarkdown', () => {
 })
 
 describe('docsPages locale routes', () => {
-  it('publishes every route in both locales and selects paired user sources', () => {
+  it('publishes every route in both locales and selects paired sources', () => {
     const byRoute = new Map(docsPages.map(page => [page.route, page]))
     for (const page of docsPages.filter(page => page.locale === 'root')) {
       const counterpart = byRoute.get(`en/${page.route}`)
       expect(counterpart, page.route).toBeDefined()
       expect(counterpart?.locale).toBe('en')
-      if (page.source.startsWith('docs/user/')) {
+      if (page.source.startsWith('docs/user/') || page.route === 'reference/cordis-primer.md') {
         expect(page.source).toMatch(/\.zh\.md$/)
         expect(page.contentLocale).toBe('zh-CN')
         expect(counterpart?.source).toBe(page.source.replace(/\.zh\.md$/, '.md'))
diff --git a/website/docs.ts b/website/docs.ts
index ee7ad64061..e033e2d6ef 100644
--- a/website/docs.ts
+++ b/website/docs.ts
@@ -226,14 +226,24 @@ const cordisTutorial = mirroredPages(([
   ...(file === 'index.md' ? { sourceAliases: ['docs/cordis-tutorial'] } : {}),
 })))
 
+const cordisPrimerReference = pairedPages([
+  {
+    source: 'docs/cordis-primer.md',
+    route: 'reference/cordis-primer.md',
+    label: { root: 'Cordis 入门', en: 'Cordis primer' },
+    sidebar: { root: 'zh-reference', en: 'en-reference' },
+    section: { root: '概念', en: 'Concepts' },
+    order: 1,
+  },
+])
+
 const reference = mirroredPages([
   ...([
-    ['docs/architecture.md', 'reference/index.md', '架构', 'Architecture'],
-    ['docs/cordis-primer.md', 'reference/cordis-primer.md', 'Cordis 入门', 'Cordis primer'],
-    ['docs/capability-seams.md', 'reference/capability-seams.md', '能力服务', 'Capability services'],
-    ['docs/agent-lifecycle.md', 'reference/agent-lifecycle.md', 'Agent 生命周期', 'Agent lifecycle'],
-    ['docs/tool-execution-pipeline.md', 'reference/tool-execution-pipeline.md', 'Tool 执行', 'Tool execution'],
-  ] as const).map(([source, route, rootLabel, enLabel], order): MirroredPage => ({
+    ['docs/architecture.md', 'reference/index.md', '架构', 'Architecture', 0],
+    ['docs/capability-seams.md', 'reference/capability-seams.md', '能力服务', 'Capability services', 2],
+    ['docs/agent-lifecycle.md', 'reference/agent-lifecycle.md', 'Agent 生命周期', 'Agent lifecycle', 3],
+    ['docs/tool-execution-pipeline.md', 'reference/tool-execution-pipeline.md', 'Tool 执行', 'Tool execution', 4],
+  ] as const).map(([source, route, rootLabel, enLabel, order]): MirroredPage => ({
     source,
     route,
     contentLocale: 'en-US',
@@ -325,5 +335,6 @@ export const docsPages: DocsPage[] = [
   ...homeAndGuide,
   ...develop,
   ...cordisTutorial,
+  ...cordisPrimerReference,
   ...reference,
 ]