@zhz8888/dsh-radeon-cloud-patcher 1.2.1 → 1.4.0

package/README.md

@@ -1,568 +1,182 @@
 # Radeon Cloud Patcher for DeepSeek Harness
 
-把 [AMD Radeon Cloud](https://amd-aim.github.io/radeon-cloud-docs/) 接入 DeepSeek Harness 的模型选择器，**完整支持模型思考（reasoning）功能**。
+把 [AMD Radeon Cloud](https://amd-aim.github.io/radeon-cloud-docs/) 接入 DeepSeek Harness 的模型选择器，完整支持模型思考（reasoning）。
 
-包名 `@zhz8888/dsh-radeon-cloud-patcher`。provider 定义由插件**自带的补丁层**声明，
-由 DSH 自带的 `dsh-llm-pi-ai`（通用 OpenAI 兼容 provider）承载——**不修改 DSH 本体，
-不需要自研适配器，也不往你的 profile 里写任何东西**。
+包名 `@zhz8888/dsh-radeon-cloud-patcher`。provider 定义由插件**自带的补丁层**声明，传输、思考字段解析、多轮回传与用量计量全部由 DSH 自带的 `dsh-llm-pi-ai` 承担——**不改 DSH 本体，不写你的 profile**。
 
-> 之所以叫 patcher，是因为它靠**补丁层**交付：定义写在插件自己的
-> `cordis.plugin.patch.yml` 里。这样做的直接后果有三个，也正是这个设计的目的——
->
-> | 现象 | 原因 |
-> | --- | --- |
-> | 设置页**没有**「删除」按钮 | DSH 只在「该 provider 路径存在于用户层、且不存在于 base 层」时渲染它；定义在插件的 bundle 层，base 层永远有它 |
-> | 卸载插件 = 删除供应商 | 定义只活在插件里，profile 中不留副本 |
-> | 想删供应商只能卸载插件 | 同上；设置页里也点不到删除 |
+由此带来三个直接后果：
+
+- 设置页那一行**没有**「删除」按钮；
+- **卸载插件 = 删除供应商**，profile 中不留副本；
+- 想删供应商只能卸载插件。
 
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 ![target: DSH](https://img.shields.io/badge/DSH-0.2.x-blue?label=target)
-![Radeon Cloud](https://img.shields.io/badge/API-Radeon%20Cloud-orange)
-
----
 
 ## 快速上手
 
-装好 DSH、手上有 Radeon Cloud 的 API 密钥（`rc-…`），三步就能用起来，
-**不需要编辑任何配置文件**：
+装好 DSH、手上有 Radeon Cloud 的 API 密钥（`rc-…`），三步即可，不需要编辑任何配置文件。
 
-1. **装插件** —— 桌面版在左侧「插件」页里添加 `@zhz8888/dsh-radeon-cloud-patcher`；
-   命令行执行
+1. **装插件** —— 桌面版在左侧「插件」页添加 `@zhz8888/dsh-radeon-cloud-patcher`；命令行执行
    `dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher`。
-   装不上（pnpm 报 404）就改用[安装](#安装)里的方式三，从源码装同一个包。
-2. **重启 DSH** —— 定义写在补丁层的 config 行里，插件管理器对这类变更只会给出
-   `restart-required`，不会在运行中生效。重启后 provider 就位，没有其它后置步骤。
-3. **填密钥** —— 左下角「账号菜单 → 设置 → 模型」，找到 **Radeon Cloud** 一行，
-   点「编辑」，在「API 密钥」里粘贴密钥，点「保存」。
-
-装好之后：那一行右侧出现**绿点**（悬停显示「API 密钥已配置」）；回到对话，点输入框下方的
-模型选择器，Radeon 的 8 个模型会出现在列表里；选中模型后再选「推理等级」就是思考档位。
-
-**怎么确认真的装好了** —— 三个现象同时成立，说明插件与它的补丁层都到位：
-
-| 现象 | 在哪看 |
-| --- | --- |
-| 模型选择器里出现 Radeon Cloud 的模型 | 输入框下方的模型选择器 |
-| 那一行**没有**「删除」按钮 | 设置 → 模型 → Radeon Cloud 行 |
-| 那一行**不带**「自定义」标签 | 同上 |
-
-**没生效怎么办** —— 插件不会静默消失：定义失效时它**直接让启动失败并写明原因**
-（profile 里已有同 id 定义、profile 的 `llm-pi-ai` 配置把插件层整份盖掉……），
-逐条处置见[归属与删除](#归属与删除)。想手工核验真正生效的配置，用
-`dsh --profile <profile> --dump-config`（`desktop` profile 例外，它由桌面应用独占管理）。
+   插件列表里显示的条目名是 **Radeon Cloud**（中文界面「Radeon Cloud 提供方」），不是那串包名。
+2. **重启 DSH** —— 定义在补丁层的 config 行里，运行中不生效；重启后即就位，没有其它后置步骤。
+3. **填密钥** —— 左下角「账号菜单 → 设置 → 模型」→ **Radeon Cloud** 行 →「编辑」→ 粘贴密钥 →「保存」。
 
-> 更细的安装方式（npm 源、镜像、GitHub、本地 tarball、手工清单）见[安装](#安装)；
-> 密钥、模型、档位、图片输入与升级卸载见[使用](#使用)。
+装好的三个现象同时成立：模型选择器里出现 Radeon 的模型；那一行右侧是**绿点**（悬停「API 密钥已配置」）；那一行**没有**「删除」按钮、也不带「自定义」标签。
 
----
-
-## 目录
-
-- [快速上手](#快速上手)
-- [功能](#功能)
-- [环境要求](#环境要求)
-- [安装](#安装)
-- [使用](#使用)
-- [归属与删除](#归属与删除)
-- [项目结构](#项目结构)
-- [常用命令](#常用命令)
-- [可用模型](#可用模型)
-- [已知限制](#已知限制)
-- [兼容性](#兼容性)
-- [许可证](#许可证)
-
----
-
-## 功能
-
-### 规范化模型返回文本的结构
-
-Radeon 的响应体与流式分片都存在一个容易致错的形态：思考内容的字段名是 `reasoning`，
-但同一份数据里还带一个 `reasoning_content` 占位，且占位值是 `null` 而不是空字符串。
-按字段名直读会取到 `null`，思考内容静默丢失，**全程不产生任何报错**。
-
-本配置接的是 DSH 既有的字段选择逻辑——取第一个「值为非空字符串」的思考字段。
-`null` 的类型不是字符串，于是被自然跳过，正确落到 `reasoning`。经此规范化：
-
-| 源字段 | 规范化后的结构 |
-| --- | --- |
-| `delta.content` / `message.content` | 回答 → `text` 内容块 |
-| `delta.reasoning` / `message.reasoning` | 思考 → `reasoning` 内容块 |
-| `delta.reasoning_content: null` | 跳过，不产生空块 |
-
-思考与回答成为并列的两类内容块，在界面上分区呈现，而不是把思考混进正文。
-
-### 桥接模型思考方式回传
-
-思考不只是「取回来」，还必须能「送回去」——多轮对话中 DSH 会把上一轮的助手消息
-连同思考内容一起回传，否则多轮上下文会断裂。
-
-- **流式产出**：思考以 `reasoning-delta` 分片实时送达界面，不必等回答生成完毕；
-- **对称回传**：回放时使用**读取时所用的同一个字段名**（助手消息上的 `reasoning`），
-  而非另换一个字段名，避免读取与回传不对称导致多轮请求被拒；
-- **强度可选**：思考强度按模型逐个声明，而非全局统一。接受 `none` 的模型可关闭思考，
-  不接受的模型则不提供该档位，而非提供一个会报错的选项；
-- **用量归集**：思考 token 计入 `reasoning_tokens`，与回答 token 一并进入用量统计。
-
-实测确认：Radeon 的 `usage` 在顶层与 `completion_tokens_details` 两处都回报
-`reasoning_tokens` 且数值一致，DSH 读取后者即可正常计量。
-
-### 其他
-
-- 8 个对话模型全部可选，思考档位按模型独立声明
-- 视觉模型支持图片输入
-- 限流退避遵循服务端 `Retry-After`
-- 附带离线校验、回归测试与档位实测工具
-
----
-
-## 环境要求
-
-| 项 | 要求 | 说明 |
-| --- | --- | --- |
-| DSH | `>=0.2.0-rc.1`（含预发布，无上界） | 由 `peerDependencies` 声明范围，低于下界会被安装器拒绝；上界不写，DSH 升大版本不需要插件跟着重发（见[版本闸门](#版本闸门)） |
-| Node.js | `>=22` | 与 `package.json` 的 `engines.node` 一致；仅运行 `scripts/` 与 `test/` 下的脚本时需要 |
-| bash | 任意 | 仅 `scripts/radeon-api.sh` 需要 |
-| 操作系统 | macOS | `scripts/validate-config.mjs` 按 DSH 桌面版应用包的绝对路径加载校验用的 schema，路径为 `/Applications/DSH Desktop.app/Contents/Resources/app/node_modules`。其余脚本与系统无关 |
-
-> 配置文件本身（`provider/radeon-cloud.yml`）是纯 YAML，不依赖上述任何运行时。
-
----
+**没生效怎么办** —— 插件不会静默消失：定义失效时它直接让启动失败并写明原因，逐条处置见[归属与删除](#归属与删除)。想核验真正生效的配置，用 `dsh --profile <profile> --dump-config`（`desktop` profile 例外，由桌面应用独占管理）。
 
 ## 安装
 
-四种方式，任选其一。**装完都要重启 DSH**（原因见[快速上手](#快速上手)第 2 步）：
-定义由插件自带的补丁层声明，不写入你的 profile，重启后即生效，没有其它后置步骤。
-
-### 方式一：DSH 插件管理器（推荐）
-
-桌面版：应用左侧「插件」页 → 「添加插件」→ 输入包名或本地目录路径。
-
-命令行：`dsh plugin --profile <profile> …` 会把参数**原样转发**给 profile 目录里的 pnpm，
-因此 pnpm 支持的写法它都支持：
+用 DSH 插件命令从 npm 安装本包：
 
 ```bash
 dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher
 dsh plugin --profile <profile> remove @zhz8888/dsh-radeon-cloud-patcher   # 卸载
 ```
 
-装完 `dsh.profile.bundles` 会自动多出本包名——插件管理器按各包的 `dsh.bundle` 声明维护它，
-不必手改 profile 清单。
-
-> **桌面版的 `desktop` profile 由应用独占管理**：在普通终端里执行
-> `dsh plugin --profile desktop …` 会被拒绝（`profile "desktop" is managed exclusively by
-> the Electron application`）。两条正路：用应用内的插件页安装，或在应用右上角
-> 「打开 DSH 终端」里执行同样的命令。`web` / `tui` / `headless` 等 profile 不受此限。
->
-> 若你的源上还没有这个包（pnpm 报 404），用方式三装同一个包。
-
-### 方式二：从 npm 源安装
-
-方式一走的就是 npm registry；换源只需给 pnpm 传参，或写进 profile 自己的 `.npmrc`：
+命令行参数会**原样转发**给 profile 目录里的 pnpm，因此换源、指定版本按 pnpm 语法写即可：
 
 ```bash
-# 单次指定镜像源
-dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher \
-  --registry https://registry.npmmirror.com
-
-# 或给这个 profile 固定源（.npmrc 是 pnpm 自己的配置文件）
-printf 'registry=https://registry.npmmirror.com\n' >> ~/.dsh/profiles/<profile>/.npmrc
-
-# 指定版本或范围（pnpm 语法）
+dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher --registry https://registry.npmmirror.com
 dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher@<版本>
 ```
 
-> 本包的 tarball 里只有插件自己的源码、定义与脚本（不含 `test/` 与 `docs/`），
-> **没有安装期构建脚本**，因此换源、离线镜像、内网私服都不会碰到 pnpm 的
-> `allowBuilds` 授权那一步。
-
-### 方式三：从源码 / GitHub 安装
-
-三种源码形态都直接可用，原因同上：本项目零运行时依赖、没有构建步骤。
-
-```bash
-git clone https://github.com/zhz8888/dsh-radeon-cloud-patcher.git
-
-# ① 本地目录：pnpm 做 link，仓库里改了代码重启 DSH 即生效（开发本插件时最省事）
-dsh plugin --profile <profile> add /绝对路径/dsh-radeon-cloud-patcher
-
-# ② git 依赖：直接装公开仓库
-dsh plugin --profile <profile> add github:zhz8888/dsh-radeon-cloud-patcher
-
-# ③ 本地 tarball：适合内网分发（npm pack 在仓库目录里执行）
-npm pack
-dsh plugin --profile <profile> add ./zhz8888-dsh-radeon-cloud-patcher-<版本>.tgz
-```
-
-> DSH 对「装 git 依赖」有一句提醒：带 `prepare` 脚本的插件会在安装期构建，
-> 而 pnpm 默认拦住构建脚本，需要先在 profile 的 `pnpm-workspace.yaml` 里追加
-> `allowBuilds` 才能装上。**本插件不属于这种情况**——它没有任何安装期脚本。
-
-### 方式四：手工改 profile 清单
-
-不用插件管理器时：
-
-1. 在 profile 的 `package.json` 里把本包加进 `dependencies`；
-2. 把包名追加进 `dsh.profile.bundles`（顺序即补丁层顺序，放在 `@deepseek-ai/dsh-base`
-   与 `@deepseek-ai/dsh-web-app` 之后即可）；
-3. 执行 `dsh plugin --profile <profile> install` 安装依赖。
+> 桌面版的 `desktop` profile 由应用独占管理，终端里执行 `dsh plugin --profile desktop …` 会被拒绝；改用应用内的插件页，或在应用右上角「打开 DSH 终端」里执行。
+>
+> 本包的 tarball 只有插件源码、定义与脚本，**没有安装期构建脚本**，不会碰到 pnpm 的 `allowBuilds` 授权那一步。
 
 ### 版本闸门
 
-本包的 DSH 兼容范围是 **`>=0.2.0-rc.1`——只有下界，没有上界**，
-三处声明逐字一致（`peerDependencies`、`engines.dsh`、`dsh.compatibility.dsh`，
-由 `pnpm test:manifest` 断言）：
-
-- DSH 安装器读的是 `peerDependencies`：运行时版本低于下界 → **直接拒绝安装**，
-  不会出现「装上了但思考功能失效」；
-- **上界故意不写**：写死上界意味着 DSH 每升一个大版本都要重发一版插件去放宽范围，
-  代价大于收益。换来的代价是失去「未来版本被挡住」这层保护——改由插件自己的
-  响亮失败兜底（定义校验、id 归属判定、启动收尾核验路由是否注册，
-  见[归属与删除](#归属与删除)）；
-- `@deepseek-ai/cordis` 同理放宽为 `>=4.0.2`：它**不参与**安装闸门（判定只看
-  `@deepseek-ai/dsh*` 开头的包），但它是 pnpm 的 peer，写死上界同样会在它升大版本时
-  把安装卡住。
-
-> **预发布的一个细节**：node-semver 规定，带预发布标签的版本只有在范围里存在
-> 「元组相同、且自身也带预发布标签」的比较符时才被放行。
-> `>=0.2.0-rc.1` 因此只覆盖 `0.2.0` 这一元组的预发布（`0.2.0-rc.2` ✓）；
-> `0.2.1-alpha.1`、`0.3.0-beta.1` 这类**新元组的预发布**在 npm/pnpm 的默认规则下
-> 不被放行（DSH 自己的闸门带 `includePrerelease`，会放行——两者判定不一致时，
-> 失败的是 pnpm 那一步）。真遇到时二选一：
->
-> ```bash
-> # ① 给该元组补一条分支，写回范围（例如到 0.2.1 的预发布）
-> #    ">=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0"
->
-> # ② 或让 pnpm 放宽 peer 校验（参数照样原样转发）
-> dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher \
->   --config.strict-peer-dependencies=false
-> ```
->
-> 稳定版（`0.2.0`、`0.2.1`、`0.3.0`、`1.0.0`…）不受这个细节影响，一律放行。
+DSH 兼容范围 **`>=0.2.0-rc.1`，只有下界、没有上界**，三处声明逐字一致（`peerDependencies`、`engines.dsh`、`dsh.compatibility.dsh`）。DSH 安装器读的是 `peerDependencies`：运行时版本低于下界会被**直接拒绝安装**，不会出现「装上了但功能失效」。上界不写，意味着 DSH 升大版本不必重发插件，代价是失去「未来版本被挡住」这层保护——由插件启动时的响亮失败兜底。
 
----
+> 预发布细节：`>=0.2.0-rc.1` 只覆盖 `0.2.0` 这一元组的预发布，`0.2.1-alpha.1` 这类新元组的预发布会卡在 pnpm 那一步（DSH 闸门带 `includePrerelease`，会放行）。真遇到时给该元组补一条范围分支，或加 `--config.strict-peer-dependencies=false`。
 
 ## 使用
 
 ### 1. 配置 API 密钥
 
-密钥从 [AMD Radeon Cloud 文档](https://amd-aim.github.io/radeon-cloud-docs/) 里的入口申请
-（本项目只覆盖 Public Free Model APIs 的共享端点）。拿到 `rc-…` 之后二选一：
+密钥从 [AMD Radeon Cloud 文档](https://amd-aim.github.io/radeon-cloud-docs/) 的入口申请（本项目只覆盖 Public Free Model APIs 共享端点）。
 
-**方式一：设置页（推荐给日常使用）**
+- **设置页（推荐）**：「设置 → 模型」→ Radeon Cloud →「编辑」→ 粘贴 `rc-…` →「保存」。密钥写进本机凭据存储 `~/.dsh/.credentials.yaml` 的 `RADEON_CLOUD_API_KEY` 条目，明文不落配置文件、界面不回显。仓库脚本读的是同一个条目。
+- **环境变量**（不落盘，适合临时试用与 CI）：`RADEON_CLOUD_API_KEY=rc-你的密钥 dsh --profile <profile>`。凭据服务按「进程环境 → 凭据存储 → `.env` → `$DSH_HOME/.env`」依次查找，环境变量优先级最高。
 
-左下角「账号菜单 → 设置 → 模型」→ Radeon Cloud 行 →「编辑」→ 在「API 密钥」里粘贴
-`rc-…` →「保存」。保存成功后该行右侧出现**绿点**（悬停显示「API 密钥已配置」；
-没配密钥时是红点，提示「API 密钥缺失」）。
-
-密钥写进本机凭据存储 `~/.dsh/.credentials.yaml` 的 `RADEON_CLOUD_API_KEY` 条目，
-明文不落配置文件、界面不回显；要换密钥就再次「编辑」并输入新值
-（输入框会提示「已配置——输入新值可替换」）。`scripts/` 下的脚本读的是同一个条目，
-因此在设置页填过一次，脚本也就不用再配了。
-
-**方式二：环境变量（不落盘，适合临时试用与 CI）**
-
-```bash
-export RADEON_CLOUD_API_KEY=rc-你的密钥
-```
-
-凭据服务按「**继承的进程环境** → 插件写入的凭据存储 → 当前目录 `.env` → `$DSH_HOME/.env`」
-依次查找，环境变量优先级最高，一次性的写法也有效：
-
-```bash
-RADEON_CLOUD_API_KEY=rc-你的密钥 dsh --profile <profile>
-```
-
-> 注意名字：**插件运行时**读的是 `RADEON_CLOUD_API_KEY`（即 provider 定义里的
-> `apiKeyEnv`），而**仓库脚本**用的是 `RADEON_API_KEY`。两者互不影响，
-> 脚本那一套见下面的表格。
+> **插件运行时**读的是 `RADEON_CLOUD_API_KEY`（定义里的 `apiKeyEnv`），**仓库脚本**用的是 `RADEON_API_KEY`，两者互不影响。
 
 ### 2. 选模型与思考档位
 
-对话输入框下方点模型选择器 → 选 Radeon Cloud 的模型 → 再选「推理等级」，
-那就是思考档位。档位按模型逐个声明（见[可用模型](#可用模型)）：
-GLM 不接受 `none`，因此没有关闭档位；`MiniCPM5-2B` 不是推理模型，
-不会出现档位下拉。选了服务端不接受的档位是**硬失败**（400 / 422），不会静默降级。
+输入框下方的模型选择器里选 Radeon 的模型，再选「推理等级」就是思考档位（按模型逐个声明，见[可用模型](#可用模型)）。MiniCPM-V-4.7-1B 与 MiniCPM-V-4.7-35B-A3B 不接受 `none`，没有关闭档位；`MiniCPM5-2B` 非推理模型，不出现档位下拉。选了服务端不接受的档位是**硬失败**（400/422），不会静默降级。
 
 ### 3. 图片输入
 
-支持图片：DeepSeek-V4.1-Flash、DeepSeek-V4-Flash-Vision-Exp、MiMo-V2.6-Flash、
-Qwen3.8-27B、Qwen3.8-Flash-Next。只收文本：DeepSeek-V4-Flash、GLM-5.3-Flash、MiniCPM5-2B。
+支持图片：DeepSeek-V4.1-Flash、Gemma-4-31B-IT、MiMo-V2.6-Flash、MiniCPM-V-4.7-1B、MiniCPM-V-4.7-35B-A3B、Qwen3.8-27B、Qwen3.8-Flash-Next。只收文本：DeepSeek-V4-Flash、GLM-5.3-Flash、MiniCPM5-2B。
 
 ### 4. 升级与卸载
 
 ```bash
 dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher@latest  # 升级
-dsh plugin --profile <profile> remove @zhz8888/dsh-radeon-cloud-patcher      # 卸载
+dsh plugin --profile <profile> remove @zhz8888/dsh-radeon-cloud-patcher      # 卸载 = 删除供应商
 ```
 
-升级不需要额外动作：定义由插件层声明，装上新版本重启即生效
-（在市场里升级同样要重启，原因与安装一致）。
-**卸载即删除供应商**——插件层消失，provider 与设置页那一行一起消失。
-
-> 例外：如果你曾用 `pnpm install:profile` 把定义合并进 profile（见[归属与删除](#归属与删除)），
-> profile 里那份副本会**盖住**插件层的新定义——升级后要么重跑一次
-> `pnpm install:profile`，要么删掉那份副本，让插件独占管理。
+升级后重启即生效，不需要额外动作。例外：若你曾用 `pnpm install:profile` 把定义合并进 profile（见[归属与删除](#归属与删除)），那份副本会盖住插件层的新定义，升级后要么重跑一次，要么删掉副本让插件独占管理。
 
-### 5. 仓库脚本用的环境变量
+### 5. 仓库脚本的环境变量
 
-下面这些只影响仓库里的 `scripts/`（`radeon-api.sh`、`probe-efforts.mjs`），
-与插件运行时无关：
+只影响 `scripts/`（`radeon-api.sh` / `radeon-api.ps1`、`probe-efforts.mjs`），与插件运行时无关：
 
 | 变量 | 作用 | 默认值 |
 | --- | --- | --- |
 | `RADEON_API_KEY` | 脚本用的密钥字面值，优先级高于凭据文件 | 无 |
-| `RADEON_KEY_REF` | 脚本从凭据文件读取时用的条目名 | `RADEON_CLOUD_API_KEY` |
+| `RADEON_KEY_REF` | 从凭据文件读取时用的条目名 | `RADEON_CLOUD_API_KEY` |
 | `RADEON_BASE` | 端点基础 URL，可指向独占端点 | `https://developer.amd.com.cn/radeon/api/v1` |
 | `DSH_HOME` | DSH 数据目录，凭据文件据此定位 | `~/.dsh` |
 
-> 密钥在脚本中只存在于进程变量与 curl 请求头，不写盘、不打印、不出现在输出里。
-> 但 shell 历史记录仍会留下 `export RADEON_API_KEY=...` 这一行，请自行注意。
-
----
-
-## 归属与删除
-
-本插件要求 `radeon-cloud` 这个 id **由它独占**，因此：
-
-- 设置页那一行**不会出现「删除」按钮**。DSH 的判据是「该 provider 路径存在于用户层、
-  且不存在于 base 层」——定义写在插件的 bundle 层，base 层永远有它，按钮因此永不渲染；
-- **删除供应商 = 卸载插件**。卸载后插件层消失，provider 随之消失。
-  若你曾用 `pnpm install:profile` 把定义合并进 profile，profile 里会留下一份副本
-  （那份副本的所有权归你，卸载后设置页里也会重新出现删除按钮，可自行清理）；
-- **「自定义」标签**：DSH 对**任何不在内置模型目录里的 provider** 硬编码了这个标记
-  （`dsh-llm-pi-ai` 的 `declared: !catalog.has(provider)`），配置层面无从去掉。
-  本插件随包带了一个极小的客户端补丁（`client/client.js`），用一条 CSS 规则把
-  **本 provider 那一行**的标签隐藏掉：
-
-  ```css
-  li:has(button[aria-label*="(radeon-cloud)"]) span[class*="rowTag"] { display: none !important }
-  ```
-
-  代价说清楚：它依赖 DSH 的 DOM 结构与类名片段，DSH 改版后可能静默失效——
-  标签重新出现，功能不受影响。
-
-### 定义归谁管：启动时的判定
-
-DSH 的非 insert 补丁是**整体替换**：`llm-pi-ai` 的 config 只要在 profile 里出现过，
-就会整份盖掉插件层的定义。插件启动时静态读 profile / home / 命令行 overlay 三层，
-判定这个 id 现在由谁说了算：
-
-| 情况 | 结果 |
-| --- | --- |
-| 没人碰过 `llm-pi-ai` 的 config | 插件层的定义生效，正常启动 |
-| profile 里有一份**与本插件一致**的同 id 声明 | 放行，并提示它会在卸载后残留（通常是你在设置页保存过一次、被物化出的副本） |
-| profile 里有一份**与之不一致**的同 id 声明 | **启动失败**：报「provider id 冲突」，并指名第一处差异字段 |
-| profile 给 `llm-pi-ai` 写了 config 却没有本 provider | **启动失败**：报「定义未生效」，并打印可直接执行的合并命令 |
-| 那一层的 config 是 `!!js` 表达式，或本次运行读不到 profile 目录 | 跳过判定并告警——静态判断不了，不等于失败；真正生效的是哪一份以 `dsh --profile <profile> --dump-config` 为准 |
-
-后两种是**失败 + 原因**，而不是静默接管或静默消失——这是本项目的取舍：id 冲突要响亮。
-处置方式（按键合并、`--force`、输出示例）见[已知限制](#6-与用户自有-provider-共存)。
-
-> 想彻底消除标签、不留 DOM 依赖，只能让插件自己注册 provider 路由，也就意味着自己实现
-> 传输、思考解析与用量计量。本项目定位是「薄壳 + 由 DSH 自带的 pi-ai 承载」，
-> 因此选择了 CSS 隐藏这条路。
-
----
-
-## 项目结构
-
-```
-dsh-radeon-cloud-patcher/
-├── README.md                                  本文件
-├── AGENTS.md                                  智能体与协作者指引
-├── LICENSE                                    MIT 许可证
-├── package.json                               插件包清单（版本闸门、导出、客户端声明、脚本）
-├── cordis.plugin.patch.yml                    bundle 补丁：provider 定义 + 本插件行
-├── pnpm-workspace.yaml                        本仓库的安装期构建授权（不影响用户安装）
-├── pnpm-lock.yaml                             依赖锁文件
-├── .gitignore
-│
-├── provider/                                  配置本体
-│   └── radeon-cloud.yml                       provider 定义的唯一真源
-│
-├── client/                                    客户端补丁
-│   └── client.js                              隐藏本行的「自定义」标签（DSH 客户端模块格式，非 ESM）
-│
-├── src/                                       插件实现（薄壳，不含 provider 逻辑）
-│   ├── index.js                               插件入口：启动校验、所有权判定、收尾核验
-│   ├── ownership.js                           所有权判定的纯函数（四种归属结局 + dynamic 哨兵、差异定位）
-│   ├── merge.js                               键级合并的纯函数（补救路径使用）
-│   ├── patch-text.js                          文本级合并，保留用户注释与格式
-│   ├── validate.js                            定义的结构校验
-│   └── yaml.js                                定位 YAML 解析器
-│
-├── scripts/                                   运维与校验工具
-│   ├── sync-bundle-patch.mjs                  把定义真源渲染进补丁的生成区块
-│   ├── apply-to-profile.mjs                   补救路径：按键合并进 profile（冲突时拒绝覆盖）
-│   ├── validate-config.mjs                    用 llm-pi-ai 真实 schema 校验定义
-│   ├── probe-efforts.mjs                      实测逐模型 reasoning_effort 档位表
-│   └── radeon-api.sh                          API 调用助手（密钥取自环境变量或凭据存储）
-│
-├── test/                                      离线测试（自研 runner，无测试框架）
-│   ├── *.test.mjs                             清单不变式、合并语义、文本级编辑、
-│   │                                          所有权判定、启动看护、补丁与客户端一致性
-│   ├── verify-reasoning.mjs                   思考文本取回的回归测试
-│   └── fixtures/stream-reasoning.sse          实测抓取的真实流
-│
-└── docs/                                      技术文档
-    └── market-submission.md                   插件市场投稿与 npm 发布说明
-```
-
-> 插件壳只做四件事：**分发**（npm 包，可被插件市场安装）、**声明**（provider 定义写在
-> 自带的补丁层里，profile 只读不改）、**版本闸门**（版本不匹配直接拒装）、
-> **看护**（启动时校验定义、判定 id 归属，不该继续就让插件启动失败并说明原因）。
-> 实际的传输、思考字段解析、多轮回传、用量计量仍全部由 DSH 自带的 `llm-pi-ai` 承担。
-
----
-
-## 常用命令
-
-```bash
-# 全量测试（合并语义、所有权判定、启动看护、补丁一致性、思考字段取回）
-pnpm test
-
-# 只跑启动看护（四种归属结局 + dynamic 跳过）与补丁一致性
-pnpm test:guard
-pnpm test:patch
-
-# 校验 provider 定义：结构校验 + llm-pi-ai 真实 schema 校验
-# 这是判断「字段在当前 DSH 版本里是否仍然有效」的那道校验，建议升级 DSH 后跑一次
-pnpm validate
-
-# 改完 provider/radeon-cloud.yml 后，把定义同步进补丁的生成区块
-pnpm sync:patch
-
-# 补救路径：把定义按键合并进 profile（冲突时拒绝覆盖，--force 才覆盖）
-pnpm install:profile:dry
-
-# 重新实测某个模型支持的思考档位
-pnpm probe --only Qwen3.8-27B
-
-# 拉取实时模型目录
-./scripts/radeon-api.sh GET /models
-```
-
----
+> 密钥只存在于进程变量与请求头，不写盘、不打印；但 shell 历史仍会留下 `export RADEON_API_KEY=...`（PowerShell 里是 `$env:RADEON_API_KEY = '...'`），请自行注意。
+>
+> 两个助手脚本的参数、环境变量与输出契约完全相同：POSIX / Git Bash 用 `./scripts/radeon-api.sh`，Windows 原生用 `./scripts/radeon-api.ps1`（需 PowerShell 7）。`pnpm probe` 在 Windows 上会自动走 `.ps1`。
 
 ## 可用模型
 
-> 采集日期：**2026-10-04**
+> 采集日期：**2026-11-09**
 
 | 模型 | 上下文 | 图片 | 思考档位 |
 | --- | --- | --- | --- |
 | DeepSeek-V4.1-Flash | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
 | DeepSeek-V4-Flash | 1,048,576 | ❌ | off/minimal/low/medium/high/xhigh/max |
-| DeepSeek-V4-Flash-Vision-Exp | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
 | MiMo-V2.6-Flash | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
+| Gemma-4-31B-IT | 262,144 | ✅ | off/minimal/low/medium/high/xhigh/max |
+| GLM-5.3-Flash | 262,144 | ❌ | off/minimal/low/medium/high/xhigh/max |
+| MiniCPM-V-4.7-1B | 262,144 | ✅ | low/medium/high |
+| MiniCPM-V-4.7-35B-A3B | 262,144 | ✅ | low/medium/high |
 | Qwen3.8-27B | 262,144 | ✅ | off/low/medium/xhigh |
 | Qwen3.8-Flash-Next | 262,144 | ✅ | off/low/medium/xhigh |
-| GLM-5.3-Flash | 262,144 | ❌ | low/medium/high |
 | MiniCPM5-2B | 131,072 | ❌ | （不返回分离思考，故不提供档位） |
 
-`off` 表示发送 `reasoning_effort: "none"` 关闭思考。
-**GLM-5.3-Flash 不接受 `none`**，因此没有关闭档位；Qwen 系靠 `none` 关闭，而**不传档位时仍会思考**（AMD 服务端行为）。
-
-> **档位表不在 API 里**（`GET /v1/models` 不返回该信息），只能实测。模型上下架会导致此表过期，
-> 请用 `pnpm probe` 复测后再更新 `provider/radeon-cloud.yml`。
->
-> `MinerU2.5-Pro` 未收录——它走独立的 `/v1/ocr` 端点，不是对话模型。
+`off` 表示发送 `reasoning_effort: "none"` 关闭思考；Qwen 系靠 `none` 关闭，**不传档位时仍会思考**（AMD 服务端行为）。档位表与厂商、模型名的相近程度无关：同为 MiniCPM 系，`MiniCPM-V-4.7-1B` 与 `MiniCPM-V-4.7-35B-A3B` 只接受 `low/medium/high`，`MiniCPM5-2B` 接受三档却不返回分离思考——**只能逐个实测**。
 
----
+> 档位表不在 API 里（`GET /v1/models` 不返回该信息），只能实测；模型上下架会让此表过期，用 `pnpm probe` 复测后再更新 `provider/radeon-cloud.yml`。目录里的 `Clef`、`d3`、`d3-flash` 与 `OmniVoice` 未收录——前三者的输出模态是 `decision`、上下文为 0，后者输出音频，都不是对话模型。
 
 ## 已知限制
 
-### 1. 思考与答案共用同一个 token 预算（最重要）
-
-Radeon 的 `max_tokens` 同时约束思考和最终回答。预算不足时**回答会变成空字符串**：
-
-| 配置 | finish_reason | content | reasoning |
-| --- | --- | --- | --- |
-| `effort=low`, `max_tokens=16` | `length` | **空** | 84 字符 |
-| `effort=low`, `max_tokens=120` | `length` | **空** | 584 字符 |
-| `effort=low`, `max_tokens=400` | `length` | **空** | 1717 字符 |
-| `effort=none`, `max_tokens=64` | `length` | 330 字符 ✅ | 0 |
-
-**应对**：配置里 `defaultMaxTokens` 已设为 `32768`（pi-ai 默认值），给思考留足余量。
-`max_tokens` 是上限而非计费项，实际按产出计费，调高不增加成本。
-
-若仍偶发空回答，把该会话的思考档位调低，或临时改用 `off`。
-
-### 2. `stop`（停止序列）不可用
-
-Radeon 网关按白名单重建请求体，`stop` 不在白名单内，会被**静默丢弃**。
-DSH 的 `dsh-llm-pi-ai` 会对此抛 `UNSUPPORTED_OPTION`，属于响亮失败，比静默失效好。
+1. **思考与回答共用同一个 token 预算**：Radeon 的 `max_tokens` 同时约束思考和回答，预算不足时**回答会变成空字符串**（实测 `effort=low`、`max_tokens` ≤ 400 时 `finish_reason=length` 而 content 全空）。配置里 `defaultMaxTokens` 已设为 `32768` 留足余量；`max_tokens` 是上限而非计费项，调高不增加成本。仍偶发空回答就调低该会话档位或临时改用 `off`。
+2. **`stop` 不可用**：网关按白名单重建请求体，`stop` 被静默丢弃，`dsh-llm-pi-ai` 会抛 `UNSUPPORTED_OPTION`（响亮失败，比静默失效好）。
+3. **部分模型不接受 `developer` 角色**：10 个模型中有 5 个拒绝（MiniCPM5-2B、MiniCPM-V-4.7-1B、MiniCPM-V-4.7-35B-A3B 报 422；Qwen 系两个报 400），已用 `compat.supportsDeveloperRole: false` 改走 `system`。
+4. **非法档位是硬失败**（400/422），不会自动降级；档位表来自实测，新增模型请先复测。
+5. **上游偶发故障**：出现过 `504` 被包装成 HTTP `500` + `code: upstream_error`，DSH 归为可重试的 `SERVER`，重试即可。
 
-### 3. 部分模型不接受 `developer` 角色
-
-DSH 默认对 OpenAI 兼容端点使用 `developer` 承载系统提示词，8 个模型中有 5 个会直接报
-`unknown role: developer`。已通过 `compat.supportsDeveloperRole: false` 关闭。
-
-### 4. 档位被拒是硬失败
-
-非法档位返回 `400`（Qwen 系）或 `422`（GLM 系），不会自动降级。
-配置里的档位表来自实测，如新增模型请先复测。
+## 归属与删除
 
-### 5. 上游偶发故障
+本插件要求 `radeon-cloud` 这个 id 由它独占：
 
-实测中出现过 `504 Gateway Timeout`，被包装为 HTTP `500` + `code: upstream_error`。
-DSH 将其归为可重试的 `SERVER`。偶发，重试即可。
+- 设置页那一行**不会出现「删除」按钮**——DSH 只在「该 provider 存在于用户层、且不存在于 base 层」时渲染它，而定义写在插件的 bundle 层。
+- **删除供应商 = 卸载插件**。若你曾用 `pnpm install:profile` 合并进 profile，那里会留下一份归你所有的副本（卸载后删除按钮会重新出现，可自行清理）。
+- **「自定义」标签**：DSH 对任何不在内置模型目录里的 provider 硬编码了这个标记，配置层面无从去掉。随包带的极小客户端补丁（`client/client.js`）用一条 CSS 规则隐藏**本 provider 那一行**的标签；它依赖 DSH 的 DOM 结构与类名片段，DSH 改版后可能静默失效——标签重新出现，功能不受影响。
 
-### 6. 与用户自有 provider 共存
+启动时插件会静态读 profile / home / 命令行 overlay 三层，判定这个 id 现在由谁说了算：
 
-provider 定义由插件的 bundle 层声明，插件**只读 profile、不写 profile**。
-DSH 的非 insert 补丁是整体替换，因此你自己写的 `llm-pi-ai` config 会整份盖掉插件层的定义：
-插件启动时会判定这件事，响亮失败并给出处置，而不是让 provider 无声消失
-（判据见[归属与删除](#归属与删除)）。
+| 情况 | 结果 |
+| --- | --- |
+| 没人碰过 `llm-pi-ai` 的 config | 插件层定义生效，正常启动 |
+| profile 里有一份**与本插件一致**的同 id 声明 | 放行，提示它会在卸载后残留（通常是设置页保存时物化出的副本） |
+| profile 里有一份**不一致**的同 id 声明 | **启动失败**：报 id 冲突，并指名第一处差异字段 |
+| profile 给 `llm-pi-ai` 写了 config 却没有本 provider | **启动失败**：报定义未生效，并打印可直接执行的合并命令 |
+| config 是 `!!js` 表达式，或读不到 profile 目录 | 跳过判定并告警，以 `--dump-config` 为准 |
 
-想与自有 provider 共存，就用补救命令做按键合并：
+后两种是**失败 + 原因**，而不是静默接管或静默消失。要与自有 provider 共存，用补救命令按键合并：
 
 ```bash
-# 在插件仓库里
 pnpm install:profile:dry   # 演练：打印改动与被保留的其它 provider
-pnpm install:profile       # 写入（自动备份，断言其余条目与同级键逐字未变）
-
-# 只装了插件、没有克隆仓库时，脚本在包里；启动失败信息会直接打印完整命令
-node ~/.dsh/profiles/<profile>/node_modules/@zhz8888/dsh-radeon-cloud-patcher/scripts/apply-to-profile.mjs \
-  ~/.dsh/profiles/<profile>/cordis.patch.yml
+pnpm install:profile       # 写入（自动备份，冲突时拒绝覆盖，--force 才覆盖）
 ```
 
-输出示例：
+只装了插件、没克隆仓库时，用包内脚本（启动失败信息会打印完整命令）：
+`node ~/.dsh/profiles/<profile>/node_modules/@zhz8888/dsh-radeon-cloud-patcher/scripts/apply-to-profile.mjs ~/.dsh/profiles/<profile>/cordis.patch.yml`
 
-```
-【写入】 ~/.dsh/profiles/desktop/cordis.patch.yml
-  新增 providers.radeon-cloud（8 个模型）
-  保留的其它 provider：my-corp-proxy, another-one
-  顶层条目 12 个，增减 0 个
-```
+合并粒度是键：只新增或替换 `providers.radeon-cloud`，你写的其它 provider、注释、缩进与键序原样保留（文本级编辑）。⚠️ **不要另写一条 `llm-pi-ai` 的非 insert 补丁**去改该行的其它字段——那会整体替换这一行，把 `providers` 一并带走。
 
-合并粒度是键：只新增或替换 `providers.radeon-cloud` 这一个键，你添加的其它 provider、
-你写的注释、缩进风格与键序都原样保留（文本级编辑，不重新序列化你的文件）。
-写入前会断言：除 `radeon-cloud` 外的同级 provider 键集合一致、`llm-pi-ai` 之外的顶层条目
-逐字符未变，任一不成立即中止且不落盘；已存在不一致的同 id 定义时**拒绝覆盖**并打印第一处
-差异，确认要覆盖再加 `--force`。
+## 兼容性
 
-另有一处要注意：**不要另写一条 `llm-pi-ai` 的非 insert 补丁**去改该行的其它字段——
-那会整体替换这一行，把 `providers` 一并带走。要改就只改你需要的那一个键。
+- 目标 DSH 版本：`>=0.2.0-rc.1`，无上界（三处声明一致）。
+- 收录的模型当前均为 `stability: experimental`，上游接口行为可能变，档位失效时先复测。
+- 仅覆盖 Public Free Model APIs（共享端点）；独占端点的基础 URL 每次实例重启都会变化，不在本项目范围内。
+- 客户端补丁依赖 DSH 的 DOM 结构，改版后可能静默失效。
 
----
+## 开发
 
-## 兼容性
+零运行时依赖，源码只用 Node 内置模块；测试为自研 runner，无测试框架。运行 `scripts/` 与 `test/` 需要 Node `>=22`；`pnpm validate` 需本机有可用的 DSH 安装（macOS 下按桌面版应用包路径加载 schema，可用 `DSH_MODULES` 覆盖）。要用 PowerShell 版助手或 `pnpm test:ps1` 的行为层，另需 PowerShell 7（`pwsh`）。
 
-- 目标 DSH 版本：`>=0.2.0-rc.1`，**无上界**（三处声明一致，见[版本闸门](#版本闸门)）
-- 收录的模型当前均为 `stability: experimental`——上游接口行为可能变，档位失效时先复测
-- 仅覆盖 Public Free Model APIs（共享端点）；独占端点的基础 URL 每次实例重启都会变化，不在本项目范围内
-- 客户端补丁依赖 DSH 的 DOM 结构，DSH 改版后可能静默失效（机制与代价见[归属与删除](#归属与删除)）
+```bash
+pnpm test                 # 全量离线测试（清单不变式 / 插件元信息 / 合并语义 / 所有权判定 / 启动看护 / 补丁一致性 / 思考取回）
+pnpm validate             # 用 llm-pi-ai 真实 schema 校验 provider 定义——升级 DSH 后必跑
+pnpm sync:patch           # 改完 provider/radeon-cloud.yml 后同步进补丁，否则定义漂移
+pnpm probe --only <模型>  # 重新实测思考档位
+./scripts/radeon-api.sh GET /models   # 拉取实时模型目录（POSIX / Git Bash）
+./scripts/radeon-api.ps1 GET /models  # 同上，PowerShell 7
+```
 
----
+架构约束、补丁层设计理由与发版流程见 [`AGENTS.md`](AGENTS.md) 与 [`docs/market-submission.md`](docs/market-submission.md)。
 
 ## 许可证
 
-本项目以 [MIT 许可证](https://github.com/zhz8888/dsh-radeon-cloud-patcher/blob/main/LICENSE) 开源。
-
-MIT 许可证允许你自由使用、复制、修改、合并、发布、分发、再许可及销售本项目的副本，
-唯一义务是在所有副本或实质性部分中保留版权声明与许可声明。
-
-本软件按「原样」提供，不附带任何形式的担保，包括但不限于对适销性、特定用途适用性
-及不侵权的担保；作者或版权持有人不对使用本软件产生的任何损害承担责任。
+本项目以 [MIT 许可证](https://github.com/zhz8888/dsh-radeon-cloud-patcher/blob/main/LICENSE) 开源。本软件按「原样」提供，不附带任何形式的担保。

package/cordis.plugin.patch.yml

@@ -49,7 +49,7 @@
         baseURL: https://developer.amd.com.cn/radeon/api/v1
         displayName: Radeon Cloud
 
-        # 默认思考档位。medium 在全部 8 个已收录模型上均被接受。
+        # 默认思考档位。medium 在全部 10 个已收录模型上均被接受。
         reasoning: medium
 
         # Radeon 的思考与答案共用同一个 max_tokens 预算，预算不足时 content
@@ -76,7 +76,9 @@
         # ── 协议兼容开关 ──────────────────────────────────────────────
         compat:
           # ★ 关键：DSH 默认对普通 OpenAI 兼容端点发送 developer 角色，
-          #   而 8 个模型中有 5 个直接拒绝（unknown role: developer）。
+          #   而 10 个模型中有 5 个直接拒绝——MiniCPM5-2B、MiniCPM-V-4.7-1B、
+          #   MiniCPM-V-4.7-35B-A3B 报 422 unknown role: developer，Qwen 系两个
+          #   报 400 Unexpected message role。
           supportsDeveloperRole: false
           supportsReasoningEffort: true
           # Radeon 的网关只按白名单转发字段，thinking_budget /
@@ -87,11 +89,14 @@
           thinkingFormat: openai
 
         # ── 模型目录 ──────────────────────────────────────────────────
-        # 共收录 8 个对话模型。目录接口里还有 MinerU2.5-Pro，但它的
-        # context_length 为 0、tools 为 false，走的是独立的 /v1/ocr
-        # 文档识别端点而非对话接口，故不收录。
+        # 共收录 10 个对话模型。目录接口里另有 Clef、d3、d3-flash 与 OmniVoice：
+        # 前三者的 output_modalities 是 decision、context_length 为 0，OmniVoice 的
+        # 输出是 audio，都不走对话接口，故不收录。
+        #
+        # 下面的分组按「档位表的形状」而非厂商划分——同一厂商的模型档位未必相同，
+        # 按厂商分组会把读者引向错误预期。
         models:
-          # ── DeepSeek 系：7 档全接受，`none` 可关闭思考 ──
+          # ── 全档接受：none 可关闭思考 ──
           - id: DeepSeek-V4.1-Flash
             name: DeepSeek-V4.1-Flash
             contextWindow: 1048576
@@ -118,8 +123,8 @@
               xhigh: xhigh
               max: max
 
-          - id: DeepSeek-V4-Flash-Vision-Exp
-            name: DeepSeek-V4-Flash-Vision-Exp
+          - id: MiMo-V2.6-Flash
+            name: MiMo-V2.6-Flash
             contextWindow: 1048576
             input: [text, image]
             reasoningEfforts:
@@ -131,9 +136,9 @@
               xhigh: xhigh
               max: max
 
-          - id: MiMo-V2.6-Flash
-            name: MiMo-V2.6-Flash
-            contextWindow: 1048576
+          - id: Gemma-4-31B-IT
+            name: Gemma-4-31B-IT
+            contextWindow: 262144
             input: [text, image]
             reasoningEfforts:
               off: none
@@ -144,6 +149,39 @@
               xhigh: xhigh
               max: max
 
+          - id: GLM-5.3-Flash
+            name: GLM-5.3-Flash
+            contextWindow: 262144
+            input: [text]
+            reasoningEfforts:
+              off: none
+              minimal: minimal
+              low: low
+              medium: medium
+              high: high
+              xhigh: xhigh
+              max: max
+
+          # ── 仅 low/medium/high：不接受 none/minimal/xhigh/max ──
+          # 不声明 off 键：这两个模型没有「关闭思考」的档位。
+          - id: MiniCPM-V-4.7-1B
+            name: MiniCPM-V-4.7-1B
+            contextWindow: 262144
+            input: [text, image]
+            reasoningEfforts:
+              low: low
+              medium: medium
+              high: high
+
+          - id: MiniCPM-V-4.7-35B-A3B
+            name: MiniCPM-V-4.7-35B-A3B
+            contextWindow: 262144
+            input: [text, image]
+            reasoningEfforts:
+              low: low
+              medium: medium
+              high: high
+
           # ── Qwen 系：无 minimal/max/high，仅 none/low/medium/xhigh ──
           # 这两个模型唯一能关闭思考的方式是 none；传入 high 会返回 400。
           - id: Qwen3.8-27B
@@ -166,20 +204,9 @@
               medium: medium
               xhigh: xhigh
 
-          # ── GLM 系：不接受 none/minimal/xhigh/max ──
-          # 不声明 off 键：该模型没有「关闭思考」的档位。
-          - id: GLM-5.3-Flash
-            name: GLM-5.3-Flash
-            contextWindow: 262144
-            input: [text]
-            reasoningEfforts:
-              low: low
-              medium: medium
-              high: high
-
           # MiniCPM5-2B 接受 low/medium/high，但不返回分离的思考内容
-          # （思考字段恒为空）。给出档位控件会误导用户，
-          # 故显式声明为非推理模型。
+          # （实测 reasoning 恒为空、reasoning_tokens 为 0）。
+          # 给出档位控件会误导用户，故显式声明为非推理模型。
           - id: MiniCPM5-2B
             name: MiniCPM5-2B
             contextWindow: 131072

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Radeon Cloud",
+    "description": "Unofficial Radeon Cloud provider: full reasoning-effort support, declared in the plugin's own patch layer with no profile writes."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Radeon Cloud 提供方",
+    "description": "非官方 Radeon Cloud 提供方：完整支持模型思考档位；provider 定义由插件自带的补丁层声明，不写用户 profile。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhz8888/dsh-radeon-cloud-patcher",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "为 DeepSeek Harness 接入 AMD Radeon Cloud，完整支持模型思考（reasoning）功能。provider 定义由插件自带的补丁层声明，交由 DSH 自带的 dsh-llm-pi-ai 承载，不修改 DSH 本体、不写用户 profile，也不自研适配器。",
   "keywords": [
     "amd",
@@ -34,6 +34,7 @@
     "./merge": "./src/merge.js",
     "./provider": "./provider/radeon-cloud.yml",
     "./client": "./client/client.js",
+    "./locale/*.json": "./locale/*.json",
     "./package.json": "./package.json"
   },
   "dsh": {
@@ -59,18 +60,21 @@
     "src",
     "client",
     "provider",
+    "locale",
     "scripts",
     "cordis.plugin.patch.yml",
     "LICENSE",
     "README.md"
   ],
   "scripts": {
-    "test": "node test/manifest.test.mjs && node test/merge.test.mjs && node test/patch-text.test.mjs && node test/ownership.test.mjs && node test/apply-guard.test.mjs && node test/patch-sync.test.mjs && node test/client-patch.test.mjs && node test/verify-reasoning.mjs",
+    "test": "node test/manifest.test.mjs && node test/plugin-meta.test.mjs && node test/merge.test.mjs && node test/patch-text.test.mjs && node test/ownership.test.mjs && node test/apply-guard.test.mjs && node test/patch-sync.test.mjs && node test/client-patch.test.mjs && node test/ps1-parity.test.mjs && node test/verify-reasoning.mjs",
     "test:manifest": "node test/manifest.test.mjs",
+    "test:meta": "node test/plugin-meta.test.mjs",
     "test:merge": "node test/merge.test.mjs && node test/patch-text.test.mjs && node test/ownership.test.mjs",
     "test:guard": "node test/apply-guard.test.mjs",
     "test:patch": "node test/patch-sync.test.mjs && node test/client-patch.test.mjs",
     "test:reasoning": "node test/verify-reasoning.mjs",
+    "test:ps1": "node test/ps1-parity.test.mjs",
     "sync:patch": "node scripts/sync-bundle-patch.mjs",
     "validate": "node scripts/validate-config.mjs",
     "probe": "node scripts/probe-efforts.mjs",

package/provider/radeon-cloud.yml

@@ -17,7 +17,7 @@ api: openai-completions
 baseURL: https://developer.amd.com.cn/radeon/api/v1
 displayName: Radeon Cloud
 
-# 默认思考档位。medium 在全部 8 个已收录模型上均被接受。
+# 默认思考档位。medium 在全部 10 个已收录模型上均被接受。
 reasoning: medium
 
 # Radeon 的思考与答案共用同一个 max_tokens 预算，预算不足时 content
@@ -44,7 +44,9 @@ retryPolicy:
 # ── 协议兼容开关 ──────────────────────────────────────────────
 compat:
   # ★ 关键：DSH 默认对普通 OpenAI 兼容端点发送 developer 角色，
-  #   而 8 个模型中有 5 个直接拒绝（unknown role: developer）。
+  #   而 10 个模型中有 5 个直接拒绝——MiniCPM5-2B、MiniCPM-V-4.7-1B、
+  #   MiniCPM-V-4.7-35B-A3B 报 422 unknown role: developer，Qwen 系两个
+  #   报 400 Unexpected message role。
   supportsDeveloperRole: false
   supportsReasoningEffort: true
   # Radeon 的网关只按白名单转发字段，thinking_budget /
@@ -55,11 +57,14 @@ compat:
   thinkingFormat: openai
 
 # ── 模型目录 ──────────────────────────────────────────────────
-# 共收录 8 个对话模型。目录接口里还有 MinerU2.5-Pro，但它的
-# context_length 为 0、tools 为 false，走的是独立的 /v1/ocr
-# 文档识别端点而非对话接口，故不收录。
+# 共收录 10 个对话模型。目录接口里另有 Clef、d3、d3-flash 与 OmniVoice：
+# 前三者的 output_modalities 是 decision、context_length 为 0，OmniVoice 的
+# 输出是 audio，都不走对话接口，故不收录。
+#
+# 下面的分组按「档位表的形状」而非厂商划分——同一厂商的模型档位未必相同，
+# 按厂商分组会把读者引向错误预期。
 models:
-  # ── DeepSeek 系：7 档全接受，`none` 可关闭思考 ──
+  # ── 全档接受：none 可关闭思考 ──
   - id: DeepSeek-V4.1-Flash
     name: DeepSeek-V4.1-Flash
     contextWindow: 1048576
@@ -86,8 +91,8 @@ models:
       xhigh: xhigh
       max: max
 
-  - id: DeepSeek-V4-Flash-Vision-Exp
-    name: DeepSeek-V4-Flash-Vision-Exp
+  - id: MiMo-V2.6-Flash
+    name: MiMo-V2.6-Flash
     contextWindow: 1048576
     input: [text, image]
     reasoningEfforts:
@@ -99,9 +104,9 @@ models:
       xhigh: xhigh
       max: max
 
-  - id: MiMo-V2.6-Flash
-    name: MiMo-V2.6-Flash
-    contextWindow: 1048576
+  - id: Gemma-4-31B-IT
+    name: Gemma-4-31B-IT
+    contextWindow: 262144
     input: [text, image]
     reasoningEfforts:
       off: none
@@ -112,6 +117,39 @@ models:
       xhigh: xhigh
       max: max
 
+  - id: GLM-5.3-Flash
+    name: GLM-5.3-Flash
+    contextWindow: 262144
+    input: [text]
+    reasoningEfforts:
+      off: none
+      minimal: minimal
+      low: low
+      medium: medium
+      high: high
+      xhigh: xhigh
+      max: max
+
+  # ── 仅 low/medium/high：不接受 none/minimal/xhigh/max ──
+  # 不声明 off 键：这两个模型没有「关闭思考」的档位。
+  - id: MiniCPM-V-4.7-1B
+    name: MiniCPM-V-4.7-1B
+    contextWindow: 262144
+    input: [text, image]
+    reasoningEfforts:
+      low: low
+      medium: medium
+      high: high
+
+  - id: MiniCPM-V-4.7-35B-A3B
+    name: MiniCPM-V-4.7-35B-A3B
+    contextWindow: 262144
+    input: [text, image]
+    reasoningEfforts:
+      low: low
+      medium: medium
+      high: high
+
   # ── Qwen 系：无 minimal/max/high，仅 none/low/medium/xhigh ──
   # 这两个模型唯一能关闭思考的方式是 none；传入 high 会返回 400。
   - id: Qwen3.8-27B
@@ -134,22 +172,11 @@ models:
       medium: medium
       xhigh: xhigh
 
-  # ── GLM 系：不接受 none/minimal/xhigh/max ──
-  # 不声明 off 键：该模型没有「关闭思考」的档位。
-  - id: GLM-5.3-Flash
-    name: GLM-5.3-Flash
-    contextWindow: 262144
-    input: [text]
-    reasoningEfforts:
-      low: low
-      medium: medium
-      high: high
-
   # MiniCPM5-2B 接受 low/medium/high，但不返回分离的思考内容
-  # （思考字段恒为空）。给出档位控件会误导用户，
-  # 故显式声明为非推理模型。
+  # （实测 reasoning 恒为空、reasoning_tokens 为 0）。
+  # 给出档位控件会误导用户，故显式声明为非推理模型。
   - id: MiniCPM5-2B
     name: MiniCPM5-2B
     contextWindow: 131072
     input: [text]
-    reasoningEfforts: false
+    reasoningEfforts: false

package/scripts/probe-efforts.mjs

@@ -9,11 +9,14 @@
  *
  * 探测手法：对每个「模型 × 档位」组合发一次 max_tokens 为 1 的极小请求，
  * 只看 HTTP 状态码，200 即视为接受，不关心回复内容；这样单次探测的产出
- * token 成本可忽略。按每分钟 20 次的账户限流节流到约 19 次/分钟。
+ * token 成本可忽略。
  *
- * 注意：429 表示触发了限流，不代表该档位被拒绝，遇到时应单独复测确认。
+ * 只有 200 才是「接受」；400 与 422 才是「拒绝」。429（限流）与 5xx
+ * （上游偶发故障，README 记录过 504 被包装成 500）都不构成结论，本脚本会
+ * 自动重测，避免把「测不出来」写成档位表里的一个 ✗——那会让用户在选择器里
+ * 少一个本来可用的档位，且全程不产生任何报错。
  *
- * 用法: node scripts/probe-efforts.mjs [--only ModelId] [--tiers a,b,c]
+ * 用法: node scripts/probe-efforts.mjs [--only ModelId] [--tiers a,b,c] [--interval 毫秒]
  */
 import { execFile } from 'node:child_process'
 import { promisify } from 'node:util'
@@ -24,8 +27,15 @@ import { fileURLToPath } from 'node:url'
 const execFileAsync = promisify(execFile)
 /** 本脚本文件所在目录。 */
 const HERE = path.dirname(fileURLToPath(import.meta.url))
-/** 发起请求的可执行助手脚本路径。 */
-const HELPER = path.join(HERE, 'radeon-api.sh')
+/** 发起请求的助手脚本。
+ *
+ * Windows 上没有 bash，改用同目录的 PowerShell 7 版本：两个脚本遵守同一份
+ * 输出契约（响应体走 stdout，状态码走 stderr 的 ---HTTP <code>--- 标记），
+ * 所以上面对 stderr 的解析逻辑不用分平台。
+ */
+const HELPER = process.platform === 'win32'
+  ? { cmd: 'pwsh', prefix: ['-NoProfile', '-File', path.join(HERE, 'radeon-api.ps1')] }
+  : { cmd: path.join(HERE, 'radeon-api.sh'), prefix: [] }
 
 /** 待探测的候选档位全集。 */
 const ALL_TIERS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']
@@ -48,8 +58,22 @@ const only = argOf('--only')
 /** 只探测这些档位，逗号分隔；未指定时用 ALL_TIERS。 */
 const tiers = (argOf('--tiers') ?? ALL_TIERS.join(',')).split(',')
 
-/** 相邻两次请求之间的最小间隔，取 3100 毫秒约为每分钟 19 次。 */
-const MIN_INTERVAL_MS = 3100
+/** 相邻两次请求之间的默认最小间隔。
+ *
+ * 网关的账户限流是每分钟 20 次（响应头 x-ratelimit-limit-user-rpm）。原先取
+ * 3100 毫秒看似合规（≈19.4 次/分），但节流判据是「距上次请求满 3.1 秒」，
+ * 第 21 次请求会落在与第 1 次同一个滚动窗口内，实测必踩 429。取 4500 毫秒
+ * 把网关这一层躲开；上游自身仍会偶发限流，那由下面的重测兜住。 */
+const DEFAULT_INTERVAL_MS = 4500
+/** 相邻两次请求之间的最小间隔，可用 --interval 覆盖。 */
+const MIN_INTERVAL_MS = Number(argOf('--interval') ?? DEFAULT_INTERVAL_MS)
+/** 命中 429 后的冷却时长：服务端 Retry-After 为 60 秒，多留几秒余量。 */
+const RATE_LIMIT_COOLDOWN_MS = 65000
+/** 命中 5xx 后的重试间隔。上游偶发故障，等几秒再问通常就好了。 */
+const UPSTREAM_RETRY_DELAY_MS = 5000
+/** 单个「模型 × 档位」组合命中可重试错误后最多重测的次数。 */
+const MAX_RETRIES = 2
+
 /** 上一次请求发出的时间戳，用于计算需要等待多久。 */
 let lastAt = 0
 
@@ -73,6 +97,30 @@ async function throttle() {
  * @returns {Promise<{status: number, error?: string}>} HTTP 状态码；取不到时为 -1
  */
 async function call(model, effort) {
+  for (let attempt = 0; ; attempt += 1) {
+    const res = await once(model, effort)
+    // 429 是限流，5xx 是上游故障，两者都测不出该档位的真实结论。直接返回会把
+    // 「没测到」写成「不接受」，进而从档位表里删掉一个本来可用的档位，所以必须重测。
+    const delay = res.status === 429
+      ? RATE_LIMIT_COOLDOWN_MS
+      : res.status >= 500 ? UPSTREAM_RETRY_DELAY_MS : 0
+    if (delay === 0 || attempt >= MAX_RETRIES) return res
+    process.stderr.write(
+      `  ${model.padEnd(30)} ${effort.padEnd(9)} ${res.status} 非结论，`
+      + `${delay / 1000} 秒后重测（第 ${attempt + 1} 次）\n`,
+    )
+    await new Promise((r) => setTimeout(r, delay))
+  }
+}
+
+/**
+ * 发起一次探测请求，不做限流重试。
+ *
+ * @param {string} model 模型 id
+ * @param {string} effort reasoning_effort 取值
+ * @returns {Promise<{status: number, error?: string}>} HTTP 状态码；取不到时为 -1
+ */
+async function once(model, effort) {
   await throttle()
   // max_tokens 压到 1，让这次请求只为确认档位是否被接受，不产生实际产出。
   const body = JSON.stringify({
@@ -83,12 +131,21 @@ async function call(model, effort) {
     stream: false,
   })
   try {
-    const { stderr } = await execFileAsync(HELPER, ['POST', '/chat/completions', body], {
-      maxBuffer: 8 * 1024 * 1024,
-    })
+    const { stderr } = await execFileAsync(
+      HELPER.cmd,
+      [...HELPER.prefix, 'POST', '/chat/completions', body],
+      { maxBuffer: 8 * 1024 * 1024 },
+    )
     const code = /---HTTP (\d+)---/.exec(stderr)?.[1]
     return { status: Number(code) }
   } catch (err) {
+    // pwsh 没装时 execFile 直接 ENOENT，此后每个组合都会得到 -1。
+    // 与其把「没测到」写进档位表，不如当场停下并说明怎么装。
+    if (err.code === 'ENOENT') {
+      console.error(`✗ 找不到 ${HELPER.cmd}。Windows 上本脚本通过 scripts/radeon-api.ps1 发请求，`
+        + '请先安装 PowerShell 7，或改用 Git Bash 直接调用 scripts/radeon-api.sh。')
+      process.exit(1)
+    }
     const code = /---HTTP (\d+)---/.exec(err.stderr ?? '')?.[1]
     return { status: code ? Number(code) : -1, error: (err.stderr ?? err.message ?? '').slice(0, 200) }
   }
@@ -96,7 +153,7 @@ async function call(model, effort) {
 
 /** 模型目录中 data 数组的原始条目。 */
 const catalog = await new Promise((resolve, reject) => {
-  execFileAsync(HELPER, ['GET', '/models'], { maxBuffer: 8 * 1024 * 1024 })
+  execFileAsync(HELPER.cmd, [...HELPER.prefix, 'GET', '/models'], { maxBuffer: 8 * 1024 * 1024 })
     .then(({ stdout }) => resolve(JSON.parse(stdout).data ?? []))
     .catch(reject)
 })
@@ -118,7 +175,8 @@ for (const model of models) {
   for (const effort of tiers) {
     const { status } = await call(model, effort)
     result[model][effort] = status
-    // 200 为接受；400 与 422 为档位不被接受；其余（429 等）需人工复测。
+    // 200 为接受；400 与 422 为档位不被接受；冷却重测后仍非这三者的
+    // （例如持续 429、5xx）说明这次没测出结论，须人工复测后手工入表。
     const mark = status === 200 ? '✓' : status === 400 ? '✗400' : status === 422 ? '✗422' : `?${status}`
     process.stderr.write(`  ${model.padEnd(30)} ${effort.padEnd(9)} ${mark}\n`)
   }

package/scripts/radeon-api.ps1

@@ -0,0 +1,169 @@
+#!/usr/bin/env pwsh
+#Requires -Version 7.0
+<#
+.SYNOPSIS
+    Radeon Cloud API 调用助手（PowerShell 7 版）。
+
+.DESCRIPTION
+    与同目录的 radeon-api.sh 行为一致：发起一次已认证请求，把响应体打到标准输出、
+    HTTP 状态码以 ---HTTP <code>--- 的形式打到标准错误，使调用方可以分别解析内容与状态。
+
+    密钥有两个来源，按优先级取用：
+      1. 环境变量 RADEON_API_KEY —— 直接给出密钥字面值，适合没有安装 DSH、
+         或不想在本机留存凭据文件的使用者；
+      2. DSH 凭据存储 ~/.dsh/.credentials.yaml 中名为 RADEON_CLOUD_API_KEY 的
+         条目（条目名可用 RADEON_KEY_REF 覆盖）—— 适合已在 DSH 的模型设置页
+         录入过密钥的使用者。
+    无论走哪个来源，密钥都只存在于本进程变量与请求头里，
+    不写盘、不打印、不出现在输出中。
+
+    用法: ./scripts/radeon-api.ps1 <METHOD> <PATH> [JSON_BODY]
+      $env:RADEON_API_KEY = 'rc-xxxx'; ./scripts/radeon-api.ps1 GET /models
+      $env:RAW = '1' 时改为逐块输出 SSE，不做缓冲与状态码拆分。
+
+.PARAMETER Method
+    HTTP 方法，如 GET / POST。
+
+.PARAMETER ApiPath
+    相对端点基础 URL 的路径，如 /models。
+
+.PARAMETER Body
+    可选的 JSON 请求体。
+#>
+[CmdletBinding()]
+param(
+    [Parameter(Position = 0)]
+    [string] $Method,
+
+    [Parameter(Position = 1)]
+    [string] $ApiPath,
+
+    [Parameter(Position = 2)]
+    [string] $Body
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+# 统一按 UTF-8 输出：脚本里有中文，Windows 默认代码页会把它们变成乱码。
+try { [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false) } catch { }
+
+# 凭据文件位置。DSH_HOME 未设置时回退到默认的 ~/.dsh。
+$CredFile = if ($env:DSH_HOME) {
+    Join-Path $env:DSH_HOME '.credentials.yaml'
+}
+else {
+    Join-Path $HOME '.dsh' '.credentials.yaml'
+}
+# 要读取的凭据条目名，可用环境变量覆盖以切换密钥。
+$Ref = if ($env:RADEON_KEY_REF) { $env:RADEON_KEY_REF } else { 'RADEON_CLOUD_API_KEY' }
+# 共享端点基础 URL，可用环境变量覆盖以指向独占端点。
+$Base = if ($env:RADEON_BASE) { $env:RADEON_BASE } else { 'https://developer.amd.com.cn/radeon/api/v1' }
+
+# 密钥优先取环境变量；未提供时才回退到凭据文件。
+# 这样在完全没有 DSH 凭据文件的机器上，仅设置 RADEON_API_KEY 即可使用。
+$Key = $env:RADEON_API_KEY
+
+if (-not $Key) {
+    if (-not (Test-Path -LiteralPath $CredFile -PathType Leaf)) {
+        [Console]::Error.WriteLine(@"
+错误：没有可用的 API 密钥。
+  凭据文件 $CredFile 不存在，且环境变量 RADEON_API_KEY 未设置。
+  请任选其一：
+    `$env:RADEON_API_KEY = 'rc-你的密钥'
+    或在 DSH 的模型设置页录入密钥，条目名用 $Ref
+"@)
+        exit 1
+    }
+    # 从凭据文件中按条目名取出密钥值。条目名先做正则转义，
+    # 避免名字里的特殊字符被当成模式的一部分（bash 版交给 node 处理同一问题）。
+    $text = Get-Content -LiteralPath $CredFile -Raw -Encoding utf8
+    if ($null -eq $text) { $text = '' }
+    $pattern = '(?m)^\s*' + [regex]::Escape($Ref) + ':\s*(\S+)\s*$'
+    $match = [regex]::Match($text, $pattern)
+    if (-not $match.Success) {
+        [Console]::Error.WriteLine("凭据 $Ref 未设置")
+        exit 1
+    }
+    $Key = $match.Groups[1].Value
+}
+
+# 三个位置参数依次为方法、路径（相对 Base）、可选的请求体。
+# 与 bash 版一样在缺参时报用法并退出 1，而不是抛异常——
+# 脚本被 probe-efforts.mjs 这类调用方以 execFile 拉起时，抛异常只会留下一行栈。
+if (-not $Method) {
+    [Console]::Error.WriteLine('用法: radeon-api.ps1 <METHOD> <PATH> [JSON_BODY]')
+    exit 1
+}
+if (-not $ApiPath) {
+    [Console]::Error.WriteLine('缺少路径')
+    exit 1
+}
+
+$Uri = "$Base$ApiPath"
+$IsRaw = $env:RAW -eq '1'
+$Utf8 = [System.Text.UTF8Encoding]::new($false)
+
+# 直接用 HttpClient 而不是 Invoke-WebRequest：后者会把响应整体缓冲，
+# 拿不到 RAW 模式要求的「分片一到就写出」，也不能把非 2xx 当正常结果读回来。
+$handler = [System.Net.Http.HttpClientHandler]::new()
+$client = [System.Net.Http.HttpClient]::new($handler)
+# 与 curl 一致：不设超时。上游偶发慢响应时由调用方自己判重试。
+$client.Timeout = [System.Threading.Timeout]::InfiniteTimeSpan
+
+try {
+    $request = [System.Net.Http.HttpRequestMessage]::new([System.Net.Http.HttpMethod]::new($Method), $Uri)
+    $request.Headers.TryAddWithoutValidation('Authorization', "Bearer $Key") | Out-Null
+    if ($IsRaw) {
+        $request.Headers.TryAddWithoutValidation('Accept', 'text/event-stream') | Out-Null
+    }
+    if ($Body) {
+        $bodyContent = [System.Net.Http.StringContent]::new($Body, $Utf8)
+    }
+    else {
+        # 无请求体时也要带上 Content-Type，与 bash 版的 -H 一致。
+        # HttpClient 不允许单独设置内容头，只能挂一个空内容；
+        # 代价是多一个 Content-Length: 0，对网关没有影响。
+        $bodyContent = [System.Net.Http.ByteArrayContent]::new([byte[]]@())
+    }
+    $bodyContent.Headers.ContentType = [System.Net.Http.Headers.MediaTypeHeaderValue]::new('application/json')
+    $request.Content = $bodyContent
+
+    $stdout = [Console]::OpenStandardOutput()
+
+    if ($IsRaw) {
+        # 流式模式：响应头一到就返回，分片一到就直接写出。
+        # 此模式不追加状态码标记，也不拆分响应体，调用方需自行处理。
+        $response = $client.SendAsync($request, [System.Net.Http.HttpCompletionOption]::ResponseHeadersRead).GetAwaiter().GetResult()
+        $stream = $response.Content.ReadAsStreamAsync().GetAwaiter().GetResult()
+        $buffer = [byte[]]::new(8192)
+        while (($read = $stream.Read($buffer, 0, $buffer.Length)) -gt 0) {
+            $stdout.Write($buffer, 0, $read)
+            $stdout.Flush()
+        }
+        $stream.Dispose()
+        $response.Dispose()
+        exit 0
+    }
+
+    # 非流式模式：状态码走标准错误、响应体走标准输出，调用方才能分别解析。
+    # 非 2xx 也照常输出响应体与状态码，退出码仍为 0——bash 版的 curl 没有 -f，
+    # 语义相同；探针脚本正是靠 ---HTTP 4xx--- 判定「档位被拒绝」。
+    $response = $client.SendAsync($request).GetAwaiter().GetResult()
+    $bodyText = $response.Content.ReadAsStringAsync().GetAwaiter().GetResult()
+    $status = [int]$response.StatusCode
+    # 末尾补一个换行，与 bash 版的 echo 一致；空响应体也补。
+    $bytes = $Utf8.GetBytes("$bodyText`n")
+    $stdout.Write($bytes, 0, $bytes.Length)
+    $stdout.Flush()
+    [Console]::Error.WriteLine("---HTTP $status---")
+    $response.Dispose()
+    exit 0
+}
+catch {
+    [Console]::Error.WriteLine("错误：请求失败：$($_.Exception.Message)")
+    exit 1
+}
+finally {
+    $client.Dispose()
+}