dsh-tes-spinner

dsh-tes-spinner

一个常驻在 DSH Web 界面上的 TES 陀螺挂件：点一下就转，能拖到任意位置，带转速滑条和同步歌词。

不需要左侧面板入口 —— 它像宠物插件一样，直接浮在页面上。

功能

• 点击旋转 —— 沿用真实陀螺的物理：点一下给一记"抽打"冲量，转速按恒定摩擦线性衰减，转得越快停得越久
• 连点加速 —— 旋转中再点会叠加转速（方向锁定，不会互相抵消）
• 拖动定位 —— 拖到任意位置，位置会被记住（存 localStorage，刷新后回到原处）
• 转速滑条 —— 0.2× ~ 2.0× 实时调节，数值同样被记住
• 歌词同步 —— 读取同名 .lrc 文件，在陀螺上方单行显示，随播放进度滚动
• 音乐联动 —— 转动时播放音频，音量跟随转速；停下自动淡出并复位
• 优雅降级 —— 音频、歌词、图片任一缺失都不影响其他功能

安装

把整个目录放到 DSH profile 的 node_modules 下（或用 link 指向本目录），然后在 profile 的 package.json 里加上：

{
  "dependencies": {
    "dsh-tes-spinner": "link:/path/to/dsh-tes-spinner"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-tes-spinner"
      ]
    }
  }
}

重启 DSH 生效。

使用

想复位位置，在浏览器控制台执行：

localStorage.removeItem('dsh-tes-spinner-pos')

目录结构

dsh-tes-spinner/
├─ lib/
│  ├─ index.js        宿主侧:注册静态资源路由(public/ 走这里)
│  └─ client.js       浏览器侧:陀螺组件、歌词解析、挂载逻辑
├─ public/
│  ├─ tes-gyro.png    陀螺图形
│  ├─ sudden-spinner.mp3   音频
│  └─ sudden-spinner.lrc   歌词
├─ cordis.patch.yml   插件注册补丁
└─ package.json

开发说明

本项目没有构建步骤。 lib/ 下的文件就是源码本身（手写 JS），改完直接重启 DSH 生效。

之所以不用 TypeScript 编译链：DSH 加载的就是 lib/index.js 和 lib/client.js 这两个 ESM 文件，而最初的 src/*.ts 与最终实现已经严重脱节（形态从侧边栏面板改成了常驻浮层），保留两套互相矛盾的"源码"只会误导人，所以移除了。

两个文件的分工：

• lib/index.js —— 宿主侧。唯一职责是用 webServer.register 注册一条前缀路由，把 public/ 目录挂到 /plugins/dsh-tes-spinner/。（DSH 的 /plugins/ 端点只提供客户端 bundle 和 RPC，不提供任意插件文件，所以必须自己注册。）
• lib/client.js —— 浏览器侧。用 window.__ModuleLoader__.load({ id, factory }) 包装，自己 createRoot 挂到 document.body。

素材来源与声明

• 音频与歌词：来自 B 站 UP 主 蔚蓝边际 的作品 TES先锋赛单曲1.0《突然的陀螺》（BV1h5QaY5EaH）。 该曲为改编翻唱，完整归属如下：

  角色	署名
  原曲	《突然的自我》
  原唱	伍佰
  填词 / 翻唱 / 视频	蔚蓝边际
  混音	@SpecialSound

  版权归上述原作者所有，此处仅作非商业的个人使用与演示。

• 陀螺图形：为 TES（滔搏电子竞技俱乐部） 战队标志样式，属其商标/标识。仅限非商业的社区个人使用，不得用于商业用途。

• 代码：本项目自带代码由作者编写。

如原作者或权利方对素材使用有异议，请联系删除。

已知限制

• 陀螺位置、转速偏好存在浏览器 localStorage，换浏览器或清缓存会重置
• 歌词目前读的是固定文件名 public/sudden-spinner.lrc；换歌需要同时替换 .mp3 和 .lrc，并在 lib/client.js 里改 LYRICS_URL 与 <audio> 的 src
• 音频文件约 3.3 MB，会让仓库体积偏大