opencode-acp 1.14.25-pr.352.85 → 1.14.26-pr.352.91

package/README.md

@@ -339,11 +339,29 @@ Each level overrides the previous, so project settings take priority over global
         //     "anthropic/claude-sonnet-4.6": "80%"
         // },
         // Optional per-model override for minContextLimit.
+        // DEPRECATED — scheduled for removal alongside minContextLimit;
+        // use compress.providers (or minNudgeContextPercent for growth
+        // nudges) instead. Still honored until removed.
         // If present, this wins over the global minContextLimit.
         // "modelMinLimits": {
         //     "openai/gpt-5.3-codex": 50000,
         //     "anthropic/claude-sonnet-4.6": "25%"
         // },
+        // Nested per-provider/per-model overrides for ANY compress field
+        // (23 fields: thresholds, nudge behavior, protection, ...).
+        // Resolution is per field: model > provider > global. Unknown
+        // provider/model IDs fall back to the global value.
+        // "providers": {
+        //     "anthropic": {
+        //         "nudgeGrowthTokens": 50000,
+        //         "models": {
+        //             "claude-sonnet-4.6": {
+        //                 "maxContextLimit": "70%",
+        //                 "minNudgeContextPercent": 10
+        //             }
+        //         }
+        //     }
+        // },
         // How often the context-limit nudge fires (1 = every fetch, 5 = every 5th)
         "nudgeFrequency": 5,
         // Start adding compression reminders after this many
@@ -403,6 +421,33 @@ Each level overrides the previous, so project settings take priority over global
 
 </details>
 
+### Per-Provider / Per-Model Overrides
+
+Any `compress` field can be overridden per provider and per model via the nested `compress.providers` map:
+
+```jsonc
+{
+    "compress": {
+        "maxContextLimit": "80%",
+        "providers": {
+            "anthropic": {
+                "nudgeGrowthTokens": 20000,
+                "models": {
+                    "claude-sonnet-4.6": { "maxContextLimit": "70%", "nudgeForce": "strong" }
+                }
+            },
+            "openai": { "nudgeGrowthTokens": 40000 }
+        }
+    }
+}
+```
+
+Resolution is **per field**: model > provider > global. Unknown provider/model IDs fall back to the global value. A nested `maxContextLimit` also wins over the legacy flat `modelMaxLimits` map. Overrides deep-merge across the three config layers (global → config dir → project) per provider/model key.
+
+Not overridable here: `permission`, the deprecated `minContextLimit` / `modelMinLimits` family, and the flat `modelMaxLimits` / `modelMinLimits` maps themselves. Note: `modelMaxLimits` is **not** deprecated — it stays fully supported; a nested `maxContextLimit` simply outranks it.
+
+See the [`compress.providers`](./CONFIGURATION.md#compressproviders) reference in CONFIGURATION.md for the full 23-field list and recipes.
+
 ### Prompt Overrides
 
 ACP exposes six editable prompts:

package/README.zh-CN.md

@@ -292,11 +292,29 @@ ACP 使用自己的配置文件，按以下顺序搜索：
         //     "anthropic/claude-sonnet-4.6": "80%"
         // },
         // Optional per-model override for minContextLimit.
+        // 已废弃 —— 将随 minContextLimit 一并移除；
+        // 请改用 compress.providers（增长型提醒用
+        // minNudgeContextPercent）。移除前仍然生效。
         // If present, this wins over the global minContextLimit.
         // "modelMinLimits": {
         //     "openai/gpt-5.3-codex": 50000,
         //     "anthropic/claude-sonnet-4.6": "25%"
         // },
+        // 嵌套的 provider/model 级覆盖：可覆盖任意 compress 字段
+        // （23 项：阈值、nudge 行为、保护策略等）。
+        // 逐字段解析优先级：model > provider > 全局。
+        // 未知的 provider/model ID 回退到全局值。
+        // "providers": {
+        //     "anthropic": {
+        //         "nudgeGrowthTokens": 50000,
+        //         "models": {
+        //             "claude-sonnet-4.6": {
+        //                 "maxContextLimit": "70%",
+        //                 "minNudgeContextPercent": 10
+        //             }
+        //         }
+        //     }
+        // },
         // How often the context-limit nudge fires (1 = every fetch, 5 = every 5th)
         "nudgeFrequency": 5,
         // Start adding compression reminders after this many
@@ -355,6 +373,33 @@ ACP 使用自己的配置文件，按以下顺序搜索：
 
 </details>
 
+### 按 Provider / 按模型覆盖
+
+任意 `compress` 字段都可通过嵌套的 `compress.providers` 按 provider 和按模型覆盖：
+
+```jsonc
+{
+    "compress": {
+        "maxContextLimit": "80%",
+        "providers": {
+            "anthropic": {
+                "nudgeGrowthTokens": 20000,
+                "models": {
+                    "claude-sonnet-4.6": { "maxContextLimit": "70%", "nudgeForce": "strong" }
+                }
+            },
+            "openai": { "nudgeGrowthTokens": 40000 }
+        }
+    }
+}
+```
+
+解析为**逐字段**优先级：model > provider > 全局。未知的 provider/model ID 回退到全局值。嵌套的 `maxContextLimit` 同时优先于旧版扁平 `modelMaxLimits` 映射。多层配置（全局 → 配置目录 → 项目）按 provider/model 键深合并。
+
+不可覆盖：`permission`、已废弃的 `minContextLimit` / `modelMinLimits` 系列、以及扁平 `modelMaxLimits` / `modelMinLimits` 映射自身。注意：`modelMaxLimits` **未废弃** —— 仍完全支持，只是优先级低于嵌套的 `maxContextLimit`。
+
+完整 23 项字段清单与配方见 CONFIGURATION.zh-CN.md 的 [`compress.providers`](./CONFIGURATION.zh-CN.md#compressproviders) 参考节。
+
 ### Prompt 覆盖
 
 ACP 暴露六个可编辑的 prompt：