DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zefferry /

zefferry/dsh-station-tuner

Verified

为 Mineradio 主题增加工作区电台调台。

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

Station Tuner(调台)

给 Mineradio 主题加一个小功能:每个工作区的「…」菜单里,在「重命名」下方多出一行 「调台」。

  • 鼠标悬停在这一行上,旁边会弹出一个只有进度条的小面板;
  • 按住左右拖动进度条,即可改变该工作区的电台偏移(FM 台号);
  • 整屏背景 / 氛围光 / 色散颜色,以及 wordmark 旁的 FM xxx 数字实时跟随;
  • 调过的值会记住(写进 Mineradio 自己的 dsh.ui-mineradio.stations 映射表);
  • 不修改 Mineradio 源码:只复用它的 station 映射表与实时重读机制;
  • 主题未启用时,菜单里不会出现「调台」。

依赖

  • DSH Web 桌面端 0.2.2-rc.1 或更新(本插件使用该版本引入的官方菜单贡献 API: contextMenus.register、contextMenu.icon 插槽);
  • Mineradio 主题已启用(插件靠它的 data-dsh-station-tuner 徽章与 --dsh-aqua-spot-color 变量判断主题是否在跑)。

用法

  1. 确保主题是 Mineradio;
  2. 把鼠标移到某个工作区行,点「…」;
  3. 菜单第二行是「调台」——悬停它,右侧弹出一个只有进度条的小面板(外框与下拉菜单等宽、与该菜单行垂直居中对齐);
  4. 按住进度条左右拖动:FM 数字与整屏背景色实时变化,松手即保存。

也可以直接点击「调台」这一行:面板会保留在当前工作区菜单里,再拖也行。

实现要点

  • 位置与抗升级:菜单项通过官方 contextMenus.register({ target: "workspace", order: 150 }) 贡献。DSH 的菜单是数据驱动的:按 provider 的 order 排序, 内置项是「重命名(100) / 在文件夹显示(200) / 删除工作区(300)」,所以 150 刚好落在「重命名」下方。它不依赖菜单的 DOM 结构、类名或条目数量——以后 DSH 增删菜单项、改样式,这一行依然会被渲染。
  • 为什么拖拽条是悬停弹出的小面板:官方给第三方的自定义插槽 contextMenu.content 没有 order,只能渲染在所有原生项之后;而原生项本身 不能内嵌自定义控件。所以这里用「原生项(位置可控)+ 悬停时弹出的自有面板 (可放拖拽条)」,面板位置贴着菜单右侧,样式从菜单表面复制。
  • 实时变色:拖动时临时把 window.matchMedia 改成让 prefers-reduced-motion: reduce 命中,使 Mineradio 走「无动画、立即切换」分支; 同时把当前选中工作区的标题临时改成「零宽空格 + 原标题」(视觉不可见), 触发 Mineradio 的 MutationObserver 重新读取 station 映射表,从而整屏换色。 松手后还原标题、删除临时键。
  • 调非当前工作区:借助当前选中行做颜色预览,松手后回到当前工作区自己的台。
  • 数值换算:offset = (FM - 44 + 360) % 360; 背景色相 = (fluidHue + offset) % 360。

更新与故障排查

  • DSH 升级后整页刷新一次(Ctrl+R / Cmd+R)。DSH 的插件热更新在宿主 release 变化时会暂停,页面刷新后才会按新 release 重新加载插件。
  • 菜单里没有「调台」:先确认 Mineradio 主题已启用;再确认 DSH 版本不低于 0.2.2-rc.1。
  • 找不到 FM 数字:Mineradio 主题可能被关闭或升级改动了内部结构, 此时菜单项会隐藏(不会报错)。
  • 悬停不出现面板但菜单项在:说明 DSH 改动了菜单按钮结构;面板是增强功能, 菜单项本身不受影响。

文件

  • lib/client.js —— 客户端插件(手写 bundle,无需构建);
  • lib/index.js —— 宿主半边空壳(让 profile 认识这个包);
  • cordis.patch.yml —— 挂载宿主半边的 bundle patch;
  • package.json —— dsh.bundle.patch、dsh.client 元数据。
—/ 5

No ratings yet

Verified DSH bundle

Commit 0d1810546efc

Community comments

No comments yet. Be the first to write one.

DSH HUB

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

CommunityResourcesAPIAbout