@@ -131,7 +131,7 @@ yarn twenty dev --once
Her iki mod da geliştirme modunda bir sunucuya ve kimliği doğrulanmış bir uzak uca ihtiyaç duyar.
-Geliştirme modu yalnızca geliştirme ortamında (`NODE_ENV=development`) çalışan Twenty örneklerinde kullanılabilir. Üretim örnekleri, geliştirme eşitleme isteklerini reddeder — üretim sunucularına dağıtmak için `yarn twenty deploy` kullanın. Bkz. [Publishing](/l/tr/developers/extend/apps/operations/publishing).
+Geliştirme modu yalnızca geliştirme ortamında (`NODE_ENV=development`) çalışan Twenty örneklerinde kullanılabilir. Üretim örnekleri, geliştirme eşitleme isteklerini reddeder — üretim sunucularına dağıtmak için `yarn twenty deploy` kullanın. Bkz. [Yayımlama](/l/tr/developers/extend/apps/operations/publishing).
---
@@ -144,7 +144,7 @@ Daha kapsamlı bir projeyle başlamak için `--example` kullanın (özel nesnele
npx create-twenty-app@latest my-twenty-app --example postcard
```
-Örnekler [twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples) dizininde yer alır. Ayrıca `yarn twenty add` ile mevcut bir projeye tek tek varlıklar için iskelet oluşturabilirsiniz — bkz. [Scaffolding](/l/tr/developers/extend/apps/getting-started/scaffolding).
+Örnekler [twenty-apps/examples](https://github.com/twentyhq/twenty/tree/main/packages/twenty-apps/examples) dizininde yer alır. Ayrıca `yarn twenty add` ile mevcut bir projeye tek tek varlıklar için iskelet oluşturabilirsiniz — bkz. [İskelet Oluşturma](/l/tr/developers/extend/apps/getting-started/scaffolding).
---
@@ -154,14 +154,14 @@ Uygulamalar **varlıklardan** oluşur — her biri tek bir `export default` içe
| Varlık | Ne yapar |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
-| **Nesneler ve Alanlar** | Özel veri modelleri (Post Card, Invoice vb.) tipli alanlarla |
+| **Nesneler ve Alanlar** | Özel veri modelleri (Post Card, Invoice vb.) tiplendirilmiş alanlarla |
| **Mantıksal işlevler** | HTTP rotaları, cron zamanlamaları veya veritabanı olayları tarafından tetiklenen sunucu tarafı TypeScript |
| **Ön uç bileşenleri** | Twenty'nin arayüzünde görüntülenen React bileşenleri (yan panel, widget'lar, komut menüsü) |
| **Beceriler ve Aracılar** | Yapay zeka yetenekleri — yeniden kullanılabilir yönergeler ve otonom asistanlar |
| **Görünümler ve Gezinme** | Önceden yapılandırılmış liste görünümleri ve kenar çubuğu menü öğeleri |
| **Sayfa düzenleri** | Sekmeler ve widget'lar içeren özel kayıt ayrıntı sayfaları |
-Tam başvuru: [Concepts](/l/tr/developers/extend/apps/getting-started/concepts).
+Tam başvuru: [Kavramlar](/l/tr/developers/extend/apps/getting-started/concepts).
## Sonraki adımlar
@@ -173,12 +173,12 @@ Tam başvuru: [Concepts](/l/tr/developers/extend/apps/getting-started/concepts).
Nesneler, alanlar ve çift yönlü ilişkiler.
- Mantık fonksiyonları, beceriler, aracılar ve OAuth bağlantıları.
+ Mantık işlevleri, beceriler, aracılar ve OAuth bağlantıları.
- Görünümler, gezinme, sayfa düzenleri, ön bileşenler.
+ Görünümler, gezinme, sayfa düzenleri, ön uç bileşenleri.
- CLI, test, uzaklar, CI ve uygulamanızı yayımlama.
+ CLI, test, uzak uçlar, CI ve uygulamanızı yayımlama.
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/layout/overview.mdx
index baf37d2ad4..e8277af891 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/layout/overview.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/layout/overview.mdx
@@ -1,6 +1,6 @@
---
title: Genel Bakış
-description: Uygulamanızı Twenty'nin UI'sinin içine yerleştirin — kenar çubuğu girişleri, kaydedilmiş görünümler, kayıt sayfası sekmeleri ve yalıtılmış React bileşenleri.
+description: Uygulamanızı Twenty'nin kullanıcı arayüzüne yerleştirin — kenar çubuğu öğeleri, kaydedilmiş görünümler, kayıt sayfası sekmeleri ve yalıtılmış React bileşenleri.
icon: table-columns
---
@@ -26,7 +26,7 @@ Bir Twenty uygulamasının **düzen katmanı**, kullanıcının gördüğü her
## Bu bölümde
-
+
`defineView` — kaydedilmiş liste yapılandırmaları: görünür sütunlar, filtreler, gruplar.
@@ -39,13 +39,13 @@ Bir Twenty uygulamasının **düzen katmanı**, kullanıcının gördüğü her
`defineFrontComponent` — Twenty içinde oluşturulan yalıtılmış React bileşenleri.
- `defineCommandMenuItem` — ön bileşenleri Cmd+K girişleri ve hızlı eylemler olarak kaydedin.
+ `defineCommandMenuItem` — ön uç bileşenlerini Cmd+K girişleri ve hızlı eylemler olarak kaydedin.
## Uygulamanın göründüğü yerler
-| Yüzey | Neyi kontrol eder | Varlık |
+| Görünüm alanı | Neyi kontrol eder | Varlık |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------- |
| **Kenar çubuğu** | Kaydedilmiş bir görünüme veya harici bir URL'ye bağlanan özel bir giriş | `defineNavigationMenuItem` |
| **Kayıt listesi** | Bir nesne için kaydedilmiş yapılandırma — görünür sütunlar, sıralama, filtreler, gruplar | `defineView` |
@@ -53,4 +53,4 @@ Bir Twenty uygulamasının **düzen katmanı**, kullanıcının gördüğü her
| **Yukarıdakilerin herhangi birinin içinde** | Özel bir React bileşeni — butonlar, formlar, panolar, entegrasyonlar | `defineFrontComponent` |
| **Komut menüsü (Cmd+K)** | Sabitlenmiş bir hızlı eylem veya gizli komut | `defineCommandMenuItem` |
-Ön bileşenler, Remote DOM kullanan yalıtılmış bir Web Worker içinde çalışır — sayfada *yerel* olarak oluşturulurlar (bir iframe içinde değil), ancak ana sayfaya veya DOM'a doğrudan erişemezler. Twenty ile iletişim, mesaj iletimi yapan bir ana makine API'si aracılığıyla gerçekleşir.
+Ön uç bileşenleri, Remote DOM kullanan yalıtılmış bir Web Worker içinde çalışır — sayfada *yerel* olarak oluşturulurlar (bir iframe içinde değil), ancak ana makine sayfasına veya DOM'a doğrudan erişemezler. Twenty ile iletişim, mesaj iletimi yapan bir ana makine API'si aracılığıyla gerçekleşir.
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/logic/connections.mdx
index 6e5d33e9ad..5d36c5bd7a 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/logic/connections.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/logic/connections.mdx
@@ -52,7 +52,6 @@ export default defineApplication({
universalIdentifier: '...',
displayName: 'Linear',
description: 'Connect Linear to Twenty.',
- defaultRoleUniversalIdentifier: '...',
// OAuth client credentials live on the app registration (one OAuth app per
// Twenty server, configured by the admin) — not per-workspace. Declare them
// as serverVariables so the admin can fill them in once for all installs.
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
index dc95236fc2..370ea7ab1a 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/logic/logic-functions.mdx
@@ -7,9 +7,9 @@ icon: bolt
Mantık işlevleri, Twenty platformunda çalışan sunucu tarafı TypeScript işlevleridir. HTTP istekleri, cron zamanlamaları veya veritabanı olayları tarafından tetiklenebilirler — ve ayrıca yapay zekâ ajanları için araçlar olarak sunulabilirler.
-
+
-Her fonksiyon dosyası, bir işleyici ve isteğe bağlı tetikleyiciler içeren bir yapılandırmayı dışa aktarmak için `defineLogicFunction()` kullanır.
+Her işlev dosyası, bir işleyici ve isteğe bağlı tetikleyiciler içeren bir yapılandırmayı dışa aktarmak için `defineLogicFunction()` kullanır.
```ts src/logic-functions/createPostCard.logic-function.ts
import { defineLogicFunction } from 'twenty-sdk/define';
@@ -51,14 +51,14 @@ export default defineLogicFunction({
```
Kullanılabilir tetikleyici türleri:
-* **httpRoute**: Fonksiyonunuzu bir HTTP yolu ve yöntemiyle **`/s/` uç noktasının altında** kullanıma sunar:
+* **httpRoute**: İşlevinizi bir HTTP yolu ve yöntemiyle **`/s/` uç noktasının altında** kullanıma sunar:
> örn. `path: '/post-card/create'` `https://your-twenty-server.com/s/post-card/create` adresinden çağrılabilir
-* **cron**: Bir CRON ifadesi kullanarak fonksiyonunuzu bir zamanlamayla çalıştırır.
-* **databaseEvent**: Çalışma alanı nesnesi yaşam döngüsü olaylarında çalışır. Olay işlemi `updated` olduğunda, dinlenecek belirli alanlar `updatedFields` dizisinde belirtilebilir. Tanımsız veya boş bırakılırsa, herhangi bir güncelleme fonksiyonu tetikler.
+* **cron**: Bir CRON ifadesi kullanarak işlevinizi bir zamanlamayla çalıştırır.
+* **databaseEvent**: Çalışma alanı nesnesi yaşam döngüsü olaylarında çalışır. Olay işlemi `updated` olduğunda, dinlenecek belirli alanlar `updatedFields` dizisinde belirtilebilir. Tanımsız veya boş bırakılırsa, herhangi bir güncelleme işlevi tetikler.
> örn. `person.updated`, `*.created`, `company.*`
-Bir fonksiyonu CLI kullanarak manuel olarak da çalıştırabilirsiniz:
+Bir işlevi CLI kullanarak manuel olarak da çalıştırabilirsiniz:
```bash filename="Terminal"
yarn twenty exec -n create-new-post-card -p '{"key": "value"}'
@@ -371,5 +371,5 @@ console.log(uploadedFile);
* `TWENTY_API_URL` — Twenty API'nin temel URL'si
* `TWENTY_APP_ACCESS_TOKEN` — Uygulamanızın varsayılan işlev rolü kapsamında kısa ömürlü bir anahtar
- Bunları istemcilere iletmeniz gerekmez — otomatik olarak `process.env`'den okurlar. API anahtarının izinleri, `application-config.ts` içinde `defaultRoleUniversalIdentifier` ile referans verilen role göre belirlenir.
+ Bunları istemcilere iletmeniz gerekmez — otomatik olarak `process.env`'den okurlar. API anahtarının izinleri, `defineApplicationRole()` ile bildirilen role (veya `application-config.ts` içindeki `defaultRoleUniversalIdentifier` üzerinden referans verilen role) göre belirlenir.
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx
index ee1ccd69e3..9c49604b66 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx
@@ -187,7 +187,6 @@ export default defineApplication({
universalIdentifier: '...',
displayName: 'My App',
description: 'A great app',
- defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
logoUrl: 'public/logo.png',
screenshots: [
'public/screenshot-1.png',
diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/operations/testing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/operations/testing.mdx
index d445ad985e..12539ba52d 100644
--- a/packages/twenty-docs/l/tr/developers/extend/apps/operations/testing.mdx
+++ b/packages/twenty-docs/l/tr/developers/extend/apps/operations/testing.mdx
@@ -1,6 +1,6 @@
---
title: Test
-description: Vitest kurulumu, gerçek bir Twenty sunucusuna karşı tümleştirme testleri, tür denetimi ve GitHub Actions ile CI.
+description: Vitest kurulumu, gerçek bir Twenty sunucusunda entegrasyon testleri, tip denetimi ve GitHub Actions ile CI.
icon: flask
---
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx
index 753c6179e3..871c507b45 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx
@@ -13,7 +13,6 @@ icon: rocket
```ts src/application-config.ts
import { defineApplication } from 'twenty-sdk/define';
-import { DEFAULT_ROLE_UNIVERSAL_IDENTIFIER } from 'src/roles/default-role';
export default defineApplication({
universalIdentifier: '39783023-bcac-41e3-b0d2-ff1944d8465d',
@@ -27,7 +26,6 @@ export default defineApplication({
isSecret: false,
},
},
- defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
});
```
@@ -35,12 +33,13 @@ export default defineApplication({
* `universalIdentifier` 字段是你拥有的确定性 ID。 只需生成一次，并在多次同步过程中保持稳定不变。
* `applicationVariables` 会变成你的函数和前端组件可用的环境变量（例如，`DEFAULT_RECIPIENT_NAME` 可作为 `process.env.DEFAULT_RECIPIENT_NAME` 使用）。
-* `defaultRoleUniversalIdentifier` 必须引用使用 [`defineRole()`](/l/zh/developers/extend/apps/config/roles) 定义的角色。
+* 默认角色会根据使用 [`defineApplicationRole()`](/l/zh/developers/extend/apps/config/roles) 标记的角色文件自动检测——你不需要在 `defineApplication()` 中引用它。
* 在构建清单时会自动检测安装前/安装后函数——无需在 `defineApplication()` 中引用它们。
+* 显式传递 `defaultRoleUniversalIdentifier` 仍然受支持以保持向后兼容性，但已弃用，推荐改用 `defineApplicationRole()`。
## 默认函数角色
-`defaultRoleUniversalIdentifier` 控制应用的逻辑函数和前端组件可以访问的内容：
+使用 [`defineApplicationRole()`](/l/zh/developers/extend/apps/config/roles) 声明的角色控制应用的逻辑函数和前端组件可以访问的内容：
* 作为 `TWENTY_APP_ACCESS_TOKEN` 注入的运行时令牌来源于该角色。
* 类型化 API 客户端将受限于授予该角色的权限。
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx
index f70fefcafc..9cb2cec3d9 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/roles.mdx
@@ -4,7 +4,7 @@ description: 声明你的应用的逻辑函数和前端组件可以读取和写
icon: shield-halved
---
-**角色（role）** 是一组权限：应用可以读取或写入哪些对象，可以查看哪些字段，以及可以使用哪些平台级功能。 每个应用的逻辑函数和前端组件都会继承在 [`defineApplication`](/l/zh/developers/extend/apps/config/application) 中被声明为 `defaultRoleUniversalIdentifier` 的角色的权限。
+**角色（role）** 是一组权限：应用可以读取或写入哪些对象，可以查看哪些字段，以及可以使用哪些平台级能力。 每个应用的逻辑函数和前端组件都会继承使用 `defineApplicationRole()` 标记的角色的权限（参见下文的 [默认函数角色](#the-default-function-role)）。
```ts src/roles/restricted-company-role.ts
import {
@@ -51,15 +51,15 @@ export default defineRole({
## 默认函数角色
-当你使用脚手架创建新应用时，CLI 会创建一个默认角色文件：
+当你使用脚手架创建新应用时，CLI 会创建一个使用 `defineApplicationRole()` 声明的默认角色文件：
```ts src/roles/default-role.ts
-import { defineRole, PermissionFlag } from 'twenty-sdk/define';
+import { defineApplicationRole, PermissionFlag } from 'twenty-sdk/define';
export const DEFAULT_ROLE_UNIVERSAL_IDENTIFIER =
'b648f87b-1d26-4961-b974-0908fd991061';
-export default defineRole({
+export default defineApplicationRole({
universalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
label: 'Default function role',
description: 'Default role for function Twenty client',
@@ -77,10 +77,13 @@ export default defineRole({
});
```
-该角色的 `universalIdentifier` 会在 `application-config.ts` 中被引用为 `defaultRoleUniversalIdentifier`：
+`defineApplicationRole()` 是 `defineRole()` 的一个轻量包装，它会标记在应用安装时用作应用默认角色的**该**角色。 验证与 `defineRole` 完全相同，但构建流水线会自动将其 `universalIdentifier` 注入到应用清单的 `defaultRoleUniversalIdentifier` 中——因此你无需在 [`defineApplication`](/l/zh/developers/extend/apps/config/application) 中自行引用它。
-* **`*.role.ts`** 声明该角色可以执行的操作。
-* **`application-config.ts`** 指向该角色，使你的函数继承其权限。
+备注：
+
+* 每个应用只允许有且仅有 **一个** `defineApplicationRole(...)`——如果发现多于一个，清单构建将失败。
+* 对于你的应用随附的任何**额外**角色，请使用 `defineRole()`（而不是 `defineApplicationRole()`）。
+* 在 `defineApplication()` 上显式设置 `defaultRoleUniversalIdentifier` 仍然受支持以保持向后兼容性，但已经弃用，推荐使用 `defineApplicationRole()`。
## 最佳实践
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/quick-start.mdx
index 3d807d0431..27015c4f40 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/quick-start.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/quick-start.mdx
@@ -123,10 +123,10 @@ yarn twenty dev
yarn twenty dev --once
```
-| 命令 | 行为 | 适用场景 |
-| ------------------------ | -------------------------------- | ------------------------------ |
-| `yarn twenty dev` | 监视并在每次更改时重新同步。 持续运行，直到你将其停止。 | 交互式本地开发。 |
-| `yarn twenty dev --once` | 单次构建与同步，成功时以 `0` 退出，失败时以 `1` 退出。 | CI、pre-commit 钩子、AI 代理、脚本化工作流。 |
+| 命令 | 行为 | 适用场景 |
+| ------------------------ | -------------------------------- | ------------------------------- |
+| `yarn twenty dev` | 监视并在每次更改时重新同步。 持续运行，直到你将其停止。 | 交互式本地开发。 |
+| `yarn twenty dev --once` | 单次构建与同步，成功时以 `0` 退出，失败时以 `1` 退出。 | CI、pre-commit 钩子、AI 智能体、脚本化工作流。 |
两种模式都需要处于开发模式的服务器和已认证的远程。
@@ -167,13 +167,13 @@ npx create-twenty-app@latest my-twenty-app --example postcard
- 应用身份、默认角色、安装钩子、公共资源。
+ 应用标识、默认角色、安装钩子、公共资源。
对象、字段和双向关系。
- 逻辑函数、技能、代理和 OAuth 连接。
+ 逻辑函数、技能、智能体和 OAuth 连接。
视图、导航、页面布局、前端组件。
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx
index b47cb3c425..77cee49a99 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/layout/overview.mdx
@@ -26,7 +26,7 @@ Twenty 应用的**布局层**是用户看到的一切：应用在侧边栏中的
## 本节内容
-
+
`defineView` — 已保存的列表配置：可见列、筛选器、分组。
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx
index 3d3dfb9d4c..a77142005c 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/connections.mdx
@@ -52,7 +52,6 @@ export default defineApplication({
universalIdentifier: '...',
displayName: 'Linear',
description: 'Connect Linear to Twenty.',
- defaultRoleUniversalIdentifier: '...',
// OAuth client credentials live on the app registration (one OAuth app per
// Twenty server, configured by the admin) — not per-workspace. Declare them
// as serverVariables so the admin can fill them in once for all installs.
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
index 2aa1ecf8f4..6e5267f81b 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/logic/logic-functions.mdx
@@ -4,7 +4,7 @@ description: 定义具有 HTTP、cron 和数据库事件触发器的服务端 Ty
icon: bolt
---
-逻辑函数是在 Twenty 平台上运行的服务端 TypeScript 函数。 它们可以由 HTTP 请求、cron 调度或数据库事件触发——也可以作为工具暴露给 AI 代理。
+逻辑函数是在 Twenty 平台上运行的服务端 TypeScript 函数。 它们可以由 HTTP 请求、cron 调度或数据库事件触发——也可以作为工具暴露给 AI 智能体。
@@ -54,7 +54,7 @@ export default defineLogicFunction({
* **httpRoute**：在 **`/s/` 端点**下通过 HTTP 路径和方法公开你的函数：
> 例如 `path: '/post-card/create'` 可在 `https://your-twenty-server.com/s/post-card/create` 调用
* **cron**：使用 CRON 表达式按计划运行你的函数。
-* **databaseEvent**：在工作空间对象生命周期事件上运行。 当事件操作为 `updated` 时，可以在 `updatedFields` 数组中指定要监听的特定字段。 如果未定义或为空，任何更新都会触发该函数。
+* **databaseEvent**：在工作区对象生命周期事件上运行。 当事件操作为 `updated` 时，可以在 `updatedFields` 数组中指定要监听的特定字段。 如果未定义或为空，任何更新都会触发该函数。
> 例如 `person.updated`、`*.created`、`company.*`
@@ -185,7 +185,7 @@ export default defineLogicFunction({
关键点：
* 函数可以混用这些入口 — 同时声明 `toolTriggerSettings` 和 `workflowActionTriggerSettings`，即可在 chat 和工作流构建器中同时公开它。
-* `toolTriggerSettings.inputSchema` 和 `workflowActionTriggerSettings.inputSchema` 均为可选。 如果省略，清单构建器会根据处理器源代码进行推断（AI 工具使用 JSON Schema，工作流操作使用 Twenty 的 `InputSchema`）。 当你需要更丰富的类型时，可显式提供一个 — 例如，在工作流构建器中使用对 `FieldMetadataType` 友好的字段（如 `CURRENCY` 或 `RELATION`），或提供 AI 代理可读取的 `description` 字段：
+* `toolTriggerSettings.inputSchema` 和 `workflowActionTriggerSettings.inputSchema` 均为可选。 如果省略，清单构建器会根据处理器源代码进行推断（AI 工具使用 JSON Schema，工作流操作使用 Twenty 的 `InputSchema`）。 当你需要更丰富的类型时，可显式提供一个 — 例如，在工作流构建器中使用对 `FieldMetadataType` 友好的字段（如 `CURRENCY` 或 `RELATION`），或提供 AI 智能体可读取的 `description` 字段：
```ts
export default defineLogicFunction({
@@ -371,5 +371,5 @@ console.log(uploadedFile);
* `TWENTY_API_URL`——Twenty API 的基础 URL
* `TWENTY_APP_ACCESS_TOKEN`——作用域限定为你的应用默认函数角色的短期密钥
- 你无需将这些值传递给客户端——它们会自动从 `process.env` 读取。 API 密钥的权限由你的 `application-config.ts` 中 `defaultRoleUniversalIdentifier` 引用的角色决定。
+ 你无需将这些值传递给客户端——它们会自动从 `process.env` 读取。 API 密钥的权限由使用 `defineApplicationRole()` 声明的角色（或在 `application-config.ts` 中通过 `defaultRoleUniversalIdentifier` 引用的角色）决定。
diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx
index 622c8e7fe8..3c507ed3d2 100644
--- a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx
+++ b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx
@@ -187,7 +187,6 @@ export default defineApplication({
universalIdentifier: '...',
displayName: 'My App',
description: 'A great app',
- defaultRoleUniversalIdentifier: DEFAULT_ROLE_UNIVERSAL_IDENTIFIER,
logoUrl: 'public/logo.png',
screenshots: [
'public/screenshot-1.png',
-**My twenty app**'e tıklayarak **application registration**'ı görüntüleyin — uygulamanızı tanımlayan (ad, tanımlayıcı, OAuth kimlik bilgileri, kaynak) sunucu düzeyinde bir kayıttır. Tek bir kayıt, aynı sunucudaki birden çok çalışma alanına kurulabilir.
+**My twenty app**'e tıklayarak **uygulama kaydını** görüntüleyin — uygulamanızı tanımlayan (ad, tanımlayıcı, OAuth kimlik bilgileri, kaynak) sunucu düzeyinde bir kayıttır. Tek bir kayıt, aynı sunucudaki birden çok çalışma alanına kurulabilir.