dsh-amd-model-load
English · 简体中文
在 DeepSeek Harness(DSH Desktop)里给 AMD Radeon TokenFactory 的免费模型显示实时负载徽章。
模型选择列表里每一行会多出一枚「状态点 + 百分比」的负载 chip,比如 [●] 20.1%;点进 插件 → 已安装 → dsh-amd-model-load 就能直接看到一张卡片,把 15 个免费模型按 AMD 官网的五类分组列出、组内按繁忙度从空闲到繁忙排序(不需要再点「配置」)。插件项的行「配置」页里同样有这张卡。本插件不再注册设置页。
数据来自 AMD 公开的负载接口,不需要 API Key。
目录:快速开始 · 界面预览 · 功能 · 安装 · 配置 · 数据来源 · 已知限制 · 开发 · 许可证
快速开始
前置:DSH Desktop 0.12.1 或更新(内嵌 dsh 0.2.1-rc.2)即可装;但配置入口(插件行的「配置」按钮)需要 0.14.0+(内嵌 dsh ≥ 0.2.2-rc.1,见已知限制),本机已装 pnpm。
git clone https://github.com/ORIOW/dsh-amd-model-load.git
打开当前 profile 的 package.json(Desktop 默认在
~/Library/Application Support/dsh-desktop/harness/profiles/web/package.json),在 dependencies 里加一行:
"dsh-amd-model-load": "link:/absolute/path/to/dsh-amd-model-load"
在同一个目录跑 pnpm install,然后重启 DSH Desktop。重启后在 插件 → 已安装 → dsh-amd-model-load 的行上能看到「配置」按钮、点开有负载卡片即为装好;日志怎么核对见校验安装。
界面预览
下面是文字示意,不是截图——真实界面由 DSH 主题决定,颜色与间距随主题变化:
插件 → 已安装 → dsh-amd-model-load ← 包详情页配置区直接就是这张卡
VLM (Vision) ← 组标题原样取上游 capability_label
● MiMo-V2.6-Flash FREE 空闲 20.1% ← 组内按繁忙度升序,空闲在前
● MiniCPM-V-4.7-1B FREE 繁忙 61.8%
LLM (Text)
● DeepSeek-V4.1-Flash-1017 FREE 空闲 5.7%
● GLM-5.3-Flash FREE 繁忙 33.2%
OCR (Document)
● MinerU2.5-Pro FREE 空闲 12.4%
模型选择列表
DeepSeek-V4.1-Flash-1017 [●] 5.7% ← 本插件追加的 chip,紧跟官方 1017 徽章
GLM-5.3-Flash [●] 33.2%
一行读数的固定顺序是「状态点 → 模型 id → FREE 徽章 → 状态文字 → 百分比」;没有负载数据的行整行降到 55% 不透明度,右侧显示 — 而不是编造一个数字。
功能
| 挂载点 | 效果 |
|---|---|
包详情页(plugins.bundle.config,key = dsh-amd-model-load) |
打开 插件 → 已安装 → dsh-amd-model-load 即直接看到五分组卡片(宿主把它渲染在 README 文档区下方的 data-plugin-config 一节里) |
行配置页(plugins.row.config,key = dsh-amd-model-load#amd-model-load) |
按 VLM / LLM / Decision / TTS / OCR 五类分组;组内按 utilization 升序(空闲在前);带 FREE 徽章的模型照抄 AMD 官网样式;顶部显示最后更新时间,超时自动标记为过期 |
模型选择列表(conversation.input.model.label) |
每个 AMD 模型的 option 行追加一枚负载 chip(状态点 + 百分比,悬浮与读屏可读完整语义);非 AMD 行、收起按钮、菜单顶部保持原样 |
| 兼容性 | 不覆盖 DeepSeek 官方的 1017 徽章:本插件在 priority: -1 注册,代渲染官方的「模型名 + 1017」形态后再追加自己的徽章 |
轮询节奏:负载 10 分钟一次(AMD 的 VLM/LLM 只有十几到三十 tokens/s,更快没有意义),目录 6 小时一次。
安装
本插件是 DSH 第三方插件,两种装法:link: 挂载(已实测)和插件页添加(未实测)。
方式一:link 挂载(已验证)
把本仓库克隆到本地任意位置。
编辑当前 profile 的
package.json(Desktop 默认在~/Library/Application Support/dsh-desktop/harness/profiles/web/package.json),在dependencies里加一行:"dsh-amd-model-load": "link:/absolute/path/to/dsh-amd-model-load"在同一目录跑
pnpm install,生成node_modules里的符号链接。重启 DSH Desktop(宿主只在启动时重新组合插件;改 profile 触发的 HMR 在依赖未就绪时不重试)。
装好后:点进 插件 → 已安装 → dsh-amd-model-load 的包详情页应直接出现五分组负载卡片(行上的「配置」按钮点开也有同一张卡);日志里能看到 [amd-model-load] host loaded 与 catalog ok: 15 models。
方式二:插件页添加
在 插件 → 添加插件 里填本地路径或仓库地址。这条路径尚未实测,遇到问题请优先用方式一。
⚠️ 本插件尚未发布到 npm(截至 v0.1.2),填包名
dsh-amd-model-load是装不上的。
校验安装
# 宿主日志(Desktop)
tail -f "/Users/dengjiawei/Library/Logs/DSH Desktop/harness.log" | grep amd-model-load
正常时依次出现:
[amd-model-load] host loaded
[amd-model-load] pollers started (load pollMs=600000, timeoutMs=40000; catalog pollMs=21600000)
[amd-model-load] catalog ok: 15 models, source=shared
[amd-model-load] load ok: 13 models, scope=fleet
catalog ok 要等一次成功拉取,load ok 首次要等约 26 秒(AMD 接口本身的响应时间)。
配置
所有字段都有默认值,通常不需要改。可覆盖项(写在挂载条目的 config 里):
| 字段 | 默认值 | 说明 |
|---|---|---|
pollMs |
600000 |
负载轮询间隔(毫秒),10 分钟 |
timeoutMs |
40000 |
负载请求超时;必须大于 AMD 的 ~26 秒响应时间 |
staleAfterMs |
660000 |
超过该时长未刷新即标记为过期(11 分钟) |
loadUrl |
AMD load 端点 | 负载接口地址 |
catalogPollMs |
21600000 |
目录轮询间隔,6 小时 |
catalogUrl |
bootstrap?section=dedicated |
目录首选端点(一次拿全 15 条) |
catalogFallbackUrl |
bootstrap?directory=true |
目录回退端点(拿卡片列表后逐个查详情) |
catalogTimeoutMs |
20000 |
目录请求超时 |
数据来源
两个端点都在 https://developer.amd.com.cn,免 Key,但要求请求头 Origin: https://developer.amd.com.cn,否则返回 403 Invalid request origin——插件已自动带上。
- 目录:
POST /radeon/api/tokenfactory/bootstrap?section=dedicated→shared_models[],约 0.4 秒 / 58 KB。 - 负载:
GET /radeon/api/tokenfactory/load→{ models: { <id>: { state, label, utilization } }, scope: "fleet" },约 26 秒。
匹配模型时只认「去掉 model_gateway: 前缀的全 id」,不能用 display_config.name(DeepSeek-V4.1-Flash 的 name 带 -1017 后缀,会永远匹配不到负载);徽章只认 display_config.badge_label。
已知限制
- 配置入口需要 DSH Desktop ≥ 0.14.0(内嵌 dsh ≥ 0.2.2-rc.1):
plugins.row.config是 0.2.2-rc.1 才有的 slot,而plugins.bundle.config/plugins.row.config都属于 0.2.2-rc.1 的插件管理 UI,slots.inject对未声明的 slot 是静默等待(不报错、不打日志)——旧版本宿主上「配置」按钮与配置页都不会出现,且没有任何日志可查。v0.1.1 及更早版本注册的是设置页,本插件不再注册设置页,配置入口在 插件 → 已安装 → dsh-amd-model-load。 - 只覆盖 Public Free 区的 15 个模型,Dedicated 区(MiniCPM 系列)按设计不显示。
- 依赖 AMD 的公开接口,对方改版就会失效;
load端点单次响应约 26 秒,首次出数是慢的,属正常。 - 与
dsh-reasoning-effort0.8.1 及更早同装时,模型列表的徽章不会显示:那个版本以priority: -100整个替换了 composer 的模型选择器,且从不渲染conversation.input.model.label子 slot,连官方1017徽章也会一起消失。0.9.0 起上游改成「包裹原生组件」,已修好。排查过程见 M4-UPSTREAM-FINDING.md。 - 收起态的模型行(
placement: "trigger")会随流式输出被宿主父组件频繁重渲染(实测空闲 ~8 次/秒、流式期间 105–129 次/秒)。本插件在这条路径上只做一次 O(1) 缓存查找、渲染期不写任何副作用,日志也不再按次上报;该重渲染属宿主行为,不在本插件修复范围。分析与测法见 M5-RENDER-CHURN.md。 - 定位上述两个问题期间曾临时带一层诊断设施(
reportDiag/probeLedger/ heartbeat / 设置卡诊断行)。v0.1.1 已全部摘除:发布版不再向宿主日志写client-diag,也不再持有任何诊断定时器;保留的只有注册失败时的一条console.error(带[amd-model-load]前缀,只进浏览器 console)。
开发
无需构建步骤,纯 ESM。测试用 Node 内置 test runner:
node test/load-source.test.mjs # 32 用例:归一化、过期判定、轮询器
node test/catalog.test.mjs # 50 用例:目录解析、五分类分组、排序
node test/client.test.mjs # 82 用例:两个 slot 的注册与渲染分支
bash test/with-stub.sh # 24 用例:host 半身(临时建 schemastery 桩,退出即删)
host套件必须走bash test/with-stub.sh:插件本身不带依赖,直接node --test test/*.test.mjs会因缺@deepseek-ai/schemastery桩而MODULE_NOT_FOUND。
连真实端点跑一次(约 30 秒):
node test/e2e-live.mjs
目录结构:
lib/index.js host 半身:双轮询器 + loopback RPC 通道(load / catalog / refresh / diag)
lib/load-source.js 负载数据源(零依赖,可裸跑单测)
lib/catalog.js 目录数据源 + 五分类分组排序(零依赖)
lib/client.js 浏览器半身:插件行配置页 + 模型行 chip,共用唯一快照订阅器
cordis.patch.yml bundle 补丁:把插件 insert 进 profile
test/ 四个套件 + fixtures + with-stub.sh + e2e-live.mjs
各里程碑的验证记录与踩坑在 M0-VERIFY.md、M1-REPORT.md、M3-REPORT.md、M4-*.md 里。
许可证
MIT © 2026 dengjiawei
No comments yet. Be the first to write one.