@@ -113,7 +90,7 @@ sidebar-title: 端点请求代码片段
### 隐藏试用按钮
-`EndpointRequestSnippet` 组件默认包含试用按钮。使用 `hideTryItButton` 属性来隐藏它。
+`EndpointRequestSnippet` 组件默认包含一个试用按钮。使用 `hideTryItButton` 属性来隐藏它。
@@ -131,7 +108,7 @@ sidebar-title: 端点请求代码片段
## 属性
- 要显示的端点，格式为 `METHOD /path`（例如，`POST /chat/{domain}`）。如果您的 API 使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请在前面加上命名空间和 `::`（例如，`payments::POST /chat/{domain}`）。
+ 要显示的端点，格式为 `METHOD /path`（例如：`POST /chat/{domain}`）。如果您的 API 使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请在前面加上命名空间和 `::`（例如：`payments::POST /chat/{domain}`）。
@@ -139,13 +116,13 @@ sidebar-title: 端点请求代码片段
- 代码片段中要高亮的行号。接受单个数字、数字数组或范围（例如，`{[1-3, 5]}`）。
+ 代码片段中要高亮的行号。接受单个数字、数字数组或范围（例如：`{[1-3, 5]}`）。
- 指定在下拉菜单中显示哪些语言以及显示顺序。支持的值包括 `curl`、`python`、`typescript`、`javascript`、`go`、`ruby`、`java`、`kotlin`、`csharp`、`php`、`swift`、`rust` 和 `payload`。未指定时，显示所有可用语言。
+ 指定下拉菜单中显示哪些语言以及显示顺序。支持的值包括 `curl`、`python`、`typescript`、`javascript`、`go`、`ruby`、`java`、`kotlin`、`csharp`、`php`、`swift`、`rust` 和 `payload`。未指定时，显示所有可用语言。
- 设置为 `true` 时，隐藏片段中的试用按钮。
-
\ No newline at end of file
+ 当设置为 `true` 时，从片段中隐藏试用按钮。
+
diff --git a/fern/translations/zh/products/docs/pages/component-library/default-components/endpoint-response-snippet.mdx b/fern/translations/zh/products/docs/pages/component-library/default-components/endpoint-response-snippet.mdx
index 6d45543c4b..95157f0a9e 100644
--- a/fern/translations/zh/products/docs/pages/component-library/default-components/endpoint-response-snippet.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/default-components/endpoint-response-snippet.mdx
@@ -1,13 +1,11 @@
---
title: '端点响应代码片段'
-description: '引用API文档中的端点响应'
-sidebar-title: 端点响应代码片段
+description: '从你的 API 参考中引用端点响应'
---
+使用 `
` 组件从你的 API 参考中引用端点响应。
-使用 `` 组件来引用API文档中的端点响应。
-
-## 用法
+## 使用方法
@@ -20,51 +18,27 @@ sidebar-title: 端点响应代码片段
## 引用特定示例
- ### 在规格中设置示例名称
+ ### 在你的规范中设置示例名称
-
-
- ```yaml openapi.yml {13}
- paths:
- /pet/{petId}:
- put:
- summary: Get a pet
- operationId: pets_get
- responses:
- '200':
- content:
- application/json:
- schema:
- $ref: '#/components/schemas/Pet'
- examples:
- ExampleWithMarkley:
- summary: This is an example of a Pet
- value:
- name: Markley
- id: 44
- ```
-
-
- ```yaml pets.yml {11}
- service:
- auth: true
- base-path: ""
- endpoints:
- update:
- docs: Get a pet
- method: GET
- path: /pet/{petId}
- response: Pet
- examples:
- - name: ExampleWithMarkley
- docs: This is an example of a Pet
- response:
- body:
- name: Markley
- id: 44
- ```
-
-
+ ```yaml openapi.yml {13}
+ paths:
+ /pet/{petId}:
+ put:
+ summary: Get a pet
+ operationId: pets_get
+ responses:
+ '200':
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Pet'
+ examples:
+ ExampleWithMarkley:
+ summary: This is an example of a Pet
+ value:
+ name: Markley
+ id: 44
+ ```
### 直接引用示例
@@ -79,13 +53,13 @@ sidebar-title: 端点响应代码片段
## 属性
- 要显示的端点，格式为 `METHOD /path`（例如，`POST /chat/{domain}`）。如果你的API使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请在前面加上命名空间和 `::`（例如，`payments::POST /chat/{domain}`）。
+ 要显示的端点，格式为 `METHOD /path`（例如 `POST /chat/{domain}`）。如果你的 API 使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请在前面添加命名空间和 `::`（例如 `payments::POST /chat/{domain}`）。
- 要显示的特定示例的名称。如果示例包含 `summary` 或 `docs` 字段，使用该值。
+ 要显示的特定示例名称。如果示例包含 `summary` 或 `docs` 字段，请使用该值。
- 要在代码片段中高亮显示的行号。接受单个数字、数字数组或范围（例如，`{[1-3, 5]}`）。
-
\ No newline at end of file
+ 代码片段中要高亮显示的行号。接受单个数字、数字数组或范围（例如 `{[1-3, 5]}`）。
+
diff --git a/fern/translations/zh/products/docs/pages/component-library/default-components/prompt.mdx b/fern/translations/zh/products/docs/pages/component-library/default-components/prompt.mdx
index acdeefbd77..08ae55b9a9 100644
--- a/fern/translations/zh/products/docs/pages/component-library/default-components/prompt.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/default-components/prompt.mdx
@@ -1,34 +1,33 @@
---
-title: 提示词组件
-sidebar-title: 提示词组件
-description: 显示一个可复制的提示词，并可附带在 Cursor、Claude、ChatGPT 等 AI 工具中“打开”的操作按钮。
+title: Prompt
+description: 显示带有可复制提示的组件，可选择在 AI 工具中打开，如 Cursor、Claude、ChatGPT 或任何自定义 URL。
---
-`` 组件用于展示 AI 提示词卡片，包含图标、多行提示词预览、复制按钮以及可选的“打开方式”操作按钮（适用于各类 AI 工具）。将其添加到任意页面，读者就能复制相关说明，或直接在 Cursor、Claude 或 ChatGPT 中打开它们。
+`` 组件显示一个 AI 提示卡片，包含图标、多行提示预览、复制按钮以及可选的 AI 工具操作按钮。将其添加到任何页面，让读者可以复制指令或直接在 Cursor、Claude、ChatGPT 或您定义的任何自定义 URL 中打开它们。
-适用于教程、快速上手、迁移指南，或任何希望读者将任务交给 AI 助手的页面——例如搭建项目脚手架、生成 SDK 或应用代码改动。
+在教程、快速开始、迁移指南或任何您希望读者将任务交给 AI 助手的页面中使用它——例如，搭建项目脚手架、生成 SDK 或应用代码更改。
-复制或打开提示词时，会保留其原有的 Markdown 格式。
+复制或打开提示时会保留其原始的 markdown 格式。
## 用法
-默认情况下，`` 会渲染一个星光图标、提示词文本和一个复制按钮。当未设置标题时，操作按钮会内联显示。
+默认情况下，`` 渲染一个闪光图标、提示文本和一个复制按钮。当没有设置标题时，操作按钮会显示在内联位置。
- 你是一名 **文档搭建助手**。请帮助用户创建并发布一个新的文档站点。
+ You are a **docs setup assistant**. Help the user create and publish a new docs site.
- 按步骤参考 [快速上手指南](https://buildwithfern.com/learn/docs/getting-started/quickstart.md)。
+ Follow the [Quickstart guide](https://buildwithfern.com/learn/docs/getting-started/quickstart.md) step by step.
```jsx Markdown
-你是一名 **文档搭建助手**。请帮助用户创建并发布一个新的文档站点。
+You are a **docs setup assistant**. Help the user create and publish a new docs site.
-按步骤参考 [快速上手指南](https://buildwithfern.com/learn/docs/getting-started/quickstart.md)。
+Follow the [Quickstart guide](https://buildwithfern.com/learn/docs/getting-started/quickstart.md) step by step.
```
@@ -36,209 +35,209 @@ description: 显示一个可复制的提示词，并可附带在 Cursor、Claude
### 带标题
-设置 `title` 属性可以在提示词栏上方添加标题行。设置标题后，操作按钮会移动到标题行中。
+设置 `title` 属性可在提示栏上方添加标题行。设置标题后，操作按钮会移到标题行中。
-
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
-### 单个“打开方式”操作
+### 带单个打开操作
-设置 `actions` 属性可添加按钮，将提示词直接在 AI 工具中打开。可用值：`cursor`、`claude`、`chatgpt`。
+设置 `actions` 属性可添加一个按钮，直接在 AI 工具中打开提示。可用值：`cursor`、`claude`、`chatgpt`。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
-### 多个“打开方式”操作
+### 带多个打开操作
-当指定多个操作时，第一个会作为主按钮，其余的可通过下拉菜单访问。
+当指定多个操作时，第一个成为主按钮，其余的通过下拉菜单访问。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
-### 自定义 URL 操作
+### 带自定义 URL 操作
-在 `actions` 中传入 `{ label, url, icon? }` 对象，可指向任意 AI 工具。自定义操作和内置操作可以在同一个数组中混合使用。
+在 `actions` 中传递 `{ label, url, icon? }` 对象可指向任何 AI 工具。自定义操作和内置操作可以在同一数组中混合使用。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
-### 自定义图标
+### 带自定义图标
-将 `icon` 属性设置为 Font Awesome 图标名或图片 URL。
+设置 `icon` 属性为 Font Awesome 图标名称或图片 URL。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
### 单行模式
-设置 `singleLine` 可将提示词正文截断为单行并以省略号结尾。这对紧凑的内联预览非常有用。
+设置 `singleLine` 可将提示主体截断为带有省略号的单行。这对于紧凑的内联预览很有用。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
-### 隐藏提示词正文
+### 隐藏提示主体
-设置 `hidePrompt` 可完全隐藏提示词正文区域，仅显示带复制和“打开方式”操作的标题行。当提示词较长且只想展示概要视图时，这一属性很有用。
+设置 `hidePrompt` 可完全隐藏提示主体。只显示带有复制和打开操作的标题行。当提示很长而您想要仅显示摘要视图时，这很有用。
- 根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+ Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```jsx Markdown
-根据我的 OpenAPI 规范生成一个 TypeScript SDK。请参照 [TypeScript SDK 快速上手](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md)。
+Generate a TypeScript SDK from my OpenAPI spec. Follow the [TypeScript SDK quickstart](https://buildwithfern.com/learn/sdks/generators/typescript/quickstart.md).
```
## 属性
- 以 Markdown 格式书写的提示词文本。该内容会显示在提示词正文中、复制到剪贴板，或发送给所选的 AI 工具，并保留原有的 Markdown 格式。
+ markdown 格式的提示文本。此内容显示在提示主体中，复制到剪贴板，或发送到选定的 AI 工具并保留其原始 markdown 格式。
- 显示在提示词栏上方的标题。
+ 显示在提示栏上方的标题。
- 显示在提示词文本左侧的 [Font Awesome 图标](/learn/docs/writing-content/components/icons) 名称或图片 URL。未设置时默认使用星光图标。
+ 显示在提示文本左侧的 [Font Awesome 图标](/learn/docs/writing-content/components/icons)名称或图片 URL。省略时默认为闪光图标。
- 要显示的操作按钮。每一项可以是内置的缩写值（`cursor`、`claude` 或 `chatgpt`），也可以是包含 `label`、`url` 以及可选 `icon` 字段的自定义操作对象。第一个操作会渲染为主按钮，其他操作可通过下拉菜单访问。无论该属性如何设置，复制按钮始终存在。
+ 要显示的操作按钮。每个条目是内置简写（`cursor`、`claude` 或 `chatgpt`）或带有 `label`、`url` 和可选 `icon` 字段的自定义操作对象。第一个操作渲染为主按钮；其他操作通过下拉菜单访问。无论此属性如何，复制按钮始终存在。
- 自定义操作的按钮文本。原样渲染——不会自动添加 `Open in` 前缀。
+ 自定义操作的按钮文本。按原样渲染——不添加 `Open in` 前缀。
- 自定义操作的目标 URL。使用 `{prompt}` 作为 URL 编码后提示词正文的占位符。若省略该占位符，提示词会作为 `prompt` 查询参数附加在 URL 后。仅支持 `http` 和 `https` 协议的 URL。
+ 自定义操作的目标 URL。使用 `{prompt}` 作为 URL 编码提示主体的占位符。如果省略，提示将作为 `prompt` 查询参数附加。仅支持 `http` 和 `https` URL。
- 在自定义操作按钮上显示的 [Font Awesome 图标](/learn/docs/writing-content/components/icons) 名称或图片 URL。未设置时默认使用星光图标。
+ 显示在自定义操作按钮中的 [Font Awesome 图标](/learn/docs/writing-content/components/icons)名称或图片 URL。省略时默认为闪光图标。
- 隐藏提示词正文区域，仅显示带复制和“打开方式”操作的标题行。需要同时设置 `title`。
+ 隐藏提示主体。只显示带有复制和打开操作的标题行。需要设置 `title`。
- 强制以单行截断并显示省略号的预览方式呈现提示词。当为 `false`（默认值）时，提示词正文会自动换行，最多显示五行并支持垂直滚动。
+ 强制单行截断预览并带有省略号。当为 `false`（默认值）时，提示主体会换行显示长行，最多显示五行并支持垂直滚动。
diff --git a/fern/translations/zh/products/docs/pages/component-library/default-components/runnable-endpoint.mdx b/fern/translations/zh/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
index 1275e7ea74..f683d28904 100644
--- a/fern/translations/zh/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/default-components/runnable-endpoint.mdx
@@ -1,52 +1,57 @@
---
title: 可运行端点
-description: 使用 RunnableEndpoint 为文档添加可测试的 API 端点。支持多环境、示例和实时响应预览。
-sidebar-title: 可运行端点
+description: 使用 RunnableEndpoint 在您的文档中添加可测试的 API 端点。支持多环境、示例和实时响应预览。
---
-`` 组件允许用户直接在 API 参考文档中对您的 API 发起真实的 HTTP 请求。它会自动从您的 API 规范中检测端点定义，并提供一个请求构建器，支持输入标头、路径参数、查询参数和请求体。
-## 使用方法
+`` 组件让用户直接从您的文档中向您的 API 发出真实的 HTTP 请求。它会自动从您的 API 规范中检测端点定义，为标头、路径参数、查询参数和请求体渲染请求构建器，并内联显示响应状态、标头、正文和时间。表单输入在页面重新加载时会保存在本地存储中。
+
+## 用法
- 
+
```jsx Markdown
-
+
```
-## 功能特性
+## 变体
+
+### 默认折叠
+
+使用 `collapsed` 来渲染组件，表单部分处于隐藏状态。用户可以通过单击组件来展开它。
-该组件支持：
-- **多个示例** – 当您的端点配置了多个预设示例时，组件会在标头显示一个下拉选择器，用户可以在不同示例之间切换
-- **多环境支持** – 如果您的 API 定义了多个环境（生产、预发布、开发），组件会自动显示环境选择器，用户可以针对不同的基础 URL 进行测试
-- **API 参考集成** – 每个 `` 都包含一个按钮，可以链接到该端点的完整 API 参考文档
-- **实时响应预览** – 用户发送请求后可以立即查看响应状态、标头、响应体和响应时间
-- **表单持久化** – 表单输入会自动保存在浏览器的本地存储中，即使在页面间导航或刷新浏览器时，用户的测试数据也会被保留
+
+
+
+
+```jsx Markdown
+
+```
## 属性
- "METHOD /path" 格式的端点定位符。例如：`"POST /api/users"` 或 `"GET /api/users/{id}"`。如果您的 API 使用了[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请使用命名空间和 `::` 作为前缀（例如：`"payments::POST /api/users"`）。
+ 端点定位符，格式为 "METHOD /path"。例如：`"POST /api/users"` 或 `"GET /api/users/{id}"`。如果您的 API 使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请在前面加上命名空间和 `::` （例如，`"payments::POST /api/users"`）。
- 使用指定名称的示例预填充表单。如果未指定，默认使用第一个示例。
+ 通过名称使用特定示例预填充表单。如果未指定，默认使用第一个示例。
- 设置端点的默认环境。该值必须对应于您的 API 规范中定义的服务器 URL 的 [`x-fern-server-name`](/learn/api-definitions/openapi/extensions/server-names-and-url-templating)。如果未指定，默认使用第一个环境。
+ 设置端点的默认环境。该值必须对应于 API 规范中定义的服务器 URL 的 [`x-fern-server-name`](/learn/api-definitions/openapi/extensions/server-names-and-url-templating)。如果未指定，默认使用第一个环境。
- 通过隐藏下拉选择器来锁定的字段。接受 `"environment"` 来锁定服务器 URL 并防止用户切换环境。当设置为 `readonly={["environment"]}` 时，环境选择器会被隐藏，端点使用 `defaultEnvironment` 指定的环境（如果未指定则使用第一个环境）。
+ 通过隐藏其下拉选择器来锁定的字段。接受 `"environment"` 来锁定服务器 URL 并防止用户切换环境。设置为 `readonly={["environment"]}` 时，环境选择器会被隐藏，端点使用 `defaultEnvironment` 指定的环境（如果未指定则使用第一个环境）。
- 控制组件是否默认以折叠状态渲染，隐藏表单部分。设置为 `collapsed={true}` 或使用简写 `collapsed`。用户可以通过点击组件来展开它。
+ 控制组件是否默认渲染为折叠状态，表单部分隐藏。设置为 `collapsed={true}` 或使用简写形式 `collapsed`。用户可以通过单击组件来展开它。
- 用于自定义组件容器样式的 CSS 类名。
-
\ No newline at end of file
+ 用于组件容器自定义样式的 CSS 类名。
+
diff --git a/fern/translations/zh/products/docs/pages/component-library/default-components/webhook-payload-snippet.mdx b/fern/translations/zh/products/docs/pages/component-library/default-components/webhook-payload-snippet.mdx
index c365fddec0..fd643ad284 100644
--- a/fern/translations/zh/products/docs/pages/component-library/default-components/webhook-payload-snippet.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/default-components/webhook-payload-snippet.mdx
@@ -1,20 +1,29 @@
---
title: Webhook 负载片段
-description: 从你的 API 参考文档中引用 webhook 负载，以在文档中显示示例负载。
-sidebar-title: Webhook 负载代码片段
+description: 从您的 API 参考中引用 webhook 负载，以在文档中显示示例负载。
---
-使用 `` 组件从你的 API 参考文档中引用 webhook 负载。
+`` 组件从您的 API 参考中显示 webhook 的请求负载架构。它呈现与 webhook 完整 API 参考页面相同的字段、类型和示例值，因此读者可以在您的内容中内联检查负载。
+
+要显示常规 HTTP 端点的架构，请使用 [``](/learn/docs/writing-content/components/endpoint-schema-snippet) 组件。
## 用法
+通过其 `operationId` 引用 webhook。
+
+
+
```jsx Markdown
-
+
```
## 属性
- 要显示的 webhook 的操作 ID。
-
\ No newline at end of file
+ 要显示的 webhook 的 `operationId`。如果您的 API 使用[命名空间](/learn/api-definitions/overview/project-structure#combined-sdks-from-multiple-apis)，请使用命名空间和 `::` 作为前缀（例如，`payments::on-payment-succeeded`）。
+
diff --git a/fern/translations/zh/products/docs/pages/component-library/demo.mdx b/fern/translations/zh/products/docs/pages/component-library/demo.mdx
index 739dc07b19..945719e229 100644
--- a/fern/translations/zh/products/docs/pages/component-library/demo.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/demo.mdx
@@ -1,11 +1,9 @@
---
title: 组件演示
-sidebar-title: 组件演示
-description: "用于测试和展示文档组件及示例内容片段的隐藏演示页面。"
+description: "用于测试和演示文档组件以及示例内容片段的隐藏展示页面。"
hidden: true
---
-
此页面包含用于测试和展示各种文档组件的演示内容。它在导航中隐藏，但可以从示例中链接到。
## API 客户端示例
@@ -15,9 +13,9 @@ hidden: true
`PlantClient` 类是与植物商店 API 交互的主要入口点。它处理身份验证、请求管理，并提供对所有 API 端点的访问。
**构造函数参数：**
-- `apiKey` (string, 必需): 您的 API 身份验证密钥
-- `baseUrl` (string, 可选): 用于测试的自定义 API 基础 URL
-- `timeout` (number, 可选): 请求超时时间（毫秒）
+- `apiKey`（string，必需）：您的 API 身份验证密钥
+- `baseUrl`（string，可选）：用于测试的自定义 API 基础 URL
+- `timeout`（number，可选）：请求超时时间（毫秒）
**使用示例：**
```typescript
@@ -33,21 +31,21 @@ const client = new PlantClient({
用于自定义植物商店 SDK 行为的配置对象。
**属性：**
-- `retryAttempts` (number): 失败请求的重试次数
-- `cacheEnabled` (boolean): 启用响应缓存
-- `logLevel` (string): 日志详细程度级别
+- `retryAttempts`（number）：失败请求的重试次数
+- `cacheEnabled`（boolean）：启用响应缓存
+- `logLevel`（string）：日志详细程度级别
### createPlant
在数据库中创建新的植物条目。
**参数：**
-- `name` (string, 必需): 植物的常用名称
-- `species` (string, 必需): 科学物种名称
-- `description` (string, 可选): 植物描述
-- `careLevel` (string, 可选): 护理难度级别
+- `name`（string，必需）：植物的通用名称
+- `species`（string，必需）：科学物种名称
+- `description`（string，可选）：植物描述
+- `careLevel`（string，可选）：护理难度级别
-**返回值：** 解析为已创建植物对象的 Promise
+**返回：** 解析为已创建植物对象的 Promise
**示例：**
```typescript
@@ -79,11 +77,11 @@ def create_plant(
从 API 检索植物列表，支持可选过滤。
**参数：**
-- `filters` (object, 可选): 过滤条件
-- `limit` (number, 可选): 最大结果数量
-- `offset` (number, 可选): 分页偏移量
+- `filters`（object，可选）：过滤条件
+- `limit`（number，可选）：结果的最大数量
+- `offset`（number，可选）：分页偏移量
-**返回值：** 解析为植物对象数组的 Promise
+**返回：** 解析为植物对象数组的 Promise
## 类型定义
@@ -92,30 +90,30 @@ def create_plant(
`PlantStore` 类管理植物数据存储和检索操作。
**构造函数参数：**
-- `apiKey` (string, 必需): 您的 API 身份验证密钥
-- `config` (PlantConfig, 可选): 配置选项
+- `apiKey`（string，必需）：您的 API 身份验证密钥
+- `config`（PlantConfig，可选）：配置选项
### PlantClient
`PlantClient` 类提供与 PlantStore 交互的客户端接口。
**构造函数参数：**
-- `store` (PlantStore, 必需): 要使用的 PlantStore 实例
+- `store`（PlantStore，必需）：要使用的 PlantStore 实例
### PlantResponse
从植物相关 API 调用返回的响应对象。
**属性：**
-- `plants` (Array): 植物对象列表
-- `total` (number): 植物总数
-- `hasMore` (boolean): 是否有更多结果可用
+- `plants`（Array）：植物对象列表
+- `total`（number）：植物总数
+- `hasMore`（boolean）：是否有更多结果可用
## Get 方法
-用于访问植物商店资源的常用检索方法。
+访问植物商店资源的常见检索方法。
-| 方法 | 描述 | 参数 | 返回值 |
+| 方法 | 描述 | 参数 | 返回 |
|--------|-------------|------------|---------|
-| `getPlant` | 通过 ID 检索单个植物 | `plant_id` (string, 必需): 植物的唯一标识符 | 植物对象 |
-| `getGarden` | 通过 ID 检索单个花园 | `garden_id` (string, 必需): 花园的唯一标识符 | 花园对象 |
\ No newline at end of file
+| `getPlant` | 通过 ID 检索单个植物 | `plant_id`（string，必需）：植物的唯一标识符 | 植物对象 |
+| `getGarden` | 通过 ID 检索单个花园 | `garden_id`（string，必需）：花园的唯一标识符 | 花园对象 |
diff --git a/fern/translations/zh/products/docs/pages/component-library/writing-content/markdown-basics.mdx b/fern/translations/zh/products/docs/pages/component-library/writing-content/markdown-basics.mdx
index 09b3199659..c7180e79e4 100644
--- a/fern/translations/zh/products/docs/pages/component-library/writing-content/markdown-basics.mdx
+++ b/fern/translations/zh/products/docs/pages/component-library/writing-content/markdown-basics.mdx
@@ -1,24 +1,23 @@
---
title: Markdown 基础
-description: 使用 Markdown 和 MDX 在 Fern 文档网站中添加内容，包括标题、组件、链接和 API 端点链接。
-sidebar-title: Markdown 基础
+description: 使用 Markdown 和 MDX 为你的 Fern 文档站点添加内容，包括标题、组件、链接和 API 端点链接。
---
-学习如何使用 Markdown 和 MDX 在文档中添加内容，包括标题、组件和链接。
+学习如何使用 Markdown 和 MDX 为你的文档添加内容，包括标题、组件和链接。
-
-在本文档中，"Markdown" 指代 Markdown 和 MDX。[MDX](https://mdxjs.com/) 是 Markdown 的扩展版本，允许使用 JSX 组件。
+
+在整个文档中，"Markdown"既指 Markdown 也指 MDX。[MDX](https://mdxjs.com/) 是 Markdown 的一个版本，扩展了对 JSX 组件的支持。
## 添加 Markdown 或 MDX 页面
-通过创建 Markdown（`.md`）或 MDX（`.mdx`）文件手动向文档添加页面。初次接触 Markdown？请参阅 [Markdown Guide: Getting started](https://www.markdownguide.org/getting-started/)。
+通过创建 Markdown (`.md`) 或 MDX (`.mdx`) 文件手动为你的文档添加页面。初次接触 Markdown？查看 [Markdown Guide: Getting started](https://www.markdownguide.org/getting-started/)。
-将页面放置在 `fern/` 文件夹内，并在 `docs.yml` 文件的[导航设置](/learn/docs/configuration/navigation)中链接到它们。
+将你的页面放在 `fern/` 文件夹内，并在 `docs.yml` 文件的[导航设置](/learn/docs/configuration/navigation)中链接到它们。
-在下面的示例中，MDX 文件位于名为 `pages/` 的文件夹内。
+在下面的例子中，MDX 文件放在名为 `pages/` 的文件夹内。
-
+
```bash
fern/
├─ fern.config.json
@@ -32,37 +31,57 @@ fern/
```yml
navigation:
- - section: 概述
+ - section: Overview
contents:
- - page: 欢迎
+ - page: Welcome
path: ./pages/welcome.mdx
- - page: 快速开始
+ - page: Quickstart
path: ./pages/quickstart.mdx
```
## 页面标题
-Fern 使用 `docs.yml` 中的 `page` 值自动为每个页面生成 `` 页面标题。例如，以下条目将此页面的页面标题设置为"Markdown basics"：
+Fern 使用 `docs.yml` 中的 `page` 值自动为每个页面生成 `` 页面标题。例如，以下条目为此页面设置页面标题为 "Markdown basics"：
```yml docs.yml
- page: Markdown basics
path: ./pages/component-library/writing-content/markdown-basics.mdx
```
-因为 `` 是自动生成的，您应该从 `` 标题开始页面内容，而不是 ``。
+由于 `` 是自动生成的，你应该用 `` 标题开始页面内容，而不是 ``。
## Markdown 中的链接
### 链接格式
-使用 `/` 字符开始一个指向文档网站上另一个页面的相对 URL。这会路由到 `docs.yml` 文件中定义的 `url`，例如 `example-docs.buildwithfern.com`。例如，如果您想链接到 `https://example-docs.buildwithfern.com/overview/introduction`，您可以在 Markdown 中这样写链接：
-
-```mdx
-阅读[介绍](/learn/sdks/overview/introduction)。
+要链接到文档站点上的另一个页面，请写目标的**已发布站点路径**，以 `/` 开头。Fern 从你的[`docs.yml` 和产品 YAML 文件](/learn/docs/configuration/navigation)中的 slugs 构建此路径，而不是从磁盘上的文件位置构建。要链接到另一个页面的标题，请在路径后追加 `#anchor`。
+
+
+ 内页链接不支持文件相对路径如 `./` 和 `../` — 请使用已发布的站点路径代替。（文件相对路径仍然适用于[图片和其他媒体](/learn/docs/writing-content/markdown-media)以及 YAML 配置中的 `path:` 引用。）
+
+
+
+```mdx wordWrap
+了解 [Fern SDK 如何工作](/learn/sdks/overview/how-it-works)。
+
+配置[侧边栏图标](/learn/docs/configuration/navigation#sidebar-icons)为你的导航添加视觉提示。
```
+在[版本化文档](/learn/docs/configuration/versions)中，相同的路径会根据你写的是无版本形式（默认版本）还是有版本形式（例如 `/learn/docs/v2/getting-started`）而跳转到不同版本。对于单个页面内的内联版本特定内容，请使用 [``](/learn/docs/writing-content/components/if#by-version) 或 [``](/learn/docs/writing-content/components/versions)。
+
+### 验证链接
+
+Fern 提供两种捕获损坏链接的方法。[`broken-links` 规则](/learn/docs/configuration/site-level-settings#check-configuration) — 由 [`fern check`](/learn/cli-api-reference/cli-reference/commands#fern-check) 运行，包括在 `fern docs dev` 期间 — 验证每个内部链接是否符合从你的**本地** YAML 构建的导航树。要检查已发布站点上的链接，请使用 [`fern docs link check`](/learn/cli-api-reference/cli-reference/commands#fern-docs-link-check) 或 [Fern Dashboard](https://dashboard.buildwithfern.com/)。
+
+| | `fern check` broken-links 规则 | `fern docs link check` |
+|---|---|---|
+| 检查内容 | 你的**本地** YAML 导航树中的内部链接 | 你的**实时部署**站点上的所有链接 |
+| 外部链接 | 不检查 | 检查 |
+| 是否需要已发布站点 | 否 | 是 |
+| 使用场景 | 在 CI 中，发布前 | 发布后，捕获实时 404 和损坏的外部 URL |
+
### API 链接语法
@@ -71,11 +90,11 @@ Fern 使用 `docs.yml` 中的 `page` 值自动为每个页面生成 `` 页
-[了解更多](/learn/docs/configuration/navigation)关于链接和其他导航元素的信息。
+[了解更多](/learn/docs/configuration/navigation)关于链接和其他导航元素。
## 表格
-使用标准 Markdown 语法通过管道（`|`）和连字符（`-`）创建表格：
+使用标准 Markdown 语法和管道符（`|`）及连字符（`-`）创建表格：
```markdown
| 列 1 | 列 2 | 列 3 |
@@ -84,8 +103,8 @@ Fern 使用 `docs.yml` 中的 `page` 值自动为每个页面生成 `` 页
| 行 2 | 数据 | 数据 |
```
-对于更高级的表格功能，如较长数据集的粘性标题，请参阅[表格组件](/learn/docs/writing-content/components/tables)文档。
+对于更高级的表格功能，如为较长数据集提供粘性标题，请参阅 [Table 组件](/learn/docs/writing-content/components/tables)文档。
## Fern 组件
-Fern 具有内置组件库，您可以在 Markdown 中使用。[探索组件。](/learn/docs/content/components/overview)
\ No newline at end of file
+Fern 有一个内置的组件库，你可以在 Markdown 中使用。[探索这些组件。](/learn/docs/content/components/overview)
diff --git a/fern/translations/zh/products/docs/pages/customization/hiding-content-example.mdx b/fern/translations/zh/products/docs/pages/customization/hiding-content-example.mdx
index 14d6dba03a..e4b45433b1 100644
--- a/fern/translations/zh/products/docs/pages/customization/hiding-content-example.mdx
+++ b/fern/translations/zh/products/docs/pages/customization/hiding-content-example.mdx
@@ -1,11 +1,10 @@
---
title: 隐藏页面示例
-sidebar-title: 隐藏页面示例
-description: "隐藏页面演示。此页面不在侧边栏和搜索结果中显示,只能通过直接 URL 访问 —— 用于演示 hidden: true 设置。"
+description: "隐藏页面演示。此页面不显示在侧边栏和搜索中，仅可通过直接 URL 访问——用于说明 hidden: true 设置。"
noindex: true
---
-你找到了！这个页面通过在 `docs.yml` 中设置 `hidden: true` 从侧边栏和搜索结果中隐藏。只能通过直接 URL 访问。
+你找到了！此页面通过在 `docs.yml` 中使用 `hidden: true` 从侧边栏和搜索结果中隐藏。只能通过直接 URL 访问。
-要了解如何在你自己的文档中隐藏内容，请参阅[隐藏内容](/learn/docs/customization/hiding-content)。
\ No newline at end of file
+要了解如何在你自己的文档中隐藏内容，请参见[隐藏内容](/learn/docs/customization/hiding-content)。
diff --git a/fern/translations/zh/products/docs/pages/customization/hiding-content.mdx b/fern/translations/zh/products/docs/pages/customization/hiding-content.mdx
index e26f0be69b..6df6aef5ad 100644
--- a/fern/translations/zh/products/docs/pages/customization/hiding-content.mdx
+++ b/fern/translations/zh/products/docs/pages/customization/hiding-content.mdx
@@ -1,16 +1,15 @@
---
-title: 在站点中隐藏内容
-description: 通过从侧边栏和搜索结果中隐藏页面、章节、选项卡、选项卡变体、版本和 API 端点来控制内容的可见性。
-sidebar-title: 隐藏站点内容
+title: 在您的网站中隐藏内容
+description: 通过将页面、部分、选项卡、选项卡变体、版本和API端点从侧边栏和搜索结果中隐藏，来控制内容的可见性。
---
-Fern 为您提供了两个主要工具来控制内容可见性：在 `docs.yml` 中设置 `hidden: true` 可以从站点侧边栏和搜索结果中移除内容，而在页面前言中设置 `noindex: true` 可以在不影响导航的情况下将页面从搜索中排除。
+Fern 为您提供了两种主要工具来控制内容可见性：在 `docs.yml` 中设置 `hidden: true` 可以从网站侧边栏和搜索结果中移除内容，而在页面前置元数据中设置 `noindex: true` 可以在不影响导航的情况下将页面排除在搜索之外。
## 隐藏页面
-### 仅通过直接 URL 访问
+### 仅通过直接URL访问
-在 `docs.yml` 中设置 `hidden: true` 可以从侧边栏、搜索结果和 [llms.txt](/learn/docs/ai-features/llms-txt) 中移除页面，同时保持通过直接链接访问。这对于与审核人员分享草稿文档或从外部工具（如支持工单）进行链接很有用。无需同时设置 `noindex` — `hidden: true` 会自动处理两者。
+在 `docs.yml` 中设置 `hidden: true` 可以从侧边栏、搜索结果和 [llms.txt](/learn/docs/ai-features/llms-txt) 中移除页面，但仍可通过直接链接访问。这对于与审阅者分享草稿文档或从支持工单等外部工具链接很有用。无需同时设置 `noindex` — `hidden: true` 会自动处理这两种情况。
```yaml title="docs.yml" {4}
navigation:
@@ -25,12 +24,12 @@ navigation:
```
-此页面在侧边栏和搜索引擎中隐藏，但您可以通过直接链接访问。
+此页面已从侧边栏和搜索引擎中隐藏，但您可以通过直接链接访问。
### 仅从搜索中排除
-在页面前言中设置 `noindex: true` 可以将其从搜索引擎和 [llms.txt](/learn/docs/ai-features/llms-txt) 中排除，同时保持在站点上的可发现性。这对于早期访问文档或您希望读者通过导航而非搜索或 AI 工具找到的内容很有用。
+在页面前置元数据中设置 `noindex: true` 可以将页面从搜索引擎和 [llms.txt](/learn/docs/ai-features/llms-txt) 中排除，但仍保持在网站上可被发现。这对于早期访问文档或您希望读者通过导航找到但不通过搜索或AI工具找到的内容很有用。
```mdx title="early-access-feature.mdx" {3}
---
@@ -39,11 +38,11 @@ noindex: true
---
```
-有关更多 SEO 相关选项，请参见 [SEO 元数据](/learn/docs/seo/setting-seo-metadata)。
+有关更多SEO相关选项，请参阅 [SEO元数据](/learn/docs/seo/setting-seo-metadata)。
-## 隐藏 API 端点
+## 隐藏API端点
-在 `docs.yml` 中的端点布局配置中设置 `hidden: true` 可以将其从侧边栏中隐藏。与页面级别的 `hidden` 一样，隐藏的端点会自动从搜索引擎索引中排除，因此无需设置 `noindex: true`。
+在 `docs.yml` 的端点布局配置中设置 `hidden: true` 可以从侧边栏中隐藏端点。与页面级别的 `hidden` 一样，隐藏的端点会自动从搜索引擎索引中排除，因此无需设置 `noindex: true`。
```yaml title="docs.yml" {6}
navigation:
@@ -54,16 +53,16 @@ navigation:
hidden: true
```
-有关完整配置详情，包括 OpenAPI、Fern Definition 和 WebSocket 端点的示例，请参见[隐藏端点](/learn/docs/api-references/customize-api-reference-layout#hiding-endpoints)。
+有关完整配置详情，包括OpenAPI和WebSocket端点的示例，请参阅 [隐藏端点](/learn/docs/api-references/customize-api-reference-layout#hiding-endpoints)。
-## 隐藏章节、选项卡、选项卡变体或版本
+## 隐藏部分、选项卡、选项卡变体或版本
-从导航中隐藏整个[章节](/learn/docs/configuration/navigation)、[选项卡](/learn/docs/configuration/tabs)、[选项卡变体](/learn/docs/configuration/tabs#tab-variants)或[版本](/learn/docs/configuration/versions) — 例如，旧版 API、内部选项卡或内部工具文档章节。
+从导航中隐藏整个 [部分](/learn/docs/configuration/navigation)、[选项卡](/learn/docs/configuration/tabs)、[选项卡变体](/learn/docs/configuration/tabs#tab-variants) 或 [版本](/learn/docs/configuration/versions) — 例如，传统API版本、内部选项卡或内部工具文档的某个部分。
-与隐藏页面或端点不同，隐藏章节、选项卡、选项卡变体或版本只会从导航中移除组。其中的单个页面仍然会被搜索引擎和 AI 索引，因为 `hidden` 应用于组，而不是每个页面。要同时从搜索结果中排除单个页面，请在每个页面的前言中添加 `noindex: true`。
+与隐藏页面或端点不同，隐藏部分、选项卡、选项卡变体或版本只会从导航中移除该组。其中的各个页面仍会被搜索引擎和AI索引，因为 `hidden` 适用于分组，而不是每个页面。要同时从搜索结果中排除各个页面，请在每个页面的前置元数据中添加 `noindex: true`。
-
+
```yaml title="docs.yml" {8}
navigation:
- section: Introduction
@@ -79,7 +78,7 @@ navigation:
```
-
+
@@ -132,6 +131,6 @@ versions:
hidden: true
```
-默认版本（版本列表中的第一个版本）不能隐藏。
+默认版本（版本列表中的第一个版本）无法隐藏。
-
\ No newline at end of file
+
diff --git a/fern/translations/zh/products/docs/pages/customization/search.mdx b/fern/translations/zh/products/docs/pages/customization/search.mdx
index 97f25087c1..958de187ce 100644
--- a/fern/translations/zh/products/docs/pages/customization/search.mdx
+++ b/fern/translations/zh/products/docs/pages/customization/search.mdx
@@ -1,26 +1,25 @@
---
title: 搜索配置
-description: 使用 Algolia DocSearch 为您的 Fern 文档配置搜索。了解搜索过滤器如何工作、结果排名机制，以及如何与 Algolia 集成。
-sidebar-title: 搜索配置
+description: 使用 Algolia DocSearch 为您的 Fern 文档配置搜索。了解搜索过滤器的工作原理、结果排序方式，以及如何与 Algolia 集成。
---
Fern 使用 [Algolia DocSearch](https://docsearch.algolia.com/) 为您的文档提供搜索功能。
-DocSearch 专为文档站点设计，帮助用户找到所需内容。
+DocSearch 专为文档站点设计，帮助用户找到他们需要的内容。
## 搜索工作原理
-DocSearch 扫描您的 Fern 站点内容并构建索引以生成搜索结果。
-它包含内置的下拉过滤器，这些过滤器会根据您站点的配置动态显示，让用户精细化搜索：
+DocSearch 扫描您的 Fern 站点内容并构建索引来生成搜索结果。
+它包含基于您站点配置动态显示的内置下拉过滤器，让用户可以精细化搜索：
-- **产品：** 将结果限定为文档中的特定产品（适用于有多个[产品](/learn/docs/configuration/products)的站点）
-- **版本：** 按文档版本过滤结果（适用于使用[版本文档](/learn/docs/configuration/versions)的站点）
+- **产品：** 将结果范围缩小到文档中的特定产品（适用于具有多个[产品](/learn/docs/configuration/products)的站点）
+- **版本：** 按文档版本过滤结果（适用于使用[版本化文档](/learn/docs/configuration/versions)的站点）
- **内容类型：** 按指南、更新日志条目或 API 端点过滤结果
- **API 类型：** 按协议（HTTP、webhooks、WebSockets 或 gRPC）过滤 API 结果
- **HTTP 方法：** 按 HTTP 方法（`GET`、`POST`、`PUT`、`DELETE` 等）过滤 API 结果
- **状态码：** 按 HTTP 状态码过滤 API 结果
-- **可用性：** 按可用性状态过滤 API 结果，包括稳定版、测试版和已弃用
+- **可用性：** 按可用性状态过滤 API 结果，包括稳定、测试版和已弃用
-
+
{/* Community Section */}
@@ -268,7 +261,7 @@ layout: custom
-
更新日志
+
变更日志
查看我们最新的产品更新。
@@ -321,10 +314,10 @@ layout: custom
-
GitHub
+
Github
-
\ No newline at end of file
+
diff --git a/fern/translations/zh/products/api-def/openapi/auth.mdx b/fern/translations/zh/products/api-def/openapi/auth.mdx
index 394972b3bf..d672fd2b22 100644
--- a/fern/translations/zh/products/api-def/openapi/auth.mdx
+++ b/fern/translations/zh/products/api-def/openapi/auth.mdx
@@ -1,19 +1,18 @@
---
title: 身份验证
-description: '为 bearer、basic、API 密钥和 OAuth 等认证方案建模。'
-sidebar-title: 身份验证
+description: '对 bearer、basic、API 密钥和 OAuth 等认证方案进行建模。'
---
Fern 支持两种配置身份验证的方式：
-- **在您的 OpenAPI 规范中**使用 `securitySchemes` — 标准方法，使身份验证配置具有可移植性，并与其他 OpenAPI 工具兼容。
-- **在 `generators.yml` 中**使用 `auth-schemes` — 用于自定义参数名称和环境变量，覆盖规范中定义的内容，或配置 OAuth（在 OpenAPI 中不可用）。
+- **在您的 OpenAPI 规范中**使用 `securitySchemes` — 标准方法，保持认证配置的可移植性，并与其他 OpenAPI 工具兼容。
+- **在 `generators.yml` 中**使用 `auth-schemes` — 使用此方式自定义参数名称和环境变量，覆盖规范中定义的内容，或配置 OAuth（在 OpenAPI 中不可用）。
-您的身份验证配置适用于生成的 SDK 和 [API 浏览器](/learn/docs/api-references/api-explorer)。所有 SDK 都支持凭据的直接配置和环境变量。如果您在两个地方定义了相同的方案，`generators.yml` 优先。
+您的身份验证配置适用于生成的 SDK 和 [API 浏览器](/learn/docs/api-references/api-explorer)。所有 SDK 都支持凭证的直接配置和环境变量。如果您在两个地方定义了相同的方案，则以 `generators.yml` 为准。
-## 在您的规范中配置身份验证
+## 在规范中配置身份验证
-在 `components.securitySchemes` 中定义您的方案，然后使用 `security` 属性全局或按端点应用它们。
+在 `components.securitySchemes` 中定义您的方案，然后使用 `security` 属性全局应用或按端点应用。
```yml title="openapi.yml"
# 定义方案
@@ -23,7 +22,7 @@ components:
type: http
scheme: bearer
-# 在所有端点中全局应用
+# 在所有端点全局应用
security:
- BearerAuth: []
```
@@ -89,7 +88,7 @@ components:
```
-
-
-
-## 工作原理
-
-### 发起请求
-
-在您已添加 Fern Writer 的 Slack 频道中，标记 `@Fern Writer` 并描述您需要的更改。Fern Writer [仅在被直接标记时响应](#隐私和数据处理)。它会对您的消息进行表情反应以确认收到，然后创建拉取请求并回复链接。
-
-
- 
-
-
-Fern Writer 支持图片和文件附件以提供额外的上下文。当在现有对话串中被标记时，它会读取完整对话以理解上下文后再响应。
-
-| 用例 | 示例请求 |
-|----------|----------------|
-| 为新功能编写文档（基于拉取请求） | `@Fern Writer 为 PR #123 中添加的新速率限制功能编写文档` |
-| 向现有页面添加新内容 | `@Fern Writer 在 webhook 指南中添加关于 webhook 重试行为的章节` |
-| 重新组织和整合内容 | `@Fern Writer 合并身份验证和授权页面，并从旧的认证页面添加重定向` |
-| 修复错误并提高清晰度 | `@Fern Writer 修复快速开始中损坏的代码示例，并将包版本更新到 v2.1.0` |
-
-
@@ -82,18 +67,6 @@ navigation:
- DELETE /user/{username}
```
- 
-### 样式化端点
+### 设置端点样式
-要自定义端点的显示，您可以添加 `title`。您也可以使用 `slug` 自定义端点 URL。
+要自定义端点的显示，您可以添加 `title`。您还可以使用 `slug` 来自定义端点 URL。
@@ -297,7 +211,7 @@ navigation:
### 添加章节概述
-您可以通过两种方式向您的 API 参考或单个章节添加概述页面：
+您可以通过两种方式为 API 参考或单个章节添加概述页面：
+WebSocket API 参考在 Fern 中的渲染示例}>
+