@henjicc/ai-sdk 0.2.8 → 0.4.0

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

@@ -1,91 +1,103 @@
-# DeepSeek
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `deepseek` |
-| 对应项目 `adapter` | `deepseek`（已实现；思考参数映射见 `packages/ai-sdk/src/llm/providerReasoningRequest.ts`，认证与请求体怪癖见 `packages/ai-sdk/src/llm/providerProtocol.ts`） |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | **Responses API 已实现并作为直连默认** → Chat Completions 兜底；Anthropic 暂不实现、不显示 |
-| 鉴权 | `Authorization: Bearer <DEEPSEEK_API_KEY>` |
-| 官方协议 | OpenAI Chat Completions、OpenAI Responses API、**Anthropic Messages API** 三选一，同一 Base URL 域名 |
-| 项目当前实际协议 | 直连预制模型自动使用 Responses；Chat Completions 保留为兼容路径 |
-
-## 2. Base URL
-
-| 协议 | Base URL |
-|---|---|
-| OpenAI 格式（Chat Completions / Responses） | `https://api.deepseek.com` |
-| Anthropic 格式（Messages API） | `https://api.deepseek.com/anthropic` |
-
-三种协议共用同一域名，只是路径不同：`/chat/completions`、`/responses`、`/anthropic/v1/messages`。
-
-## 3. 协议现状
-
-| 协议 | 官方支持 | 备注 |
-|---|---|---|
-| Chat Completions | ✅ | SDK 兼容路径 |
-| Responses API | ✅ | SDK 直连默认；`client.responses.create(model=..., input=...)`，见第 6 节 |
-| Anthropic Messages API | ✅ | 把 Claude 模型名映射到 DeepSeek 模型（`claude-opus-*` → `deepseek-v4-pro`；`claude-haiku-*`/`claude-sonnet-*` → `deepseek-v4-flash`），可以不改代码直接把现有 Anthropic 客户端指过来 |
-
-三种协议**同一批新模型会同步支持**，官方没有"新模型先上 Chat 后补 Responses"的滞后期。
-
-## 4. 模型清单
-
-官方用稳定别名指向最新快照，调用时直接用别名即可，无需关心具体快照号：
-
-| 模型别名 | 当前快照 | 简介 | 输入 → 输出 | 上下文 / 最大输出 | 并发上限 |
-|---|---|---|---|---|---|
-| `deepseek-v4-flash` | DeepSeek-V4-Flash-0731 | 高性价比、低延迟 | 文本 → 文本 | 1M / 384K | 2500 |
-| `deepseek-v4-pro` | DeepSeek-V4-Pro-0813 | 高能力，复杂推理与长任务 | 文本 → 文本 | 1M / 384K | 500 |
-| `deepseek-v4-flash-vision-exp` | — | **实验性视觉模型**，在 Flash 基础上加图片输入 | 文本、图片 → 文本 | 1M / 384K | 2500 |
-
-`deepseek-v4-flash-vision-exp` 不在此前整理的清单里，是新发现——它是唯一支持图片输入的 DeepSeek 模型，且**只能通过 Responses API 调用**（`input_image` 内容块），Chat Completions 路径下这个模型不接受图片。
-
-### 价格（元/百万 tokens，闲时/高峰各半，高峰为北京时间 09:00–12:00、14:00–18:00 工作日）
-
-| 模型 | 输入（缓存命中） | 输入（缓存未命中） | 输出 |
-|---|---|---|---|
-| `deepseek-v4-flash` | 闲时 0.05 / 高峰 0.10 | 闲时 1.5 / 高峰 3 | 闲时 4.5 / 高峰 9 |
-| `deepseek-v4-pro` | 闲时 0.15 / 高峰 0.30 | 闲时 4.5 / 高峰 9 | 闲时 13.5 / 高峰 27 |
-| `deepseek-v4-flash-vision-exp` | 同 flash | 同 flash | 同 flash |
-
-## 5. 思考模式
-
-- 请求体同时传 `thinking: {"type": "enabled"}` 和顶层 `reasoning_effort`；官方两个字段都要求（示例见 curl）。`reasoning_effort` 取值与思考强度的对应关系官方未列举离散档位，直接透传字符串即可。
-- 思考模式下 `temperature`、`top_p` 无效——传了也不报错，但不生效，UI 应避免让用户误以为调节生效。
-
-## 6. Responses API 适配要点（比 Chat Completions 复杂得多，接入前必读）
-
-`client.responses.create(model=..., input=..., instructions=...)`：
-
-- `input` 可以是字符串或 `input_text`/`input_image` 内容块数组；`instructions` 相当于插入一条首位 system 消息。
-- **不支持** `previous_response_id`、`conversation`、`store`（响应恒为 `store: false`）——**是无状态 API**，不要按 OpenAI 官方 Responses API 的"自动多轮托管"心智去设计，每次都要自己拼完整历史。
-- `tools` 只支持 `function` 与 `web_search`/`web_search_2025_08_26`，其余内置工具类型（`file_search`/`code_interpreter`/`computer_use`/`mcp`）会被**静默忽略**，不报错。
-- `web_search` 由服务端执行，`search_context_size`/`user_location` 参数会被忽略，服务端自动续搜最多 10 轮。**Chat Completions 完全不支持这个工具**——DeepSeek 官方 `guides/tool_calls` 文档里没有出现过 `web_search`，要联网搜索必须走 Responses API。
-- 未知/不支持的顶层参数一律静默忽略而不报错，意味着"参数传了但没生效"这类 bug 不会在 DeepSeek 侧报错，需要自己校验响应内容。
-
-## 7. Anthropic Messages API 适配要点（最低优先级，仅供顺手接入时参考）
-
-- 沿用 Anthropic 官方字段名（`system`、`messages[].content[].type=text/image/tool_use/tool_result` 等），`thinking` 支持但 `budget_tokens` 被忽略。
-- `output_config.effort` 是 DeepSeek 侧唯一生效的思考强度字段，其余 Anthropic 原生参数（`top_k`、`cache_control`、`disable_parallel_tool_use` 等）大多被忽略。
-- 项目设置页不显示 Anthropic：它没有运行时实现，存量伪配置会归一化成 OpenAI Chat。官方能力只留作未来资料，不让用户面对无效协议选项。
-
-## 8. 视觉输入限制（`deepseek-v4-flash-vision-exp`）
-
-- 单张内联图片 ≤ 32 MiB，`file_id` 图片 ≤ 64 MiB；不含 `file_id` 时总大小 ≤ 64 MiB，含则 ≤ 200 MiB；单请求最多 600 张图。
-- 图片只能出现在 `user`/`developer` 消息里，出现在 `system`/`assistant` 消息会直接返回 400。
-- 非视觉模型收到 `input_image` 不会报错，而是被替换成占位文本——容易造成"没报错但模型看不到图"的静默失效。
-
-## 原始链接索引（均无需登录）
-
-- [Your First API Call](https://api-docs.deepseek.com/quick_start/pricing)（含 base_url/模型 ID/思考请求示例）
-- [Models & Pricing](https://api-docs.deepseek.com/quick_start/pricing)
-- [Using the Responses API](https://api-docs.deepseek.com/guides/responses_api)
-- [Using the Anthropic API](https://api-docs.deepseek.com/guides/anthropic_api)
-- [Reasoning Model（思考模式）](https://api-docs.deepseek.com/guides/reasoning_model)
-- [Function Calling](https://api-docs.deepseek.com/guides/tool_calls)
-- [Vision（视觉输入限制）](https://api-docs.deepseek.com/guides/vision)
-- [API sitemap](https://api-docs.deepseek.com/sitemap.xml)（用于核对页面是否存在，避免中文 `/zh-cn/` 前缀 404 后静默 fallback 到错误页面）
+# DeepSeek
+
+> 核对时间：2026-09-11。以中文官方文档为准，英文页面尚有更新滞后。
+
+## 2026-09-11 更新（覆盖下方历史资料中的旧模型和能力说明）
+
+- 官方默认与预设唯一推荐模型改为 `deepseek-flash`（DeepSeek V4.1 Flash），原生文本、图片输入，1M 上下文、384K 最大输出。Chat Completions 和 Responses 均支持图片；项目继续默认 Responses。
+- 旧 `deepseek-v4-flash`、`deepseek-v4-flash-vision-exp` 已由官方转发到新版。`deepseek-v4-pro` 将于北京时间 2026-09-14 12:00 转由新版承接。项目不再推荐这些旧名字，也不把聚合供应商的旧 ID 当作新版别名。
+- 新版价格（人民币/百万 token，闲时 / 工作日高峰）：缓存命中输入 0.02 / 0.04，未命中输入 1 / 2，输出 4 / 8。高峰为北京时间工作日 09:00–12:00、14:00–18:00。
+- 思考默认开启，默认 high；正式档位 low/high/max，兼容 minimal→low、medium/xhigh→high、ultra→max。Responses 用 reasoning.effort，none 关闭。思考时 temperature 无效，top_p 生效但下限 0.95；非思考 top_p 固定 1。
+- Responses 为无状态 API，必须回传完整历史；text.format 支持 json_schema。当前仅支持 function 工具，内置工具会被忽略，不能再据旧资料宣称 web_search 可用。SDK 本次只更新目录与默认选型，不新增内置工具或协议分支。
+- 图片支持 JPEG/PNG/GIF/WebP；请求体最多 48 MiB，单图内联/URL 32 MiB，file_id 64 MiB，最多 600 张；总大小不含 file_id 64 MiB、包含时 200 MiB。Chat 图片仅 user；Responses 支持 user/developer 和工具结果，system/assistant 图片返回 400。SDK 沿用已实现的 URL/内联图片通道，不新增 Files 上传能力。
+- 官方来源：[模型与价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)、[图片理解](https://api-docs.deepseek.com/zh-cn/guides/vision/)、[思考模式](https://api-docs.deepseek.com/zh-cn/guides/thinking_mode/)、[Responses API](https://api-docs.deepseek.com/zh-cn/api/create-response/)。
+
+以下为 2026-08-26 历史采集记录；冲突字段以本节为准。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `deepseek` |
+| 对应项目 `adapter` | `deepseek`（已实现；思考参数映射见 `packages/ai-sdk/src/llm/providerReasoningRequest.ts`，认证与请求体怪癖见 `packages/ai-sdk/src/llm/providerProtocol.ts`） |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | **Responses API 已实现并作为直连默认** → Chat Completions 兜底；Anthropic 暂不实现、不显示 |
+| 鉴权 | `Authorization: Bearer <DEEPSEEK_API_KEY>` |
+| 官方协议 | OpenAI Chat Completions、OpenAI Responses API、**Anthropic Messages API** 三选一，同一 Base URL 域名 |
+| 项目当前实际协议 | 直连预制模型自动使用 Responses；Chat Completions 保留为兼容路径 |
+
+## 2. Base URL
+
+| 协议 | Base URL |
+|---|---|
+| OpenAI 格式（Chat Completions / Responses） | `https://api.deepseek.com` |
+| Anthropic 格式（Messages API） | `https://api.deepseek.com/anthropic` |
+
+三种协议共用同一域名，只是路径不同：`/chat/completions`、`/responses`、`/anthropic/v1/messages`。
+
+## 3. 协议现状
+
+| 协议 | 官方支持 | 备注 |
+|---|---|---|
+| Chat Completions | ✅ | SDK 兼容路径 |
+| Responses API | ✅ | SDK 直连默认；`client.responses.create(model=..., input=...)`，见第 6 节 |
+| Anthropic Messages API | ✅ | 把 Claude 模型名映射到 DeepSeek 模型（`claude-opus-*` → `deepseek-v4-pro`；`claude-haiku-*`/`claude-sonnet-*` → `deepseek-v4-flash`），可以不改代码直接把现有 Anthropic 客户端指过来 |
+
+三种协议**同一批新模型会同步支持**，官方没有"新模型先上 Chat 后补 Responses"的滞后期。
+
+## 4. 模型清单
+
+官方用稳定别名指向最新快照，调用时直接用别名即可，无需关心具体快照号：
+
+| 模型别名 | 当前快照 | 简介 | 输入 → 输出 | 上下文 / 最大输出 | 并发上限 |
+|---|---|---|---|---|---|
+| `deepseek-v4-flash` | DeepSeek-V4-Flash-0731 | 高性价比、低延迟 | 文本 → 文本 | 1M / 384K | 2500 |
+| `deepseek-v4-pro` | DeepSeek-V4-Pro-0813 | 高能力，复杂推理与长任务 | 文本 → 文本 | 1M / 384K | 500 |
+| `deepseek-v4-flash-vision-exp` | — | **实验性视觉模型**，在 Flash 基础上加图片输入 | 文本、图片 → 文本 | 1M / 384K | 2500 |
+
+`deepseek-v4-flash-vision-exp` 不在此前整理的清单里，是新发现——它是唯一支持图片输入的 DeepSeek 模型，且**只能通过 Responses API 调用**（`input_image` 内容块），Chat Completions 路径下这个模型不接受图片。
+
+### 价格（元/百万 tokens，闲时/高峰各半，高峰为北京时间 09:00–12:00、14:00–18:00 工作日）
+
+| 模型 | 输入（缓存命中） | 输入（缓存未命中） | 输出 |
+|---|---|---|---|
+| `deepseek-v4-flash` | 闲时 0.05 / 高峰 0.10 | 闲时 1.5 / 高峰 3 | 闲时 4.5 / 高峰 9 |
+| `deepseek-v4-pro` | 闲时 0.15 / 高峰 0.30 | 闲时 4.5 / 高峰 9 | 闲时 13.5 / 高峰 27 |
+| `deepseek-v4-flash-vision-exp` | 同 flash | 同 flash | 同 flash |
+
+## 5. 思考模式
+
+- 请求体同时传 `thinking: {"type": "enabled"}` 和顶层 `reasoning_effort`；官方两个字段都要求（示例见 curl）。`reasoning_effort` 取值与思考强度的对应关系官方未列举离散档位，直接透传字符串即可。
+- 思考模式下 `temperature`、`top_p` 无效——传了也不报错，但不生效，UI 应避免让用户误以为调节生效。
+
+## 6. Responses API 适配要点（比 Chat Completions 复杂得多，接入前必读）
+
+`client.responses.create(model=..., input=..., instructions=...)`：
+
+- `input` 可以是字符串或 `input_text`/`input_image` 内容块数组；`instructions` 相当于插入一条首位 system 消息。
+- **不支持** `previous_response_id`、`conversation`、`store`（响应恒为 `store: false`）——**是无状态 API**，不要按 OpenAI 官方 Responses API 的"自动多轮托管"心智去设计，每次都要自己拼完整历史。
+- `tools` 只支持 `function` 与 `web_search`/`web_search_2025_08_26`，其余内置工具类型（`file_search`/`code_interpreter`/`computer_use`/`mcp`）会被**静默忽略**，不报错。
+- `web_search` 由服务端执行，`search_context_size`/`user_location` 参数会被忽略，服务端自动续搜最多 10 轮。**Chat Completions 完全不支持这个工具**——DeepSeek 官方 `guides/tool_calls` 文档里没有出现过 `web_search`，要联网搜索必须走 Responses API。
+- 未知/不支持的顶层参数一律静默忽略而不报错，意味着"参数传了但没生效"这类 bug 不会在 DeepSeek 侧报错，需要自己校验响应内容。
+
+## 7. Anthropic Messages API 适配要点（最低优先级，仅供顺手接入时参考）
+
+- 沿用 Anthropic 官方字段名（`system`、`messages[].content[].type=text/image/tool_use/tool_result` 等），`thinking` 支持但 `budget_tokens` 被忽略。
+- `output_config.effort` 是 DeepSeek 侧唯一生效的思考强度字段，其余 Anthropic 原生参数（`top_k`、`cache_control`、`disable_parallel_tool_use` 等）大多被忽略。
+- 项目设置页不显示 Anthropic：它没有运行时实现，存量伪配置会归一化成 OpenAI Chat。官方能力只留作未来资料，不让用户面对无效协议选项。
+
+## 8. 视觉输入限制（`deepseek-v4-flash-vision-exp`）
+
+- 单张内联图片 ≤ 32 MiB，`file_id` 图片 ≤ 64 MiB；不含 `file_id` 时总大小 ≤ 64 MiB，含则 ≤ 200 MiB；单请求最多 600 张图。
+- 图片只能出现在 `user`/`developer` 消息里，出现在 `system`/`assistant` 消息会直接返回 400。
+- 非视觉模型收到 `input_image` 不会报错，而是被替换成占位文本——容易造成"没报错但模型看不到图"的静默失效。
+
+## 原始链接索引（均无需登录）
+
+- [Your First API Call](https://api-docs.deepseek.com/quick_start/pricing)（含 base_url/模型 ID/思考请求示例）
+- [Models & Pricing](https://api-docs.deepseek.com/quick_start/pricing)
+- [Using the Responses API](https://api-docs.deepseek.com/guides/responses_api)
+- [Using the Anthropic API](https://api-docs.deepseek.com/guides/anthropic_api)
+- [Reasoning Model（思考模式）](https://api-docs.deepseek.com/guides/reasoning_model)
+- [Function Calling](https://api-docs.deepseek.com/guides/tool_calls)
+- [Vision（视觉输入限制）](https://api-docs.deepseek.com/guides/vision)
+- [API sitemap](https://api-docs.deepseek.com/sitemap.xml)（用于核对页面是否存在，避免中文 `/zh-cn/` 前缀 404 后静默 fallback 到错误页面）

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)