总览—
读取中...
🛡️ 守护状态 P3
读取中...
最近检查：—
⚡ 快速操作
读取中...
机器人心跳
读取中...
📊 数据完整性监控
读取中...
VPS 资源
读取中...
专案监控
读取中...
机器人 / 脚本
读取中...
📜 日志查看
点左侧机器人查看日志
← 从左侧选一个机器人
异常中心
🚨 待处理异常
读取中...
定时任务
每日任务
读取中...
月度任务
读取中...
专案排程
读取中...
TG 管家指令
指令一览
/a总览状态
/b异常清单
/c今日任务
/d定时任务
/e机器人心跳
/h查看日志
/i手动巡检
/r重启机器人（按钮选单）
AI 对话模式
非 / 开头的消息将进入 AI 对话模式。
AI 可分析异常、解释日志、判断原因、提供修复建议。
AI 不会执行操作，所有执行必须通过指令触发。
AI 可分析异常、解释日志、判断原因、提供修复建议。
AI 不会执行操作，所有执行必须通过指令触发。
📋 依赖清单
—
读取中...
跨机器人文件依赖
读取中...
新增依赖项
❓ 面板操作说明
📌 这是什么？
Wendy 监控中枢 — 把分散在 VPS 服务器、本机 Windows 电脑、Google Apps Script 的脚本统一管起来：
- 看哪些脚本还活着（心跳 / systemd 状态）
- 异常时自动报警 → TG 通知
- 关键 Google Sheet 数据完整性检查
- 依赖清单可视化（每个脚本读写哪些资源）
🗺️ 各分页都干什么
| 总览 | 一眼看完整体状态：VPS 资源、机器人心跳、守护级别（P1-P3）、数据完整性。每天打开就来这里。 |
| 机器人/脚本 | 所有被监控的脚本列表 + 最近日志 + 手动重启按钮。 |
| 异常中心 | 未处理 / 已处理异常列表。可手动「解决」或「重开」。已处理项 3 天后自动清理。 |
| 定时任务 | 所有有 cron / 触发器的脚本（包括 GAS Apps Script）。注册时填了「排程时间」字段的本机脚本也会进这里。 |
| 📋 依赖清单 | 每个 bot 读写的资源（Google Sheet / 本地文件 / API / TG）。每条 dep 行末有徽章显示健康状态（✓ ok / ⚠ 缺失 / ✗ 错误 / · 未监控）。 |
| 📖 介绍说明 | 每个脚本是干嘛的、功能列表（从脚本 docstring / 顶部注释自动提取）。 |
| ❓ 操作说明 | 就是你现在看的这页。 |
| 📜 操作日志 | 面板上「添加/删除/修改」等动作的审计日志。保留 3 天。 |
| ⚙️ 设定 | 改密码、配置 VPS 连线、TG 通知、添加新监控项目（4 种方式：自动扫描 / 手动 / 本机脚本 / GAS）。 |
🆕 怎么添加新监控项目？
到「设定 → 添加监控项目」，4 种方式：
- 🔍 自动扫描 — SSH 到 VPS 找所有 .py / .sh，未注册的自动全部加入。
- 📝 手动添加 — SSH 扫描后弹列表，你勾选哪些要加（已添加的会标「已在监控中」）。
- 📁 添加本机脚本 — 给你的 Windows 本地脚本接入心跳监控。会引导你：① 选脚本档 → ② 复制回传代码到脚本 → ③ 可选填排程/依赖 → ④ 注册 + 显示开机自启指引。
- 🟢 添加 GAS — 输入 Google Apps Script 部署 URL，自动扫触发器加入定时任务。
🚨 异常处理流程
- 面板检测到异常 → 进入「异常中心」+ 总览右上「未处理异常」红点
- 同时（如果配置了 TG）发通知到所有 Chat ID
- 你点进异常卡，查看详情和最近日志
- 处理完后点「✅ 标记已解决」，3 天后自动清理
- 如果是误报，下次同一类异常会自动不再触发（用 bot+title 配对去重）
🎨 界面小技巧
- 右下角浮动按钮 🖥️ ☀️ 🌙 — 全页可见，切换系统/开灯/关灯主题
- 异常卡里的展开按钮可看最近日志原文
- 依赖清单行末徽章会在数据完整性出问题时立即显示
- 设定 → 修改密码可改；忘记密码可发 TG 验证码重置
📜 操作日志
保留最近 3 天
读取中...
⚙️ 设定
修改密码
🖥️ VPS 连线设定
读取中...
📨 TG 通知设定
Chat ID 可向
@userinfobot 发任意消息取得；群组 ID 把 bot 拉进群后用 @RawDataBot 取得。
➕ 添加监控项目
🔍
自动扫描
扫描未监控的服务 · 全部加入
📝
手动添加
扫描后挑选
📁
添加本机脚本
选档 · 生成回传代码
🟢
添加 GAS
输入 URL · 扫触发器
🔁
重新绑定
已注册但没心跳？重新生成接入指令
目前监控清单
读取中...
添加 VPS
📁 选取本机资料夹
当前：
/root
读取中...
📁 添加本机脚本 — 资料夹扫描
① 选资料夹 + 扫描
›
② 接入指令
💡 选脚本所在资料夹，面板自动扫描里面的 .py / .bat / .ps1 等可监控档案，自动识别每个的运行方式 / 依赖 / 语言，你只要勾选哪些要加入即可。
📁
点击选资料夹 或 把资料夹拖到这里
扫描资料夹内所有 .py / .bat / .cmd / .ps1 / .sh / .js / .ts
💡 可多次拖入不同资料夹合并扫描；或一次拖多个
🔁 重新绑定本机脚本
如果你之前注册了脚本但忘了加心跳代码（或者代码删了），脚本会一直显示「等待首次心跳」。
选要重新生成接入指令的脚本，把生成的指令粘给 Claude Code（或用 PowerShell 一键）即可。
选要重新生成接入指令的脚本，把生成的指令粘给 Claude Code（或用 PowerShell 一键）即可。
🔍 扫描结果
🔐 重置密码
系统会发送 6 位验证码到您预设的 Telegram。
⚠ 需要先在「设定 → TG 通知设定」配置 Bot Token + Chat ID
⚠ 需要先在「设定 → TG 通知设定」配置 Bot Token + Chat ID
➕ 添加快捷操作
勾选要加到总览的操作（已加入的会显示为灰色）
🟢 添加 Google Apps Script
添加时系统会自动 GET URL 抓
ScriptApp.newTrigger(...) 触发器，没扫到也能加（标注「排程未知」）。🤖 Claude Code 面板
📋 错误内容
从异常中心点击「发送至 Claude」，或在此粘贴日志 / 错误内容
🛡️ 系统安全提示
Bot Token 与 API Key 均硬编码在脚本中，请定期轮换并避免推送至公共仓库
禁止手动
python3 bot.py 启动机器人，必须通过 systemctl 管理，避免多实例 Telegram Conflict/root/ 目录权限为 700，monitor_api 以 ubuntu 运行，日志读取需要 sudo tail，不可直接访问Google Sheet 通过公开 CSV 接口读取，写入依赖 Apps Script Web App；修改前须核对
dependency_map.md执行重启 / 操作前确认 Guardian 状态，P0 状态下所有自动操作应暂停，优先人工排查
监控面板 Token 存储于 sessionStorage，关闭浏览器后自动失效；密码连续错误 5 次锁定 5 分钟
📖 介绍说明
🧭 系统架构
• 监控主机：公用 VPS（72.60）——monitor_api + TG 管家 bot 本机运行，直接监控本机所有服务与专案（无 SSH）。
• 看门狗：187 每 3 分钟探测本面板，整台挂掉时 TG 告警（补上「监控自己挂了没人通知」的盲区）。
• 面板网址：
• 看门狗：187 每 3 分钟探测本面板，整台挂掉时 TG 告警（补上「监控自己挂了没人通知」的盲区）。
• 面板网址：
https://wendy-monitor.duckdns.org（登入后使用）
🤖 本机机器人 / 脚本
▶Pythontg_monitor_bottg_monitor_bot.py点击展开
- TG 管家：定时巡察（每日 08:00 + 07–14 点每 2 小时）本机服务与 6 个专案的存活/错误，异常推送到 TG
- 巡察涵盖专案：服务停止、journald 与日志错误都会纳入报告
- 支持 TG 指令查询状态 / 日志 / AI 对话
📦 监控的专案（本机）
csc-attend（考勤）· ai-dashboard · jingpin（竞聘）· kefu（客服）· sso · huashu（话术）
每个专案监控其 systemd 服务存活 + journald/日志错误即时；实际 排程（crontab） 见「定时任务」页的专案排程。总览「专案监控」卡有异常会标红，巡察也会纳入。
每个专案监控其 systemd 服务存活 + journald/日志错误即时；实际 排程（crontab） 见「定时任务」页的专案排程。总览「专案监控」卡有异常会标红，巡察也会纳入。
⚠️ 注意事项
• 所有服务用 systemctl 管理，禁止手动 python 启动（避免 TG Conflict）
• 改前端＝改 72.60 的
• 187 保留旧 monitor 作冷备援，可回滚（DuckDNS 指回 187）
• 改前端＝改 72.60 的
/var/www/wendy-monitor/dashboard.html；改后端＝改 /home/ubuntu/monitor_api/app.py 后 restart• 187 保留旧 monitor 作冷备援，可回滚（DuckDNS 指回 187）