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变量判断主题是否在跑)。
用法
- 确保主题是 Mineradio;
- 把鼠标移到某个工作区行,点「…」;
- 菜单第二行是「调台」——悬停它,右侧弹出一个只有进度条的小面板(外框与下拉菜单等宽、与该菜单行垂直居中对齐);
- 按住进度条左右拖动:
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元数据。
No comments yet. Be the first to write one.