AC
AC 批量设备刷新器
批量登录业主账号 · 自定义周期刷新云端智能设备 · 本机常驻调度
连接中…
控制台未连接到后台服务。 请双击本目录下的 启动.bat,保持黑色命令行窗口运行,然后在浏览器访问
http://127.0.0.1:8765(端口被占用会自动顺延,以命令行窗口显示的实际地址为准)。直接双击 HTML 文件(file://)或用预览面板打开时,页面无法调用本地接口。
目标服务器 — · 端口 — · 默认周期 —
账号密码仅保存在本机 config.json(AES 加密),页面不回显密码
批量导入账户
每行一个:备注名,用户名,密码 或 用户名,密码;支持逗号 / 中文逗号 / 制表符分隔;也支持粘贴 JSON 数组 [{"name":"…","username":"…","password":"…"}]。同名用户名会更新密码。
它解决什么问题
业主端设备页 /static/owner/devices-modular.html 只在两种情况下更新:打开页面时加载一次,或收到 SSE 的 device_state_update 推送。页面自身没有定时轮询,云端的开关机 / 温度变化不会自己回来,必须有人点一下页面上的「刷新全部」按钮。本工具就是替你定期点这个按钮:批量登录每个业主账号,定时调后端刷新接口,后端拉到最新状态后经 SSE 推给所有已打开的业主页面。
怎么用
- 双击
启动.bat,浏览器自动打开 http://127.0.0.1:8765(端口被占用时自动顺延,以命令行窗口显示的实际地址为准);关掉网页不影响后台定时任务,只要这个黑窗口不关就一直跑。
- 首次打开会要求输入管理用户名和密码,通过后进入控制台;右上角「退出登录」可立即注销。
- 「账户管理 → 批量导入」贴入各门店业主账号(每行
备注名,用户名,密码),也可以单个添加。
- 先对一两个账户点「测试」确认能登录、能看到设备数,再点「立即刷新全部」验证一轮。
- 「全局设置」里改默认周期;单个账户点「编辑」可以设独立周期(留 0 = 跟随全局)。
- 每个账户的「下次执行」是独立计时的,多账户自动错峰,不互相等待。
每轮具体做什么
- 登录
POST /auth/login 拿 Bearer token,缓存复用;token 过期或返回 401 自动重登重试一次。
- 刷新前拉一次
GET /owner/devices 作为基线,识别品牌与设备数。
- 按勾选执行:
/owner/devices/refresh(美的 + 涂鸦)、/owner/xiaomi/refresh、/owner/tcl/refresh,可选涂鸦全量同步与逐台精刷。
- 刷新后再拉一次设备列表,对比出状态变化数、上下线变化、新增 / 减少设备,写进日志。
- 网络异常 / 5xx / 429 按指数退避重试;单个品牌接口失败不影响其它动作,日志会标出是哪一步失败。
关于「新增的智能设备在页面里看不到」:SSE 只推已有设备的状态,不会把新设备追加到已打开的页面列表。本工具检测到设备数变化会在日志里提示;此时业主端页面按一次 F5 重新加载即可看到新设备。日常状态更新则不需要刷新页面。
安全与边界
- 服务只监听
127.0.0.1,公网访问由 Nginx 反向代理;管理密码用 scrypt 加盐哈希存储,签名会话放 HttpOnly Cookie(默认 7 天),连续 5 次密码错误锁定 60 秒。
- 密码用本机
.secret.key 做 AES-256-GCM 加密后存 config.json,页面与日志均不显示明文。但能读到这台机器文件的人仍可解密 —— 请勿把 config.json / .secret.key 上传、发群或提交到仓库。
- 只调用官方刷新接口,不改设备状态、不下发控制指令,也不碰策略规则。
- 账号角色需为
owner(业主);agent / superadmin 账号刷不到设备列表,用「测试」会显示设备数 0 或报错。
常见问题
- 测试登录失败 401:账号或密码错,或该账号被停用;确认是业主端登录账号,不是顾客端 / 代理商账号。
- 刷新成功但状态变化 0:云接口可能是异步拉取,或设备本来没变化;看各步骤是否全部 ✓,以及业主端 SSE 是否连上。
- 某品牌步骤 ✗:该租户没绑定此品牌云账号时会报错,属正常;打开「只刷新该账户实际存在的品牌」即可自动跳过。
- 要换服务器:服务端地址由部署配置文件锁定,网页故意不提供修改入口——否则会话一旦被劫持,攻击者改掉地址就能把全部业主账号密码发到自己的服务器。