DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

ORIOW /

ORIOW/dsh-amd-model-load

Verified

DSH Desktop 插件 · 在模型选择器与插件管理页显示 AMD Radeon TokenFactory 免费模型的实时使用率(Public Free 15 个模型,5 类分组)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@88dd7086

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 挂载(已验证)

  1. 把本仓库克隆到本地任意位置。

  2. 编辑当前 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"
    
  3. 在同一目录跑 pnpm install,生成 node_modules 里的符号链接。

  4. 重启 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-effort 0.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

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit 88dd70862253

Community comments

No comments yet. Be the first to write one.