docs: complete Chinese proofreading and generated reference pairing

This commit is contained in:
xjt
2026-08-09 11:02:16 +08:00
parent 0543a6f79d
commit 7ff0cbcb7e
565 changed files with 10606 additions and 2171 deletions

View File

@@ -307,12 +307,9 @@ const subsystemsReference = pairedPages(([
...(file === 'README.md' ? { sourceAliases: ['docs/subsystems'] } : {}),
})))
const reference = mirroredPages([
...([
const reference = [
...mirroredPages(([
['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,
@@ -321,27 +318,47 @@ const reference = mirroredPages([
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: '概念', en: 'Concepts' },
order,
})),
...([
}))),
...pairedPages(([
['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]): PairedPage => ({
source,
route,
label: { root: rootLabel, en: enLabel },
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: '概念', en: 'Concepts' },
order,
}))),
...pairedPages(([
['docs/config-catalog.md', 'reference/config-catalog.md', '插件配置', 'Plugin configuration'],
['docs/tool-catalog.md', 'reference/tool-catalog.md', 'Tool Schema', 'Tool schemas'],
['docs/persistence-catalog.md', 'reference/persistence-catalog.md', '持久化事件', 'Persistence events', 'deep'],
] as const).map(([source, route, rootLabel, enLabel, outline], order): MirroredPage => ({
] as const).map(([source, route, rootLabel, enLabel, outline], order): PairedPage => ({
source,
route,
contentLocale: 'en-US',
label: { root: rootLabel, en: enLabel },
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: '生成参考', en: 'Generated reference' },
order,
...(outline === undefined ? {} : { outline }),
})),
...([
}))),
...pairedPages(([
['context.md', 'Context', 'Context'],
['events.md', 'Events', 'Events'],
['fiber.md', 'Fiber', 'Fiber'],
['registry.md', 'Plugin Registry', 'Plugin Registry'],
['service.md', 'Service', 'Service'],
] as const).map(([file, rootLabel, enLabel], order): PairedPage => ({
source: `docs/cordis-api/${file}`,
route: `reference/cordis-api/${file}`,
label: { root: rootLabel, en: enLabel },
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: 'Cordis API', en: 'Cordis Core API' },
order,
}))),
...mirroredPages(([
['inherited.md', '继承接口面', 'Inherited surface'],
] as const).map(([file, rootLabel, enLabel], order): MirroredPage => ({
source: `docs/cordis-api/${file}`,
@@ -350,9 +367,9 @@ const reference = mirroredPages([
label: { root: rootLabel, en: enLabel },
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: 'Cordis API', en: 'Cordis Core API' },
order,
})),
...([
order: order + 5,
}))),
...mirroredPages(([
['goal.md', '目标', 'Goals', 14],
['pty.md', 'PTY 会话', 'PTY sessions', 26],
['commands.md', '命令', 'Human commands', 38],
@@ -364,8 +381,8 @@ const reference = mirroredPages([
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: '子系统', en: 'Subsystems' },
order,
})),
...([
}))),
...mirroredPages(([
['adding-a-package.md', '新增 Package', 'Adding a package'],
['adding-a-tool.md', '新增 Tool', 'Adding a tool'],
['adding-an-llm-adapter.md', '新增 LLM Adapter', 'Adding an LLM adapter'],
@@ -378,8 +395,8 @@ const reference = mirroredPages([
sidebar: { root: 'zh-reference', en: 'en-reference' },
section: { root: '开发手册', en: 'Cookbook' },
order,
})),
])
}))),
]
/** Every canonical page published by the documentation website. */
export const docsPages: DocsPage[] = [