docs: use kimi-for-coding in model overrides example; drop dangling experimental refs (#1337)

* docs: use kimi-for-coding in model overrides example

kimi-for-coding is the stable public model ID users actually configure;
kimi-k2 is the underlying model name and shouldn't appear in the config
example. Demonstrate overrides with max_context_size and display_name.

* docs: drop dangling references to commented-out experimental section

The `## experimental` section was commented out when micro_compaction
was removed, but the top-level fields table and the intro sentence still
linked to the now-dead #experimental anchor. Remove those references.
This commit is contained in:
wenhua020201-arch 2026-07-03 11:41:03 +08:00 committed by GitHub
parent 4c1d0a1633
commit 4498ea9ee3
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 12 additions and 18 deletions

View file

@ -86,12 +86,11 @@ Fields in the config file fall into two categories: **top-level scalars** that d
| `thinking` | `table` | — | Default parameters for Thinking mode → [`thinking`](#thinking) |
| `loop_control` | `table` | — | Agent loop control parameters → [`loop_control`](#loop_control) |
| `background` | `table` | — | Background task runtime parameters → [`background`](#background) |
| `experimental` | `table` | — | Experimental feature overrides → [`experimental`](#experimental) |
| `services` | `table` | — | Built-in external service configuration → [`services`](#services) |
| `permission` | `table` | — | Initial permission rules → [`permission`](#permission) |
| `hooks` | `array<table>` | — | Lifecycle hooks; see [Hooks](../customization/hooks.md) |
The following sections cover each of the nested tables in turn: `providers`, `models`, `thinking`, `loop_control`, `background`, `experimental`, `services`, and `permission`.
The following sections cover each of the nested tables in turn: `providers`, `models`, `thinking`, `loop_control`, `background`, `services`, and `permission`.
## `providers`
@ -147,16 +146,14 @@ max_context_size = 1047576
Use `[models."<alias>".overrides]` for user overrides that must survive provider-model refreshes. Runtime consumers read the effective value: the override when present, otherwise the top-level field.
```toml
[models."kimi-code/kimi-k2"]
[models."kimi-code/kimi-for-coding"]
provider = "managed:kimi-code"
model = "kimi-k2"
model = "kimi-for-coding"
max_context_size = 262144
support_efforts = ["low", "high", "max"]
default_effort = "max"
[models."kimi-code/kimi-k2".overrides]
support_efforts = ["low", "high"]
default_effort = "high"
[models."kimi-code/kimi-for-coding".overrides]
max_context_size = 131072
display_name = "Kimi for Coding (custom)"
```
`[models."<alias>".overrides]` accepts ordinary model fields such as `max_context_size`, `max_output_size`, `capabilities`, `display_name`, `reasoning_key`, `adaptive_thinking`, `support_efforts`, and `default_effort`. It does not accept identity / routing fields: `provider`, `model`, `protocol`, and `beta_api`.

View file

@ -86,12 +86,11 @@ timeout = 5
| `thinking` | `table` | — | Thinking 模式默认参数 → [`thinking`](#thinking) |
| `loop_control` | `table` | — | Agent 循环控制参数 → [`loop_control`](#loop_control) |
| `background` | `table` | — | 后台任务运行参数 → [`background`](#background) |
| `experimental` | `table` | — | 实验功能覆盖 → [`experimental`](#experimental) |
| `services` | `table` | — | 内置外部服务配置 → [`services`](#services) |
| `permission` | `table` | — | 初始权限规则 → [`permission`](#permission) |
| `hooks` | `array<table>` | — | 生命周期 hook详见 [Hooks](../customization/hooks.md) |
以下各节对 `providers``models``thinking``loop_control``background``experimental`、`services`、`permission` 等嵌套表逐一展开。
以下各节对 `providers``models``thinking``loop_control``background``services`、`permission` 等嵌套表逐一展开。
## `providers`
@ -147,16 +146,14 @@ max_context_size = 1047576
如果某些用户覆盖需要在 provider-model 刷新后保留,请写到 `[models."<alias>".overrides]`。运行时读取的是 effective 值:有 override 时用 override否则用顶层字段。
```toml
[models."kimi-code/kimi-k2"]
[models."kimi-code/kimi-for-coding"]
provider = "managed:kimi-code"
model = "kimi-k2"
model = "kimi-for-coding"
max_context_size = 262144
support_efforts = ["low", "high", "max"]
default_effort = "max"
[models."kimi-code/kimi-k2".overrides]
support_efforts = ["low", "high"]
default_effort = "high"
[models."kimi-code/kimi-for-coding".overrides]
max_context_size = 131072
display_name = "Kimi for Coding (custom)"
```
`[models."<alias>".overrides]` 接受普通模型字段,例如 `max_context_size``max_output_size``capabilities``display_name``reasoning_key``adaptive_thinking``support_efforts``default_effort`。不接受身份 / 路由字段:`provider``model``protocol``beta_api`