音箱播放和停止通过 MiAirX 完成，音箱睡眠模式仍由 Home Assistant 控制。初次部署时，将根目录的 MiAirX.example.json 复制为 Evergreen.Health.Application/Configuration/MiAirX.json，再填写服务地址、音箱 DID 和手动测试音频 URL。本机 MiAirX.json 已加入 .gitignore，不会随普通 git add 提交。

当前 MiAirX 管理页已开启密码保护，在启动后端的环境中设置 MiAirX__WebPassword 环境变量（Visual Studio 可在本机启动配置中设置）。不要把管理密码写入 JSON 或提交到仓库。若以后关闭了 MiAirX 的密码保护，可将 RequireWebPassword 改为 false。后端需要能访问 MiAirX 服务地址；首次联调建议先在设备页手动测试“播放音乐”和“停止播放”，再测试一键启动／关闭。MiAirX 返回成功表示指令已送达，不代表已经确认音箱实际发声。

九体质演示曲目在 Evergreen.Health.Application/Configuration/TcmMusic.json 中按体质代码排列，当前 9 首的 OSS URL 已配置。每个体质的列表可按顺序增加多首；一键开启从 50% 音量开始，每 5 秒降低 1%，单曲结束自动播下一首并继承当前音量，末曲结束后从头循环（只有一首时重播该曲），直到音量为 0 时停止。页面显示的是 MiAirX 已成功下发的音量，不依赖 Home Assistant 中可能延迟的音量状态。当前按配置的曲目时长切换，MiAirX 并未提供此播放方式的可靠结束事件。手动播放按钮仍使用 MiAirX.json 的测试 URL；手动调整音量会停止自动渐弱，但不会停止当前音乐。

健康业务接口

POST /api/health/auth/register 用户注册
POST /api/health/auth/login 用户登录
GET /api/health/dashboard 健康首页
PUT /api/health/profile 更新个人健康档案
PUT /api/health/modules 选择健康板块
POST /api/health/plans/generate 生成个性化健康参数

接口文档以应用启动后生成的 OpenAPI/Scalar 页面为准。

后台基础模块范围

当前版本保留 Admin.NET 的通用后台底座：用户、角色、菜单与权限、组织、职位、租户、字典、系统配置、日志、文件、通知和在线用户等。

为保持演示版精简，已移除支付宝、微信/微信支付、LDAP、代码生成、任务调度、动态插件、打印模板等可选扩展模块。数据库迁移脚本位于 Database/Migrations/20260921_RemoveUnusedExtensionTables.sql，后续确有业务需要时再按模块重新接入。