仓库	说明	语言
monitor	hub：后台、API、公开页宿主（axum + SQLite）
agent	Linux 采集端
monitor-theme-default	公开状态页主题（Vite + React + TS）
monitor-document	文档站（Vite + React SSR，构建时预渲染）

四个仓库均 fork 自 monitor-probe，fork 关系保留以便随时对照上游。

但已不再跟随上游：上游不再接受功能合入，这里走自己的 main。因此 git merge --ff-only upstream/main 已不适用 —— 仓库不再是上游的纯镜像。

• 公开状态页主题：浅色语义配色、明暗两套、全部过 WCAG AA；分组页签、筛选与搜索、列表视图； 图表调色板重建（排除与状态色冲突的绿 / 琥珀 / 红），资源图表有悬停卡片与十字线； 卡片与详情页重构；国家旗与发行版图标、在线时长徽章；速率图标出「均值到峰值」的带； 深色模式下浏览器原生控件也用深色；货币一律显示在数字前；续费周期支持任意值（5 年、18 个月）
• 主题可视化配置：主题在 theme.json 里声明配置项，面板据此渲染表单，不用改 hub （内置主题目前八项：汇总开关、默认视图、分组页签常驻、四张卡片各一项、速率峰值）； 主题还可以直接填 GitHub 仓库地址安装
• 后台重做：新增「总览」页并作为默认落地页 —— 一行 KPI（在线 / 离线 / 总数 / 待升级 / 30 天内到期 / 已过期）、一张续费日历（每天挂「N 台」，集中到期日高亮，点某天看那天的节点）、 近期事项与 Agent 版本一览；全队趋势图（流量 / 带宽 / 资源，资源图带「最热那台」的 P95 分布带）。 延迟页能展开看哪台节点在拖后腿（分桶直方图 + 百分位区间带），节点表有「只看待升级」开关； 节点还可以加一条私有备注——只在管理后台出现，公开页任何情况下都不显示
• 成本视图：新增汇率模块与 GET /api/fx，各币种折成 CNY（缓存 + 手动覆盖），成本页给出 未到期当月开销与剩余价值。有一条硬约束：绝不回退成 1:1——取不到就用上一次的值，并在页面上 标明它有多旧；悄悄按 1:1 算的话 $50 会被当成 ¥50，总额少算七倍而页面看起来完全正常
• 延迟监控支持 ICMP：每条任务可选探测方式，默认仍是 TCP，现有任务不受影响。 ICMP 只写裸主机或 IP（1.1.1.1、example.com、2606:4700:4700::1111），带端口会被拒绝并提示正确写法， IPv4 与 IPv6 都支持；monitor-agent --ping <host> 可以在目标机器上先自检能不能发 ICMP、 不能的话是权限还是路由；探测失败的原因显示在面板上，权限不足不再表现为一条没有解释的 100% 丢包； agent 太旧时也明确说出来（ICMP 需要 agent ≥ 1.1.1，面板在保存任务之前就会提示哪些节点太旧）
• 历史保留 7 → 90 天（可设 1–365）：分钟数据折叠进小时汇总表，长窗口跨水位线拼接读取； /api/me 报 history_days，公开页的档位阶梯跟着它走，不再写死
• 可用率与故障历史：uptime{d7,d30} 与 series=availability 接口，公开页出时间轴与故障列表
• 升级路径（手动 / 批量）：agent 重跑一次安装命令即升级（带备份与失败回滚），文档给了把命令发到每台机器的几种做法； hub 的安装器可以自我更新，发布产物里带 install-hub.sh；升级前自动备份数据库到 数据目录/backups/（留最近三份），回滚时数据库一并恢复，健康检查还会再问一句端口是否真的在应答 ——is-active 只说明进程活着，起来了但没在服务的 hub 从那一句看不出来
• 可选的远程升级（签名验证）：agent 把发布公钥编译进二进制（不是配置项，hub 也改不了）， 只依赖 minisign-verify 验签；私钥从不进仓库——CI 只构建并发出草稿，签名在本机离线做、 之后转正，而 releases/latest 只解析已发布的版本，所以未签名的草稿产物任何节点都取不到。 节点侧用 --allow-remote-upgrade 显式开启（默认不勾），开关状态在握手里如实上报；开启后可在 面板上对单台节点点「远程升级」（两步确认），hub 用同一条已认证的 WebSocket 把公告与二进制推过去， 与 /agent/{arch} 中继同源。验签通过才替换自己，升级后自检、失败回滚，结果回报到面板
• 装完自检：agent 安装器收尾不再只说一句「去看日志」，而是带超时去日志里等第一条 connected to （服务 active 不等于在报数——token 或地址错了会一直重连而服务始终是 active），再打印实测事实 monitor-agent is running (pid N) 与 connected to <hub>；连不上就大声警告但不让安装失败， 并给出真实路径的 ${BIN} --ping 1.1.1.1 自检命令与 net.ipv4.ping_group_range 的前提检查
• 有新版本时通知：agent 与 hub 的发布都算，搭在每日那次检查上（不另开轮询）， 每个版本只说一次，通知页里可以关掉
• 节点地址与国家：按节点自身地址查，也可以手填
• 品牌：产品名 Spot Monitor，自带 favicon 与 og:image；文档站配色与主题同源； 标签页图标 / iOS 主屏图标 / 社交预览图三处各自独立，可以在设置页里各换一份
• 文档：全站按本 fork 的实际行为重写（hub 的添加节点判定、agent 的真实参数、 ICMP 的权限与自检、保留天数的上限、可用率的「无数据 ≠ 离线」语义等）

hub 内置的主题版本由 monitor 仓库里的 web-theme.pin 钉住（含发布物的 sha256，当前指向 v1.8.9）， 升级要 pin 与版本号一起改。agent 的发布走「CI 出草稿 → 本机离线签名 → 转正」，所以 releases/latest 指向的永远是已签名的那一版。

• main 就是发布线：自己的改动走分支，经 PR 合入 main，发版打 tag。CI 在 PR 上跑构建与检查， 另有一套 Playwright 冒烟——起一个真实 hub 对着它跑，不是 jsdom
• 版本号必须一起改：hub 的 Cargo.toml 与 Cargo.lock、主题的 theme.json / package.json / package-lock.json 各自必须同值，CI 与发版 tag 都会校验 —— 只改一处会在发布流水线上才暴露
• 上游仍在开发，但不再接受功能合入；./dev.sh sync 默认只报告差异，不加 --merge 不会动 main

• 文档站：https://spot-probe-docs.hualala.workers.dev/
• 上游组织：monitor-probe
• 上游文档站（对照用）：https://monitor-document.pages.dev/
• 维护者：@jacob-bytes