@henjicc/ai-sdk 0.2.8 → 0.3.0

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/Kimi.md

@@ -1,75 +1,75 @@
-# Kimi（Moonshot）
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `kimi` / `moonshot` |
-| 对应项目 `adapter` | `openai`（Chat Completions 兼容） |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API 也**没有** Anthropic Messages API，Chat Completions 是唯一路径，已实现，无需再排优先级 |
-| 鉴权 | `Authorization: Bearer $MOONSHOT_API_KEY` |
-| Base URL | `https://api.moonshot.cn/v1`（文档站已迁移到 `platform.kimi.com`，但**接口域名仍是 moonshot.cn**，不要混淆两个域名） |
-| 官方协议 | 仅 OpenAI Chat Completions，**没有 Responses API** |
-
-## 2. 协议现状
-
-Kimi 官方文档全文没有出现过 `responses.create`；`platform.kimi.com/docs/llms.txt` 索引里也没有 Responses API 页面。三个消费方（助手、画布文本节点、提示词优化）走本项目现有的 `openai-compatible` 协议即可完整覆盖 Kimi，**不需要等 Responses API 适配器**。
-
-## 3. 模型
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
-|---|---|---|---|---|
-| `kimi-k3` | 当前旗舰，2.8 万亿参数，KDA 混合线性注意力，全球首个开源 3 万亿级模型 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
-
-价格（元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100。
-
-K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的 15 元代金券不能用于 K3。
-
-## 4. 思考模式（始终开启，不可关闭）
-
-- 顶层 `reasoning_effort`：`low` / `high` / `max`，默认 `max`。**没有 `off`**——K2.x 系列的 `thinking` 配置迁移到 K3 时要整段删除，改传 `reasoning_effort`。
-- 多轮对话/工具调用时必须把 API 返回的**完整** assistant message（含 `reasoning_content` 和 `tool_calls`）原样回传，只保留 `content` 会破坏推理连续性。
-
-## 5. 固定采样参数（不要显式传）
-
-`temperature=1.0`、`top_p=0.95`、`n=1`、`presence_penalty=0`、`frequency_penalty=0` 是官方文档明确写出的固定值，"建议不要显式传入"——如果项目通用请求构建层默认带上自己的 `temperature`/`topP`，K3 这边等于被覆盖成无效参数，属于容易被忽视的静默问题。
-
-## 6. 视觉输入（重要限制）
-
-- 图片必须走 `image_url.url` 的 **base64 data URL**（`data:image/png;base64,...`），**不支持公网图片直链**。这与大多数供应商"直接传 URL"的默认假设相反，接入时要单独处理。
-- 视频走 Files API 先上传拿 `file_id`，再用 `video_url.url = "ms://<file-id>"` 引用，用完建议调用 `client.files.delete` 清理。
-- `content` 必须是对象数组，不能是拼好的字符串。
-
-## 7. 结构化输出
-
-`response_format: {type: "json_schema", json_schema: {name, strict: true, schema}}`，只解析 `message.content`，不解析 `reasoning_content`。
-
-## 8. 联网搜索（官方明确提示不建议用于生产）
-
-- 内置工具名 `$web_search`，声明方式和普通 function 不同：`type` 要写成 `"builtin_function"`（不是 `"function"`），且**只需要 `function.name`，不需要 `parameters`**：
-  ```json
-  { "type": "builtin_function", "function": { "name": "$web_search" } }
-  ```
-  `$` 前缀是 Kimi 保留给内置函数的命名空间，普通 `function` 类型的工具名不允许出现 `$`。
-- 执行方式：模型返回 `finish_reason=tool_calls` 且 `tool_call.function.name="$web_search"` 时，调用方**原样把 `arguments` 塞回一条 `role=tool` 消息**即可，不需要真的执行搜索——搜索本身由 Kimi 服务端完成。
-- 价格：¥0.03/次（只在 `finish_reason=tool_calls` 且工具名是 `$web_search` 时收取；如果中途放弃 `tool_calls` 循环，只收这笔工具调用费，不收搜索内容占用的 token 费）。搜索结果本身也会计入下一次请求的 `prompt_tokens`，可从 `tool_call.function.arguments.usage.total_tokens` 读到这部分用量。
-- **官方定价页原文警告**：「联网搜索（`web_search`）正在更新升级中，近期不建议使用该功能，当前文档已经过时」。项目侧如果要接这个能力，应该默认关闭并在 UI 上标注"实验性/暂不稳定"，而不是当作可靠能力直接暴露。
-- 官方更推荐的替代路径是走 Formula 官方工具通道（标准 OpenAI `function` 类型，见「官方工具」文档），但同样标注"联网搜索工具正在更新，近期不建议使用"。
-
-## 9. 动态加载工具（K3 独有能力）
-
-把完整工具定义放进一条 `role=system` 且不含 `content`、只含 `tools` 字段的消息里，可以从对话中间某一轮开始动态生效，不需要在最初就声明全部工具。用于工具数量多、想省 token 或提升工具选择准确率的场景。
-
-## 原始链接索引（均无需登录）
-
-- [Kimi API 概览](https://platform.kimi.com/docs/overview)
-- [Kimi K3 快速开始](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)
-- [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort)
-- [使用 Kimi API 的联网搜索功能](https://platform.kimi.com/docs/guide/use-web-search)
-- [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools)
-- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
-- [联网搜索定价](https://platform.kimi.com/docs/pricing/tools)
-- [使用思考模式](https://platform.kimi.com/docs/guide/use-thinking-models)
-- [Kimi 文档全量索引](https://platform.kimi.com/docs/llms.txt)
+# Kimi（Moonshot）
+
+> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `kimi` / `moonshot` |
+| 对应项目 `adapter` | `openai`（Chat Completions 兼容） |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API 也**没有** Anthropic Messages API，Chat Completions 是唯一路径，已实现，无需再排优先级 |
+| 鉴权 | `Authorization: Bearer $MOONSHOT_API_KEY` |
+| Base URL | `https://api.moonshot.cn/v1`（文档站已迁移到 `platform.kimi.com`，但**接口域名仍是 moonshot.cn**，不要混淆两个域名） |
+| 官方协议 | 仅 OpenAI Chat Completions，**没有 Responses API** |
+
+## 2. 协议现状
+
+Kimi 官方文档全文没有出现过 `responses.create`；`platform.kimi.com/docs/llms.txt` 索引里也没有 Responses API 页面。三个消费方（助手、画布文本节点、提示词优化）走本项目现有的 `openai-compatible` 协议即可完整覆盖 Kimi，**不需要等 Responses API 适配器**。
+
+## 3. 模型
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
+|---|---|---|---|---|
+| `kimi-k3` | 当前旗舰，2.8 万亿参数，KDA 混合线性注意力，全球首个开源 3 万亿级模型 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
+
+价格（元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100。
+
+K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的 15 元代金券不能用于 K3。
+
+## 4. 思考模式（始终开启，不可关闭）
+
+- 顶层 `reasoning_effort`：`low` / `high` / `max`，默认 `max`。**没有 `off`**——K2.x 系列的 `thinking` 配置迁移到 K3 时要整段删除，改传 `reasoning_effort`。
+- 多轮对话/工具调用时必须把 API 返回的**完整** assistant message（含 `reasoning_content` 和 `tool_calls`）原样回传，只保留 `content` 会破坏推理连续性。
+
+## 5. 固定采样参数（不要显式传）
+
+`temperature=1.0`、`top_p=0.95`、`n=1`、`presence_penalty=0`、`frequency_penalty=0` 是官方文档明确写出的固定值，"建议不要显式传入"——如果项目通用请求构建层默认带上自己的 `temperature`/`topP`，K3 这边等于被覆盖成无效参数，属于容易被忽视的静默问题。
+
+## 6. 视觉输入（重要限制）
+
+- 图片必须走 `image_url.url` 的 **base64 data URL**（`data:image/png;base64,...`），**不支持公网图片直链**。这与大多数供应商"直接传 URL"的默认假设相反，接入时要单独处理。
+- 视频走 Files API 先上传拿 `file_id`，再用 `video_url.url = "ms://<file-id>"` 引用，用完建议调用 `client.files.delete` 清理。
+- `content` 必须是对象数组，不能是拼好的字符串。
+
+## 7. 结构化输出
+
+`response_format: {type: "json_schema", json_schema: {name, strict: true, schema}}`，只解析 `message.content`，不解析 `reasoning_content`。
+
+## 8. 联网搜索（官方明确提示不建议用于生产）
+
+- 内置工具名 `$web_search`，声明方式和普通 function 不同：`type` 要写成 `"builtin_function"`（不是 `"function"`），且**只需要 `function.name`，不需要 `parameters`**：
+  ```json
+  { "type": "builtin_function", "function": { "name": "$web_search" } }
+  ```
+  `$` 前缀是 Kimi 保留给内置函数的命名空间，普通 `function` 类型的工具名不允许出现 `$`。
+- 执行方式：模型返回 `finish_reason=tool_calls` 且 `tool_call.function.name="$web_search"` 时，调用方**原样把 `arguments` 塞回一条 `role=tool` 消息**即可，不需要真的执行搜索——搜索本身由 Kimi 服务端完成。
+- 价格：¥0.03/次（只在 `finish_reason=tool_calls` 且工具名是 `$web_search` 时收取；如果中途放弃 `tool_calls` 循环，只收这笔工具调用费，不收搜索内容占用的 token 费）。搜索结果本身也会计入下一次请求的 `prompt_tokens`，可从 `tool_call.function.arguments.usage.total_tokens` 读到这部分用量。
+- **官方定价页原文警告**：「联网搜索（`web_search`）正在更新升级中，近期不建议使用该功能，当前文档已经过时」。项目侧如果要接这个能力，应该默认关闭并在 UI 上标注"实验性/暂不稳定"，而不是当作可靠能力直接暴露。
+- 官方更推荐的替代路径是走 Formula 官方工具通道（标准 OpenAI `function` 类型，见「官方工具」文档），但同样标注"联网搜索工具正在更新，近期不建议使用"。
+
+## 9. 动态加载工具（K3 独有能力）
+
+把完整工具定义放进一条 `role=system` 且不含 `content`、只含 `tools` 字段的消息里，可以从对话中间某一轮开始动态生效，不需要在最初就声明全部工具。用于工具数量多、想省 token 或提升工具选择准确率的场景。
+
+## 原始链接索引（均无需登录）
+
+- [Kimi API 概览](https://platform.kimi.com/docs/overview)
+- [Kimi K3 快速开始](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)
+- [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort)
+- [使用 Kimi API 的联网搜索功能](https://platform.kimi.com/docs/guide/use-web-search)
+- [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools)
+- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
+- [联网搜索定价](https://platform.kimi.com/docs/pricing/tools)
+- [使用思考模式](https://platform.kimi.com/docs/guide/use-thinking-models)
+- [Kimi 文档全量索引](https://platform.kimi.com/docs/llms.txt)

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/MiniMax.md

@@ -1,84 +1,84 @@
-# MiniMax
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `minimax` |
-| 对应项目 `adapter` | `openai`（Chat Completions / Responses 均可）。官方推荐的 Anthropic 路径在本项目没有可选的 adapter——那个选项从未接通，已删除，见下方"接入优先级" |
-| 官方协议 | Anthropic Messages（官方推荐）、OpenAI Chat Completions、OpenAI Responses API 三选一，同域名不同路径 |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | MiniMax-M3 已默认走 **Responses API** → Chat Completions 兼容；Anthropic 暂不实现、不显示 |
-
-MiniMax 是本次调研 7 家里**唯一把 Anthropic 协议列为默认推荐接入方式**的供应商——官方"通过 SDK 接入"快速开始页第一步就是装 `anthropic` SDK，不是 `openai`；原因是 Anthropic 协议能拿到原生 `thinking` 块和 interleaved thinking，Chat/Responses 路径下这部分体验打折扣。**但本项目按统一的协议接入优先级执行，不因为某一家官方推荐就单独提高 Anthropic 的实现顺序**——MiniMax 官方文档自己也说 Chat Completions 与 Responses 两条路径"功能对等，只是拿不到原生 thinking 块"，所以 Responses API 仍然是够用的第一选择。
-
-## 2. Base URL
-
-| 协议 | Base URL |
-|---|---|
-| Anthropic Messages（推荐） | `https://api.minimaxi.com/anthropic` |
-| OpenAI Chat Completions | `https://api.minimaxi.com/v1`（路径 `/chat/completions`） |
-| OpenAI Responses API | `https://api.minimaxi.com/v1`（路径 `/responses`） |
-
-## 3. 模型清单
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
-|---|---|---|---|---|
-| `MiniMax-M3` | 当前最新旗舰，原生多模态，1M 上下文，面向 Frontier Coding、复杂推理、Agent | 文本、图片、视频 → 文本 | 1,000,000 | 官方建议 131,072，硬上限 524,288 |
-
-`MiniMax-M2.7`（含 `-highspeed`）仍在正常提供服务，属于上一代仍在售的并行线，不是 M3 的档位变体；`M2.5`/`M2.1`/`M2` 系列已归入官方"历史模型"分组。
-
-### 价格（元/百万 tokens，当前促销"永久五折"后）
-
-| 输入长度 | 输入 | 输出 | 缓存读取 |
-|---|---|---|---|
-| ≤ 512K | 2.10 | 8.40 | 0.42 |
-| > 512K | 4.20 | 16.80 | 0.84 |
-
-`service_tier: "priority"` 优先服务档按上表 1.5 倍计费，可换取更快响应与更低失败率。
-
-## 4. Anthropic 协议接入要点（官方推荐路径，但本项目最低优先级，仅供顺手接入时参考）
-
-```python
-import anthropic
-client = anthropic.Anthropic(base_url="https://api.minimaxi.com/anthropic", api_key="<KEY>")
-message = client.messages.create(model="MiniMax-M3", max_tokens=1000, messages=[...])
-for block in message.content:
-    if block.type == "thinking": ...   # 原生 thinking 块
-    elif block.type == "text": ...
-```
-
-- 支持 `thinking` 内容块和 interleaved thinking（推理与工具调用交替）——这是官方文档反复强调的 M3 核心卖点，Chat Completions 路径下只能拿到扁平化的 `reasoning_content` 字符串，信息密度不如原生 `thinking` 块。
-- 官方 Mini-Agent 示例项目就是用 Anthropic 协议 + interleaved thinking 演示"如何用 M3 搭 Agent"的最佳实践，可作为项目内 Agent 集成的参考实现。
-
-## 5. 联网搜索（Server Tools，Beta，两个协议都支持——这与此前认知不同）
-
-**更正**：此前认为 MiniMax 的 `web_search` 只在 Anthropic Messages 文档出现，OpenAI/Responses 路径不支持——这是过时信息。**官方当前 Server Tools 文档明确写：Anthropic Messages API 和 OpenAI Responses API 都支持**，只是工具类型标识不同：
-
-| 接口 | 工具声明 |
-|---|---|
-| Anthropic Messages API | `{"type": "web_search_20250305", "name": "web_search"}` |
-| OpenAI Responses API | `{"type": "web_search"}` |
-
-服务端工具（Server Tools）与项目自研的 function-calling 工具是两套机制：模型在 MiniMax 服务端自动执行搜索并把结果直接嵌进响应，调用方不需要多轮回传 `tool_result`，一次请求内完成。
-
-- Anthropic 路径响应里会依次出现 `text`（引导语）→ `server_tool_use`（`name=web_search`, `input.query`）→ `web_search_tool_result`（含 `title`/`url`/`page_age`/`content`）→ `text`（最终答案），直接读最后一个 `text` 块即可。
-- Responses API 路径的 `output` 数组包含 `web_search_call`（含 `action.query`）和 `message`，可以直接读顶层聚合字段 `output_text`。
-- **纯 Chat Completions（`/v1/chat/completions`）不支持这个工具**——只有 Anthropic Messages 和 Responses 两条路径能用，选型时要注意。
-- 价格 ¥0.03/次；处于 **Beta 阶段**，官方提示行为与参数可能随时调整，服务端全程执行导致单次请求耗时可能更长，客户端超时要放宽。
-
-## 6. 兼容性说明
-
-- OpenAI Chat Completions 与 Anthropic Messages 是"等价的两套非流式样例"，官方文档明确"如果你的项目已经接入 OpenAI SDK，把 base_url 和 model 换成 MiniMax 的值即可直接复用，无需迁移 SDK"——即两条路径功能对等（除服务端工具的可用面略有差异），选哪个更多是团队已有技术栈的问题，不是能力取舍。这也是本项目仍把 Responses API 排在 Anthropic 前面的依据：不用 Anthropic 也不会丢失核心能力，只是拿不到原生 `thinking` 块和 interleaved thinking 这部分体验加成。
-- `LlmProviderConfig.adapter` 只保留内部供应商特性标识；协议由 `apiProtocol` 和预制模型矩阵决定。Anthropic 虽是 MiniMax 官方推荐路径，但项目暂不实现、不显示；MiniMax-M3 由 SDK 自动走 Responses。
-
-## 原始链接索引（均无需登录）
-
-- [模型概览](https://platform.minimaxi.com/docs/guides/models-intro)
-- [模型调用（URL 配置、双协议示例）](https://platform.minimaxi.com/docs/guides/text-generation)
-- [通过 SDK 接入（Anthropic SDK 快速开始）](https://platform.minimaxi.com/docs/guides/quickstart-sdk)
-- [服务端工具（Server Tools / web_search）](https://platform.minimaxi.com/docs/guides/server-tools)
-- [工具使用 & 交错思维链](https://platform.minimaxi.com/docs/guides/text-m3-function-call)
-- [按量计费](https://platform.minimaxi.com/docs/guides/pricing-paygo)
-- [MiniMax 文档全量索引](https://platform.minimaxi.com/docs/llms.txt)
+# MiniMax
+
+> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `minimax` |
+| 对应项目 `adapter` | `openai`（Chat Completions / Responses 均可）。官方推荐的 Anthropic 路径在本项目没有可选的 adapter——那个选项从未接通，已删除，见下方"接入优先级" |
+| 官方协议 | Anthropic Messages（官方推荐）、OpenAI Chat Completions、OpenAI Responses API 三选一，同域名不同路径 |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | MiniMax-M3 已默认走 **Responses API** → Chat Completions 兼容；Anthropic 暂不实现、不显示 |
+
+MiniMax 是本次调研 7 家里**唯一把 Anthropic 协议列为默认推荐接入方式**的供应商——官方"通过 SDK 接入"快速开始页第一步就是装 `anthropic` SDK，不是 `openai`；原因是 Anthropic 协议能拿到原生 `thinking` 块和 interleaved thinking，Chat/Responses 路径下这部分体验打折扣。**但本项目按统一的协议接入优先级执行，不因为某一家官方推荐就单独提高 Anthropic 的实现顺序**——MiniMax 官方文档自己也说 Chat Completions 与 Responses 两条路径"功能对等，只是拿不到原生 thinking 块"，所以 Responses API 仍然是够用的第一选择。
+
+## 2. Base URL
+
+| 协议 | Base URL |
+|---|---|
+| Anthropic Messages（推荐） | `https://api.minimaxi.com/anthropic` |
+| OpenAI Chat Completions | `https://api.minimaxi.com/v1`（路径 `/chat/completions`） |
+| OpenAI Responses API | `https://api.minimaxi.com/v1`（路径 `/responses`） |
+
+## 3. 模型清单
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
+|---|---|---|---|---|
+| `MiniMax-M3` | 当前最新旗舰，原生多模态，1M 上下文，面向 Frontier Coding、复杂推理、Agent | 文本、图片、视频 → 文本 | 1,000,000 | 官方建议 131,072，硬上限 524,288 |
+
+`MiniMax-M2.7`（含 `-highspeed`）仍在正常提供服务，属于上一代仍在售的并行线，不是 M3 的档位变体；`M2.5`/`M2.1`/`M2` 系列已归入官方"历史模型"分组。
+
+### 价格（元/百万 tokens，当前促销"永久五折"后）
+
+| 输入长度 | 输入 | 输出 | 缓存读取 |
+|---|---|---|---|
+| ≤ 512K | 2.10 | 8.40 | 0.42 |
+| > 512K | 4.20 | 16.80 | 0.84 |
+
+`service_tier: "priority"` 优先服务档按上表 1.5 倍计费，可换取更快响应与更低失败率。
+
+## 4. Anthropic 协议接入要点（官方推荐路径，但本项目最低优先级，仅供顺手接入时参考）
+
+```python
+import anthropic
+client = anthropic.Anthropic(base_url="https://api.minimaxi.com/anthropic", api_key="<KEY>")
+message = client.messages.create(model="MiniMax-M3", max_tokens=1000, messages=[...])
+for block in message.content:
+    if block.type == "thinking": ...   # 原生 thinking 块
+    elif block.type == "text": ...
+```
+
+- 支持 `thinking` 内容块和 interleaved thinking（推理与工具调用交替）——这是官方文档反复强调的 M3 核心卖点，Chat Completions 路径下只能拿到扁平化的 `reasoning_content` 字符串，信息密度不如原生 `thinking` 块。
+- 官方 Mini-Agent 示例项目就是用 Anthropic 协议 + interleaved thinking 演示"如何用 M3 搭 Agent"的最佳实践，可作为项目内 Agent 集成的参考实现。
+
+## 5. 联网搜索（Server Tools，Beta，两个协议都支持——这与此前认知不同）
+
+**更正**：此前认为 MiniMax 的 `web_search` 只在 Anthropic Messages 文档出现，OpenAI/Responses 路径不支持——这是过时信息。**官方当前 Server Tools 文档明确写：Anthropic Messages API 和 OpenAI Responses API 都支持**，只是工具类型标识不同：
+
+| 接口 | 工具声明 |
+|---|---|
+| Anthropic Messages API | `{"type": "web_search_20250305", "name": "web_search"}` |
+| OpenAI Responses API | `{"type": "web_search"}` |
+
+服务端工具（Server Tools）与项目自研的 function-calling 工具是两套机制：模型在 MiniMax 服务端自动执行搜索并把结果直接嵌进响应，调用方不需要多轮回传 `tool_result`，一次请求内完成。
+
+- Anthropic 路径响应里会依次出现 `text`（引导语）→ `server_tool_use`（`name=web_search`, `input.query`）→ `web_search_tool_result`（含 `title`/`url`/`page_age`/`content`）→ `text`（最终答案），直接读最后一个 `text` 块即可。
+- Responses API 路径的 `output` 数组包含 `web_search_call`（含 `action.query`）和 `message`，可以直接读顶层聚合字段 `output_text`。
+- **纯 Chat Completions（`/v1/chat/completions`）不支持这个工具**——只有 Anthropic Messages 和 Responses 两条路径能用，选型时要注意。
+- 价格 ¥0.03/次；处于 **Beta 阶段**，官方提示行为与参数可能随时调整，服务端全程执行导致单次请求耗时可能更长，客户端超时要放宽。
+
+## 6. 兼容性说明
+
+- OpenAI Chat Completions 与 Anthropic Messages 是"等价的两套非流式样例"，官方文档明确"如果你的项目已经接入 OpenAI SDK，把 base_url 和 model 换成 MiniMax 的值即可直接复用，无需迁移 SDK"——即两条路径功能对等（除服务端工具的可用面略有差异），选哪个更多是团队已有技术栈的问题，不是能力取舍。这也是本项目仍把 Responses API 排在 Anthropic 前面的依据：不用 Anthropic 也不会丢失核心能力，只是拿不到原生 `thinking` 块和 interleaved thinking 这部分体验加成。
+- `LlmProviderConfig.adapter` 只保留内部供应商特性标识；协议由 `apiProtocol` 和预制模型矩阵决定。Anthropic 虽是 MiniMax 官方推荐路径，但项目暂不实现、不显示；MiniMax-M3 由 SDK 自动走 Responses。
+
+## 原始链接索引（均无需登录）
+
+- [模型概览](https://platform.minimaxi.com/docs/guides/models-intro)
+- [模型调用（URL 配置、双协议示例）](https://platform.minimaxi.com/docs/guides/text-generation)
+- [通过 SDK 接入（Anthropic SDK 快速开始）](https://platform.minimaxi.com/docs/guides/quickstart-sdk)
+- [服务端工具（Server Tools / web_search）](https://platform.minimaxi.com/docs/guides/server-tools)
+- [工具使用 & 交错思维链](https://platform.minimaxi.com/docs/guides/text-m3-function-call)
+- [按量计费](https://platform.minimaxi.com/docs/guides/pricing-paygo)
+- [MiniMax 文档全量索引](https://platform.minimaxi.com/docs/llms.txt)

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//345/260/217/347/261/263MiMo.md

@@ -1,85 +1,85 @@
-# 小米 MiMo
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录（文档站是 SPA，curl 拿不到正文，用浏览器渲染后取 `innerText`，见采集手册）。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定，代码中已存在） | `mimo` |
-| 对应项目 `adapter` | `openai`（Chat Completions）；官方也提供 Anthropic Messages API |
-| 官方协议 | OpenAI Chat Completions + **Anthropic Messages API**，**没有 Responses API** |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API；Chat Completions 是唯一已实现且能用联网搜索的路径；Anthropic **最低优先级**，且接了也拿不到联网搜索（第 7 节） |
-| 已知协议怪癖（代码里已实现） | 额外发送 `api-key` 认证头；请求体 `max_tokens` 要改名成 `max_completion_tokens`，见 `packages/ai-sdk/src/llm/providerProtocol.ts` |
-
-## 2. Base URL
-
-| 用法 | OpenAI 兼容 | Anthropic 兼容 |
-|---|---|---|
-| 按量计费 | `https://api.xiaomimimo.com/v1` | `https://api.xiaomimimo.com/anthropic` |
-| Token Plan（订阅套餐） | `https://token-plan-cn.xiaomimimo.com/v1` | `https://token-plan-cn.xiaomimimo.com/anthropic` |
-
-两种用法的 Base URL 和 API Key 都不同，Token Plan 走独立域名——如果项目未来要支持订阅制账号，不能简单复用按量计费的 Base URL。
-
-## 3. 认证怪癖（已在代码里处理，供交叉核对）
-
-官方文档给出的 Header 名是 `api-key`（不是 `Authorization: Bearer`）：
-
-```
-curl --header "api-key: $MIMO_API_KEY" ...
-```
-
-这与项目 `providerProtocol.ts` 里 `PROVIDER_EXTRA_AUTH_HEADERS: { mimo: 'api-key' }` 的注释描述完全一致——代码是**额外补发**这个头而不是替换 `Authorization`，因为通用 OpenAI 兼容实现默认发的是 Bearer，MiMo 网关只认它认识的那个头，两个头同时发是安全的。
-
-## 4. 模型清单
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 / 最大输出 | RPM / TPM |
-|---|---|---|---|---|
-| `mimo-v2.5-pro` | 复杂推理、深度分析、长文档场景 | 文本 → 文本 | 1M / 128K | 100 / 10M |
-| `mimo-v2.5` | 全模态理解，图片/音频/视频场景 | 文本、图片、音频、视频 → 文本 | 1M / 128K | — |
-
-能力标签（官方模型列表页原文）：两个模型都标注支持 Deep Thinking、Streaming、Function Call、Structured Output、**Web Search**；`mimo-v2.5` 额外标注 Full-modal Understanding。
-
-`mimo-v2-pro`/`mimo-v2-omni`/`mimo-v2-flash`/`mimo-v2-tts` 已于 2026-06-30 正式下线，不要再作为可选模型出现在任何清单里。
-
-### 价格（国内，元/百万 tokens）
-
-| 模型 | 缓存命中 | 缓存未命中 | 输出 |
-|---|---|---|---|
-| `mimo-v2.5-pro` | 0.025 | 3.00 | 6.00 |
-| `mimo-v2.5` | 0.02 | 1.00 | 2.00 |
-
-海外价格另有独立美元档（见原始链接），缓存写入限时免费。
-
-## 5. `max_completion_tokens` 怪癖（已在代码里处理，供交叉核对）
-
-官方 Quick Start 示例请求体直接用的就是 `max_completion_tokens`，不是通用 OpenAI 实现默认的 `max_tokens`。这与项目 `applyProviderRequestBodyQuirks` 的注释一致——实测发 `max_tokens` 时六项能力探测**全部返回 400 `Invalid request parameters`**，包括最基础的纯文本对话，说明这不是能力缺失，是请求字段本身不被接受。
-
-## 6. 思考模式的多轮回传
-
-思考模式下，`assistant` 消息会带 `reasoning_content` 字段（与 `content`/`tool_calls` 并列）。多轮工具调用场景，官方建议把历史轮次的 `reasoning_content` 也保留在 `messages` 里回传，以获得最佳效果——这点和 Kimi K3、GLM 的"必须回传完整 assistant message"是同一类要求，三家风格接近，可以复用同一套"assistant message 原样回传"逻辑，不用分别实现。
-
-## 7. 联网搜索（需要先在控制台激活插件，且只支持 Chat Completions）
-
-- **前置步骤**：控制台 → 插件管理，先激活 Web Search 插件，否则 API 侧声明了 `tools` 也不会生效。
-- 声明方式（比 GLM 简单，扁平结构而非嵌套）：
-  ```json
-  {
-    "type": "web_search",
-    "max_keyword": 3,
-    "force_search": true,
-    "limit": 1,
-    "user_location": { "type": "approximate", "country": "China", "region": "Hubei", "city": "Wuhan" }
-  }
-  ```
-- **官方原文明确写"其他 API 协议暂不支持"**——即联网搜索只能走 OpenAI Chat Completions，Anthropic Messages 路径下不可用，即便两个模型基础对话都支持 Anthropic 协议。
-- 响应里搜索来源以 `annotations: [{type:"url_citation", url, title, ...}]` 形式附在 `message` 里，usage 里会带 `web_search_usage: {tool_usage, page_usage}`。
-- 有 5 分钟缓存期：刚开关搜索插件后 5 分钟内可能不会立即生效，排查"为什么没触发搜索"时先看这一条。
-- 价格：国内 ¥16/1000 次、海外 $5/1000 次；一轮搜索按 `max_keyword` 并发展开多个关键词，会产生多次调用计费；网页内容本身按标准 token 单价计入 `prompt_tokens`。
-
-## 原始链接索引（均无需登录，需浏览器渲染）
-
-- [模型列表](https://mimo.mi.com/docs/quick-start/summary/model)
-- [首次 API 调用（含 OpenAI/Anthropic 双协议示例）](https://mimo.mi.com/docs/quick-start/summary/first-api-call)
-- [联网搜索](https://mimo.mi.com/docs/en-US/quick-start/usage-guide/text-generation/tool-calling/web-search)
-- [按量计费价格](https://mimo.mi.com/docs/en-US/price/pay-as-you-go)
+# 小米 MiMo
+
+> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录（文档站是 SPA，curl 拿不到正文，用浏览器渲染后取 `innerText`，见采集手册）。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定，代码中已存在） | `mimo` |
+| 对应项目 `adapter` | `openai`（Chat Completions）；官方也提供 Anthropic Messages API |
+| 官方协议 | OpenAI Chat Completions + **Anthropic Messages API**，**没有 Responses API** |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API；Chat Completions 是唯一已实现且能用联网搜索的路径；Anthropic **最低优先级**，且接了也拿不到联网搜索（第 7 节） |
+| 已知协议怪癖（代码里已实现） | 额外发送 `api-key` 认证头；请求体 `max_tokens` 要改名成 `max_completion_tokens`，见 `packages/ai-sdk/src/llm/providerProtocol.ts` |
+
+## 2. Base URL
+
+| 用法 | OpenAI 兼容 | Anthropic 兼容 |
+|---|---|---|
+| 按量计费 | `https://api.xiaomimimo.com/v1` | `https://api.xiaomimimo.com/anthropic` |
+| Token Plan（订阅套餐） | `https://token-plan-cn.xiaomimimo.com/v1` | `https://token-plan-cn.xiaomimimo.com/anthropic` |
+
+两种用法的 Base URL 和 API Key 都不同，Token Plan 走独立域名——如果项目未来要支持订阅制账号，不能简单复用按量计费的 Base URL。
+
+## 3. 认证怪癖（已在代码里处理，供交叉核对）
+
+官方文档给出的 Header 名是 `api-key`（不是 `Authorization: Bearer`）：
+
+```
+curl --header "api-key: $MIMO_API_KEY" ...
+```
+
+这与项目 `providerProtocol.ts` 里 `PROVIDER_EXTRA_AUTH_HEADERS: { mimo: 'api-key' }` 的注释描述完全一致——代码是**额外补发**这个头而不是替换 `Authorization`，因为通用 OpenAI 兼容实现默认发的是 Bearer，MiMo 网关只认它认识的那个头，两个头同时发是安全的。
+
+## 4. 模型清单
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 / 最大输出 | RPM / TPM |
+|---|---|---|---|---|
+| `mimo-v2.5-pro` | 复杂推理、深度分析、长文档场景 | 文本 → 文本 | 1M / 128K | 100 / 10M |
+| `mimo-v2.5` | 全模态理解，图片/音频/视频场景 | 文本、图片、音频、视频 → 文本 | 1M / 128K | — |
+
+能力标签（官方模型列表页原文）：两个模型都标注支持 Deep Thinking、Streaming、Function Call、Structured Output、**Web Search**；`mimo-v2.5` 额外标注 Full-modal Understanding。
+
+`mimo-v2-pro`/`mimo-v2-omni`/`mimo-v2-flash`/`mimo-v2-tts` 已于 2026-06-30 正式下线，不要再作为可选模型出现在任何清单里。
+
+### 价格（国内，元/百万 tokens）
+
+| 模型 | 缓存命中 | 缓存未命中 | 输出 |
+|---|---|---|---|
+| `mimo-v2.5-pro` | 0.025 | 3.00 | 6.00 |
+| `mimo-v2.5` | 0.02 | 1.00 | 2.00 |
+
+海外价格另有独立美元档（见原始链接），缓存写入限时免费。
+
+## 5. `max_completion_tokens` 怪癖（已在代码里处理，供交叉核对）
+
+官方 Quick Start 示例请求体直接用的就是 `max_completion_tokens`，不是通用 OpenAI 实现默认的 `max_tokens`。这与项目 `applyProviderRequestBodyQuirks` 的注释一致——实测发 `max_tokens` 时六项能力探测**全部返回 400 `Invalid request parameters`**，包括最基础的纯文本对话，说明这不是能力缺失，是请求字段本身不被接受。
+
+## 6. 思考模式的多轮回传
+
+思考模式下，`assistant` 消息会带 `reasoning_content` 字段（与 `content`/`tool_calls` 并列）。多轮工具调用场景，官方建议把历史轮次的 `reasoning_content` 也保留在 `messages` 里回传，以获得最佳效果——这点和 Kimi K3、GLM 的"必须回传完整 assistant message"是同一类要求，三家风格接近，可以复用同一套"assistant message 原样回传"逻辑，不用分别实现。
+
+## 7. 联网搜索（需要先在控制台激活插件，且只支持 Chat Completions）
+
+- **前置步骤**：控制台 → 插件管理，先激活 Web Search 插件，否则 API 侧声明了 `tools` 也不会生效。
+- 声明方式（比 GLM 简单，扁平结构而非嵌套）：
+  ```json
+  {
+    "type": "web_search",
+    "max_keyword": 3,
+    "force_search": true,
+    "limit": 1,
+    "user_location": { "type": "approximate", "country": "China", "region": "Hubei", "city": "Wuhan" }
+  }
+  ```
+- **官方原文明确写"其他 API 协议暂不支持"**——即联网搜索只能走 OpenAI Chat Completions，Anthropic Messages 路径下不可用，即便两个模型基础对话都支持 Anthropic 协议。
+- 响应里搜索来源以 `annotations: [{type:"url_citation", url, title, ...}]` 形式附在 `message` 里，usage 里会带 `web_search_usage: {tool_usage, page_usage}`。
+- 有 5 分钟缓存期：刚开关搜索插件后 5 分钟内可能不会立即生效，排查"为什么没触发搜索"时先看这一条。
+- 价格：国内 ¥16/1000 次、海外 $5/1000 次；一轮搜索按 `max_keyword` 并发展开多个关键词，会产生多次调用计费；网页内容本身按标准 token 单价计入 `prompt_tokens`。
+
+## 原始链接索引（均无需登录，需浏览器渲染）
+
+- [模型列表](https://mimo.mi.com/docs/quick-start/summary/model)
+- [首次 API 调用（含 OpenAI/Anthropic 双协议示例）](https://mimo.mi.com/docs/quick-start/summary/first-api-call)
+- [联网搜索](https://mimo.mi.com/docs/en-US/quick-start/usage-guide/text-generation/tool-calling/web-search)
+- [按量计费价格](https://mimo.mi.com/docs/en-US/price/pay-as-you-go)