Repository navigation
Releases
MiAir Plus 2.0.9 · AirPlay 修复与整首循环闹钟
MiAir Plus 2.0.9
- iOS:移动端输入字号调整,避免输入时自动放大,保留手动缩放。
- AirPlay:音量请求移到后台,避免慢云响应阻塞音频接收;修复最低音量误静音、音箱音量未同步及实时流 Range 探测兼容问题。
- 闹钟:支持完整播放一首、整首循环 2–20 次和原来的按时长播放;新建默认整首,旧闹钟保留原设置。
- 新增接收、转码和音箱拉流日志,便于定位投送故障。
通用 FPK,支持 x86_64 / ARM64,内置 FFmpeg、Shairport Sync 和 NQPTP。
已通过自动测试和模拟音频链路验证;AirPlay 是否解决现场无声仍需安装后实测,AirPlay 2 仍为预览功能。
验证记录:Go、前端、双架构构建与安装脚本检查 已通过。
下载 miair-plus-2.0.9-all.fpk 安装或升级;其他附件为校验值和原生组件对应源码。旧闹钟保持原来的播放时长,编辑闹钟即可切换到整首或循环模式。
MiAir Plus 2.0.8 · AirPlay 2 自定义端口修复
更新内容
- 设置页支持自定义 AirPlay 2 TCP 端口,默认 7000,范围 1024–65535。
- 修复 Shairport Sync 5.5.1 将用户设置的端口覆盖回 7000,导致“未在 TCP 指定端口就绪”的问题。
- 修改端口后自动重建接收连接;支持配置持久化、备份恢复和旧配置兼容。
- 明确使用 AirPlay 2 模式,原生组件启动信息进入应用日志。
安装与升级
下载 miair-plus-2.0.8-all.fpk,适用于 x86_64 和 ARM64 飞牛 NAS。升级保留已有设置;启用 AirPlay 2 后,可在设置页填写 7014 等空闲端口,保存后重新连接投送。防火墙需放行所选 TCP 端口。时间同步仍需 UDP 319/320。
验证
两个架构均在 Debian 12 普通用户环境中验证:预先占用 TCP 7000,自定义 TCP 17001 的 RTSP 响应、Bonjour 广播端口和退出清理通过。Go 测试、静态检查、前端类型检查与构建通过。手机到小爱音箱的实际音频投送仍需实机验收。
附带 SHA-256 校验文件和原生组件对应源码。源码归档中的 sources/shairport-sync-custom-port.patch 为本版本使用的端口修复补丁。
MiAir Plus 2.0.6 · 自动更新与配置备份
MiAir Plus 2.0.6 正式版。
- 新增自动检测更新:打开管理界面时及使用期间每小时检测 GitHub 正式版本,也可在“设置”或“关于”页手动检测并查看更新说明。
- 新增配置导入与导出:备份应用设置、音箱偏好和闹钟规则;不导出账号凭据和音乐文件。导入前确认并完整校验,失败时保留原配置。
- 修复新建和编辑闹钟时“响铃时间”与“重复规则”的标签、输入框对齐。
- 兼容旧版配置:从旧版本升级后默认开启自动检测更新,同时保留用户之后手动关闭的选择。
下载 miair-plus-2.0.6-all.fpk,在飞牛应用中心使用“手动安装”升级,x86_64 / ARM64 共用此包。导入配置后,闹钟会保持关闭,请检查音箱、重新选择铃声并保存后再启用。
验证:前端类型检查与生产构建、完整 Go 测试、双架构 FPK 构建通过;已检查安装包清单、校验和、x86_64 / ARM64 可执行文件、原生音频组件及对应源码。桌面和手机宽度页面均已检查。
SHA256:4d8b5d9cad20411b5b66a9f4b2592ca7322c43b5d1bf909196bc80e85ed7139a
MiAir Plus 2.0.5 · 飞牛远程与移动端修复
MiAir Plus 2.0.5 正式版。用户已确认在当前设备和环境实测,各项功能正常。
- 接入飞牛统一网关,远程入口复用系统域名与 HTTPS,保留 8310 局域网访问。
- 修复网关与应用令牌冲突、移动端来源校验及页面加载问题。
- 适配手机底部导航、安全区域与 WebView 存储兼容。
- 完善 NAS 原生文件选择、文件权限校验、授权回调与错误提示。
- 保留 DLNA / AirPlay 音乐投送、音乐上传与自定义闹钟;AirPlay 2 仍为预览功能。
下载 miair-plus-2.0.5-all.fpk,在飞牛应用中心使用“手动安装”升级,x86_64 / ARM64 共用此包。升级后关闭旧页面,从应用中心重新打开。NAS 文件授权能力需要 fnOS 1.2.0401+、飞牛 App 1.34.0+。
验证:前端类型检查与构建、go vet、Go 测试、双架构 FPK 构建通过;GitHub Linux CI 的竞态测试、双架构编译与安装包生命周期检查全部通过;用户反馈实测正常。其他机型和环境的兼容性见仓库 docs/COMPATIBILITY.md。
附件包含通用安装包、SHA256 校验文件及原生音频组件对应源码;应用源码也包含在安装包中。
MiAir Plus 2.0.0-alpha.7 · 关于页面 / 闹钟交互优化
新增“关于”页面,展示开发者 BearHero520、项目主页、问题反馈、版本发布、飞牛应用源与开源许可。
- 优化闹钟时间选择:小时/分钟双列面板,24 小时制,支持直接输入。
- 修复新增/编辑弹窗在 PC 上铺满的问题,最大宽度 560px,手机保留边距并支持内部滚动。
- 消除设置页滚动条出现和消失引起的横向布局抖动。
- 提供 x86_64 / ARM64 通用安装包,保留音乐上传、NAS 选曲、法定工作日/节假日闹钟及 AirPlay 2 预览功能。
当前仍为预览版,实际音箱型号和发送端的兼容范围见项目说明。原生组件及对应源码与 alpha.6 相同,源码归档一并提供。
MiAir Plus 2.0.0-alpha.6 · 音乐上传 / NAS 选曲 / 工作日闹钟
MiAir Plus 2.0.0-alpha.6(预览版)
- 修复从旧版本升级后因配置文件所有者错误导致无法启动的问题;启动失败原因同时写入日志与飞牛安装提示。
- 新增闹钟:支持电脑/手机上传音乐、飞牛原生 NAS 文件选择与授权、铃声库复用。内置 FFmpeg 在保存时准备铃声。
- 支持每周、法定工作日(含调休补班)、休息日、法定节假日;内置中国大陆 2026 年日历。未公布年份不会猜测法定日期。
- 支持停止、稍后提醒、限定播放时长和错误状态;左侧选中入口改为纯色主题蓝。
- 清理前端历史资源,继续提供 x86_64 / ARM64 单一通用安装包及原生 AirPlay 2 预览组件。
验证:Go 测试、竞态检查、前端构建与 Linux 生命周期检查通过;已在真实飞牛 NAS 验证启动、原生文件授权、导入、保存和 FFmpeg 转码;上传完整流程已在内置浏览器验证。
注意:这是应用调度的音乐闹钟,需要 NAS 在线,并非拦截小爱内置闹钟。音频播放一次,设置时长为上限;语音/按键停止取决于音箱型号,尚未完成真实音箱响铃和语音停止验证。AirPlay 2 仍为预览功能。
附带两种架构的原生组件源码归档及 SHA256SUMS。
MiAir Plus 2.0.0-alpha.4 · 蓝色磨砂左右布局 / 投送诊断日志
MiAir Plus 2.0.0-alpha.4:左右布局与投送诊断更新。
- 左侧导航、右侧页面,统一使用 Element Plus 主题蓝(#409EFF),保留半透明磨砂效果与深浅主题。手机使用紧凑左侧导航。
- 首页精简为服务、音箱、账号状态和简短音箱列表,移除唱片装饰、重复说明与大块宣传内容。
- 设置页直接显示 FFmpeg 状态,自定义路径收进高级选项;移除界面中的运行环境宣传文案。
- 通用 FPK 继续内置 amd64 / arm64 的 FFmpeg、Shairport Sync 与 NQPTP。FFmpeg 优先使用包内版本,增加安装目录自动查找。
- 日志增加投送操作、音箱执行结果与耗时、名称广播、扫码登录状态、凭据续期和断线恢复记录。常规查询不刷屏,状态读取失败限频记录。
- 支持按级别、模块、关键字筛选,暂停刷新、手动刷新与脱敏诊断报告下载。报告包含组件检查、版本、架构及事件,不包含账号配置。
- 最近 1000 条记录重启后可恢复;events.jsonl 单文件 2 MiB,保留一个轮转备份。持久化失败会明确提示。
下载 miair-plus-2.0.0-alpha.4-all.fpk,x86_64 和 ARM64 使用同一文件,约 25.5 MiB。升级后按 Ctrl+Shift+R 刷新页面。
已通过前端类型检查与构建、Go vet / race tests、日志脱敏与持久化测试、桌面及窄屏页面检查。原生音频组件沿用 alpha.3 通过双架构启动、ALAC 解码和 RAOP 管道测试的同一批文件。真实 fnOS / 小爱音箱 / Apple 发送端的兼容验收仍待完成,AirPlay 2 保持预览状态。
普通用户只需下载 FPK。airplay2-sources-*.tar.xz 为包内第三方组件对应源代码;SHA256SUMS 为下载校验值。
MiAir Plus 2.0.0-alpha.3 · AirPlay 2 原生预览 / 双架构通用包
MiAir Plus 2.0.0-alpha.3:AirPlay 2 原生组件预览版。
- 一个
all.fpk同时支持 x86_64 和 ARM64,启动时自动选择架构。 - Go 主服务配套 Shairport Sync 5.5.1、NQPTP 1.2.8、精简 FFmpeg 8.1;NAS 无需 Docker、Python 或 Node.js。
- 保留每台音箱的 DLNA;设置中可开启 AirPlay 2 并选择一个目标音箱,其余音箱保留传统 AirPlay。
- 原生组件异常会显示状态并按配置后台重试;实际编码音频就绪后才通知音箱播放。
- 延续 alpha.2 的黑屏修复:打包 Vue 下划线辅助模块、修正 JavaScript MIME、入口 HTML 禁止缓存。升级后按 Ctrl+Shift+R。
安装后进入“设置”,确认 FFmpeg 已检测到,打开 AirPlay 2 开关,选择已启用音箱并保存。AirPlay 2 需要 NAS 系统的 Avahi / D-Bus,以及空闲 TCP 7000、UDP 319/320;界面会报告依赖或端口问题。Go 与 Shairport Sync 以应用用户运行,只有 NQPTP 获得低端口绑定能力。
自动验证包括前端类型检查与构建、Go vet/race tests、双架构原生组件普通用户启动与 RTSP 响应、实际 ALAC 解码及 RAOP 音频管道测试。尚未完成 fnOS 安装及 Apple 发送端到真实小爱音箱的实机验收。 不保证全型号兼容,不提供屏幕镜像,也不保证经过小米云/HTTP 桥接后的多房间精确同步。
普通用户只需下载 .fpk。airplay2-sources-*.tar.xz 是随二进制提供的第三方对应源代码;FPK 内含组件许可证及本项目源码。SHA256SUMS 用于下载校验。
MiAir Plus 2.0.0-alpha.2 · 黑屏修复 / 双架构通用包
修复启动后黑屏,并提供一个同时适用于 x86_64 / ARM64 的原生飞牛安装包。
- 修复 Go 嵌入资源遗漏下划线模块导致的 Vue 页面 404。
- 入口 HTML 禁止缓存,升级后请 Ctrl+Shift+R 强制刷新。
- 通用包启动时自动选择 CPU 架构,包含两个 ELF 二进制。
- 校验了脚本 LF、执行权限与 FPK 内部校验和。
- Linux CI 已通过前端检查、Go vet、race 测试及双架构编译。
此修复版仍为 DLNA + 经典 AirPlay 1。AirPlay 2 原生组件正在单独集成,不包含在此包中。FFmpeg 仍需系统提供;真实 NAS / 音箱兼容性待验收。
安装文件:miair-plus-2.0.0-alpha.2-all.fpk(约 9 MB)。从 alpha.1 更新可保留本地数据。请停止旧版 airisland 服务,避免 8310 / 8311 端口冲突。