DSH 电台 · dsh-plugin-radio

在 DSH Web GUI 里边工作边听的网络电台。 一条 24px 的胶囊嵌在 composer 状态行里，和轮次、token 那些状态并排；点一次出声，切台、暂停、音量、曲目都在它自己的面板里。

Internet radio for the DeepSeek-Harness Web GUI — a 24px capsule in the composer status row.

安装

方式一：在 dsh 里直接装（推荐）

1. 侧边栏 插件 → 添加插件；

2. 粘贴仓库地址并安装：

   https://github.com/CXZAAA/dsh-radio
   

3. 如果提示 restart-required，重启一次再刷新：

   sudo systemctl restart dsh-web
   

包内声明了组合包 patch，插件页会自动加好 Loader 行并默认启用，不需要手改配置。

之前用脚本装过？先清掉旧的那份

dsh plugin --profile web remove dsh-plugin-radio

再删掉 ~/.dsh/profiles/web/cordis.patch.yml 末尾 # dsh-radio (managed by install-local.sh) 那一段，避免同一行被写两次。

方式二：克隆后用脚本

git clone https://github.com/CXZAAA/dsh-radio.git
cd dsh-radio
bash scripts/install-local.sh
sudo systemctl restart dsh-web

仓库已提交 lib/ 构建产物，不需要在本地构建。

其他安装方式与卸载

pnpm git 安装（未在 CI 中验证；github: 简写默认走 SSH，没有 key 会卡住，用 git+https://）：

dsh plugin --profile web add "git+https://github.com/CXZAAA/dsh-radio.git"

之后手动在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

# dsh-radio
- insert:
    - id: radio
      name: dsh-plugin-radio

卸载：

dsh plugin --profile web remove dsh-plugin-radio

并删掉上面那段 id: radio，重启 dsh-web。

能做什么

• 7 个预置电台：Nightride FM 四个频道、Radio Paradise 两个频道、EVE Radio。
• 切台干净：先停旧流再起新流，不会叠音；主地址失败静默切备用地址一次，12 秒没出声才算失败。
• 首声尽可能快：只预热一条流（上次听的那台），点击时复用同一个音频元素。
• 真实频谱：AnalyserNode 采样，收起态 28 根小方柱，面板里一条 56 根的频谱带。
• 当前曲目：Nightride 直读 Icecast，Radio Paradise 走宿主只读路由，面板里显示 歌手 — 曲名。
• 记住状态：上次电台、音量、静音、设置都存在浏览器本地。
• 不打扰：只用 --dsw-* 主题变量，明暗主题都成立；颜色只出现在频谱柱和失败态。

用起来

操作	结果
点胶囊左端	播放 / 暂停（失败时变成重试）
点「下一台」	切到下一台，7 台循环
点台名	向上弹出面板
面板里点某台	切过去；点当前台是暂停 / 恢复
面板右上角齿轮	系统媒体键、频谱样式、记住上次电台
底部一行	左侧播放 / 下一台，右侧静音 + 音量滑杆
Esc	关闭面板

面板：电台列表、频谱、当前曲目	设置：三项开关

电台

电台	来源	流
ChillSynth	Nightride FM	MP3 320
Nightride	Nightride FM	MP3 320
Darksynth	Nightride FM	MP3 320
Spacesynth	Nightride FM	MP3 320
Main Mix	Radio Paradise	AAC 320
Mellow Mix	Radio Paradise	AAC 128
EVE Radio	GamingNow	MP3 256

全部是浏览器直放的渐进式流，没有 HLS、不需要音频代理。

已知限制

• 入口只在对话面板可见；切到轨迹等其他主面板时入口消失，播放不中断。
• EVE Radio 的 Icecast 没有有效 title，所以不显示曲目。
• EVE Radio 的备用地址是 http://，dsh 跑在 HTTPS 下时会被混合内容策略拦掉。
• Nightride 没有低码率 MP3，移动网络首声依赖预缓冲。
• Radio Paradise 的曲目信息需要宿主半侧的小路由；改了宿主代码要重启 dsh 才生效。
• 不支持自定义电台（v0.1 的范围）。

开发

pnpm install
pnpm typecheck   # tsc --noEmit
pnpm build       # esbuild → lib/client.js + lib/index.js
pnpm test        # node:test：45 项，含 ModuleLoader 冒烟与宿主路由

客户端半侧支持 HMR：改完 pnpm build 会自动推进已打开的页面；宿主半侧改动需要重启 dsh。

包结构

src/
  index.ts             # 宿主半侧：注册 /plugins/dsh-plugin-radio/now-playing（RP 曲目代理）
  client/
    index.ts           # name / inject: ['slots'] / apply(ctx)
    stations.ts        # 7 个电台与主备地址
    settings.ts        # 设置与 localStorage 解析
    i18n.ts            # 中文（默认）/ 英文
    player.ts          # 单例 Audio、预缓冲、超时、备用流、AnalyserNode
    nowPlaying.ts      # Nightride / EVE / RP 三条曲目来源
    store.ts           # 模块级 store + MediaSession + 持久化
    Radio.tsx          # 状态行胶囊 / 面板 / 设置
    styles.ts          # CSS 字符串与 <style data-dsh-radio> 注入
lib/
  client.js            # window.__ModuleLoader__.load({ id, factory })
  index.js             # 宿主半侧产物
locale/{zh,en}.json    # 插件页显示的标题与描述
cordis.patch.yml       # 组合包 patch：插入 id: radio

文档

• GLOSSARY.md：电台条目 / 来源 / 预置 / 备用流 / 首声 / 预缓冲
• docs/spec-v0.1.md：实现任务书
• docs/acceptance-log.md：验收清单与证据
• docs/network-probe.md：中国大陆可达性与码率实测
• ADR：0001 浏览器直放 · 0002 投放位置 · 0003 曲目来源
• design/：方向稿、可交互原型、harness 截图

License

MIT © 2026 CXZAAA