README.md

🎧 HaloPixelToolBox（花再音响工具箱）

一个面向桌面端的实用工具箱，致力于为音响 / 桌面设备提供更丰富、更直观的信息展示能力。

🚧 当前开发进度

✅ 已支持 网易云音乐歌词显示
✅ 客户端可从服务器动态获取不同版本的内存解析地址，并在本地缓存；服务器暂时不可用时自动回退缓存
✅ 提供独立管理员端，可管理版本解析地址和 IP 黑名单
✅ 微信、QQ、企业微信原生消息提示，可在「设置 → 消息提示」分别开启，默认关闭
🚀 其它音乐平台歌词正在开发中

项目仍处于持续迭代阶段，功能和体验都会不断完善。

📝 提交 Issue

如果你在使用过程中遇到问题，或有新的功能想法，欢迎提交 Issue。

🐞 Bug 报告 / ✨ 功能建议均可
Issue 支持使用中文
提交前请阅读 👉 Issue 提交说明

🔮 计划支持的功能

🎵 更多音乐软件的歌词显示
💬 更多社交软件消息提示
🎨 更多个性化与自定义内容

💬 消息提示

在「设置 → 消息提示」开启微信、QQ 或企业微信，并保持工具箱运行（可最小化到托盘）。工具箱会使用花再设备的原生聊天消息通道触发提示，并显示可读取的发送者和消息预览。请开启聊天软件的桌面提醒及消息预览。

QQ 直接通过 Windows 标准通知接口读取应用身份、发送者和正文，请开启 QQ 的系统通知及消息预览；「允许读取系统通知」按钮用于 Windows 需要授权的环境。微信、企业微信也可读取标准系统通知；微信另支持无障碍接口提供的未读会话预览，其它详情弹窗可读取可访问的通知文字。整个消息功能不截图、不使用 OCR，也不查询 QQ 窗口的无障碍提供程序。

图片、语音等使用客户端提供的摘要。微信、企业微信隐藏详情、没有内容弹窗或未提供可读取的会话列表时，会退回「有新消息」。部分客户端在最小化或停留于其它页面时不提供会话预览。QQ 的系统通知不可读取时，设置页显示原因，避免以任务栏事件抢先发送不带内容的提示。

三个开关独立保存，每项提供「测试提示」按钮。提示期间会暂缓歌词、界面和灯光更新，8 秒后补发最新状态。持续闪烁和短时间重复提醒会合并；关闭选项后，旧的排队提醒不会在重新开启时重放。

协议与验证方式见消息提示开发说明。

LICENSE.txt MIT

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

CONTRIBUTING.md

如何为花再具箱提交 Issue

感谢你愿意为 花再具箱 提供反馈 🙏
无论是 Bug 报告、功能建议，还是使用体验的改进想法，都非常欢迎。

为了让问题能被更快理解和处理，请在提交 Issue 前阅读以下说明。

🐞 提交 Bug 报告

如果你遇到了程序异常、崩溃或行为不符合预期的问题，请选择 Bug 报告 模板，并尽量提供：

清晰的问题描述
可复现的操作步骤
使用的软件版本
操作系统环境
相关日志或截图（如有）

📌 请尽量避免：

只描述“不能用 / 有问题”
缺少复现步骤或环境信息

✨ 提交功能需求

如果你有新的功能想法或改进建议，请选择 功能需求 模板，并说明：

你当前遇到的使用场景或不便
你期望的解决方式
这个功能能解决什么问题

功能需求不一定都会立刻实现，但每一条都会被认真考虑和记录。

🌍 关于语言

Issue 支持使用中文提交
仓库已配置自动翻译为英文，方便更多人参与讨论
无需自行翻译

🚫 不适合使用 Issue 的情况

以下情况请不要提交 Issue：

使用咨询或简单提问（可查看 README 或 Discussions）
与项目无关的内容
已在现有 Issue 中被明确提及的问题（请先搜索）

❤️ 最后

感谢你花时间参与花再具箱的改进！
你的每一次反馈，都会让这个项目变得更好。