解锁校园热水自由：蓝牙水控器独立控制工具完全指南

🌟 为什么选择这款工具？

还在为控制宿舍热水器必须打开微信而烦恼吗？这款开源工具让你彻底告别第三方App依赖，用技术夺回生活控制权！作为深圳市常工电子"蓝牙水控器"的非官方控制程序，它已帮助全国数万大学生实现了热水器自由控制，支持Windows、Linux、macOS、Android、iOS及ChromeOS全平台运行。

🛠️ 核心技术亮点

这款工具采用现代Web技术栈打造，确保跨平台兼容性和高效性能：

• TypeScript：提供类型安全保障，减少运行时错误
• WebAssembly：关键算法通过WASM优化，实现接近原生的执行效率
• PWA架构：支持浏览器一键安装，提供媲美原生应用的使用体验
• 离线优先设计：完全支持断网使用，保护用户隐私数据

📋 系统准备清单

在开始前，请确认你的设备满足以下要求：

• 具备蓝牙功能的设备（手机/电脑均可）
• 已安装Node.js最新稳定版（推荐v16+）
• 稳定的网络连接（仅首次安装需要）
• 操作系统：Windows 10+/macOS 11+/Linux内核5.4+或移动设备最新系统

⚠️ 注意事项：部分国产安卓设备可能需要在系统设置中手动授予蓝牙扫描权限

🚀 分阶段部署指南

准备阶段：获取源码

打开终端，执行以下命令克隆项目到本地：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/wa/waterctl.git

部署阶段：环境配置

进入项目目录并安装依赖：

# 进入项目文件夹
cd waterctl

# 安装依赖包（二选一）
npm install  # 使用npm
# 或
yarn         # 使用yarn

💡 技巧提示：如果安装速度慢，可以使用国内镜像源：npm install --registry=https://registry.npmmirror.com

构建阶段：编译项目

执行构建命令准备运行环境：

# 编译TypeScript代码和前端资源
npm run build  # 或 yarn build

构建成功后，项目会生成优化后的静态资源和可执行文件。

运行阶段：启动应用

# 启动本地服务器
npm start  # 或 yarn start

启动成功后，终端会显示访问地址（通常是http://localhost:3000），打开浏览器访问该地址即可使用。

🔗 蓝牙连接全流程

第一步：设备发现

1. 确保蓝牙已开启并授予应用权限
2. 应用会自动扫描附近的水控器设备
3. 在设备列表中选择你的水控器（通常以"CG-"开头）

第二步：配对认证

1. 点击设备名称进入配对流程
2. 根据提示输入配对码（默认为设备编号后六位）
3. 等待配对成功提示（通常需要3-5秒）

⚠️ 注意事项：若配对失败，请检查设备电量并确保与水控器距离不超过3米

第三步：控制热水器

配对成功后，你可以：

• 实时查看当前水温
• 调节水流量大小
• 设置用水时间提醒
• 查看历史用水记录

💡 使用技巧：长按温度显示区域可切换摄氏度/华氏度单位

❓ 常见问题解决

遇到问题？先查阅项目内置的FAQ.md文档，里面收录了：

• 蓝牙无法搜索到设备的解决方案
• 连接频繁断开的处理方法
• 不同操作系统的特殊配置要求
• 常见错误代码含义说明

如果文档未能解决你的问题，欢迎提交issue反馈。

📄 开源许可信息

本项目基于MIT许可证开源，你可以自由使用、修改和分发，但需保留原作者版权声明。完整许可文本见项目根目录下的LICENSE文件。

---

通过这款工具，你将彻底摆脱对特定App的依赖，实现对宿舍热水器的完全控制。项目持续更新中，欢迎贡献代码或提出改进建议！