安装、换机与数据恢复
现在
常用 · 最新备份完成 11 月 6 日 12:05
11 月 6 日这轮备份已通过:11:40 开始、12:10 完成,本地和云端都完成
真实备份还没试过整库恢复
截至 11 月 6 日 · 项目仓库和备份回执

新电脑从零安装、带回旧历史和灾后恢复分别选择材料;最后应在浏览器看到旧时间线与新记录继续写入,而不是只看见数据库文件。每天北京时间 11:40 自动备份数据库和看板,每次都留一份运行回执,分别写清本地快照和云端同步成没成功。

当前情况:最新一轮每日备份 11 月 6 日 11:40:02 开始、12:05:18 完成,回执为 pass,本地快照和云端同步均完成、退出码 0;10 月 29 日的本地失败保留为历史。11 月 6 日 14:25 只读查看时有 8 份完整数据库备份,当时最新一份约 5.5 GiB;但还没有用真实备份试过整库恢复,不能承诺故障前记录全部找回。

项目源码:公开仓库

安装、换机与数据恢复
现在
常用 · 最新备份完成 11 月 6 日 12:05
11 月 6 日这轮备份已通过:11:40 开始、12:10 完成,本地和云端都完成
真实备份还没试过整库恢复
截至 11 月 6 日 · 项目仓库和备份回执

新电脑从零安装、带回旧历史和灾后恢复分别选择材料;最后应在浏览器看到旧时间线与新记录继续写入,而不是只看见数据库文件。每天北京时间 11:40 自动备份数据库和看板,每次都留一份运行回执,分别写清本地快照和云端同步成没成功。

当前情况:最新一轮每日备份 11 月 6 日 11:40:02 开始、12:05:18 完成,回执为 pass,本地快照和云端同步均完成、退出码 0;10 月 29 日的本地失败保留为历史。11 月 6 日 14:25 只读查看时有 8 份完整数据库备份,当时最新一份约 5.5 GiB;但还没有用真实备份试过整库恢复,不能承诺故障前记录全部找回。

项目源码:公开仓库

数字截至 2026 年 11 月 6 日

这项功能怎样使用

用途与实际影响

为什么需要它

新电脑从零安装和带回旧历史是两件事。只复制项目文件夹会混进旧机器的运行状态;真正恢复须先验历史备份,再确认数据库、浏览器大盘和自动记录重新连上。

举个实际例子

我说“把旧电脑上的 TimeAudit 连历史一起搬到新机”。恢复完成后,我应该能在浏览器里打开原来的大盘、查到备份里的旧时间线,同时看到新电脑的记录继续往前走;若备份之后到故障之前有一段拿不回来,它会单独列出,而不是承诺历史零丢失。

最后我会得到什么

恢复后应能在浏览器大盘看到备份里的旧时间线,也看见新电脑继续产生记录。若只装好了程序、旧备份读不出或故障前最后一段没备到,会逐项列出,不承诺零丢失。

这项功能怎样使用

用途与实际影响

为什么需要它

新电脑从零安装和带回旧历史是两件事。只复制项目文件夹会混进旧机器的运行状态;真正恢复须先验历史备份,再确认数据库、浏览器大盘和自动记录重新连上。

举个实际例子

我说“把旧电脑上的 TimeAudit 连历史一起搬到新机”。恢复完成后,我应该能在浏览器里打开原来的大盘、查到备份里的旧时间线,同时看到新电脑的记录继续往前走;若备份之后到故障之前有一段拿不回来,它会单独列出,而不是承诺历史零丢失。

最后我会得到什么

恢复后应能在浏览器大盘看到备份里的旧时间线,也看见新电脑继续产生记录。若只装好了程序、旧备份读不出或故障前最后一段没备到,会逐项列出,不承诺零丢失。

结果怎么看
正常时

所选备份、运行环境、旧历史和新采集都逐层读回时,才说明对应部分恢复。

发现问题时

数据库备份读不出、大盘打不开或新记录不前进时停在那一层并保留旧备份。

入口不可用或证据不足时

备份盘、数据库或登录条件缺失时只建立可安全准备的部分,明确旧历史目前无法找回。

结果怎么看
正常时

所选备份、运行环境、旧历史和新采集都逐层读回时,才说明对应部分恢复。

发现问题时

数据库备份读不出、大盘打不开或新记录不前进时停在那一层并保留旧备份。

入口不可用或证据不足时

备份盘、数据库或登录条件缺失时只建立可安全准备的部分,明确旧历史目前无法找回。

从哪里开始

在已接入 TimeAudit 的 AI 对话中明确说全新安装或带历史换机,并给出可靠备份;Grafana 页面只负责查看结果。

需要准备什么
  • 新旧机器与目标时间线
  • 最后可靠数据库和 Grafana 备份
  • 可用软件与凭据
从开始到拿到结果
1核对最后真正可读的备份
系统确认历史数据库备份和大盘配置分别存在且能读取,并列出备份之后可能丢失的时段。
2建立并导入
安装所需运行环境,空库建表或将已验 dump 恢复到干净库,再恢复大盘。
3逐层验收
核对采集心跳、真实入库和浏览器中的旧新记录;缺备份或大盘打不开就指出停点,不说零丢失。
从哪里开始

在已接入 TimeAudit 的 AI 对话中明确说全新安装或带历史换机,并给出可靠备份;Grafana 页面只负责查看结果。

需要准备什么
  • 新旧机器与目标时间线
  • 最后可靠数据库和 Grafana 备份
  • 可用软件与凭据
从开始到拿到结果
1核对最后真正可读的备份
系统确认历史数据库备份和大盘配置分别存在且能读取,并列出备份之后可能丢失的时段。
2建立并导入
安装所需运行环境,空库建表或将已验 dump 恢复到干净库,再恢复大盘。
3逐层验收
核对采集心跳、真实入库和浏览器中的旧新记录;缺备份或大盘打不开就指出停点,不说零丢失。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

最新回执:11 月 6 日 11:40:02 开始、12:05:18 完成,status=pass,local_snapshot_status=complete、cloud_sync_status=complete、exit_code=0;只核现有回执元数据,不等于恢复验证。再往前几轮也都通过,起止按 log/backup-history.jsonl 同一行读:11 月 2 日 15:31:09—16:04:48(当天 11:40 没有开跑,15:31 才开始)、11 月 1 日 11:40:02—12:04:38、10 月 31 日 11:40:02—12:07:30、10 月 30 日 11:40:02—12:11:53。历史 2026-10-29 每日备份 11:40 开始、12:30:11 结束,结果 failed,失败环节 database,原因 backup_command_timed_out,本地快照 failed、云端同步 complete、退出码 1(backup-last-run.json,10 月 30 日回读;云端完成不证明有新数据库快照);10 月 21 日 11:40:01—12:03:05 那次本地/云端均成功、结果 0,保留为历史;11 月 4 日 12:09 健康入口读到 8 份完整 dump、当时最新约 5.7 GiB(只看元数据,没有重算指纹;10 月 30 日 11:06 是 13 份、约 5.4 GiB;10 月 12 日是 12 份);最新真实 dump 尚未做隔离整库恢复

关键规则与设计选择
1
全新安装、带历史换机、灾后 / 重装 / 硬盘更换先选场景,不把三套动作混成一张清单。
2
取得现行项目源码后运行 setup_runtime.ps1 重建 .venv;不复制旧 .venv、整个项目运行树或未干净关闭的数据卷。
3
先建立 WSL2、Docker Desktop、项目 .venv 与 PostgreSQL / ingester / Grafana 三容器。
4
全新空库执行 schema.sql;带历史换机或灾后恢复使用校验过的 dump restore。两条只选一条,避免先建再清或把空库当历史。
5
数据库 dump 优先于运行中 postgres_data 目录复制;Grafana 先确认固定 PostgreSQL datasource,再恢复 dashboard JSON 或完整状态。
6
恢复 TimeAudit_AutoStart、每分钟 TimeAudit_Watchdog 与 TimeAudit_DailyBackup 后,依次验 heartbeat、真实入库、有界聚合和浏览器看板。
7
二进制库保存完整 Grafana 状态,JSON 提供版本化 dashboard 恢复;只接受精确 .json,不导入 .json.bak;9 月 29 日起按解析后的内容比对,排版不同、内容相同不算冲突。10 月 16 日起六张主看板是 Grafana V2(elements + layout):导出保留 V2 元素和字段覆写里有含义的 id,V2 查询的 PostgreSQL 数据源必须指向固定恢复数据源;恢复走 dashboard.grafana.app/v2 接口,已有就带版本号覆盖、没有才新建,写完按 uid 回读核对。grafana_provisioning/dashboards 里的三张网站公开状态看板以文件为准,备份跳过导出,恢复遇到同 uid 也跳过。
8
任务结果 0、备份存在和源码测试都不替代最新 dump 的隔离整库恢复;历史缺口必须按最后备份时间保留。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

最新回执:11 月 6 日 11:40:02 开始、12:05:18 完成,status=pass,local_snapshot_status=complete、cloud_sync_status=complete、exit_code=0;只核现有回执元数据,不等于恢复验证。再往前几轮也都通过,起止按 log/backup-history.jsonl 同一行读:11 月 2 日 15:31:09—16:04:48(当天 11:40 没有开跑,15:31 才开始)、11 月 1 日 11:40:02—12:04:38、10 月 31 日 11:40:02—12:07:30、10 月 30 日 11:40:02—12:11:53。历史 2026-10-29 每日备份 11:40 开始、12:30:11 结束,结果 failed,失败环节 database,原因 backup_command_timed_out,本地快照 failed、云端同步 complete、退出码 1(backup-last-run.json,10 月 30 日回读;云端完成不证明有新数据库快照);10 月 21 日 11:40:01—12:03:05 那次本地/云端均成功、结果 0,保留为历史;11 月 4 日 12:09 健康入口读到 8 份完整 dump、当时最新约 5.7 GiB(只看元数据,没有重算指纹;10 月 30 日 11:06 是 13 份、约 5.4 GiB;10 月 12 日是 12 份);最新真实 dump 尚未做隔离整库恢复

关键规则与设计选择
1
全新安装、带历史换机、灾后 / 重装 / 硬盘更换先选场景,不把三套动作混成一张清单。
2
取得现行项目源码后运行 setup_runtime.ps1 重建 .venv;不复制旧 .venv、整个项目运行树或未干净关闭的数据卷。
3
先建立 WSL2、Docker Desktop、项目 .venv 与 PostgreSQL / ingester / Grafana 三容器。
4
全新空库执行 schema.sql;带历史换机或灾后恢复使用校验过的 dump restore。两条只选一条,避免先建再清或把空库当历史。
5
数据库 dump 优先于运行中 postgres_data 目录复制;Grafana 先确认固定 PostgreSQL datasource,再恢复 dashboard JSON 或完整状态。
6
恢复 TimeAudit_AutoStart、每分钟 TimeAudit_Watchdog 与 TimeAudit_DailyBackup 后,依次验 heartbeat、真实入库、有界聚合和浏览器看板。
7
二进制库保存完整 Grafana 状态,JSON 提供版本化 dashboard 恢复;只接受精确 .json,不导入 .json.bak;9 月 29 日起按解析后的内容比对,排版不同、内容相同不算冲突。10 月 16 日起六张主看板是 Grafana V2(elements + layout):导出保留 V2 元素和字段覆写里有含义的 id,V2 查询的 PostgreSQL 数据源必须指向固定恢复数据源;恢复走 dashboard.grafana.app/v2 接口,已有就带版本号覆盖、没有才新建,写完按 uid 回读核对。grafana_provisioning/dashboards 里的三张网站公开状态看板以文件为准,备份跳过导出,恢复遇到同 uid 也跳过。
8
任务结果 0、备份存在和源码测试都不替代最新 dump 的隔离整库恢复;历史缺口必须按最后备份时间保留。

数字截至 2026 年 11 月 6 日

技术实现与依据(二)
当前怎样实现
  • setup_runtime.ps1 从 Python 3.11 基座创建项目 .venv(当前 3.11.9)、安装 requirements 并运行 pip check;启动器和看门狗使用其中的 pythonw。
  • docker-compose.yml 拉起 PostgreSQL 15、audit-ingester 和 Grafana 13.0.2,与现场一致;schema(数据结构)/main 管周/月分区和预热。硬件、前台会话、生命周期、AHK 等记录默认保留 1200 天;逐程序明细只留 60 天,删除前先按小时和日汇总,汇总长期保留。汇总时同一采样时刻按应用合计不同 PID,核对样本数与源行数,遇到锁冲突整周回滚、不跳过;后台维护每 12 小时一次,不阻塞每秒采样。
  • backup_db 用 pg_dump;backup_grafana 用一致快照导出 JSON。当前导出 6 张主看板(都是 V2 格式,共 80 图);网站公开状态的 3 张小看板只维护在 grafana_provisioning/dashboards 的文件里,10 月 20 日起备份不再重复导出。看板推送 GitHub 遇到 Schannel 握手失败会按记录重试(10 月 13 日加)。
  • restore_grafana 只接受合同通过的 JSON,并支持 dry-run;V2 看板走 V2 接口写入并按 uid 回读,文件预置的看板跳过。恢复前核对数据源类型时用约定模块的 POSTGRES_DATASOURCE_TYPES,同时认旧名 postgres 和 Grafana 12 起的 grafana-postgresql-datasource;之前只认旧名,会拒绝导入(74c6c2a,10 月 28 日)。
  • PCConfig 重建 AutoStart 与每分钟看门狗;DailyBackup 每天北京时间 11:40 组合备份,数据库备份默认保留 7 天(backup_db.ps1 的 RetentionDays=7、timeaudit_backup.py 默认 retention_days=7,1501fd1,10 月 31 日 15:48 提交)、且至少保留 3 份完整可验证的备份,所以不是固定 7 份:11 月 4 日 12:09 是 7 份,覆盖 10 月 28 日到 11 月 4 日,少的是 10 月 29 日那次失败、没出成品的一份。这次改的只是数据库备份;Grafana 二进制快照仍留 14 份,是另一个设置。留 14 天时的记录作为历史:10 月 30 日跑完后是 13 份,覆盖 10 月 17 日到 30 日;10 月 22 日 06:47 是 14 份;10 月 12 日看时是 12 份,缺 10 月 1 日和 10 月 8 日的成品,原因沿用当时的核查,这次没有重查。
  • 组合备份分数据库和看板两步各自尝试,任一步普通失败整次就算失败;log/backup-last-run.json 开跑时写“运行中”,结束时分别写本地快照和云端同步的状态,云端失败不冒充本地失败;10 月 20 日起每次结束还往 log/backup-history.jsonl 追加一行,留最近 30 次的起止时间、状态、失败环节和退出码。已有备份在进行、或上次导出事务没收尾时,不启动第二条重叠导出。读取运行中容器镜像身份的只读检查,10 月 29 日起(10a8895,合入 91b7ba0)单次限时从 5 秒放宽到 30 秒,只有超时或明确的暂态错误才重试,最多 3 次;这是源码修复;修复之后从最新回执确认 11 月 6 日 11:40:02—12:05:18 一轮 pass、本地快照与云端同步均完成,尚未做真实整库恢复。杀毒软件隔离或移除了本次精确路径这类窄情况,可带文件告警保留此前可恢复的快照,并写明新数据是否拷入。
  • README 记录当前 .venv、每 1 分钟看门狗与运行链;快速部署.md 现在已写六张主看板 80 图、只迁源码依赖和可靠备份、不承诺零丢失、每分钟看门狗。11 月 5 日 02:18(f43bf35)又把原来对不上现场的两处改对了:写明每天北京时间 11:40、数据库备份保留最近 7 天,并说明触发器带时区偏移,部署 PDF 同次更新;11 月 6 日 05:15 只读回读任务 TimeAudit_DailyBackup,已启用,StartBoundary 对应北京时间 11:40。这只是文档修好了:这份说明仍没有实机走通过,真实备份也还没做过隔离整库恢复。
  • timeaudit_backup.py restore-check 使用已安装固定镜像、无网络/无公开端口、只读归档挂载与独立数据库,绝不导入 audit-postgres。原容器完成记录可跨客户端断线保留;restore-status 查看同次进度,finish-restore 核对退出码、可读表、所有权标签后记录结果并清理本次容器/匿名卷。running/starting 不算 PASS,未知资源不盲重建或删除。
技术实现与依据(二)
当前怎样实现
  • setup_runtime.ps1 从 Python 3.11 基座创建项目 .venv(当前 3.11.9)、安装 requirements 并运行 pip check;启动器和看门狗使用其中的 pythonw。
  • docker-compose.yml 拉起 PostgreSQL 15、audit-ingester 和 Grafana 13.0.2,与现场一致;schema(数据结构)/main 管周/月分区和预热。硬件、前台会话、生命周期、AHK 等记录默认保留 1200 天;逐程序明细只留 60 天,删除前先按小时和日汇总,汇总长期保留。汇总时同一采样时刻按应用合计不同 PID,核对样本数与源行数,遇到锁冲突整周回滚、不跳过;后台维护每 12 小时一次,不阻塞每秒采样。
  • backup_db 用 pg_dump;backup_grafana 用一致快照导出 JSON。当前导出 6 张主看板(都是 V2 格式,共 80 图);网站公开状态的 3 张小看板只维护在 grafana_provisioning/dashboards 的文件里,10 月 20 日起备份不再重复导出。看板推送 GitHub 遇到 Schannel 握手失败会按记录重试(10 月 13 日加)。
  • restore_grafana 只接受合同通过的 JSON,并支持 dry-run;V2 看板走 V2 接口写入并按 uid 回读,文件预置的看板跳过。恢复前核对数据源类型时用约定模块的 POSTGRES_DATASOURCE_TYPES,同时认旧名 postgres 和 Grafana 12 起的 grafana-postgresql-datasource;之前只认旧名,会拒绝导入(74c6c2a,10 月 28 日)。
  • PCConfig 重建 AutoStart 与每分钟看门狗;DailyBackup 每天北京时间 11:40 组合备份,数据库备份默认保留 7 天(backup_db.ps1 的 RetentionDays=7、timeaudit_backup.py 默认 retention_days=7,1501fd1,10 月 31 日 15:48 提交)、且至少保留 3 份完整可验证的备份,所以不是固定 7 份:11 月 4 日 12:09 是 7 份,覆盖 10 月 28 日到 11 月 4 日,少的是 10 月 29 日那次失败、没出成品的一份。这次改的只是数据库备份;Grafana 二进制快照仍留 14 份,是另一个设置。留 14 天时的记录作为历史:10 月 30 日跑完后是 13 份,覆盖 10 月 17 日到 30 日;10 月 22 日 06:47 是 14 份;10 月 12 日看时是 12 份,缺 10 月 1 日和 10 月 8 日的成品,原因沿用当时的核查,这次没有重查。
  • 组合备份分数据库和看板两步各自尝试,任一步普通失败整次就算失败;log/backup-last-run.json 开跑时写“运行中”,结束时分别写本地快照和云端同步的状态,云端失败不冒充本地失败;10 月 20 日起每次结束还往 log/backup-history.jsonl 追加一行,留最近 30 次的起止时间、状态、失败环节和退出码。已有备份在进行、或上次导出事务没收尾时,不启动第二条重叠导出。读取运行中容器镜像身份的只读检查,10 月 29 日起(10a8895,合入 91b7ba0)单次限时从 5 秒放宽到 30 秒,只有超时或明确的暂态错误才重试,最多 3 次;这是源码修复;修复之后从最新回执确认 11 月 6 日 11:40:02—12:05:18 一轮 pass、本地快照与云端同步均完成,尚未做真实整库恢复。杀毒软件隔离或移除了本次精确路径这类窄情况,可带文件告警保留此前可恢复的快照,并写明新数据是否拷入。
  • README 记录当前 .venv、每 1 分钟看门狗与运行链;快速部署.md 现在已写六张主看板 80 图、只迁源码依赖和可靠备份、不承诺零丢失、每分钟看门狗。11 月 5 日 02:18(f43bf35)又把原来对不上现场的两处改对了:写明每天北京时间 11:40、数据库备份保留最近 7 天,并说明触发器带时区偏移,部署 PDF 同次更新;11 月 6 日 05:15 只读回读任务 TimeAudit_DailyBackup,已启用,StartBoundary 对应北京时间 11:40。这只是文档修好了:这份说明仍没有实机走通过,真实备份也还没做过隔离整库恢复。
  • timeaudit_backup.py restore-check 使用已安装固定镜像、无网络/无公开端口、只读归档挂载与独立数据库,绝不导入 audit-postgres。原容器完成记录可跨客户端断线保留;restore-status 查看同次进度,finish-restore 核对退出码、可读表、所有权标签后记录结果并清理本次容器/匿名卷。running/starting 不算 PASS,未知资源不盲重建或删除。
技术实现与依据(三)
1
先选场景:全新安装没有历史、换机需要带历史,或灾后 / 重装 / 硬盘更换从备份恢复;记录最后可靠备份与预期历史缺口。
2
安装或确认 WSL2 与 Docker Desktop,取得现行项目源码,运行 pwsh -File .\setup_runtime.ps1 重建项目 .venv。
3
准备凭据后以 compose 拉起 PostgreSQL、audit-ingester、Grafana 三容器,并确认容器身份与 health;start_all --no-recreate 不会自动套用 compose 配置变更。
4
数据库二选一:全新空库执行 schema.sql;带历史或灾后候选先校验 dump,再恢复到干净目标库,不额外走空库建表路线。
5
确认 Grafana 固定 PostgreSQL datasource,再用合同通过的 JSON 或完整 Grafana 备份恢复 dashboard,并在浏览器打开 http://localhost:43000。
6
重建并回读 TimeAudit_AutoStart、TimeAudit_Watchdog、TimeAudit_DailyBackup,再手动触发一次受控启动或备份检查。
  • backup_db.ps1 以合格 Python 导出到唯一 .partial,flush 后确认 PostgreSQL custom 格式、列归档并算 SHA-256,再发布 .dump 及原子 .dump.json。失败不替换成功档案,无法证明可清理的旧原件保留。健康检查只看清单形状、长度与新鲜度,不重哈希全部载荷。
执行流程
技术实现与依据(三)
1
先选场景:全新安装没有历史、换机需要带历史,或灾后 / 重装 / 硬盘更换从备份恢复;记录最后可靠备份与预期历史缺口。
2
安装或确认 WSL2 与 Docker Desktop,取得现行项目源码,运行 pwsh -File .\setup_runtime.ps1 重建项目 .venv。
3
准备凭据后以 compose 拉起 PostgreSQL、audit-ingester、Grafana 三容器,并确认容器身份与 health;start_all --no-recreate 不会自动套用 compose 配置变更。
4
数据库二选一:全新空库执行 schema.sql;带历史或灾后候选先校验 dump,再恢复到干净目标库,不额外走空库建表路线。
5
确认 Grafana 固定 PostgreSQL datasource,再用合同通过的 JSON 或完整 Grafana 备份恢复 dashboard,并在浏览器打开 http://localhost:43000。
6
重建并回读 TimeAudit_AutoStart、TimeAudit_Watchdog、TimeAudit_DailyBackup,再手动触发一次受控启动或备份检查。
  • backup_db.ps1 以合格 Python 导出到唯一 .partial,flush 后确认 PostgreSQL custom 格式、列归档并算 SHA-256,再发布 .dump 及原子 .dump.json。失败不替换成功档案,无法证明可清理的旧原件保留。健康检查只看清单形状、长度与新鲜度,不重哈希全部载荷。
执行流程
技术实现与依据(四)
7
按三条 heartbeat 推进、真实入库、timeaudit_diagnostic_summary.py 聚合覆盖、浏览器六张主看板可读的顺序验收。
8
最后列出备份后到故障时刻的历史缺口、不可恢复项和未执行的演练;目前仍未从最新 dump 做隔离整库恢复。
技术实现与依据(四)
7
按三条 heartbeat 推进、真实入库、timeaudit_diagnostic_summary.py 聚合覆盖、浏览器六张主看板可读的顺序验收。
8
最后列出备份后到故障时刻的历史缺口、不可恢复项和未执行的演练;目前仍未从最新 dump 做隔离整库恢复。
名词和入口
本模块用到的名词
名词意思
dump(逻辑备份)由 PostgreSQL 生成、可校验恢复的文件。
fresh install(全新安装)没有历史库的场景;在三容器就绪后用 schema.sql 创建空表结构。
history restore(历史恢复)换机或灾后把校验过的 dump 恢复到干净目标库;dump 自带结构,不与空库建表步骤叠加。
runtime rebuild(运行环境重建)从现行源码和 requirements 运行 setup_runtime.ps1 创建项目 .venv,不复制旧机器的虚拟环境。
acceptance chain(验收链)从任务、heartbeat、真实入库、聚合摘要到浏览器大盘逐层回读;上一层成功不替代下一层。
consistent snapshot(一致快照)同一事务视图读取 Grafana SQLite。
dry-run(预检)只发现和验证,不修改运行实例。
专业定义

把全新安装、带历史换机、系统重装 / 硬盘更换三种场景拆开:先重建 WSL(Windows 的 Linux 子系统)、Docker、项目 .venv 和三容器,再在空库建表或 dump 恢复中二选一,接回 Grafana、三项计划任务并做真实数据链验收。

名词和入口
本模块用到的名词
名词意思
dump(逻辑备份)
意思:
由 PostgreSQL 生成、可校验恢复的文件。
fresh install(全新安装)
意思:
没有历史库的场景;在三容器就绪后用 schema.sql 创建空表结构。
history restore(历史恢复)
意思:
换机或灾后把校验过的 dump 恢复到干净目标库;dump 自带结构,不与空库建表步骤叠加。
runtime rebuild(运行环境重建)
意思:
从现行源码和 requirements 运行 setup_runtime.ps1 创建项目 .venv,不复制旧机器的虚拟环境。
acceptance chain(验收链)
意思:
从任务、heartbeat、真实入库、聚合摘要到浏览器大盘逐层回读;上一层成功不替代下一层。
consistent snapshot(一致快照)
意思:
同一事务视图读取 Grafana SQLite。
dry-run(预检)
意思:
只发现和验证,不修改运行实例。
专业定义

把全新安装、带历史换机、系统重装 / 硬盘更换三种场景拆开:先重建 WSL(Windows 的 Linux 子系统)、Docker、项目 .venv 和三容器,再在空库建表或 dump 恢复中二选一,接回 Grafana、三项计划任务并做真实数据链验收。

出问题时(一)
边界
  • 数据库和二进制备份不进入 PUBLIC(公开)Git。
  • Git JSON 不等于完整数据库或用户状态。
  • 快速部署.md 现在写的是数据库备份保留最近 7 天、每天北京时间 11:40(11 月 5 日 f43bf35),和 backup_db.ps1、timeaudit_backup.py、现场计划任务一致;以后再对不上,仍以代码和现场计划任务为准。文档修好不等于部署或恢复走通过。
  • 恢复最多到最后一份可靠备份;故障前尚未备份的区间必须列为历史缺口。
  • 无恢复回读不能称灾难恢复完成;9 月 17 日的恢复检查通过只针对一个 2317 字节、3 张表的合成归档,不能代替当前真实备份(11 月 04 日 08:35 观察时约 5.5 GiB)的隔离整库恢复。
失败与恢复
情况
怎么处理
全新安装误走 dump 恢复或历史恢复先建空表
停止并重新确认场景;在 schema.sql 建表与 dump restore 中只选正确的一条。
旧文档要求复制整个项目树或旧 .venv
只迁移现行源码与经选择的备份,在目标机运行 setup_runtime.ps1 重建环境;运行卷不作为默认迁移手段。
JSON 有人工脏改
内容真不一致时失败关闭,不覆盖或夹带;只是排版不同不算冲突。
出问题时(一)
边界
  • 数据库和二进制备份不进入 PUBLIC(公开)Git。
  • Git JSON 不等于完整数据库或用户状态。
  • 快速部署.md 现在写的是数据库备份保留最近 7 天、每天北京时间 11:40(11 月 5 日 f43bf35),和 backup_db.ps1、timeaudit_backup.py、现场计划任务一致;以后再对不上,仍以代码和现场计划任务为准。文档修好不等于部署或恢复走通过。
  • 恢复最多到最后一份可靠备份;故障前尚未备份的区间必须列为历史缺口。
  • 无恢复回读不能称灾难恢复完成;9 月 17 日的恢复检查通过只针对一个 2317 字节、3 张表的合成归档,不能代替当前真实备份(11 月 04 日 08:35 观察时约 5.5 GiB)的隔离整库恢复。
失败与恢复
情况
怎么处理
全新安装误走 dump 恢复或历史恢复先建空表
停止并重新确认场景;在 schema.sql 建表与 dump restore 中只选正确的一条。
旧文档要求复制整个项目树或旧 .venv
只迁移现行源码与经选择的备份,在目标机运行 setup_runtime.ps1 重建环境;运行卷不作为默认迁移手段。
JSON 有人工脏改
内容真不一致时失败关闭,不覆盖或夹带;只是排版不同不算冲突。

数字截至 2026 年 11 月 6 日

出问题时(二)
情况 怎么处理
退役 UID / matcher 缺失 合同失败,不能恢复。
任务显示成功但 heartbeat、入库或看板不通 只把任务层标为通过,继续定位受影响层;不宣布系统恢复。
远端领先或分叉 不 push、不 force-push,保留本地备份。
数据库或看板备份有一步失败 整次记为失败,回执分别写本地与云端状态;云端同步完成不代表本地数据库快照成功(10 月 29 日即本地失败、云端完成)。只有杀毒隔离等窄情况带告警保留此前快照。
出问题时(二)
情况 怎么处理
退役 UID / matcher 缺失 合同失败,不能恢复。
任务显示成功但 heartbeat、入库或看板不通 只把任务层标为通过,继续定位受影响层;不宣布系统恢复。
远端领先或分叉 不 push、不 force-push,保留本地备份。
数据库或看板备份有一步失败 整次记为失败,回执分别写本地与云端状态;云端同步完成不代表本地数据库快照成功(10 月 29 日即本地失败、云端完成)。只有杀毒隔离等窄情况带告警保留此前快照。
依据与来源(一)
真实入口
  • 表、分区与索引
  • 数据库、ingester 与 Grafana
  • 项目 .venv 创建、依赖安装和冲突检查
  • 现行每分钟 Watchdog、.venv 与运行验收事实
  • 组合备份
  • 数据库 dump
  • Grafana 导出与同步
  • 验证与恢复
依据与来源(一)
真实入口
  • 表、分区与索引
  • 数据库、ingester 与 Grafana
  • 项目 .venv 创建、依赖安装和冲突检查
  • 现行每分钟 Watchdog、.venv 与运行验收事实
  • 组合备份
  • 数据库 dump
  • Grafana 导出与同步
  • 验证与恢复
依据与来源(二)
  • 三场景部署说明(快速部署.md);数据库备份保留期和每日钟点 11 月 5 日已改到和现场一致,说明本身没有实机走通过
  • 备份回归
  • 恢复回归
  • 分区查询审计
  • 质量来源、活动持久化、共享健康、数据库备份与独立恢复的当前合同
如何验证
  • 2026-10-11 只读:DailyBackup 任务最近一次 11:40:01 开始、结果 0,下次 10 月 12 日 11:40;运行回执 11:40:18 开始、12:44:13 完成,本地快照和云端同步都成功。
  • 最新数据库 dump 约 4.7 GiB(5,041,899,358 字节),12:43 写完;完成的 dump 共 12 份,覆盖 9 月 28 日到 10 月 11 日(缺 10 月 1 日和 8 日)。
  • 9 月 17 日 20:13 的恢复检查通过,对象是 2317 字节、3 张表的合成归档;8 月 31 日回读的 DailyBackup 结果 0 保留原日期。
依据与来源(二)
  • 三场景部署说明(快速部署.md);数据库备份保留期和每日钟点 11 月 5 日已改到和现场一致,说明本身没有实机走通过
  • 备份回归
  • 恢复回归
  • 分区查询审计
  • 质量来源、活动持久化、共享健康、数据库备份与独立恢复的当前合同
如何验证
  • 2026-10-11 只读:DailyBackup 任务最近一次 11:40:01 开始、结果 0,下次 10 月 12 日 11:40;运行回执 11:40:18 开始、12:44:13 完成,本地快照和云端同步都成功。
  • 最新数据库 dump 约 4.7 GiB(5,041,899,358 字节),12:43 写完;完成的 dump 共 12 份,覆盖 9 月 28 日到 10 月 11 日(缺 10 月 1 日和 8 日)。
  • 9 月 17 日 20:13 的恢复检查通过,对象是 2317 字节、3 张表的合成归档;8 月 31 日回读的 DailyBackup 结果 0 保留原日期。
依据与来源(三)
  • 备份、恢复与看板合同纳入定向测试并通过(历史);当前源码有 356 个以 test_ 开头的测试函数,这次没有运行。
  • README 与 setup_runtime.ps1 当前证明运行环境应在目标机重建、看门狗为每分钟检查;它们不证明某次换机已经完成。11 月 4 日 13:29 只读观察数据库约 75.6 GiB(由数据库接口读取字节后换算,精确总行数这次没有数)。
  • 未从最新 dump 做隔离 pg_restore,也未完整走三场景任一真实换机旅程,恢复 E2E(端到端验证)仍缺。
与其他模块的关系

先重建采集模块的运行与存储底座,再恢复硬件、进程、时间和可视化所需历史;可靠性模块接回 AutoStart / 看门狗,最终由 heartbeat、入库、聚合和浏览器看板共同验收。

依据与来源(三)
  • 备份、恢复与看板合同纳入定向测试并通过(历史);当前源码有 356 个以 test_ 开头的测试函数,这次没有运行。
  • README 与 setup_runtime.ps1 当前证明运行环境应在目标机重建、看门狗为每分钟检查;它们不证明某次换机已经完成。11 月 4 日 13:29 只读观察数据库约 75.6 GiB(由数据库接口读取字节后换算,精确总行数这次没有数)。
  • 未从最新 dump 做隔离 pg_restore,也未完整走三场景任一真实换机旅程,恢复 E2E(端到端验证)仍缺。
与其他模块的关系

先重建采集模块的运行与存储底座,再恢复硬件、进程、时间和可视化所需历史;可靠性模块接回 AutoStart / 看门狗,最终由 heartbeat、入库、聚合和浏览器看板共同验收。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:安装、换机与数据恢复;仓库:wlyaaaaa/TimeAudit;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。