肥鱼电台 FishFM

给正在 DSH 里工作的 DeepSeek 一副耳机。

FishFM 是 DeepSeek Harness（DSH）的社区音乐插件。 导入你的网易云音乐，以常听歌曲为起点建立本地音乐偏好，让大肥鱼自主选歌、探索新歌；你可以随时点播、暂停、换曲或静音。

首个公开测试版 0.1.0-beta.1 已在 npm 发布。 当前支持 Windows／网易云，可在 DSH 插件管理器中添加 dsh-feiyufm-core@beta。稳定版验收仍在进行，QQ 接入暂缓。

main 的后续改动尚未发布到 npm：小开关、完整素材、多窗口/高窄适配、播放中断恢复与紧凑布局已实现。最近全量基线为 N21 的 408 项测试；U14 布局的 54 项相关测试、126 模块及隔离浏览器复验通过。源码、已发布首包和历史本地包的状态分别见 开发路线。

开始使用 · npm 包 · 功能介绍 · 文档索引 · 开发与贡献 · 发布记录

界面预览

以上截图来自 2026-10-05 客户端的隔离预览，使用模拟歌曲和统计数据，不代表真实账号记录或模型效果，也未展示后续彩蛋开关。主面板、设置页和可隐藏的悬浮条共用同一个音乐服务；切换 DSH 页面或隐藏控件后仍可继续播放。

能做什么

「静听」会关闭电脑声音，让自主听歌与有效经历继续。音乐偏好、用户反馈和禁播约束分别保存，平台请求失败不会被当成不喜欢一首歌，反馈也不会改动网易云收藏。

推荐怎样运行

你的常听歌曲 / 喜欢 / 歌单
          ↓
本地画像与歌曲关系 → 候选召回 / 可选模型歌单与筛选
          ↓
本地逐曲选歌 → 平台核对与资源解析 → 独立播放服务
          ↓
有效收听记录 → 有界偏好更新 → 下一次选择

逐曲选歌、播放和偏好更新不请求模型。 画像总结、模型歌单、发现候选筛选是低频操作，共用 token 预算，并受冷却与每日上限约束；成功和失败的调用都会记录到账本。自动更新可关闭，模型不可用时界面展示实际状态。

模型歌单会先搜索核对，再播放可匹配的歌曲。歌单暂时没有可播曲目时，用户主动点「下一首」可回退输入曲库并显示原因；自主续播保持歌单边界。完整行为见 产品规格。

开始使用

环境要求

安装到 DSH

FishFM 以 npm 包分发，但需要通过 DSH 安装到它的 profile。DSH 会下载包、读取 dsh.bundle 并登记插件；单独运行 npm install dsh-feiyufm-core 不会完成 DSH 的安装与启用。官方打包与安装说明

在 DSH 侧栏打开「插件 → 添加插件」，在「包名或地址」中输入：

dsh-feiyufm-core@beta

固定安装当前版本用 dsh-feiyufm-core@0.1.0-beta.1。等待安装完成后点击 立即启用；下载失败时可将「安装源」切换为「npm 官方源」再试。

1. 点击侧栏 肥鱼电台，或进入 设置 → 肥鱼电台。
2. 在网易云卡片扫码、手机确认，再导入音乐并点播。
3. 模型功能使用你自己在 DSH 中配置的模型；不需要模型即可点播输入歌曲。

DSH 0.2.0-rc.2 的插件页暂不支持自动更新。升级时先在插件管理器卸载 FishFM，再添加 dsh-feiyufm-core@beta 或新版的固定版本，并点击「立即启用」。已有 workspace 安装也按此方式更换来源，同一 profile 只启用一份 FishFM。数据保存在 DSH 数据目录，升级时使用同一 profile，不删除数据库，之后核对曲库、偏好与暂停状态。

dsh plugin --profile web add dsh-feiyufm-core@0.1.0-beta.1 --registry https://registry.npmjs.org/

安装、更新、数据位置和常见问题见 使用说明。首次播放仍可能等待数秒，性能边界见下方 当前进度。

从源码开发

使用上述 Windows 和 Node.js 环境：

git clone https://github.com/A7m0spHere/dsh-feiyuFM.git
cd dsh-feiyuFM
npm ci --ignore-scripts --no-audit --no-fund
npm run build

开发时通过插件管理器添加仓库绝对目录。dist/ 是开发产物，不是独立安装器；开发检查和真实音频测试要求见 贡献指南。

当前进度

0.1.0-beta.1 已发布，稳定 v0.1 验收尚未完成。 网易云真实扫码、导入、播放、自然续播、部分偏好成长、设置持久化与停用恢复已有历史实测；本次发布额外验证了隔离安装与 DSH 页面交互。完整验收状态以 开发路线 为准。

• 2026-10-07 源码：N21 修复播放中断检测、原曲一次恢复、断线曲终续播与恢复竞争；408/408 测试、126 模块与构建通过，生产未重载。此前 U12 完整素材与彩蛋、U13 跨窗口/高窄布局已实现并隔离验证，完整生产组合仍待验。这些改动尚未发布到 npm。

• 同日 U14 紧凑布局：模拟数据下播放器约少 31%、设置默认内容约少 26%；54 项相关测试及浅深色/窄窗口/键盘浏览器复验通过，未重跑音频全量、未重载生产。

• npm 下载包的 SHA-512／SHA-1 与封存包一致；从 registry 全新安装后的入口、图片、Core、WPF 和实际依赖版本检查均 ALL-PASS。本机 386 项测试通过；远端 CI 383 项通过，3 项依赖音频环境的回归显式跳过。详情见 发布记录。

• 2026-10-06 发布核验时 beta 和 latest 都指向 0.1.0-beta.1；安装建议显式使用 @beta 或固定版本。稳定版完成后再更新 latest。

• 首次播放仍需数秒；默认从 5 个预热持有者开始，根据实际打开耗时最多补齐到 8 个。显式 FISHFM_PLAYBACK_WARM_HOLDERS=0..8 使用固定数量，0 关闭。性能与填池时间随环境变化；真实长期模型筛选质量与生产迁移仍待验证。

• 真实两小时运行、DSH 模型请求/上下文对照与完整多会话验收尚未完成。

• QQ 音乐保留在规划与适配代码中，接入暂缓；当前不提供可用的 QQ 登录与播放链路。其他操作系统未验证。

数据与模型

播放核心独立于可见 UI。默认数据存于 $DSH_HOME/fishfm/music.sqlite，常见本机位置为 ~/.dsh/fishfm/music.sqlite。网易云会话使用 Windows DPAPI 加密，数据库只保存凭据引用；运行数据库、Cookie 和音频不会随仓库同步。

使用模型功能时，会发送受大小上限约束的歌曲名称、艺人、反馈与关系等音乐事实；歌单生成不发送平台 ID；候选筛选会发送用于匹配结果的曲目键（含平台与歌曲 ID）。Cookie 和凭据不进入模型事实包。具体字段、预算与持久化边界见 架构 和 控制契约。

开发

npm run check             # 模块语法、Node 版本与生成客户端一致性
npm test                  # 核心、适配器、桥接与 UI 逻辑测试
npm run build             # 生成客户端、构建 dist/ 并运行调试冒烟
npm run audit:acceptance  # 验收证据引用审计，不代表真实验收通过
npm run debug             # JSON 行调试入口，使用假播放，不出声

客户端源码在 src/ui/client/，src/ui/dsh-client.js 为生成文件。修改 UI 后执行 npm run build:client；隔离预览需要已有 React 18 UMD，详见 贡献指南。

文档导航

许可与致谢

项目原创代码与文档采用 MIT License。已发布的首个 npm beta 包使用自有三张角色状态 PNG；当前源码还将锅盖 GIF、配套静态图和六张 doll PNG 一起打包，安装后无需另行提取即可开启播放动效，该更新尚未发布到 npm。运行依赖的源码与许可随包保留，按各自许可使用，见 第三方声明 和 依赖许可清单。

用户提供锅盖鲸鱼娘 GIF、衍生素材及指定 Workshop 的 doll PNG 作者与许可尚未确认，不包含在本项目 MIT 授权范围内；保留各自来源和文件清单。本页界面截图使用自有状态图。

感谢 DSH、网易云社区 API，以及提供 UI 风格和交互参考的 PHL、dsh-api-dashboard 与 DeepSeek Balance Whale Widget。具体版本、复用范围和声明见第三方文档。FishFM 为独立维护的社区项目。