⚡ 数字蜂巢 · CellHive (合宙 4G 模组智能通信网关与桌面客户端)

插上电脑自动收短信 • 验证码自动存入剪贴板直接 Ctrl+V • 插电脑不耗手机卡流量 • Windows 免安装双击即用

🚀 3步快速上手 • 📥 软件与固件下载 • 📱 硬件选型 • 🗺️ 进阶配置指南 • ⚠️ 避坑提醒

---

💡 它能帮你做什么？

1. 📋 验证码自动复制，不用翻手机
   4G 模块插在电脑 USB 口，验证码短信一来，自动提取并存入电脑剪贴板。屏幕右下角弹窗的同时，你双手不用离开键盘，直接按 Ctrl + V 就能粘贴登录。
2. 💰 插电脑不跑卡流量，保号卡放心用
   专为无流量卡、香港卡（如 ClubSim）或几块钱的副卡保号设计。插在电脑上时，优先走电脑网络转发消息，不耗费手机卡流量，不用担心偷跑流量欠费停机。
3. 🖥️ Windows 免安装，解压双击就能跑
   不用在电脑上配 Python 环境，下载单个 Exe 双击打开就能用。自带网页后台，插上多块模块也能自动识别。

---

📥 软件与固件下载

需要什么文件？	在哪里拿？	怎么用？
电脑控制软件 (Exe)	👉 前往 Releases 页面下载 CellHive.exe (亦提供兼容别名 Air780EPV-Gateway.exe)	绿色免安装，下载后双击运行即可，自动打开网页后台。
网关功能代码	本项目 deploy/smart-gateway-780epv/	最新版源码（里面有 11 个 lua 脚本，通用适配所有型号）。
模块底层包 (Core)	本项目 deploy/core/	官方底层固件，按手里的模块型号挑一个刷入（见下方选型表）。

---

📱 支持哪些硬件 / 买哪款？

手头有哪个用哪个，买新模块看下表推荐：

模块型号	能干嘛？	选型建议	对应要刷的底层文件 (在 deploy/core/)
Air780EPM (移芯 EC718PM)	只要收发短信	【最推荐买这个】 最新二代芯片，发热小、价格便宜，做短信网关性价比最高（支持电信卡）。	LuatOS-SoC_V2050_Air780EPM_103.soc (⚠️ 千万别选 109 固件，见下方避坑)
Air780EPV (移芯 EC718PV)	短信 + 电话振铃	【全能款】 支持所有网络（含电信），唯一支持用电话振铃提醒紧急事件。	LuatOS-SoC_V2001_EC718PV_CLOUD.soc
Air780E / EC (移芯 EC618)	老款板子收短信	【手头有就继续用】 经典老款开发板，不支持电信卡。插电脑上需按一下开机键。	LuatOS-SoC_V1124_EC618.soc

---

🚀 3 步快速上手

新手拿到模块后，照着下面 3 步 就能跑起来：

第 1 步：连电脑

• 用一根 能传数据的 Type-C 线（别用只能充电的两芯线）把模块插到电脑上；
• 注意：如果是 Air780E/EC 老款开发板，插上后长按板子上的 POW 键 2 秒开机（红灯亮）。

第 2 步：一键刷固件

1. 电脑打开合宙官方下载工具 Luatools；
2. 点击右上角【项目管理测试】，添加脚本与底层：
   • 点击【新建工程】，工程名称填 智能网关（或任意名字）；
   • 点击右侧【添加脚本】，进入本项目的 deploy/smart-gateway-780epv/ 目录，全选添加全部 11 个 lua 脚本；
   • 点击右侧【选择底层 CORE】，进入本项目的 deploy/core/ 目录，挑选手头型号专属的 .soc 文件（780EPM 选 _103.soc，780EPV 选 V2001，780E 选 V1124）；
3. 勾选“添加底层和提示下载”，点击右下角 【下载底层和脚本】 烧录（如果没反应，按住板子上的 BOOT 键再插一次电脑）。

第 3 步：插卡即用

1. 模块拔下来插上手机 SIM 卡，重新插回电脑；
2. 双击运行刚才下载的 CellHive.exe（或兼容别名 Air780EPV-Gateway.exe）；
3. 电脑会自动弹出管理网页（http://127.0.0.1:17801），信号连上后就能正常收发短信了！

---

🗺️ 进阶配置指南

日常使用看上面 3 步即可。如果有更深入的定制需求，可查阅对应文档：

• 📱 想把短信推送到飞书、企业微信、钉钉或 Bark？ ➔ 📖 查看推送配置教程
• 🛠️ 电脑搜不到端口、没信号或者指示灯不亮？ ➔ 🛠️ 查看常见排错指南
• ⚡ 模块刷坏了怎么救砖？怎么改线插电自动开机？ ➔ ⚡ 查看强刷救砖与改线说明
• 🔌 模块各引脚定义、串口说明与 AT 指令？ ➔ 🔌 查看硬件详细规格
• 🤖 想对接 AI Agent (MCP) 让 Claude/Cursor 自动收发验证码？ ➔ 🤖 查看 MCP 服务调用手册
• 🧠 想研究多卡槽集群分发与黑匣子存储原理？ ➔ 🏗️ 查看系统架构设计

---

⚠️ 新手必看避坑

1. 780EPM 千万不要刷 109 固件，必须选 103
   合宙的 109 固件是纯随身 WiFi 专用的，原厂直接把短信功能删掉了。刷了 109 一插卡就会报错死机反复重启。请务必使用我们提供的 _103.soc 底层。
2. 底包不要跨型号乱刷
   老款 780E 只能用 V11xx 底包，新款 780EPM/EPV 只能用 V20xx 底包，两代芯片完全不一样，混刷会黑屏开不了机。
3. 老款开发板插上电脑没反应？
   老款 780E 开发板出厂默认是关机态，插上 USB 后需要长按板子上的 POW 键 2 秒才会开机。嫌每次开机麻烦的，把 POW 按键两端用焊锡短接就能通电自启。

---

📄 开源协议 (License)

本项目遵循 MIT 开源协议。欢迎提交 Issue 与 PR 共同完善！

---

📖 English Abstract

CellHive (数字蜂巢) turns affordable 4G Cat.1 modules (Air780EPM / Air780EPV / Air780E / Air780EC / Air700E) into a handy desktop SMS gateway and client. It auto-copies verification codes to your Windows clipboard, pushes incoming SMS to Feishu, DingTalk, WeCom and Bark, consumes 0 cellular data when connected to PC, and runs via a single standalone Windows executable (CellHive.exe).