﻿智慧社区运维平台 · 本地节点安装包
=====================================================
版本      : {ver}
内置运行时: {rt}
打包时间  : {ts}

这套东西是什么
-----------------------------------------------------
一个装在小区物业电脑（Windows 10/11 或 Win7 SP1 64 位）上的本地节点：

  · 看板   —— 浏览器打开 http://127.0.0.1:9101/ 就是。里面有六个页面：
              总览 /dashboard、设置 /settings、多品类采集 /collect、
              告警屏 /alert、云端远端 /cloud、动作确认屏 /confirm
  · 探针   —— 每 20 秒给所有点位探活并上报心跳。由守护托管，不用你单独起，
              挂了会自动重启（这是"点位三色"的唯一数据来源）。
  · 守护   —— 所有本地判定、告警、落库、页面的进程。断网照常工作。

重要：判定只在这台机器上做，云端只做"看"和"申请"，云端断了不影响本地报警。


一、怎么装（三步，约 2 分钟）
-----------------------------------------------------
1) 解压整个文件夹到一个**路径不含 & # 且不以空格结尾**的位置，例如
      D:\AIJHW-Ops\        （不要放在 C:\Program Files 里，也不要直接在压缩包里双击）
2) 双击 INSTALL.bat，按提示回答四个问题（小区名称/编号/端口/节点名），
   后面关于开机自启和云端隧道的问题按需回答。
3) 装完会自动打开浏览器。桌面上会多一个「智慧社区运维平台」图标，
   以后启动/停止/体检/备份都从这个图标进。

装完还要做的三件事（在浏览器里点，不用敲命令）：
   · 「设置」页：填摄像头账号 → 点「自动发现」或手工加点位
   · 「设置」页：配一条告警通道（最省事是 ntfy：手机装 App 订阅同名话题）
   · 回到桌面图标 → 选 5 跑一次体检，全绿就可以交给物业了


二、日常怎么用
-----------------------------------------------------
双击桌面「智慧社区运维平台」，或运行 CONSOLE.bat：
   1 启动   2 停止   3 重启   4 打开看板   5 体检   6 看日志
   7 备份   8 开机自启开关   9 改端口   10 状态   11 云端节点条目   12 写入云端

也可以在命令行直接跑（写脚本/远程排障用）：
   CONSOLE.bat status          当前状态
   CONSOLE.bat doctor          体检（退出码 0 全绿 / 1 有告警 / 2 有故障）
   CONSOLE.bat backup          备份配置+数据库到 backups\
   CONSOLE.bat port 9200       改端口（会重启，隧道目标一起改）
   CONSOLE.bat cloud-register  把本节点写进云端总部一张图（需已配 SSH 免密）


三、配置项说明（config\config.json）
-----------------------------------------------------
装完就有这个文件，下面这些是你会真正动的：

  node.site / node.site_id   小区名称与编号。site_id 是隔离键，不同小区不能重复。
                             改名字可以在「设置」页改，改 site_id 请用安装器重装。
  node.name                  节点名，云端一张图上显示的那一行。
  http.port                  看板端口，默认 9101。改端口用 CONSOLE.bat port 新端口。
  sites[]                    小区注册表。node.site_id 必须在这里存在且 enabled=true，
                             否则该小区的点位会返回 404（这是故意的，防止"看起来零故障"）。
  persistence.file           本地数据库文件名，默认 v2-local.db。
  devices[] / cameras[]      点位清单。「设置」页改了会自动写回这里。
  discover.networks          自动发现的扫描网段。装机会按本机网卡猜一个 /24。
  discover.auto_adopt        扫到摄像头要不要自动接入（默认开）。
  alerting.*                 告警通道。ntfy / 企业微信 / Server酱 / PushPlus / WxPusher / 邮件。
                             重点：ntfy 的 topic **等于密码**，谁知道了就能读你的告警。
  alerting.confirm_sec       状态要持续多久才算"成立"（防抖），默认由 levels 决定。
  scene.token                外部场景程序（AI 识别、门禁事件）上报事件用的令牌。
                             装机会随机生成；泄露了就换一个。
  tunnel.*                   云端反向隧道：云端 127.0.0.1:<remote_port> → 本机 <local_port>。
                             每个小区分配不同的 remote_port（19101 起顺延）。
  streaming.cloud_view_autogrant
                             云端申请看画面时是否免动态码自动批准（默认开）。

密码类的东西**不在这个文件里**：摄像头账号在 config\credentials.json，
页面上填，别手改；它不会上传云端。


四、出问题怎么查
-----------------------------------------------------
· 看板打不开：双击 CONSOLE.bat → 10 看状态；或 6 看日志（v2-local\v2-daemon.log）
· 点位全红：先看探针是否在跑（状态页"探针 运行中"），再看设备网络
· 告警收不到：设置页有「通道自检」，会真发一条并回读；显示"未验证"就是没通
· 换电脑：CONSOLE.bat 7 备份 → 把 backups\*.zip 拷到新机器 → 解开覆盖 config\ 与 v2-local\
· 要彻底卸载：CONSOLE.bat 8 关掉自启 → 停服务 → 删掉整个文件夹即可
  （我们不动注册表、不装服务、不写系统目录，删文件夹就是干净卸载）

日志位置：v2-local\v2-daemon.log（超过 8MB 自动滚动一份 .1）
数据位置：v2-local\v2-local.db（SQLite，直接用 DB Browser 可看）


五、获取新版本与技术支持
-----------------------------------------------------
下载页  : https://aijhw.cn/download/ops/        （新版本与 SHA-256 校验值都在这里）
支持电话: 0791-88205155（工作日 9:00–18:00）
邮箱    : 125948996@qq.com
出品    : 江西泽民智能科技有限公司

升级做法（不会丢数据）：
  1) 旧目录先跑 CONSOLE.bat backup，得到 backups\aijhw-ops-backup-<时间>.zip
  2) 新包解压到**另一个**目录，正常装一遍
  3) 把备份里的 config\ 和 v2-local\v2-local.db 覆盖到新目录
  4) 停掉旧目录服务（CONSOLE.bat 2），只保留新目录
  注意：新旧不要同时跑，端口会冲突（守卫会挡住，但两边日志都不好看）。
