From a9754823bb6d323a025a49a7a77746884d7bbd00 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Wed, 20 May 2026 19:31:32 +0800 Subject: [PATCH 1/4] docs: document plugin model provider cache TTL --- en/self-host/configuration/environments.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/en/self-host/configuration/environments.mdx b/en/self-host/configuration/environments.mdx index a67e563cf..0b85b29f4 100644 --- a/en/self-host/configuration/environments.mdx +++ b/en/self-host/configuration/environments.mdx @@ -1342,6 +1342,7 @@ The plugin daemon is a separate service that manages plugin lifecycle (installat | `PLUGIN_DAEMON_TIMEOUT` | `600.0` | Timeout in seconds for all plugin daemon requests (installation, execution, listing). | | `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | Maximum plugin package size in bytes (50 MB). Validated during marketplace downloads. | | `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | How long to cache plugin model schemas in seconds. Reduces repeated lookups. | +| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | How long to cache each tenant's plugin model provider list in Redis, in seconds. Dify invalidates this cache when the tenant installs, uninstalls, or upgrades plugins. | | `PLUGIN_DIFY_INNER_API_KEY` | (auto-generated) | API key the plugin daemon uses to call back to the Dify API. Must match `DIFY_INNER_API_KEY` in the plugin daemon service config. | | `PLUGIN_DIFY_INNER_API_URL` | `http://api:5001` | Internal API URL the plugin daemon calls back to. | | `PLUGIN_DEBUGGING_HOST` | `0.0.0.0` | Host for plugin remote debugging connections. | From e5c81a8a6386773321093661e180461d5c8f6634 Mon Sep 17 00:00:00 2001 From: -LAN- Date: Wed, 20 May 2026 20:54:05 +0800 Subject: [PATCH 2/4] docs: remove workflow node execution storage env var --- en/self-host/configuration/environments.mdx | 1 - ja/self-host/configuration/environments.mdx | 1 - zh/self-host/configuration/environments.mdx | 1 - 3 files changed, 3 deletions(-) diff --git a/en/self-host/configuration/environments.mdx b/en/self-host/configuration/environments.mdx index 0b85b29f4..0caafcf92 100644 --- a/en/self-host/configuration/environments.mdx +++ b/en/self-host/configuration/environments.mdx @@ -1154,7 +1154,6 @@ The sandbox is a separate service that runs Python, JavaScript, and Jinja2 code | `WORKFLOW_CALL_MAX_DEPTH` | `5` | Maximum depth for nested workflow-calls-workflow. Prevents infinite recursion. | | `MAX_VARIABLE_SIZE` | `204800` | Maximum size in bytes (200 KB) for a single workflow variable. | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | Maximum number of files that can be uploaded in a single workflow execution. | -| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | Where workflow node execution records are stored. `rdbms` stores everything in the database. `hybrid` stores new data in object storage and reads from both. | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | Encrypt dataset IDs when exporting DSL files. Set to `false` to export plain IDs for easier cross-environment import. | #### Workflow Storage Repository diff --git a/ja/self-host/configuration/environments.mdx b/ja/self-host/configuration/environments.mdx index 2ebc0032c..92dbf8ec6 100644 --- a/ja/self-host/configuration/environments.mdx +++ b/ja/self-host/configuration/environments.mdx @@ -1154,7 +1154,6 @@ Dify はアカウント招待、パスワードリセット、ログインコー | `WORKFLOW_CALL_MAX_DEPTH` | `5` | ネストされたワークフロー呼び出しの最大深度。無限再帰を防止します。 | | `MAX_VARIABLE_SIZE` | `204800` | 単一のワークフロー変数の最大サイズ（バイト、200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 単一のワークフロー実行でアップロードできる最大ファイル数。 | -| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | ワークフローノード実行レコードの保存先。`rdbms`はすべてをデータベースに保存します。`hybrid` は新しいデータをオブジェクトストレージに保存し、両方から読み取ります。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | DSL ファイルエクスポート時にデータセット ID を暗号化。クロス環境インポートを容易にするためにプレーン ID をエクスポートする場合は `false` に設定してください。 | #### ワークフローストレージリポジトリ diff --git a/zh/self-host/configuration/environments.mdx b/zh/self-host/configuration/environments.mdx index 3a6b92d48..f4b868246 100644 --- a/zh/self-host/configuration/environments.mdx +++ b/zh/self-host/configuration/environments.mdx @@ -1154,7 +1154,6 @@ Dify 发送邮件用于账户邀请、密码重置、登录验证码和人工输 | `WORKFLOW_CALL_MAX_DEPTH` | `5` | 嵌套工作流调用工作流的最大深度。防止无限递归。 | | `MAX_VARIABLE_SIZE` | `204800` | 单个工作流变量的最大大小（字节，200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 单次工作流执行中可上传的最大文件数。 | -| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | 工作流节点执行记录的存储位置。`rdbms` 将所有内容存储在数据库中。`hybrid` 将新数据存储在对象存储中，并从两者读取。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | 导出 DSL 文件时加密数据集 ID。设为 `false` 以导出明文 ID，便于跨环境导入。 | #### 工作流存储仓库 From e09e097c3eb2ed7a8e9a52b9a7d8a6f47e5aeb8e Mon Sep 17 00:00:00 2001 From: -LAN- Date: Wed, 20 May 2026 20:58:42 +0800 Subject: [PATCH 3/4] docs: keep translated environment references unchanged --- ja/self-host/configuration/environments.mdx | 1 + zh/self-host/configuration/environments.mdx | 1 + 2 files changed, 2 insertions(+) diff --git a/ja/self-host/configuration/environments.mdx b/ja/self-host/configuration/environments.mdx index 92dbf8ec6..2ebc0032c 100644 --- a/ja/self-host/configuration/environments.mdx +++ b/ja/self-host/configuration/environments.mdx @@ -1154,6 +1154,7 @@ Dify はアカウント招待、パスワードリセット、ログインコー | `WORKFLOW_CALL_MAX_DEPTH` | `5` | ネストされたワークフロー呼び出しの最大深度。無限再帰を防止します。 | | `MAX_VARIABLE_SIZE` | `204800` | 単一のワークフロー変数の最大サイズ（バイト、200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 単一のワークフロー実行でアップロードできる最大ファイル数。 | +| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | ワークフローノード実行レコードの保存先。`rdbms`はすべてをデータベースに保存します。`hybrid` は新しいデータをオブジェクトストレージに保存し、両方から読み取ります。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | DSL ファイルエクスポート時にデータセット ID を暗号化。クロス環境インポートを容易にするためにプレーン ID をエクスポートする場合は `false` に設定してください。 | #### ワークフローストレージリポジトリ diff --git a/zh/self-host/configuration/environments.mdx b/zh/self-host/configuration/environments.mdx index f4b868246..3a6b92d48 100644 --- a/zh/self-host/configuration/environments.mdx +++ b/zh/self-host/configuration/environments.mdx @@ -1154,6 +1154,7 @@ Dify 发送邮件用于账户邀请、密码重置、登录验证码和人工输 | `WORKFLOW_CALL_MAX_DEPTH` | `5` | 嵌套工作流调用工作流的最大深度。防止无限递归。 | | `MAX_VARIABLE_SIZE` | `204800` | 单个工作流变量的最大大小（字节，200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 单次工作流执行中可上传的最大文件数。 | +| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | 工作流节点执行记录的存储位置。`rdbms` 将所有内容存储在数据库中。`hybrid` 将新数据存储在对象存储中，并从两者读取。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | 导出 DSL 文件时加密数据集 ID。设为 `false` 以导出明文 ID，便于跨环境导入。 | #### 工作流存储仓库 From 71110a104811066ed824459375331b0e78cd079f Mon Sep 17 00:00:00 2001 From: RiskeyL <7a8y@163.com> Date: Mon, 25 May 2026 01:45:23 +0800 Subject: [PATCH 4/4] docs: annotate plugin cache TTL defaults and sync zh/ja - Annotate the plugin model cache TTL defaults with readable units in English: `PLUGIN_MODEL_SCHEMA_CACHE_TTL` as 1 hour and `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` as 24 hours. - Sync the Chinese and Japanese environment references, which are excluded from the automated translation pipeline. --- en/self-host/configuration/environments.mdx | 4 ++-- ja/self-host/configuration/environments.mdx | 4 ++-- zh/self-host/configuration/environments.mdx | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/en/self-host/configuration/environments.mdx b/en/self-host/configuration/environments.mdx index 0caafcf92..6b439f6fd 100644 --- a/en/self-host/configuration/environments.mdx +++ b/en/self-host/configuration/environments.mdx @@ -1340,8 +1340,8 @@ The plugin daemon is a separate service that manages plugin lifecycle (installat | `PLUGIN_DAEMON_PORT` | `5002` | Plugin daemon listening port. | | `PLUGIN_DAEMON_TIMEOUT` | `600.0` | Timeout in seconds for all plugin daemon requests (installation, execution, listing). | | `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | Maximum plugin package size in bytes (50 MB). Validated during marketplace downloads. | -| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | How long to cache plugin model schemas in seconds. Reduces repeated lookups. | -| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | How long to cache each tenant's plugin model provider list in Redis, in seconds. Dify invalidates this cache when the tenant installs, uninstalls, or upgrades plugins. | +| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | How long to cache plugin model schemas in seconds (1 hour). Reduces repeated lookups. | +| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | How long to cache each tenant's plugin model provider list in Redis, in seconds (24 hours). Dify invalidates this cache when the tenant installs, uninstalls, or upgrades plugins. | | `PLUGIN_DIFY_INNER_API_KEY` | (auto-generated) | API key the plugin daemon uses to call back to the Dify API. Must match `DIFY_INNER_API_KEY` in the plugin daemon service config. | | `PLUGIN_DIFY_INNER_API_URL` | `http://api:5001` | Internal API URL the plugin daemon calls back to. | | `PLUGIN_DEBUGGING_HOST` | `0.0.0.0` | Host for plugin remote debugging connections. | diff --git a/ja/self-host/configuration/environments.mdx b/ja/self-host/configuration/environments.mdx index 2ebc0032c..06d023443 100644 --- a/ja/self-host/configuration/environments.mdx +++ b/ja/self-host/configuration/environments.mdx @@ -1154,7 +1154,6 @@ Dify はアカウント招待、パスワードリセット、ログインコー | `WORKFLOW_CALL_MAX_DEPTH` | `5` | ネストされたワークフロー呼び出しの最大深度。無限再帰を防止します。 | | `MAX_VARIABLE_SIZE` | `204800` | 単一のワークフロー変数の最大サイズ（バイト、200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 単一のワークフロー実行でアップロードできる最大ファイル数。 | -| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | ワークフローノード実行レコードの保存先。`rdbms`はすべてをデータベースに保存します。`hybrid` は新しいデータをオブジェクトストレージに保存し、両方から読み取ります。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | DSL ファイルエクスポート時にデータセット ID を暗号化。クロス環境インポートを容易にするためにプレーン ID をエクスポートする場合は `false` に設定してください。 | #### ワークフローストレージリポジトリ @@ -1339,7 +1338,8 @@ HTTPS を有効化した後、 [共通変数](#共通変数) の URL 変数（ | `PLUGIN_DAEMON_PORT` | `5002` | プラグインデーモンのリッスンポート。 | | `PLUGIN_DAEMON_TIMEOUT` | `600.0` | すべてのプラグインデーモンリクエスト（インストール、実行、リスト表示）のタイムアウト（秒）。 | | `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | プラグインパッケージの最大サイズ（バイト、50 MB）。マーケットプレイスダウンロード時に検証されます。 | -| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | プラグインモデルスキーマのキャッシュ期間（秒）。繰り返しの参照を削減します。 | +| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | プラグインモデルスキーマのキャッシュ期間（秒）。デフォルトは 1 時間。繰り返しの参照を削減します。 | +| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | 各テナントのプラグインモデルプロバイダー一覧を Redis にキャッシュする期間（秒）。デフォルトは 24 時間。テナントがプラグインをインストール、アンインストール、またはアップグレードすると、Dify はこのキャッシュを無効化します。 | | `PLUGIN_DIFY_INNER_API_KEY` | （自動生成） | プラグインデーモンが Dify API にコールバックする際に使用する API キー。プラグインデーモンサービス設定の `DIFY_INNER_API_KEY` と一致する必要があります。 | | `PLUGIN_DIFY_INNER_API_URL` | `http://api:5001` | プラグインデーモンがコールバックする内部 API URL。 | | `PLUGIN_DEBUGGING_HOST` | `0.0.0.0` | プラグインリモートデバッグ接続のホスト。 | diff --git a/zh/self-host/configuration/environments.mdx b/zh/self-host/configuration/environments.mdx index 3a6b92d48..fb8c6ae1c 100644 --- a/zh/self-host/configuration/environments.mdx +++ b/zh/self-host/configuration/environments.mdx @@ -1154,7 +1154,6 @@ Dify 发送邮件用于账户邀请、密码重置、登录验证码和人工输 | `WORKFLOW_CALL_MAX_DEPTH` | `5` | 嵌套工作流调用工作流的最大深度。防止无限递归。 | | `MAX_VARIABLE_SIZE` | `204800` | 单个工作流变量的最大大小（字节，200 KB）。 | | `WORKFLOW_FILE_UPLOAD_LIMIT` | `10` | 单次工作流执行中可上传的最大文件数。 | -| `WORKFLOW_NODE_EXECUTION_STORAGE` | `rdbms` | 工作流节点执行记录的存储位置。`rdbms` 将所有内容存储在数据库中。`hybrid` 将新数据存储在对象存储中，并从两者读取。 | | `DSL_EXPORT_ENCRYPT_DATASET_ID` | `true` | 导出 DSL 文件时加密数据集 ID。设为 `false` 以导出明文 ID，便于跨环境导入。 | #### 工作流存储仓库 @@ -1339,7 +1338,8 @@ Dify 的所有出站 HTTP 请求（HTTP 节点、图片下载等）都通过代 | `PLUGIN_DAEMON_PORT` | `5002` | 插件守护进程监听端口。 | | `PLUGIN_DAEMON_TIMEOUT` | `600.0` | 所有插件守护进程请求（安装、执行、列表）的超时时间（秒）。 | | `PLUGIN_MAX_PACKAGE_SIZE` | `52428800` | 最大插件包大小（字节，50 MB）。在市场下载时验证。 | -| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | 缓存插件模型 Schema 的时间（秒）。减少重复查找。 | +| `PLUGIN_MODEL_SCHEMA_CACHE_TTL` | `3600` | 缓存插件模型 Schema 的时长（秒），默认 1 小时。减少重复查找。 | +| `PLUGIN_MODEL_PROVIDERS_CACHE_TTL` | `86400` | 在 Redis 中缓存各租户插件模型供应商列表的时长（秒），默认 24 小时。租户安装、卸载或升级插件时，Dify 会使该缓存失效。 | | `PLUGIN_DIFY_INNER_API_KEY` | （自动生成） | 插件守护进程回调 Dify API 使用的 API key。必须与插件守护进程服务配置中的 `DIFY_INNER_API_KEY` 匹配。 | | `PLUGIN_DIFY_INNER_API_URL` | `http://api:5001` | 插件守护进程回调的内部 API URL。 | | `PLUGIN_DEBUGGING_HOST` | `0.0.0.0` | 插件远程调试连接的主机。 |