@zhz8888/dsh-radeon-cloud-patcher 0.0.0-stage → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +343 -2
- package/cordis.plugin.patch.yml +26 -0
- package/package.json +75 -4
- package/provider/radeon-cloud.yml +155 -0
- package/scripts/apply-to-profile.mjs +158 -0
- package/scripts/probe-efforts.mjs +128 -0
- package/scripts/radeon-api.sh +93 -0
- package/scripts/validate-config.mjs +86 -0
- package/src/index.js +123 -0
- package/src/merge.js +111 -0
- package/src/patch-text.js +158 -0
- package/src/validate.js +150 -0
- package/src/yaml.js +39 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 zhz8888
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,344 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Radeon Cloud Patcher for DeepSeek Harness
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
把 [AMD Radeon Cloud](https://amd-aim.github.io/radeon-cloud-docs/) 接入 DeepSeek Harness 的模型选择器,**完整支持模型思考(reasoning)功能**。
|
|
4
|
+
|
|
5
|
+
包名 `@zhz8888/dsh-radeon-cloud-patcher`。它把 provider 定义**按键合并**进你的 profile,由 DSH 自带的
|
|
6
|
+
`dsh-llm-pi-ai`(通用 OpenAI 兼容 provider)承载——**不修改 DSH 本体,不需要自研适配器**。
|
|
7
|
+
|
|
8
|
+
> 之所以叫 patcher 而不是 provider,是因为本项目**不承载任何 provider 逻辑**。
|
|
9
|
+
> DSH 的补丁语义是整体替换,直接用补丁改写 `llm-pi-ai` 的 config 会把你自己添加的
|
|
10
|
+
> provider 一并抹掉;因此写入被降到键的粒度,只动 `providers.radeon-cloud`。
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+

|
|
14
|
+

|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 目录
|
|
19
|
+
|
|
20
|
+
- [功能](#功能)
|
|
21
|
+
- [环境要求](#环境要求)
|
|
22
|
+
- [快速开始](#快速开始)
|
|
23
|
+
- [项目结构](#项目结构)
|
|
24
|
+
- [常用命令](#常用命令)
|
|
25
|
+
- [可用模型](#可用模型)
|
|
26
|
+
- [已知限制](#已知限制)
|
|
27
|
+
- [兼容性](#兼容性)
|
|
28
|
+
- [许可证](#许可证)
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 功能
|
|
33
|
+
|
|
34
|
+
### 规范化模型返回文本的结构
|
|
35
|
+
|
|
36
|
+
Radeon 的响应体与流式分片都存在一个容易致错的形态:思考内容的字段名是 `reasoning`,
|
|
37
|
+
但同一份数据里还带一个 `reasoning_content` 占位,且占位值是 `null` 而不是空字符串。
|
|
38
|
+
按字段名直读会取到 `null`,思考内容静默丢失,**全程不产生任何报错**。
|
|
39
|
+
|
|
40
|
+
本配置接的是 DSH 既有的字段选择逻辑——取第一个「值为非空字符串」的思考字段。
|
|
41
|
+
`null` 的类型不是字符串,于是被自然跳过,正确落到 `reasoning`。经此规范化:
|
|
42
|
+
|
|
43
|
+
| 源字段 | 规范化后的结构 |
|
|
44
|
+
| --- | --- |
|
|
45
|
+
| `delta.content` / `message.content` | 回答 → `text` 内容块 |
|
|
46
|
+
| `delta.reasoning` / `message.reasoning` | 思考 → `reasoning` 内容块 |
|
|
47
|
+
| `delta.reasoning_content: null` | 跳过,不产生空块 |
|
|
48
|
+
|
|
49
|
+
思考与回答成为并列的两类内容块,在界面上分区呈现,而不是把思考混进正文。
|
|
50
|
+
|
|
51
|
+
### 桥接模型思考方式回传
|
|
52
|
+
|
|
53
|
+
思考不只是「取回来」,还必须能「送回去」——多轮对话中 DSH 会把上一轮的助手消息
|
|
54
|
+
连同思考内容一起回传,否则多轮上下文会断裂。
|
|
55
|
+
|
|
56
|
+
- **流式产出**:思考以 `reasoning-delta` 分片实时送达界面,不必等回答生成完毕;
|
|
57
|
+
- **对称回传**:回放时使用**读取时所用的同一个字段名**(助手消息上的 `reasoning`),
|
|
58
|
+
而非另换一个字段名,避免读取与回传不对称导致多轮请求被拒;
|
|
59
|
+
- **强度可选**:思考强度按模型逐个声明,而非全局统一。接受 `none` 的模型可关闭思考,
|
|
60
|
+
不接受的模型则不提供该档位,而非提供一个会报错的选项;
|
|
61
|
+
- **用量归集**:思考 token 计入 `reasoning_tokens`,与回答 token 一并进入用量统计。
|
|
62
|
+
|
|
63
|
+
实测确认:Radeon 的 `usage` 在顶层与 `completion_tokens_details` 两处都回报
|
|
64
|
+
`reasoning_tokens` 且数值一致,DSH 读取后者即可正常计量。
|
|
65
|
+
|
|
66
|
+
### 其他
|
|
67
|
+
|
|
68
|
+
- 8 个对话模型全部可选,思考档位按模型独立声明
|
|
69
|
+
- 视觉模型支持图片输入
|
|
70
|
+
- 限流退避遵循服务端 `Retry-After`
|
|
71
|
+
- 附带离线校验、回归测试与档位实测工具
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## 环境要求
|
|
76
|
+
|
|
77
|
+
| 项 | 要求 | 说明 |
|
|
78
|
+
| --- | --- | --- |
|
|
79
|
+
| DSH | `0.2.0-rc.2` | 桌面版内置的 `dsh-llm-pi-ai` 需为该版本 |
|
|
80
|
+
| Node.js | `^22.19.0` 或 `>=24.0.0` | 仅运行 `scripts/` 与 `test/` 下的脚本时需要 |
|
|
81
|
+
| bash | 任意 | 仅 `scripts/radeon-api.sh` 需要 |
|
|
82
|
+
| 操作系统 | macOS | `scripts/validate-config.mjs` 按 DSH 桌面版应用包的绝对路径加载校验用的 schema,路径为 `/Applications/DSH Desktop.app/Contents/Resources/app/node_modules`。其余脚本与系统无关 |
|
|
83
|
+
|
|
84
|
+
> 配置文件本身(`provider/radeon-cloud.yml`)是纯 YAML,不依赖上述任何运行时。
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 快速开始
|
|
89
|
+
|
|
90
|
+
### 1. 安装插件
|
|
91
|
+
|
|
92
|
+
推荐用 DSH 的插件管理器安装(插件 → 添加插件,输入包名或本地目录路径):
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
dsh plugin --profile <profile> add @zhz8888/dsh-radeon-cloud-patcher
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
也可以直接编辑 profile 的 `package.json`,在 `dsh.profile.bundles` 中加入本包名,
|
|
99
|
+
再执行 `dsh plugin --profile <profile> install`。
|
|
100
|
+
|
|
101
|
+
> 本包通过 `peerDependencies` 里的 `@deepseek-ai/dsh-*` 范围声明支持 DSH `0.2.x`
|
|
102
|
+
> (含 `0.2.0-rc.1` 及之后的全部预发布与正式版)。DSH 安装器会把每个
|
|
103
|
+
> `@deepseek-ai/dsh-*` peer 与当前运行时版本比对,**不匹配则直接拒绝安装**,
|
|
104
|
+
> 不会出现「装上了但思考功能失效」的情况。
|
|
105
|
+
>
|
|
106
|
+
> 范围写成 `>=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0` 的显式双分支,
|
|
107
|
+
> 是为了同时满足 DSH 的闸门判定与 npm/pnpm 的 peer 解析:node-semver 只有当范围里
|
|
108
|
+
> 某个比较符与该版本的 `major.minor.patch` 元组完全一致、且自身也带预发布标签时,
|
|
109
|
+
> 才会放行预发布版本。单写 `>=0.2.0-rc.1 <0.3.0-0` 会把 `0.2.1-alpha.1` 这类
|
|
110
|
+
> **不同元组**的预发布静默排除。
|
|
111
|
+
|
|
112
|
+
### 2. 写入 provider 定义
|
|
113
|
+
|
|
114
|
+
插件只负责分发与看护;provider 定义要落到 profile 的 `cordis.patch.yml` 里,
|
|
115
|
+
由 `llm-pi-ai` 承载。这一步是**按键合并**,不是整体替换:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
# 先演练:会打印本次改动,以及被保留的其它 provider
|
|
119
|
+
pnpm install:profile:dry
|
|
120
|
+
|
|
121
|
+
# 确认无误后写入(自动备份,断言其余条目与同级键逐字未变)
|
|
122
|
+
pnpm install:profile
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
输出示例:
|
|
126
|
+
|
|
127
|
+
```
|
|
128
|
+
【写入】 ~/.dsh/profiles/desktop/cordis.patch.yml
|
|
129
|
+
新增 providers.radeon-cloud(8 个模型)
|
|
130
|
+
保留的其它 provider:my-corp-proxy, another-one
|
|
131
|
+
顶层条目 12 个,增减 0 个
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
> **合并粒度是键**:只新增或替换 `providers.radeon-cloud` 这一个键。
|
|
135
|
+
> 你在 `llm-pi-ai` 下自行添加的 provider、你在补丁文件里写的注释、缩进风格与
|
|
136
|
+
> 键序,都原样保留。合并采用文本级编辑,不会重新序列化你的文件。
|
|
137
|
+
> 详见[已知限制](#6-与用户自有-provider-共存)。
|
|
138
|
+
|
|
139
|
+
### 3. 配置 API 密钥
|
|
140
|
+
|
|
141
|
+
密钥有两种提供方式,任选其一。
|
|
142
|
+
|
|
143
|
+
**方式一:在 DSH 的模型设置页录入(推荐给日常使用)**
|
|
144
|
+
|
|
145
|
+
重启 DSH,在「设置 → 模型」找到 Radeon Cloud 行,填入密钥。DSH 会把它写进本机凭据存储
|
|
146
|
+
`~/.dsh/.credentials.yaml` 的 `RADEON_CLOUD_API_KEY` 条目,明文不落配置、不回显。
|
|
147
|
+
此后 `scripts/` 下的脚本会自动读取该条目,无需再做任何设置。
|
|
148
|
+
|
|
149
|
+
**方式二:环境变量(适合未安装 DSH 或不想在本机留存凭据文件的使用者)**
|
|
150
|
+
|
|
151
|
+
```bash
|
|
152
|
+
export RADEON_API_KEY=rc-你的密钥
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
单次调用也可以只对这一条命令生效:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
RADEON_API_KEY=rc-你的密钥 ./scripts/radeon-api.sh GET /models
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
两种方式共存时,脚本按「环境变量优先、凭据文件次之」取用密钥;
|
|
162
|
+
两者都没有时直接报错并提示上述做法。
|
|
163
|
+
|
|
164
|
+
### 4. 相关环境变量
|
|
165
|
+
|
|
166
|
+
| 变量 | 作用 | 默认值 |
|
|
167
|
+
| --- | --- | --- |
|
|
168
|
+
| `RADEON_API_KEY` | API 密钥字面值,优先级高于凭据文件 | 无 |
|
|
169
|
+
| `RADEON_KEY_REF` | 从凭据文件读取时使用的条目名 | `RADEON_CLOUD_API_KEY` |
|
|
170
|
+
| `RADEON_BASE` | 端点基础 URL,可指向独占端点 | `https://developer.amd.com.cn/radeon/api/v1` |
|
|
171
|
+
| `DSH_HOME` | DSH 数据目录,凭据文件据此定位 | `~/.dsh` |
|
|
172
|
+
|
|
173
|
+
> 密钥在脚本中只存在于进程变量与 curl 请求头,不写盘、不打印、不出现在输出里。
|
|
174
|
+
> 但 shell 历史记录仍会留下 `export RADEON_API_KEY=...` 这一行,请自行注意。
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## 项目结构
|
|
179
|
+
|
|
180
|
+
```
|
|
181
|
+
dsh-radeon-cloud-patcher/
|
|
182
|
+
├── README.md 本文件
|
|
183
|
+
├── LICENSE MIT 许可证
|
|
184
|
+
├── package.json 插件包清单(版本闸门、导出、脚本)
|
|
185
|
+
├── cordis.plugin.patch.yml bundle 补丁:只插入本插件行
|
|
186
|
+
├── .gitignore
|
|
187
|
+
│
|
|
188
|
+
├── provider/ 配置本体
|
|
189
|
+
│ └── radeon-cloud.yml provider 定义的唯一真源
|
|
190
|
+
│
|
|
191
|
+
├── src/ 插件实现(薄壳,不含 provider 逻辑)
|
|
192
|
+
│ ├── index.js 插件入口:启动时校验定义,失效则响亮失败
|
|
193
|
+
│ ├── merge.js 键级合并的纯函数实现
|
|
194
|
+
│ ├── patch-text.js 文本级合并,保留用户注释与格式
|
|
195
|
+
│ ├── validate.js 定义的结构校验
|
|
196
|
+
│ └── yaml.js 定位 YAML 解析器
|
|
197
|
+
│
|
|
198
|
+
├── scripts/ 运维与校验工具
|
|
199
|
+
│ ├── apply-to-profile.mjs 按键合并进 profile(带断言与自动备份)
|
|
200
|
+
│ ├── validate-config.mjs 用 llm-pi-ai 真实 schema 校验定义
|
|
201
|
+
│ ├── probe-efforts.mjs 实测逐模型 reasoning_effort 档位表
|
|
202
|
+
│ └── radeon-api.sh API 调用助手(密钥取自环境变量或凭据存储)
|
|
203
|
+
│
|
|
204
|
+
├── test/ 离线测试
|
|
205
|
+
│ ├── merge.test.mjs 合并语义与幂等性
|
|
206
|
+
│ ├── patch-text.test.mjs 不破坏用户 provider 与注释
|
|
207
|
+
│ ├── verify-reasoning.mjs 思考文本取回的回归测试
|
|
208
|
+
│ └── fixtures/
|
|
209
|
+
│ └── stream-reasoning.sse 实测抓取的真实流
|
|
210
|
+
│
|
|
211
|
+
└── docs/ 技术文档
|
|
212
|
+
├── plugin-parity-assessment.md 与其他 provider 插件的使用方式差异评估
|
|
213
|
+
├── feasibility-assessment.md 可行性评估与线格式差异矩阵
|
|
214
|
+
├── implementation-plan.md 实施计划与检查点结论
|
|
215
|
+
├── live-verification.md 真机联调实测记录
|
|
216
|
+
└── reference-commandcode-provider.md 第三方 provider 插件参考实现分析
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
> 插件壳只做四件事:**分发**(npm 包,可被插件市场安装)、**版本闸门**
|
|
220
|
+
> (版本不匹配直接拒装)、**写入**(按键合并进 profile,可演练、带断言、自动备份)、
|
|
221
|
+
> **看护**(启动时校验定义,失效则让插件启动失败)。
|
|
222
|
+
> 实际的传输、思考字段解析、多轮回传、用量计量仍全部由 DSH 自带的
|
|
223
|
+
> `llm-pi-ai` 承担。
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
## 常用命令
|
|
228
|
+
|
|
229
|
+
```bash
|
|
230
|
+
# 全量测试(合并语义、冲突防护、思考字段取回)
|
|
231
|
+
pnpm test
|
|
232
|
+
|
|
233
|
+
# 校验 provider 定义:结构校验 + llm-pi-ai 真实 schema 校验
|
|
234
|
+
# 这是判断「字段在当前 DSH 版本里是否仍然有效」的那道校验,建议升级 DSH 后跑一次
|
|
235
|
+
pnpm validate
|
|
236
|
+
|
|
237
|
+
# 演练合并进 profile,打印改动与被保留的其它 provider
|
|
238
|
+
pnpm install:profile:dry
|
|
239
|
+
|
|
240
|
+
# 重新实测某个模型支持的思考档位
|
|
241
|
+
pnpm probe --only Qwen3.8-27B
|
|
242
|
+
|
|
243
|
+
# 拉取实时模型目录
|
|
244
|
+
./scripts/radeon-api.sh GET /models
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## 可用模型
|
|
250
|
+
|
|
251
|
+
> 采集日期:**2026-10-04**
|
|
252
|
+
|
|
253
|
+
| 模型 | 上下文 | 图片 | 思考档位 |
|
|
254
|
+
| --- | --- | --- | --- |
|
|
255
|
+
| DeepSeek-V4.1-Flash | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
|
|
256
|
+
| DeepSeek-V4-Flash | 1,048,576 | ❌ | off/minimal/low/medium/high/xhigh/max |
|
|
257
|
+
| DeepSeek-V4-Flash-Vision-Exp | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
|
|
258
|
+
| MiMo-V2.6-Flash | 1,048,576 | ✅ | off/minimal/low/medium/high/xhigh/max |
|
|
259
|
+
| Qwen3.8-27B | 262,144 | ✅ | off/low/medium/xhigh |
|
|
260
|
+
| Qwen3.8-Flash-Next | 262,144 | ✅ | off/low/medium/xhigh |
|
|
261
|
+
| GLM-5.3-Flash | 262,144 | ❌ | low/medium/high |
|
|
262
|
+
| MiniCPM5-2B | 131,072 | ❌ | (不返回分离思考,故不提供档位) |
|
|
263
|
+
|
|
264
|
+
`off` 表示发送 `reasoning_effort: "none"` 关闭思考。
|
|
265
|
+
**GLM-5.3-Flash 与 Qwen3.8-27B 不支持 `none`**,因此没有关闭档位;其中 Qwen 系在「不传档位」时也会思考(AMD 服务端行为)。
|
|
266
|
+
|
|
267
|
+
> **档位表不在 API 里**(`GET /v1/models` 不返回该信息),只能实测。模型上下架会导致此表过期,
|
|
268
|
+
> 请用 `pnpm probe` 复测后再更新 `provider/radeon-cloud.yml`。
|
|
269
|
+
>
|
|
270
|
+
> `MinerU2.5-Pro` 未收录——它走独立的 `/v1/ocr` 端点,不是对话模型。
|
|
271
|
+
|
|
272
|
+
---
|
|
273
|
+
|
|
274
|
+
## 已知限制
|
|
275
|
+
|
|
276
|
+
### 1. 思考与答案共用同一个 token 预算(最重要)
|
|
277
|
+
|
|
278
|
+
Radeon 的 `max_tokens` 同时约束思考和最终回答。预算不足时**回答会变成空字符串**:
|
|
279
|
+
|
|
280
|
+
| 配置 | finish_reason | content | reasoning |
|
|
281
|
+
| --- | --- | --- | --- |
|
|
282
|
+
| `effort=low`, `max_tokens=16` | `length` | **空** | 84 字符 |
|
|
283
|
+
| `effort=low`, `max_tokens=120` | `length` | **空** | 584 字符 |
|
|
284
|
+
| `effort=low`, `max_tokens=400` | `length` | **空** | 1717 字符 |
|
|
285
|
+
| `effort=none`, `max_tokens=64` | `length` | 330 字符 ✅ | 0 |
|
|
286
|
+
|
|
287
|
+
**应对**:配置里 `defaultMaxTokens` 已设为 `32768`(pi-ai 默认值),给思考留足余量。
|
|
288
|
+
`max_tokens` 是上限而非计费项,实际按产出计费,调高不增加成本。
|
|
289
|
+
|
|
290
|
+
若仍偶发空回答,把该会话的思考档位调低,或临时改用 `off`。
|
|
291
|
+
|
|
292
|
+
### 2. `stop`(停止序列)不可用
|
|
293
|
+
|
|
294
|
+
Radeon 网关按白名单重建请求体,`stop` 不在白名单内,会被**静默丢弃**。
|
|
295
|
+
DSH 的 `dsh-llm-pi-ai` 会对此抛 `UNSUPPORTED_OPTION`,属于响亮失败,比静默失效好。
|
|
296
|
+
|
|
297
|
+
### 3. 部分模型不接受 `developer` 角色
|
|
298
|
+
|
|
299
|
+
DSH 默认对 OpenAI 兼容端点使用 `developer` 承载系统提示词,8 个模型中有 5 个会直接报
|
|
300
|
+
`unknown role: developer`。已通过 `compat.supportsDeveloperRole: false` 关闭。
|
|
301
|
+
|
|
302
|
+
### 4. 档位被拒是硬失败
|
|
303
|
+
|
|
304
|
+
非法档位返回 `400`(Qwen 系)或 `422`(GLM 系),不会自动降级。
|
|
305
|
+
配置里的档位表来自实测,如新增模型请先复测。
|
|
306
|
+
|
|
307
|
+
### 5. 上游偶发故障
|
|
308
|
+
|
|
309
|
+
实测中出现过 `504 Gateway Timeout`,被包装为 HTTP `500` + `code: upstream_error`。
|
|
310
|
+
DSH 将其归为可重试的 `SERVER`。偶发,重试即可。
|
|
311
|
+
|
|
312
|
+
### 6. 与用户自有 provider 共存
|
|
313
|
+
|
|
314
|
+
provider 定义写入 profile 时采用**键级合并**:只新增或替换 `providers.radeon-cloud`
|
|
315
|
+
这一个键,同一命名空间下你自己添加的 provider 原样保留。
|
|
316
|
+
|
|
317
|
+
合并采用文本级编辑,不会重新序列化你的补丁文件,因此你写的注释、缩进风格与
|
|
318
|
+
键序也不会被改动。写入前会断言:除 `radeon-cloud` 外的同级 provider 键集合一致、
|
|
319
|
+
`llm-pi-ai` 之外的顶层条目逐字符未变,任一不成立即中止且不落盘。
|
|
320
|
+
|
|
321
|
+
需要注意的仍有一处:**不要另写一条 `llm-pi-ai` 的非 insert 补丁**去覆盖 config——
|
|
322
|
+
那会整体替换该行,绕过上面的按键合并。若要用补丁改 `llm-pi-ai` 的其它字段,
|
|
323
|
+
请只改你需要的那个字段,不要整块替换 `config`。
|
|
324
|
+
|
|
325
|
+
---
|
|
326
|
+
|
|
327
|
+
## 兼容性
|
|
328
|
+
|
|
329
|
+
- 目标 DSH 版本:`0.2.0-rc.2`
|
|
330
|
+
- 模型目录与档位表采集日期:**2026-10-04**
|
|
331
|
+
- 收录的模型当前均为 `stability: experimental`
|
|
332
|
+
- 仅覆盖 Public Free Model APIs(共享端点);独占端点的基础 URL 每次实例重启都会变化,不在本项目范围内
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
## 许可证
|
|
337
|
+
|
|
338
|
+
本项目以 [MIT 许可证](LICENSE) 开源。
|
|
339
|
+
|
|
340
|
+
MIT 许可证允许你自由使用、复制、修改、合并、发布、分发、再许可及销售本项目的副本,
|
|
341
|
+
唯一义务是在所有副本或实质性部分中保留版权声明与许可声明。
|
|
342
|
+
|
|
343
|
+
本软件按「原样」提供,不附带任何形式的担保,包括但不限于对适销性、特定用途适用性
|
|
344
|
+
及不侵权的担保;作者或版权持有人不对使用本软件产生的任何损害承担责任。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# 本插件的 bundle 补丁层。
|
|
2
|
+
#
|
|
3
|
+
# 这里只插入本插件自己那一行,**不携带 llm-pi-ai 的任何配置**。
|
|
4
|
+
#
|
|
5
|
+
# 原因:DSH 的非 insert 补丁是整体替换而不是合并。若在这里写入
|
|
6
|
+
# llm-pi-ai 的 config,用户在该命名空间下自行添加的其它 provider
|
|
7
|
+
# 会被一并抹掉。provider 定义改由插件在启动时按键合并写入,
|
|
8
|
+
# 只新增或覆盖 providers.radeon-cloud 这一个键。
|
|
9
|
+
#
|
|
10
|
+
# `id` 是本条目在 profile 里的唯一键,按 DSH 现有惯例取不带作用域的短名
|
|
11
|
+
# (对照 llm-pi-ai、llm-commandcode),它不承担包名职责。
|
|
12
|
+
#
|
|
13
|
+
# `name` 则必须是 profile node_modules 里的完整包标识符;pnpm 按真实
|
|
14
|
+
# (scoped)名链接,裸写包名会解析失败。必须加引号——YAML 中以 @ 开头的
|
|
15
|
+
# 标量会被当作指令符解析。
|
|
16
|
+
|
|
17
|
+
- insert:
|
|
18
|
+
- id: radeon-cloud-patcher
|
|
19
|
+
name: "@zhz8888/dsh-radeon-cloud-patcher"
|
|
20
|
+
config:
|
|
21
|
+
# 自动写入 provider 定义。关闭后插件只做启动校验与看护,
|
|
22
|
+
# 不再改动 profile 文件,适合由使用者自行维护配置的场景。
|
|
23
|
+
autoProvision: true
|
|
24
|
+
# 启动时用 llm-pi-ai 的真实 schema 校验 provider 定义,
|
|
25
|
+
# 不通过则直接让插件启动失败,避免配置失效却无人察觉。
|
|
26
|
+
validateOnBoot: true
|
package/package.json
CHANGED
|
@@ -1,6 +1,77 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zhz8888/dsh-radeon-cloud-patcher",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "为 DeepSeek Harness 接入 AMD Radeon Cloud,完整支持模型思考(reasoning)功能。把 provider 定义按键合并进 profile,由 DSH 自带的 dsh-llm-pi-ai 承载,不修改 DSH 本体,也不自研适配器。",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"amd",
|
|
7
|
+
"deepseek-harness",
|
|
8
|
+
"dsh",
|
|
9
|
+
"llm",
|
|
10
|
+
"patcher",
|
|
11
|
+
"provider",
|
|
12
|
+
"radeon",
|
|
13
|
+
"radeon-cloud",
|
|
14
|
+
"reasoning",
|
|
15
|
+
"thinking"
|
|
16
|
+
],
|
|
17
|
+
"license": "MIT",
|
|
18
|
+
"type": "module",
|
|
19
|
+
"packageManager": "pnpm@11.8.0",
|
|
20
|
+
"author": {
|
|
21
|
+
"name": "zhz8888"
|
|
22
|
+
},
|
|
23
|
+
"repository": {
|
|
24
|
+
"type": "git",
|
|
25
|
+
"url": "git+https://github.com/zhz8888/dsh-radeon-cloud-patcher.git"
|
|
26
|
+
},
|
|
27
|
+
"homepage": "https://github.com/zhz8888/dsh-radeon-cloud-patcher#readme",
|
|
28
|
+
"bugs": {
|
|
29
|
+
"url": "https://github.com/zhz8888/dsh-radeon-cloud-patcher/issues"
|
|
30
|
+
},
|
|
31
|
+
"main": "./src/index.js",
|
|
32
|
+
"exports": {
|
|
33
|
+
".": "./src/index.js",
|
|
34
|
+
"./merge": "./src/merge.js",
|
|
35
|
+
"./provider": "./provider/radeon-cloud.yml",
|
|
36
|
+
"./package.json": "./package.json"
|
|
37
|
+
},
|
|
38
|
+
"dsh": {
|
|
39
|
+
"manifestVersion": 1,
|
|
40
|
+
"bundle": {
|
|
41
|
+
"patch": "./cordis.plugin.patch.yml"
|
|
42
|
+
},
|
|
43
|
+
"compatibility": {
|
|
44
|
+
"dsh": ">=0.2.0-rc.1 <0.3.0-0",
|
|
45
|
+
"dshReleases": {
|
|
46
|
+
"0.2.0-rc.2": "compatible"
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
},
|
|
50
|
+
"engines": {
|
|
51
|
+
"node": ">=22",
|
|
52
|
+
"dsh": ">=0.2.0-rc.1 <0.3.0-0"
|
|
53
|
+
},
|
|
54
|
+
"files": [
|
|
55
|
+
"src",
|
|
56
|
+
"provider",
|
|
57
|
+
"scripts",
|
|
58
|
+
"cordis.plugin.patch.yml",
|
|
59
|
+
"LICENSE",
|
|
60
|
+
"README.md"
|
|
61
|
+
],
|
|
62
|
+
"scripts": {
|
|
63
|
+
"test": "node test/merge.test.mjs && node test/patch-text.test.mjs && node test/verify-reasoning.mjs",
|
|
64
|
+
"test:merge": "node test/merge.test.mjs && node test/patch-text.test.mjs",
|
|
65
|
+
"test:reasoning": "node test/verify-reasoning.mjs",
|
|
66
|
+
"validate": "node scripts/validate-config.mjs",
|
|
67
|
+
"probe": "node scripts/probe-efforts.mjs",
|
|
68
|
+
"install:profile": "node scripts/apply-to-profile.mjs",
|
|
69
|
+
"install:profile:dry": "node scripts/apply-to-profile.mjs --dry-run"
|
|
70
|
+
},
|
|
71
|
+
"peerDependencies": {
|
|
72
|
+
"@deepseek-ai/cordis": "^4.0.2",
|
|
73
|
+
"@deepseek-ai/dsh-llm": ">=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0",
|
|
74
|
+
"@deepseek-ai/dsh-llm-pi-ai": ">=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0",
|
|
75
|
+
"@deepseek-ai/dsh-settings": ">=0.2.0-rc.1 <0.2.1-0 || >=0.2.1-0 <0.3.0-0"
|
|
76
|
+
}
|
|
77
|
+
}
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
# Radeon Cloud provider 定义 —— 本项目的唯一真源。
|
|
2
|
+
#
|
|
3
|
+
# 插件安装与手工安装两条路径都从这里取值,因此不存在第二份副本。
|
|
4
|
+
# 本文件只描述 providers.radeon-cloud 这一个键,不含 llm-pi-ai 的其余内容,
|
|
5
|
+
# 因此写入时只新增或覆盖 radeon-cloud 这一个键,用户自行添加的其它 provider 不受影响。
|
|
6
|
+
#
|
|
7
|
+
# 下面的模型列表与 reasoningEfforts 档位表均来自对线上端点的逐项实测。
|
|
8
|
+
# 模型目录接口不返回档位信息,因此 AMD 新增或下架模型后,
|
|
9
|
+
# 需重新实测并同步本文件,否则选择器里会出现不生效的档位或已失效的模型。
|
|
10
|
+
|
|
11
|
+
# 与 ~/.dsh/.credentials.yaml 中的 ref 名一致;模型设置页按字面名找密钥状态
|
|
12
|
+
apiKeyEnv: RADEON_CLOUD_API_KEY
|
|
13
|
+
|
|
14
|
+
# Radeon 不在 pi-ai 的内置目录中,因此必须显式声明协议
|
|
15
|
+
api: openai-completions
|
|
16
|
+
|
|
17
|
+
baseURL: https://developer.amd.com.cn/radeon/api/v1
|
|
18
|
+
displayName: Radeon Cloud
|
|
19
|
+
|
|
20
|
+
# 默认思考档位。medium 在全部 8 个已收录模型上均被接受。
|
|
21
|
+
reasoning: medium
|
|
22
|
+
|
|
23
|
+
# Radeon 的思考与答案共用同一个 max_tokens 预算,预算不足时 content
|
|
24
|
+
# 会变成空字符串。实测 reasoning_effort=low 时,一个「详细解释」类
|
|
25
|
+
# 问题在 max_tokens=400 下思考就把预算吃光、content 为空;因此这里
|
|
26
|
+
# 取 32768,给思考留出充足余量。max_tokens 是上限而非计费项,
|
|
27
|
+
# 实际按产出计费,调高不增加成本。
|
|
28
|
+
defaultMaxTokens: 32768
|
|
29
|
+
|
|
30
|
+
# Radeon 的流式超时语义是「两个分片之间的间隔」而非总时长,
|
|
31
|
+
# 对应 DSH 的 streamIdleTimeoutMs。
|
|
32
|
+
streamIdleTimeoutMs: 600000
|
|
33
|
+
|
|
34
|
+
# Radeon 触发每分钟限流时 Retry-After 为 60 秒,退避上限必须 ≥ 该值,
|
|
35
|
+
# 否则重试会在限流窗口结束前全部失败。
|
|
36
|
+
retryPolicy:
|
|
37
|
+
mode: normal
|
|
38
|
+
maxRetries: 5
|
|
39
|
+
backoff:
|
|
40
|
+
initialDelayMs: 1000
|
|
41
|
+
maxDelayMs: 120000
|
|
42
|
+
jitterRatio: 0.2
|
|
43
|
+
|
|
44
|
+
# ── 协议兼容开关 ──────────────────────────────────────────────
|
|
45
|
+
compat:
|
|
46
|
+
# ★ 关键:DSH 默认对普通 OpenAI 兼容端点发送 developer 角色,
|
|
47
|
+
# 而 8 个模型中有 5 个直接拒绝(unknown role: developer)。
|
|
48
|
+
supportsDeveloperRole: false
|
|
49
|
+
supportsReasoningEffort: true
|
|
50
|
+
# Radeon 的网关只按白名单转发字段,thinking_budget /
|
|
51
|
+
# thinking_token_budget / thinking_budget_tokens 三个字段
|
|
52
|
+
# 全部被静默丢弃,因此不能开启思考预算。
|
|
53
|
+
supportsThinkingTokenBudget: false
|
|
54
|
+
maxTokensField: max_tokens
|
|
55
|
+
thinkingFormat: openai
|
|
56
|
+
|
|
57
|
+
# ── 模型目录 ──────────────────────────────────────────────────
|
|
58
|
+
# 共收录 8 个对话模型。目录接口里还有 MinerU2.5-Pro,但它的
|
|
59
|
+
# context_length 为 0、tools 为 false,走的是独立的 /v1/ocr
|
|
60
|
+
# 文档识别端点而非对话接口,故不收录。
|
|
61
|
+
models:
|
|
62
|
+
# ── DeepSeek 系:7 档全接受,`none` 可关闭思考 ──
|
|
63
|
+
- id: DeepSeek-V4.1-Flash
|
|
64
|
+
name: DeepSeek-V4.1-Flash
|
|
65
|
+
contextWindow: 1048576
|
|
66
|
+
input: [text, image]
|
|
67
|
+
reasoningEfforts:
|
|
68
|
+
off: none
|
|
69
|
+
minimal: minimal
|
|
70
|
+
low: low
|
|
71
|
+
medium: medium
|
|
72
|
+
high: high
|
|
73
|
+
xhigh: xhigh
|
|
74
|
+
max: max
|
|
75
|
+
|
|
76
|
+
- id: DeepSeek-V4-Flash
|
|
77
|
+
name: DeepSeek-V4-Flash
|
|
78
|
+
contextWindow: 1048576
|
|
79
|
+
input: [text]
|
|
80
|
+
reasoningEfforts:
|
|
81
|
+
off: none
|
|
82
|
+
minimal: minimal
|
|
83
|
+
low: low
|
|
84
|
+
medium: medium
|
|
85
|
+
high: high
|
|
86
|
+
xhigh: xhigh
|
|
87
|
+
max: max
|
|
88
|
+
|
|
89
|
+
- id: DeepSeek-V4-Flash-Vision-Exp
|
|
90
|
+
name: DeepSeek-V4-Flash-Vision-Exp
|
|
91
|
+
contextWindow: 1048576
|
|
92
|
+
input: [text, image]
|
|
93
|
+
reasoningEfforts:
|
|
94
|
+
off: none
|
|
95
|
+
minimal: minimal
|
|
96
|
+
low: low
|
|
97
|
+
medium: medium
|
|
98
|
+
high: high
|
|
99
|
+
xhigh: xhigh
|
|
100
|
+
max: max
|
|
101
|
+
|
|
102
|
+
- id: MiMo-V2.6-Flash
|
|
103
|
+
name: MiMo-V2.6-Flash
|
|
104
|
+
contextWindow: 1048576
|
|
105
|
+
input: [text, image]
|
|
106
|
+
reasoningEfforts:
|
|
107
|
+
off: none
|
|
108
|
+
minimal: minimal
|
|
109
|
+
low: low
|
|
110
|
+
medium: medium
|
|
111
|
+
high: high
|
|
112
|
+
xhigh: xhigh
|
|
113
|
+
max: max
|
|
114
|
+
|
|
115
|
+
# ── Qwen 系:无 minimal/max/high,仅 none/low/medium/xhigh ──
|
|
116
|
+
# 这两个模型唯一能关闭思考的方式是 none;传入 high 会返回 400。
|
|
117
|
+
- id: Qwen3.8-27B
|
|
118
|
+
name: Qwen3.8-27B
|
|
119
|
+
contextWindow: 262144
|
|
120
|
+
input: [text, image]
|
|
121
|
+
reasoningEfforts:
|
|
122
|
+
off: none
|
|
123
|
+
low: low
|
|
124
|
+
medium: medium
|
|
125
|
+
xhigh: xhigh
|
|
126
|
+
|
|
127
|
+
- id: Qwen3.8-Flash-Next
|
|
128
|
+
name: Qwen3.8-Flash-Next
|
|
129
|
+
contextWindow: 262144
|
|
130
|
+
input: [text, image]
|
|
131
|
+
reasoningEfforts:
|
|
132
|
+
off: none
|
|
133
|
+
low: low
|
|
134
|
+
medium: medium
|
|
135
|
+
xhigh: xhigh
|
|
136
|
+
|
|
137
|
+
# ── GLM 系:不接受 none/minimal/xhigh/max ──
|
|
138
|
+
# 不声明 off 键:该模型没有「关闭思考」的档位。
|
|
139
|
+
- id: GLM-5.3-Flash
|
|
140
|
+
name: GLM-5.3-Flash
|
|
141
|
+
contextWindow: 262144
|
|
142
|
+
input: [text]
|
|
143
|
+
reasoningEfforts:
|
|
144
|
+
low: low
|
|
145
|
+
medium: medium
|
|
146
|
+
high: high
|
|
147
|
+
|
|
148
|
+
# MiniCPM5-2B 接受 low/medium/high,但不返回分离的思考内容
|
|
149
|
+
# (思考字段恒为空)。给出档位控件会误导用户,
|
|
150
|
+
# 故显式声明为非推理模型。
|
|
151
|
+
- id: MiniCPM5-2B
|
|
152
|
+
name: MiniCPM5-2B
|
|
153
|
+
contextWindow: 131072
|
|
154
|
+
input: [text]
|
|
155
|
+
reasoningEfforts: false
|