前言¶

DeepSeek Harness（DSH）通过插件扩展模型供应商，而不是改本体配置。若你想在 DSH 的模型选择器里直接使用 AMD Radeon Cloud 的 Public Free Model APIs，并像其它 provider 一样在界面上选「推理等级」（思考档位），手写 profile 或自研适配器成本较高。

下面介绍社区插件 @zhz8888/dsh-radeon-cloud-patcher：它用补丁层声明 radeon-cloud provider，传输、思考字段解析、多轮回传与用量计量交给 DSH 自带的 dsh-llm-pi-ai，不改 DSH 本体、默认也不写你的 profile。

这是什么¶

• 包名：@zhz8888/dsh-radeon-cloud-patcher（npm；插件列表显示名 Radeon Cloud，中文界面为「Radeon Cloud 提供方」）
• 维护者：zhz8888
• 分类：模型推理
• 许可证：MIT（当前 package 版本 1.3.0）
• 目录页：skillhub.cn 插件条目
• 源码：GitHub

插件目标 DSH 版本为 >=0.2.0-rc.1（三处声明一致，无上界）。与「在 profile 里永久合并一份 provider 定义」不同：正常安装路径下，卸载插件即删除该供应商，profile 中不留副本；设置页对应行也没有「删除」按钮——想移除只能卸载插件。

核心功能¶

1. 接入 Radeon Cloud 模型选择器
   安装并重启后，模型选择器会出现 Radeon 侧模型；凭据配置成功后，设置页该行右侧为绿点（悬停「API 密钥已配置」）。

2. 逐模型思考档位（reasoning effort）
   在输入框下方选模型后，可按模型选择「推理等级」。档位由插件内 provider 定义与实测表维护（API 的 GET /v1/models 不返回档位信息）。例如 DeepSeek-V4.1-Flash 支持 off/minimal/low/medium/high/xhigh/max；GLM-5.3-Flash 与 MiniCPM-V-4.7-1B 不接受 none；MiniCPM5-2B 非推理模型，不出现档位下拉。选了服务端不接受的档位会硬失败（400/422），不会静默降级。

3. 多模态
   部分模型支持图片输入（如 DeepSeek-V4.1-Flash、MiMo-V2.6-Flash、Qwen3.8-27B 等）；仅文本模型在 README 中单独列出。

4. 归属与冲突检测
   要求 provider id radeon-cloud 由插件独占。若 profile 中存在不一致的同 id 声明，启动会失败并指出差异；不会静默接管。可与自有 provider 共存时使用仓库提供的合并脚本（见 README「归属与删除」）。

5. 客户端小补丁
   随包带的 client/client.js 用 CSS 隐藏本 provider 设置行的「自定义」标签（DSH 对非内置目录 provider 的硬编码展示）；DSH 界面改版后可能静默失效，不影响调用功能。

安装与启用¶

前提：已安装 DSH，且持有 Radeon Cloud API 密钥（格式 rc-…）。本包 tarball 没有安装期构建脚本，一般不需要处理 pnpm 的 allowBuilds 授权。

命令行（将 <profile> 换成你的 profile 名）：

dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher

换源或指定版本时，参数会原样转发给 profile 目录内的 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@<版本>

桌面版：在左侧「插件」页添加 @zhz8888/dsh-radeon-cloud-patcher。desktop profile 由应用独占管理，终端里 dsh plugin --profile desktop … 会被拒绝；请用应用内插件页，或在应用「打开 DSH 终端」中执行。

启用步骤（README 快速上手）：

1. 安装插件（见上）。
2. 重启 DSH——定义在补丁层 config 中，运行中不生效。
3. 配置密钥：「账号菜单 → 设置 → 模型」→ Radeon Cloud →「编辑」→ 粘贴密钥 →「保存」。密钥写入本机 ~/.dsh/.credentials.yaml 的 RADEON_CLOUD_API_KEY，界面不回显。

卸载（同时删除该供应商）：

dsh plugin --profile <profile> remove @zhz8888/dsh-radeon-cloud-patcher

升级：

dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher@latest

升级后同样需要重启。若曾用 pnpm install:profile 把定义合并进 profile，那份副本可能盖住插件层新定义，需按 README 处理。

核验生效配置（desktop profile 除外）：

dsh --profile <profile> --dump-config

典型用法¶

1. 配置 API 密钥¶

密钥从 Radeon Cloud 文档 申请；插件覆盖的是 Public Free Model APIs 共享端点。

• 设置页（推荐）：见上文安装第 3 步。
• 环境变量（不落盘，适合临时或 CI）：插件运行时读 RADEON_CLOUD_API_KEY：

RADEON_CLOUD_API_KEY=rc-你的密钥 dsh --profile <profile>

凭据查找顺序为：进程环境 → 凭据存储 → .env → $DSH_HOME/.env，环境变量优先级最高。

仓库 scripts/ 使用 RADEON_API_KEY 等变量，与插件运行时互不影响。

2. 选模型与思考档位¶

在模型选择器中选 Radeon 模型，再选「推理等级」。Qwen 系靠 none（界面上的 off）关闭思考；不传档位时 Qwen 仍可能思考（上游行为）。不要仅凭模型名相近推断档位（例如两个 MiniCPM-V 型号档位表不同）。

3. 图片输入¶

在支持视觉的模型上按 DSH 常规范式附带图片即可；纯文本模型勿发图。

适用场景与注意¶

适合谁

• 已在用 DSH 0.2.x（>=0.2.0-rc.1），希望零改 profile 接入 Radeon Cloud 免费共享端点。
• 需要在对话里显式控制 reasoning effort，并接受「档位表靠实测维护、模型上下架会导致表过期」这一运维方式。

使用前请知悉

• 插件在 当前 DSH 进程权限 下运行；安装前建议查看 GitHub 源码 与 MIT 许可证，自行评估信任边界。
• 思考与回答共用 max_tokens 预算：预算不足时可能出现空回答；配置里 defaultMaxTokens 已为 32768，仍异常时可调低档位或临时 off。
• stop 不可用：网关会丢弃，DSH 侧为响亮失败（UNSUPPORTED_OPTION）。
• 部分模型不支持 developer 角色，插件已改走 system。
• 仅 Public Free Model APIs；独占端点不在本项目范围。
• 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，DSH 生态是「一切皆插件」的独立扩展方式。

结尾¶

@zhz8888/dsh-radeon-cloud-patcher 把 AMD Radeon Cloud 以补丁 provider 的形式挂进 DSH：安装、重启、填 rc-… 密钥即可选模型与思考档位，底层仍走 dsh-llm-pi-ai。细节、模型表（采集日期 2026-10-16）、限制与 profile 合并命令见 GitHub README；安装入口亦可在 插件目录页 找到。