智慧社区运维平台 · 本地节点

装在小区的物业电脑上：本地看板 + 探针，断网照常报警；接上云端就能在总部一张图看到。

看板 + 探针一体化 内置 Python，无需装环境 双击一次装完 开机自启 · 崩了自愈 数据留在本地

下载

下载安装包（约 8.2 MB） SHA-256 校验值

版本 0.12.0-p33 · 自动识别 Windows 7 SP1 / 8.1 / 10 / 11 并选择对应安装方案 · 内置 Python 3.8.10 运行时
SHA-256：1ccba654bcb775059f2e117b17afa6abfff7eca7ca63256f4a151473e0898d59

下载后建议核对一遍： certutil -hashfile aijhw-ops-0.12.0-p33.zip SHA256，与上面的值一致即可安装。

支持哪些系统（不用你先判断）

Windows 11 / 10　标准方案（64 位）。

Windows 7 SP1 / 8.1　兼容方案（64 位）。安装器会自动把控制台留在 GBK、 进程管理改走 WMI 回退、并用 Chrome/Edge 而不是 IE 打开看板——这三处不处理会直接失效。

32 位系统：包内运行时是 64 位，启动不了。安装器会自动改用本机已有的 Python 3.8+ 继续安装（功能完整，单进程内存上限约 2GB）；本机没有 Python 则会停下来， 提示向技术支持索取 32 位安装包。
Windows 7 必须 SP1 + 通用 C 运行库（KB2999226），缺哪个会明确告诉你装哪个补丁， 不会只丢一句"安装失败"。

判定依据不是 CurrentVersion（Win10 起恒为 6.3） 也不是 ProductName（Win11 上仍写 Windows 10），而是系统 build 号。 详见包内 docs\系统兼容与自动适配.md。

安装（三步，约 2 分钟）

1
解压到本地磁盘，例如 D:\AIJHW-Ops\。 路径别带 & # ^，也别放在 C:\Program Files 下； 不要在压缩包预览窗口里直接双击运行。中文路径可以用（安装器已按 GBK 处理）。
2
双击 INSTALL.bat，回答四个问题：小区名称、小区编号、看板端口（默认 9101）、节点名。 另问两项：要不要开机自启（建议要）、要不要接云端隧道（可后补）。 安装器会自动：生成配置 → 装开机自启 → 建桌面快捷方式 → 起服务 → 体检 → 打开看板。
3
在浏览器里收尾：「设置」页填摄像头账号 → 点「自动发现」或手工加点位 → 配一条告警通道（最省事的 ntfy：手机装 App 订阅同名话题）→ 回桌面临「智慧社区运维平台」跑一次体检，全绿即可交付。

日常入口：桌面「智慧社区运维平台」

双击打开控制台（也可以直接跑 CONSOLE.bat），一个菜单管全套：

1 启动   2 停止   3 重启   4 打开看板   5 体检   6 看日志
7 备份   8 开机自启开关   9 改端口   10 当前状态
11 云端节点条目   12 写入云端（注册本小区）
13 文件传输（上传/下载，与云端看板互传）

命令行也能用（写脚本、远程排障）：

CONSOLE.bat status          当前状态（服务/探针/点位/采集/云端链路）
CONSOLE.bat doctor          体检（退出码 0 全绿 / 1 有告警 / 2 有故障）
CONSOLE.bat backup          备份配置+数据库到 backups\
CONSOLE.bat port 9200       改端口（会重启，隧道目标一起改）
CONSOLE.bat cloud-register  把本节点写进云端总部一张图（需已配 SSH 免密）
CONSOLE.bat files up D://巡检//10月报表.xlsx --site nc-lvd   上传到云端
CONSOLE.bat files down <文件id> --dest D://下载              从云端取回
CONSOLE.bat files list / del  / stat                    列目录 / 删除 / 用量

包里有什么

路径说明
INSTALL.bat / CONSOLE.bat安装入口 / 运维控制台入口（纯 ASCII，任何代码页都不会乱码）
runtime\内置 Python 3.8.10 运行时，目标机不需要装 Python
setup\install-once.py（九步安装）、console.py（控制台）、ops_files.py（文件互传）、ops_paths.py（共用件）
v2-local\守护 v2-daemon.py、探针 v2-probe.py、看板与各业务模块
config\config.template.json（脱敏模板）、credentials.example.json
README.txt给现场看的安装/配置/排障说明（记事本直接打开）
MANIFEST.txt每个文件的 SHA-256，可事后核对有没有被改过
包里不含任何真实点位、设备密码、历史数据与日志——这些只在现场生成，也不会随包外流。 设备密码保存于本机 config\credentials.json，接口不返回、不上云。

文件互传：本地 ⇄ 云端看板

报表、巡检照片、验收单可以直接推到云端归档，也能把云端已有的文件取回本地。 云端页：ops.aijhw.cn/files（同一个访问码，浏览器里可拖拽上传）。 本地走控制台菜单 13，或命令行 CONSOLE.bat files up|down|list|del|stat。

传输只走「人主动选的文件」。设备密码仍只在 config\credentials.json， 不进这个通道；文件库也不参与任何告警判定。

接入云端（可选）

  1. 安装时选「配置云端反向隧道」，填云端地址、SSH 端口、账号，以及本小区专属的远端端口（从 19101 起，每个小区不同）。
  2. 确认这台机器能免密登录云端：ssh -p 22822 root@<云端地址>（Win10 1809+ 自带 OpenSSH 客户端）。
  3. 跑一次 CONSOLE.bat cloud-register：自动备份云端 nodes.json、写入本节点、重启聚合服务。
  4. 打开 ops.aijhw.cn/hq 看总部一张图上是否出现了这个小区。
隧道只复用现有 SSH 端口（不用 frp：现场机器多装了安全软件，frp 类进程容易被拦截）。 云端访问仍走只读白名单，写操作（认领、静默、批准取流）只在本地。

常见问题

现象处理
双击 INSTALL.bat 一闪而过包不完整（缺 runtime\python.exe）或是在压缩包预览里双击；重新解压到本地磁盘再装
看板打不开CONSOLE.bat → 10 看状态、6 看日志；端口被占就 9 换端口；杀软拦 python.exe 就加白名单
点位全红先看状态页「探针」是否运行，再看设备是否断电/换 IP、discover.networks 网段是否填对
告警收不到设置页「通道自检」会真发一条并回读；显示「未验证」就是没通（出厂只开本地落盘）
要换电脑CONSOLE.bat backup → 新机装好后把 backups\*.zip 解开覆盖 config\ 与 v2-local\
彻底卸载控制台 8 关自启 → 2 停服务 → 删除整个文件夹（不写注册表、不装服务）

技术说明与文档