diff --git a/packages/protocol/src/messages.ts b/packages/protocol/src/messages.ts
index 9c0bbdefcc..4ab62451aa 100644
--- a/packages/protocol/src/messages.ts
+++ b/packages/protocol/src/messages.ts
@@ -3950,7 +3950,7 @@ export const ServerInfoStatusPayloadSchema = z
         // COMPAT(usageSetting): added in v0.14, remove after 2027-05-01.
         usageSetting: z.boolean().optional(),
         usageSources: z.boolean().optional(),
-        // COMPAT(providerInstallation): added in v0.13.3, remove gate after 2027-05-13.
+        // COMPAT(providerInstallation): added in v0.17.0, remove gate after 2027-05-13.
         providerInstallation: z.boolean().optional(),
         // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
         providersSnapshotCwd: z.boolean().optional(),
diff --git a/public-docs/plugins/reference.md b/public-docs/plugins/reference.md
index 9fa457ed5b..9c07d4e198 100644
--- a/public-docs/plugins/reference.md
+++ b/public-docs/plugins/reference.md
@@ -442,6 +442,7 @@ is never inline SVG or a URL.
 
 #### Provider installation
 
+**Requires Paseo 0.17.** Older versions ignore `installation`.
 `ProviderRegistration.installation` fills the **Installation** section of the provider's settings.
 Every member is optional. Paseo hides the section when you declare neither `inspect` nor
 `installUrl`. [Report installation and updates](/docs/plugins/providers#report-installation-and-updates)
diff --git a/public-docs/plugins/reference.zh-CN.md b/public-docs/plugins/reference.zh-CN.md
index 45ca7142b3..bc13407e5b 100644
--- a/public-docs/plugins/reference.zh-CN.md
+++ b/public-docs/plugins/reference.zh-CN.md
@@ -369,7 +369,7 @@ Paseo 刷新 Agent 的方式是关闭它当前的 Provider 会话，再用当前
 
 #### Provider 安装 {#provider-installation}
 
-`ProviderRegistration.installation` 填充 Provider 设置中的 **安装** 部分。每个成员都是可选的。`inspect` 和 `installUrl` 都没有声明时，Paseo 会隐藏这个部分。完整示例见[报告安装与更新](/docs/plugins/providers#report-installation-and-updates)。类型从 `@getpaseo/plugin/server/provider` 导入。
+**需要 Paseo 0.17**。较旧的版本会忽略 `installation`。`ProviderRegistration.installation` 填充 Provider 设置中的 **安装** 部分。每个成员都是可选的。`inspect` 和 `installUrl` 都没有声明时，Paseo 会隐藏这个部分。完整示例见[报告安装与更新](/docs/plugins/providers#report-installation-and-updates)。类型从 `@getpaseo/plugin/server/provider` 导入。
 
 ```ts
 interface ProviderInstallation {