快速开始
如果你只想尽快让守家旺财跑起来，按下面四步操作即可。任何旧手机都可以 —— 只要能装微信。
1. 准备一台旧手机
- 2018 年后出厂的 Android 或 iOS 手机，剩余电量不重要，但需要 持续供电。
- 建议放在玄关、门框、客厅角落等能覆盖关键区域的位置。
- 关闭自动锁屏（建议设置 → 开发者选项 → 保持唤醒）。
2. 打开「守家旺财」小程序
微信扫描下方二维码或在微信中搜索「守家旺财」，选择作为监控端。
第一次启动会请求摄像头、麦克风、相册写入权限。三个权限都建议同意 —— 后台保活依赖音频播放。
3. 注册或登录账号
支持两种登录方式，可任选其一或绑定为同一账号：
- 账号密码：经典方式，跨设备登录稳定。
- 微信 UnionID：扫码即登录，无需记忆密码。
4. 配置并上线
进入「设置」页面，按需配置监控模式、灵敏度、检测区域与报警方式，点击「开始监控」即完成部署。
账号与登录
守家旺财支持多设备登录同一账号。事件触发时，所有订阅端会同步收到推送。
账号体系
- 账号密码：本地通过 bcrypt 存储在服务端，仅保存 hash。
- 微信 UnionID：通过
jscode2session获取并绑定。 - 邮箱绑定：可选，用于找回密码与接收邮件通知。
Session 管理
登录成功后会颁发 JWT，同时在服务端维护 Session 表。可在「我的」→「登录设备」中查看与踢出。
建议在公共设备登录后主动「退出登录」，避免 Token 泄露。
找回密码
在登录页点击「忘记密码」，通过绑定邮箱接收验证码重置。如未绑定邮箱，请通过微信扫码登录后再补充绑定。
监控端配置
监控端 = 放在门口的那台旧手机。它负责采集画面、运行 AI 检测、上传事件。
摄像头选择
- 默认使用后置摄像头，覆盖更广。
- 支持前后切换、横竖屏切换，实时生效。
- 720P / 15fps 是平衡画质与耗电的推荐档位。
位置建议
- 与门口保持 1.5 ~ 3 米，覆盖全身。
- 避免逆光 —— 窗户在镜头后方会让画面发白。
- 避免正对白色光源，否则 AI 容易漏检。
画面叠加
可在设置中开启「AI 检测框叠加」，方便调试灵敏度与检测区域。正式上线后建议关闭以减少性能开销。
AI 检测设置
守家旺财默认使用 MoveNet Lightning 端侧模型，识别人体骨架并据此推断事件。
监控模式
- 有人报警：检测到任何人体即触发。
- 有人移动报警：检测到人 + 显著位移，适合门口有宠物经过的场景。
- 陌生人报警：检测到画面中存在陌生面孔（需要先录入家庭成员人脸）。
灵敏度
低 / 中 / 高三档。室内推荐「中」，夜间弱光环境推荐「高」。
检测区域
支持全屏检测或自定义框选。例如门口只关注下半部分区域，避免窗外树叶误触。
报警方式
- 微信订阅消息：必须先在小程序内「订阅」才能收到推送，微信政策限制一次性订阅。
- 应用内通知：所有登录设备同步弹出。
- 邮件通知：需要先绑定邮箱。
订阅消息
订阅消息是微信小程序向用户主动推送的唯一合规通道。每次订阅只能发送 一次 推送。
订阅模板
- 异常事件提醒：检测到人 / 陌生人 / 显著位移时触发。
- 设备状态变更：监控端上线 / 下线 / 异常掉线。
如何订阅
在小程序「我的」→「消息订阅」中点击对应模板的「订阅」按钮。微信会弹窗确认，每个模板独立订阅。
长期订阅
微信对长期订阅消息有严格的类目审核。守家旺财当前为一次性订阅模式 —— 每次事件触发后会消耗一次额度，消耗完后需要重新订阅。
我们正在申请长期订阅类目，上线后会单独公告。
后台保活
iOS 与 Android 均会在锁屏后冻结小程序，导致监控中断。守家旺财采用「音频保活」方案应对。
原理
小程序在后台播放一段极低音量的音频，系统会视为「正在播放媒体」而不冻结进程。
配置项
- 音频保活：默认开启，建议保持开启。
- 静音模式：静音时不影响保活效果。
- 勿扰时段：可在设置中指定静默时间段，期间不推送也不录音。
已知限制
- Android 厂商定制系统可能更激进地清理后台 —— 建议将小程序加入「电池白名单」。
- iOS 后台音频最长持续 10 分钟会被系统提示，建议每 30 分钟重启一次会话。
常见问题
通常是系统杀进程导致。请按本文「后台保活」章节配置：①将小程序加入电池白名单；②关闭省电模式；③保持音频保活开启。如仍掉线，可在「我的」→「反馈」中提交日志。
建议三步排查：①降低灵敏度到「中」；②开启「检测区域」并避开窗外 / 风扇；③切换到「有人移动报警」或「陌生人报警」模式。
微信订阅消息为一次性，每次订阅只能发一条。需要先在「消息订阅」中点击订阅按钮触发微信弹窗。消耗完后请重新订阅。
会。所有登录同一账号的设备都会同步收到事件。但订阅消息每端独立 —— 每端都需要先订阅一次。
实时画面不上传，AI 推理也完全在设备端完成。仅事件发生时上传一张缩略图用于通知预览，原图保存在监控端本地。详见「隐私协议」。
任何能安装微信并支持 TensorFlow.js WebGL 的 Android 5.0+ / iOS 12.0+ 设备均可。极低端设备可能影响 AI 检测帧率，建议至少有 2GB RAM。
当前版本暂不支持多账号协作。所有事件归属于注册者，但事件通知会同步到所有登录设备。如需团队协作，请等待后续版本。
在「我的」→「账号与安全」→「注销账号」中提交。注销后所有事件、设备、订阅关系将立即删除，且不可恢复。
故障排查
监控启动失败
- 检查摄像头权限是否被拒绝 —— 在小程序右上角「···」→「设置」中重新授权。
- 检查是否被其他应用占用摄像头 —— 关闭微信外的视频通话 / 相机应用。
事件不触发
- 确认「监控模式」不是「关闭」。
- 检查「检测区域」是否覆盖了测试人所在位置。
- 观察画面是否清晰 —— 镜头被遮挡时 AI 会自动停止触发。
推送收不到
- 检查微信是否开启「通知权限」。
- 检查小程序是否在「订阅消息」中已订阅。
- 邮箱推送请检查垃圾邮件夹。
提交反馈
「我的」→「反馈与日志」可一键上传最近 24 小时的运行日志。日志不包含摄像头原始画面。
更新日志
v1.4 · 2026-09
- 新增检测区域自定义框选。
- 优化后台保活音频策略，掉线率下降约 40%。
- 支持邮箱通知通道。
v1.3 · 2026-07
- 多端登录 Session 管理上线。
- 事件去重策略升级 —— 30 秒内合并为单事件。
v1.2 · 2026-05
- 陌生人报警模式首发。
- 灵敏度三档可调。
v1.1 · 2026-03
- 微信 UnionID 登录支持。
- 事件记录批量导出。
v1.0 · 2026-01
- 首版本发布。包含实时监控、AI 检测、订阅消息推送。