Skip to content

The Open Standard for Generative UI

docs(i18n): add Simplified Chinese translations for community docs (#453)

Zahle Khan770d2a1ec70b
diff --git a/.gitignore b/.gitignore
index ba9580689..839e82652 100644
--- a/.gitignore
+++ b/.gitignore
@@ -51,3 +51,4 @@ clean-install.sh
lint-fix.sh
draft/
+.venv/
diff --git a/translations/zh-CN/.co-op-translator.json b/translations/zh-CN/.co-op-translator.json
new file mode 100644
index 000000000..b203a5ad1
--- /dev/null
+++ b/translations/zh-CN/.co-op-translator.json
@@ -0,0 +1,32 @@
+{
+ "CODE_OF_CONDUCT.md": {
+ "original_hash": "fb4c91192caf84a289053f1cc62c6956",
+ "translation_date": "2026-04-11T02:52:22+00:00",
+ "source_file": "CODE_OF_CONDUCT.md",
+ "language_code": "zh-CN"
+ },
+ "CONTRIBUTING.md": {
+ "original_hash": "81f7f10d015181a5f40d1b46d727a89a",
+ "translation_date": "2026-04-11T02:53:05+00:00",
+ "source_file": "CONTRIBUTING.md",
+ "language_code": "zh-CN"
+ },
+ "README.md": {
+ "original_hash": "f5ba2133cbf2decfe0e443996142747f",
+ "translation_date": "2026-04-11T02:52:57+00:00",
+ "source_file": "README.md",
+ "language_code": "zh-CN"
+ },
+ "SECURITY.md": {
+ "original_hash": "a20186b934f5abceb678bba91868aa7a",
+ "translation_date": "2026-04-11T02:53:13+00:00",
+ "source_file": "SECURITY.md",
+ "language_code": "zh-CN"
+ },
+ "benchmarks/README.md": {
+ "original_hash": "69af6ec2b537d3b78c7f3f638b9aa1b6",
+ "translation_date": "2026-04-11T02:53:50+00:00",
+ "source_file": "benchmarks/README.md",
+ "language_code": "zh-CN"
+ }
+}
diff --git a/translations/zh-CN/CODE_OF_CONDUCT.md b/translations/zh-CN/CODE_OF_CONDUCT.md
new file mode 100644
index 000000000..9ea2bcda8
--- /dev/null
+++ b/translations/zh-CN/CODE_OF_CONDUCT.md
@@ -0,0 +1,99 @@
+# Contributor Covenant 行为准则
+
+## 我们的承诺
+
+作为成员、贡献者和社区领导者,我们承诺让每个人都能在社区中获得免受骚扰的参与体验,不因年龄、体型、可见或不可见的残障、族裔、性特征、性别认同与表达、经验水平、教育程度、社会经济地位、国籍、个人外貌、种族、种姓、肤色、宗教或性认同与性取向而受到区别对待。
+
+我们承诺以开放、友善、多元、包容且健康的方式行动与互动,共同建设社区。
+
+## 我们的准则
+
+有助于为社区营造积极环境的行为包括:
+
+* 对他人展现同理心与善意
+* 尊重不同的意见、观点和经历
+* 提供建设性反馈,并以得体的态度接受反馈
+* 对自己的错误承担责任,向受影响的人致歉,并从中吸取经验教训
+* 关注什么对整个社区最有益,而不只是对我们个人有利
+
+不可接受的行为包括:
+
+* 使用带有性暗示的语言或图像,以及任何形式的性关注或性挑逗
+* 挑衅、侮辱性或贬损性评论,以及人身或政治攻击
+* 公开或私下骚扰
+* 未经明确许可,发布他人的私人信息,例如住址或电子邮箱地址
+* 其他在专业场合中可被合理认为不恰当的行为
+
+## 执行责任
+
+社区领导者有责任说明并执行我们关于可接受行为的标准,并将对任何他们认定为不当、具有威胁性、冒犯性或有害的行为采取适当且公正的纠正措施。
+
+社区领导者有权利也有责任删除、编辑或拒绝与本行为准则不一致的评论、提交、代码、wiki 编辑、议题及其他贡献,并会在适当情况下说明管理决定的原因。
+
+## 适用范围
+
+本行为准则适用于所有社区空间,也适用于个人在公共场合正式代表社区时的行为。
+代表社区的例子包括:使用官方电子邮箱地址、通过官方社交媒体账号发布内容,或在网络或线下活动中担任指定代表。
+
+## 执行
+
+辱骂、骚扰或其他不可接受行为的事件,可通过
+[INSERT CONTACT METHOD]
+向负责执行的社区领导者报告。
+所有投诉都会被及时且公正地审查和调查。
+
+所有社区领导者都有义务尊重事件举报人的隐私与安全。
+
+## 执行指南
+
+社区领导者将在判断违反本行为准则的后果时,参考以下社区影响指南:
+
+### 1. 纠正
+
+<strong>社区影响</strong>:在社区中使用不当语言,或其他被认为不专业或不受欢迎的行为。
+
+<strong>后果</strong>:社区领导者将以私下书面警告的形式,明确说明违规性质,并解释为何该行为不当。也可能要求公开道歉。
+
+### 2. 警告
+
+<strong>社区影响</strong>:单次事件或一系列行为构成的违规。
+
+<strong>后果</strong>:发出警告,并说明若持续该行为将面临的后果。在规定时间内,不得与相关人员发生任何互动,包括主动与执行本行为准则的人接触。这也包括避免在社区空间以及社交媒体等外部渠道中的互动。违反这些要求可能导致临时或永久封禁。
+
+### 3. 临时封禁
+
+<strong>社区影响</strong>:严重违反社区准则,包括持续的不当行为。
+
+<strong>后果</strong>:在规定时间内,暂时禁止与社区进行任何形式的互动或公开交流。在此期间,不得与相关人员进行任何公开或私下互动,包括主动与执行本行为准则的人接触。违反这些要求可能导致永久封禁。
+
+### 4. 永久封禁
+
+<strong>社区影响</strong>:表现出持续违反社区准则的模式,包括持续的不当行为、对个人的骚扰,或对特定群体表现出攻击性或贬低行为。
+
+<strong>后果</strong>:永久禁止在社区内进行任何形式的公开互动。
+
+## 署名
+
+本行为准则改编自 [Contributor Covenant][homepage] 2.1 版,原文见
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]。
+
+社区影响指南的灵感来自
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC]。
+
+如需了解关于本行为准则的常见问题,请参阅
+[https://www.contributor-covenant.org/faq][FAQ]。
+各语言译本见
+[https://www.contributor-covenant.org/translations][translations]。
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations
+
+---
+
+<!-- CO-OP TRANSLATOR DISCLAIMER START -->
+**免责声明**:
+本文档使用 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行翻译。尽管我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。应将原始语言版本的原始文档视为权威来源。对于关键信息,建议使用专业人工翻译。对于因使用此翻译而引起的任何误解或误释,我们概不负责。
+<!-- CO-OP TRANSLATOR DISCLAIMER END -->
\ No newline at end of file
diff --git a/translations/zh-CN/CONTRIBUTING.md b/translations/zh-CN/CONTRIBUTING.md
new file mode 100644
index 000000000..685db0e2b
--- /dev/null
+++ b/translations/zh-CN/CONTRIBUTING.md
@@ -0,0 +1,32 @@
+# 贡献指南
+
+感谢你考虑为 _openui_ 做出贡献!本文档提供了参与贡献的相关指引。
+
+## 如何贡献
+
+1. Fork 此仓库。
+2. 创建一个新分支(`git checkout -b feature/amazing-feature`)并进行你的修改。
+3. 确保你的代码符合我们的风格指南。
+4. 如有需要,更新 README.md 并自动生成文档。
+5. 提交一个 Pull Request
+
+## Bug 报告
+
+请使用 Github Issues 来报告 Bug。提交 Bug 报告时,请包含以下内容:
+
+- 对问题的清晰描述
+- 复现步骤
+- 预期行为与实际行为
+- 你的环境详情
+
+## 有问题?
+
+我们很乐意提供帮助!如果你有任何问题或疑虑,欢迎随时提交 issue。
+你也可以加入我们的 [Discord](https://discord.gg/Pbv5PsqUSv) 与团队交流。
+
+---
+
+<!-- CO-OP TRANSLATOR DISCLAIMER START -->
+**免责声明**:
+本文件已使用 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行翻译。尽管我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。应以该文档原始语言版本为权威来源。对于关键信息,建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或曲解,我们概不负责。
+<!-- CO-OP TRANSLATOR DISCLAIMER END -->
\ No newline at end of file
diff --git a/translations/zh-CN/README.md b/translations/zh-CN/README.md
new file mode 100644
index 000000000..54725cec8
--- /dev/null
+++ b/translations/zh-CN/README.md
@@ -0,0 +1,188 @@
+<div align="center">
+
+<img src="../../assets/banner.png" alt="OpenUI —— 生成式 UI 的开放标准" width="100%">
+
+# OpenUI —— 生成式 UI 的开放标准
+
+[![Build](https://github.com/thesysdev/openui/actions/workflows/build-js.yml/badge.svg)](https://github.com/thesysdev/openui/actions/workflows/build-js.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![Discord](https://img.shields.io/badge/Discord-Chat-7289da?logo=discord&logoColor=white)](https://discord.com/invite/Pbv5PsqUSv)
+
+<a href="https://trendshift.io/repositories/22357" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22357" alt="thesysdev%2Fopenui | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+
+</div>
+
+
+OpenUI 是一个全栈生成式 UI 框架——包含一种紧凑、以流式输出为优先的语言,一个内置组件库的 React 运行时,以及可直接使用的聊天界面;与 JSON 相比,最高可提升 67% 的 token 效率。
+
+
+
+---
+
+
+
+[文档](https://openui.com) · [Playground](https://www.openui.com/playground) · [示例聊天应用](../../examples/openui-chat) · [Discord](https://discord.com/invite/Pbv5PsqUSv) · [参与贡献](./CONTRIBUTING.md) · [行为准则](./CODE_OF_CONDUCT.md) · [安全](./SECURITY.md) · [许可证](../../LICENSE)
+
+
+---
+
+## 什么是 OpenUI
+
+<div align="center">
+
+<img src="./assets/demo.gif" alt="OpenUI 演示" width="100%">
+</div>
+
+OpenUI 的核心是 **OpenUI Lang**:一种紧凑、面向流式输出的语言,专为模型生成 UI 而设计。OpenUI 不再只把模型输出当作文本处理,而是让你定义组件、基于组件库生成提示词指令,并在模型流式输出的同时渲染结构化 UI。
+
+**核心能力:**
+
+- **OpenUI Lang** —— 一种用于结构化 UI 生成的紧凑语言,专为流式输出设计。
+- <strong>内置组件库</strong> —— 图表、表单、表格、布局等,开箱即用,也可按需扩展。
+- <strong>基于组件库生成提示词</strong> —— 直接从你允许使用的组件生成模型指令。
+- <strong>流式渲染器</strong> —— 随着 token 到达,在 React 中渐进式解析并渲染模型输出。
+- <strong>聊天与应用界面</strong> - 可将同一套基础能力用于助手、copilot 以及更广泛的交互式产品流程。
+
+
+## 快速开始
+
+```bash
+npx @openuidev/cli@latest create --name genui-chat-app
+cd genui-chat-app
+echo "OPENAI_API_KEY=sk-your-key-here" > .env
+npm run dev
+```
+
+这是开始使用 OpenUI 的最快方式。脚手架生成的应用为你提供了一个端到端的起点,内置流式处理、UI 组件和 OpenUI Lang 支持。
+
+你将获得:
+
+- **OpenUI Lang 支持** - 从一开始就在应用流程中内置结构化 UI 生成功能。
+- <strong>库驱动的提示词</strong> - 根据你允许的组件集生成指令。
+- <strong>流式支持</strong> - 在输出到达时渐进式更新 UI。
+- <strong>可运行的应用基础</strong> - 从一个开箱即跑的示例开始,而不是手动把所有东西接起来。
+
+
+
+## 工作原理
+
+你的组件决定了模型可以生成什么。
+
+```mermaid
+flowchart LR
+ A["组件库"] --> B["系统提示词"]
+ B --> C["LLM"]
+ C --> D["OpenUI Lang 流"]
+ D --> E["渲染器"]
+ E --> F["实时 UI"]
+```
+1. 定义或复用一个组件库。
+2. 基于该组件库生成 system prompt。
+3. 将该 prompt 发送给你的模型。
+4. 将 OpenUI Lang 的流式输出返回给客户端。
+5. 使用 Renderer 渐进式渲染输出。
+
+在 [Playground](https://www.openui.com/playground) 中亲自试试看——使用默认组件库实时生成 UI。
+
+## 包
+
+| Package | 描述 |
+| :--- | :--- |
+| [`@openuidev/react-lang`](../../packages/react-lang) | 核心运行时 —— 组件定义、解析器、渲染器、提示词生成 |
+| [`@openuidev/react-headless`](../../packages/react-headless) | 无头聊天状态、流式适配器、消息格式转换器 |
+| [`@openuidev/react-ui`](../../packages/react-ui) | 预构建的聊天布局和两个内置组件库 |
+| [`@openuidev/cli`](../../packages/openui-cli) | 用于脚手架生成应用和生成 system prompt 的 CLI |
+
+```bash
+npm install @openuidev/react-lang @openuidev/react-ui
+```
+
+## 为什么选择 OpenUI Lang
+
+OpenUI Lang 专为模型生成 UI 而设计,既要求结构化,也要求可流式传输。
+
+- <strong>流式输出</strong> —— 随着 token 到达逐步输出 UI。
+- **Token 效率** —— 相比等价 JSON,最多可减少 67% 的 token(见[基准测试](../../benchmarks))。
+- <strong>受控渲染</strong> —— 将输出限制在你定义并注册的组件范围内。
+- <strong>类型化组件契约</strong> —— 通过 Zod schemas 预先定义组件 props 和结构。
+
+### Token 效率基准测试
+
+使用 `tiktoken`(GPT-5 encoder)测量。对比对象为 OpenUI Lang 与两种基于 JSON 的流式格式,覆盖七种 UI 场景:
+
+| 场景 | Vercel JSON-Render | Thesys C1 JSON | OpenUI Lang | 相比 Vercel | 相比 C1 |
+| ------------------ | -----------------: | -------------: | ----------: | -----------: | --------: |
+| simple-table | 340 | 357 | 148 | -56.5% | -58.5% |
+| chart-with-data | 520 | 516 | 231 | -55.6% | -55.2% |
+| contact-form | 893 | 849 | 294 | -67.1% | -65.4% |
+| dashboard | 2247 | 2261 | 1226 | -45.4% | -45.8% |
+| pricing-page | 2487 | 2379 | 1195 | -52.0% | -49.8% |
+| settings-panel | 1244 | 1205 | 540 | -56.6% | -55.2% |
+| e-commerce-product | 2449 | 2381 | 1166 | -52.4% | -51.0% |
+| <strong>总计</strong> | **10180** | **9948** | **4800** | **-52.8%** | **-51.7%** |
+
+完整方法说明和复现步骤见 [`benchmarks/`](../../benchmarks)。
+
+## 文档
+
+详细文档请访问 [openui.com](https://openui.com)。
+
+## 仓库结构
+
+```
+openui/
+├── packages/
+│ ├── react-lang/ # Core runtime (parser, renderer, prompt generation)
+│ ├── react-headless/ # Headless chat state & streaming adapters
+│ ├── react-ui/ # Prebuilt chat layouts & component libraries
+│ └── openui-cli/ # CLI for scaffolding & prompt generation
+├── skills/
+│ └── openui/ # Claude Code skill for AI-assisted development
+├── examples/
+│ └── openui-chat/ # Full working example app (Next.js)
+├── docs/ # Documentation site (openui.com)
+└── benchmarks/ # Token efficiency benchmarks
+```
+
+推荐从以下内容开始:
+
+- [openui.com](https://openui.com) 查看完整文档
+- [`examples/openui-chat`](../../examples/openui-chat) 查看可运行示例应用
+- 如果你想参与贡献,请查看 [`CONTRIBUTING.md`](./CONTRIBUTING.md)
+
+## 社区
+
+- [Discord](https://discord.com/invite/Pbv5PsqUSv) —— 提问、分享你正在构建的内容
+- [GitHub Issues](https://github.com/thesysdev/openui/issues) —— 报告 bug 或提出功能请求
+
+
+## 参与贡献
+
+欢迎贡献。请查看 [`CONTRIBUTING.md`](./CONTRIBUTING.md) 了解贡献指南以及参与方式。
+
+## Agent Skill
+
+OpenUI 提供了一个 [Agent Skill](https://agentskills.io),让 AI 编程助手(Claude Code、Codex、Cursor、Copilot 等)能够帮助你使用 OpenUI Lang 搭建、开发和调试生成式 UI 应用。
+
+### 安装
+
+```bash
+# 使用 skills CLI(适用于所有代理)
+npx skills add thesysdev/openui --skill openui
+
+# 手动——复制到你的项目中
+cp -r skills/openui .claude/skills/openui
+```
+
+该技能涵盖组件库设计、OpenUI Lang 语法、system prompt 生成、Renderer、SDK 包,以及对格式错误的 LLM 输出进行调试。
+
+## 许可证
+
+本项目按 [`LICENSE`](../../LICENSE) 中描述的条款提供。
+
+---
+
+<!-- CO-OP TRANSLATOR DISCLAIMER START -->
+**免责声明**:
+本文档已使用 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行翻译。尽管我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。应以该文档原始语言版本为权威来源。对于关键信息,建议使用专业人工翻译。对于因使用本翻译而产生的任何误解或误释,我们概不负责。
+<!-- CO-OP TRANSLATOR DISCLAIMER END -->
\ No newline at end of file
diff --git a/translations/zh-CN/SECURITY.md b/translations/zh-CN/SECURITY.md
new file mode 100644
index 000000000..2ef076c58
--- /dev/null
+++ b/translations/zh-CN/SECURITY.md
@@ -0,0 +1,24 @@
+# 安全政策
+
+## 报告漏洞
+
+我们非常重视 OpenUI 的安全性。如果你认为自己发现了安全漏洞,请通过 GitHub 安全通告中的“Report a Vulnerability”标签向我们报告。
+
+**请不要通过公开的 GitHub issues 报告安全漏洞。**
+
+请改为:
+
+1. 前往此仓库的“Security”标签页
+2. 点击“Report a vulnerability”
+3. 在表单中填写漏洞描述
+
+我们会尽快回应你的报告,并与你合作核实和修复该问题。
+
+感谢你帮助保障 OpenUI 及其用户的安全!
+
+---
+
+<!-- CO-OP TRANSLATOR DISCLAIMER START -->
+**免责声明**:
+本文档使用 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行了翻译。尽管我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。应以该文档原始语言版本为权威来源。对于关键信息,建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或误读,我们概不负责。
+<!-- CO-OP TRANSLATOR DISCLAIMER END -->
\ No newline at end of file
diff --git a/translations/zh-CN/benchmarks/README.md b/translations/zh-CN/benchmarks/README.md
new file mode 100644
index 000000000..35e9767b3
--- /dev/null
+++ b/translations/zh-CN/benchmarks/README.md
@@ -0,0 +1,116 @@
+# OpenUI Lang 基准测试
+
+衡量 **OpenUI Lang** 与另外三种结构化流式格式在七个真实 UI 场景中的 token 效率和预计生成延迟:
+
+- **YAML**
+- **Vercel JSON-Render**(RFC 6902 patch 流)
+- **Thesys C1 JSON**(标准化组件树)
+
+## 格式
+
+| 格式 | 说明 |
+| ---------------------- | --------------------------------------------------------------------- |
+| **OpenUI Lang** | 由 LLM 直接生成的面向行 DSL |
+| **YAML** | YAML `root` / `elements` 规范载荷 |
+| **Vercel JSON-Render** | [JSON Patch (RFC 6902)](https://jsonpatch.com/) 操作的 JSONL 流 |
+| **Thesys C1 JSON** | 标准化组件树 JSON(`component` + `props`) |
+
+四种格式编码的 UI 完全相同。LLM 始终先生成 OpenUI Lang,然后将解析得到的 AST 映射为另外三种格式。
+
+## 方法
+
+1. 使用 `generate-samples.ts` 中固定的七个提示词集合(`simple-table`、`chart-with-data`、`contact-form`、`dashboard`、`pricing-page`、`settings-panel`、`e-commerce-product`)。
+2. 针对每个提示词,使用 `gpt-5.2` 在 `temperature: 0` 且启用流式补全的条件下生成一次 OpenUI Lang。
+3. 使用 `createParser(schema)` 解析 OpenUI Lang 输出,使位置参数通过 `schema.json` 映射为具名 props。
+4. 将同一个解析后的 AST 转换为:
+ - `*.c1.json`:通过 `thesys-c1-converter.ts` 转为 Thesys C1 格式。
+ - `*.vercel.jsonl`:通过 `vercel-jsonl-converter.ts` 转为 json-render RFC 6902 patches。
+ - `*.yaml`:通过 `yaml-converter.ts` 转为 json-render YAML 规范载荷。
+5. 使用 `tiktoken` 和 `encoding_for_model("gpt-5")` 对 `samples/` 中所有保存的产物统计 token 数。
+6. 以固定的 60 tokens/second 报告 token 数和预计解码延迟。
+
+## 结果
+
+使用 `tiktoken`(`gpt-5` 模型编码器)测得。由 GPT-5.2 在 temperature 0 下生成。
+
+| 场景 | YAML | Vercel JSON-Render | Thesys C1 JSON | OpenUI Lang | 相比 YAML | 相比 Vercel | 相比 C1 |
+| ------------------ | -------: | -----------------: | -------------: | ----------: | -----------: | ----------: | ---------: |
+| simple-table | 316 | 340 | 357 | 148 | -53.2% | -56.5% | -58.5% |
+| chart-with-data | 464 | 520 | 516 | 231 | -50.2% | -55.6% | -55.2% |
+| contact-form | 762 | 893 | 849 | 294 | -61.4% | -67.1% | -65.4% |
+| dashboard | 2128 | 2247 | 2261 | 1226 | -42.4% | -45.4% | -45.8% |
+| pricing-page | 2230 | 2487 | 2379 | 1195 | -46.4% | -52.0% | -49.8% |
+| settings-panel | 1077 | 1244 | 1205 | 540 | -49.9% | -56.6% | -55.2% |
+| e-commerce-product | 2145 | 2449 | 2381 | 1166 | -45.6% | -52.4% | -51.0% |
+| <strong>总计</strong> | **9122** | **10180** | **9948** | **4800** | **-47.4%** | **-52.8%** | **-51.7%** |
+
+
+## 运行方式
+
+### 前置条件
+
+在 shell 中导出 `OPENAI_API_KEY`:
+
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+
+### 1. 生成样本(调用 OpenAI)
+
+```bash
+pnpm generate
+```
+
+这会针对每个场景调用一次 OpenAI,保存原始 `.oui` 输出,然后将其转换为 `.c1.json`、`.vercel.jsonl` 和 `.yaml`。所有文件都会存放到 `samples/` 中。还会额外写入一个 `metrics.json`,其中包含 API 响应中的 TTFT 和 TPS。
+
+### 2. 运行基准测试报告(离线)
+
+```bash
+pnpm bench
+```
+
+读取 `samples/` 中的文件,使用 `tiktoken` 统计 token 数,并输出 token 和延迟表格。
+
+## 文件结构
+
+```text
+benchmarks/
+├── generate-samples.ts # Calls OpenAI, converts AST to all four formats
+├── run-benchmark.ts # Reads samples/, prints token/latency tables
+├── thesys-c1-converter.ts # AST -> normalized Thesys C1 JSON converter
+├── vercel-spec-converter.ts # AST -> shared json-render spec projection
+├── vercel-jsonl-converter.ts # Shared spec -> RFC 6902 JSONL converter
+├── yaml-converter.ts # Shared spec -> YAML document converter
+├── schema.json # JSON Schema for the default component library
+├── system-prompt.txt # System prompt sent to the LLM
+├── package.json
+├── pnpm-lock.yaml
+└── samples/
+ ├── <scenario>.oui
+ ├── <scenario>.c1.json
+ ├── <scenario>.vercel.jsonl
+ ├── <scenario>.yaml
+ └── metrics.json
+```
+
+## 更新 Schema
+
+`schema.json` 和 `system-prompt.txt` 由 `@openuidev/react-ui` 中的 `library.toJSONSchema()` 和 `library.prompt()` 生成。如果你新增或修改了组件,请重新生成它们:
+
+```ts
+import { openuiLibrary } from "@openuidev/react-ui";
+import { writeFileSync } from "fs";
+
+writeFileSync("schema.json", JSON.stringify(openuiLibrary.toJSONSchema(), null, 2));
+writeFileSync("system-prompt.txt", openuiLibrary.prompt());
+```
+
+解析器(`createParser`)会读取该文件中 `$defs` 部分的组件定义,以便将位置参数映射为具名 props。
+
+---
+
+<!-- CO-OP TRANSLATOR DISCLAIMER START -->
+**免责声明**:
+本文档使用 AI 翻译服务 [Co-op Translator](https://github.com/Azure/co-op-translator) 进行了翻译。尽管我们力求准确,但请注意,自动翻译可能包含错误或不准确之处。应以该文档原始语言版本为权威来源。对于关键信息,建议采用专业人工翻译。对于因使用本翻译而产生的任何误解或曲解,我们概不负责。
+<!-- CO-OP TRANSLATOR DISCLAIMER END -->
\ No newline at end of file