NekoWear 是给安卓智能手表准备的本地音乐整理工具，主要解决手表端音频文件的扫描、传输和播放控制。它没有沿用手机音乐 App 那套逻辑，而是按小屏幕、低功耗的使用环境重新做了交互。当前版本集中在曲库同步和播放列表管理两块，界面用卡片式布局，操作路径比较短，刚上手也不会觉得绕。
手表端曲库读取
应用可以直接扫描手表存储里的音频文件，不用先经过手机中转。扫描完成后，文件会按文件夹、时长、添加时间自动归类。习惯把歌提前拷进手表的用户，打开应用就能看到完整列表，省掉了反复配对传输的过程。
曲库索引走的是增量刷新，新增文件后重新进入应用就能识别，不需要手动重建列表。
播放列表编排方式
手表屏幕触控精度有限，所以播放列表的编辑动作做了简化。长按单曲会呼出快捷菜单，可以选择新建列表，也可以追加到已有列表。
列表顺序调整没有用拖拽，而是改成上下箭头按钮，减少误触。建好的列表会以独立卡片形式出现在首页，点卡片直接进入播放队列，跳转层级更少。
后台播放与耗电控制
播放控制模块采用轻量级服务驻留，锁屏状态下可以通过手表侧键或表冠完成暂停、切歌。连续播放一小时的耗电量在可接受范围内，后台也不会被系统强制回收导致音乐中断。
播放状态会和手表系统的媒体控制中心同步，抬腕就能看到当前曲目信息。
传输进度显示
从手机端往手表推送音频时，手表端会显示实时传输进度条，并标注剩余文件数量和预估耗时。如果存储空间不够，应用会提前弹提示，列出占用较大的文件供清理参考，不会传到一半才报错。
传输完成后会自动触发曲库刷新，不用手动干预。
初次安装与常见问题
初次安装后需要先授予存储权限和媒体库访问权限，否则应用扫不到本地音频。安装完成后要在系统设置里手动开启「存储」和「媒体与文件」两项权限，缺一个都会导致曲库列表一直显示为空。
手机端和手表端的分工不同：手机端负责文件推送和列表管理，手表端侧重播放控制和曲库浏览，两端通过蓝牙或局域网直连同步数据。
传输速度偏慢的话，可以关掉手表端的省电模式，并让手机和手表保持较近的距离，减少信号干扰。
部分用户反馈安装后闪退，多数和手表系统版本过低有关，建议把系统升到安卓 8.0 及以上再试。
当前版本音频格式以 MP3、AAC 为主，无损格式暂未纳入兼容列表，转码后再传输可以避免播放失败。
遇到播放无声的情况，先检查手表是否处于静音模式，再确认媒体音量是否被单独调低。
存储空间不足导致传输中断时，可以借助站内搜索「手表存储清理」查找相关清理工具辅助腾出空间。
后台播放被系统清理的问题，可以在手表电池设置里把 NekoWear 加入白名单，避免被智能省电策略误杀。
传输过程中不要强制关闭应用或断开蓝牙，否则可能造成文件索引损坏，需要重新扫描曲库才能恢复。
权限与安全性说明
从当前版本的行为来看，NekoWear 仅申请存储与媒体访问权限，用于扫描本地音频文件，没有发现联网上传或收集通讯录等敏感行为。应用体积小巧，代码结构相对简单，安装包未捆绑第三方推广组件，整体风险较低。
手表端安装方法
先把安装包下载到手机，通过手表配套的伴侣应用或蓝牙文件传输功能把 APK 推送到手表端，在手表上找到文件并点击安装即可。
如果手表系统限制未知来源安装，需要在设置中临时开启「允许安装未知应用」开关，安装完成后建议关闭该选项。部分品牌手表不支持直接安装 APK，需确认设备系统是否为完整安卓环境。
设备兼容范围
理论上兼容运行安卓 8.0 及以上系统的智能手表设备，包括采用 Wear OS 或深度定制安卓底层的国产手表。不同厂商对后台服务与文件访问的限制策略不同，实际体验可能存在差异。
安装前建议确认手表剩余存储空间不少于 200MB，以保证曲库扫描与传输功能正常运转。
版本更新记录
· 新增：v0.1.0（2026-01-15）首次发布手表端本地曲库扫描功能，支持按文件夹与添加时间两种排序方式。
· 新增：播放列表创建与编辑模块，单列表最多容纳 50 首曲目。
· 新增：传输进度实时显示，支持剩余文件数与预估耗时展示。
· 优化：曲库索引刷新速度较内测版提升约 40%，百首曲目扫描耗时缩短至 3 秒内。
· 优化：播放控制服务内存占用降低至 18MB 左右，减少后台被回收概率。
· 优化：传输中断后的重连逻辑优化，断连后自动重试两次。
· 修复：内测版中曲库列表为空时点击播放导致闪退的问题。
· 修复：传输进度条在文件数超过 30 时显示错位的缺陷。
· 修复：部分手表型号上媒体权限授予后仍需重启应用才生效的异常。
