日志导出教学示例库

DEMO-LOGPIPE 按版本复做操作说明

普通整理原稿

DEMO-LOGPIPE-runbook.md下载原文件
示例库目录(4 篇文档)

适用:后续同事复现教学夹具和整理知识库证据。工作目录为知识库根目录,不修改 materials,不覆盖历史运行文件。全程使用 python -B,包括动态导入的探针;无 Python 时记录未运行及原因,只能引用维护者结果,不能声称本地验证。

选择路径和定位证据

要回答的问题 路径 预期与证据
原关闭分支是否遗漏尾批;删分支后是否排空 v1 探针 before 的关闭项 false;after 三项 true;第一轮记录
无去重输出端失败重试是否重复 v1 探针 after_failure_probe:首次 [A]、pending=[A,B];重试 [A,A,B]、duplicate_free=false;历史本地输出
稳定 ID、同实例去重能否处理确认丢失 v2 探针,仍依赖 v1 after first_attempt 已存两条而 pending 未清;same_receiver_retry 清空且 duplicate_free=true;v2 本地输出
ID 内容冲突 / 去重状态丢失 v2 探针 id_conflict 拒绝;after_dedup_reset 四条且 duplicate_free=false;v2 分析及指纹

v1 的 false 是预期失败证据;v2 reset 的 false 是保留边界,不应为了“全绿”修改期望。两版探针退出码 0 都不等于所有语义通过。

执行与留证

  1. 阅读所选版本源码和探针。对照 第一轮指纹 或 v2 指纹,核对材料版本。v2 必须连同 v1/batchpub_after.py 核对。指纹不符时建立新的版本范围,不套用旧结论。
  2. 在根目录运行下列只读命令;可只选一个版本,也可两个都运行。输出到终端,不在 materials 中落文件。
python -B --version
Get-ChildItem materials -Recurse -File | Get-FileHash -Algorithm SHA256
python -B materials/v1/probe_batchpub.py
python -B materials/v2/probe_dedup.py
  1. 需要保存时,用未使用过的会话名称执行下列模板(改版本、探针和目标文件)。使用 x 模式避免覆盖;命令会验证 JSON,并按结构对照该版本维护者结果。
python -B -c 'import json,pathlib,subprocess,sys; p=subprocess.run([sys.executable,"-B","materials/v2/probe_dedup.py"],capture_output=True,text=True,check=True); actual=json.loads(p.stdout); expected=json.loads(pathlib.Path("materials/v2/observations.json").read_text(encoding="utf-8")); print("matches_maintainer:",actual==expected); target=pathlib.Path("DEMO-LOGPIPE-session-NEW-v2-run.json"); f=target.open("x",encoding="utf-8"); f.write(json.dumps(actual,ensure_ascii=False,indent=2)+"\n"); f.close()'
  1. 核对上表每个字段及异常,不能只看退出码或比较结果。v1 与 v2 的故障点不同:v1 是 B 存入前拒绝;v2 是 B 存入后确认丢失。v2 reset 只清空 seen,不模拟真实重启。发现差异时保存实际输出和环境,调查差异,不覆盖维护者结果。
  2. 检查运行前后材料 SHA-256 一致;检查缓存:Get-ChildItem materials -Recurse -Force | Where-Object { $_.Name -eq "__pycache__" -or $_.Extension -eq ".pyc" }。记录 Python 版本、命令、退出码、结构比较、源指纹、缓存检查和证据路径。
  3. 新建独立会话记录,链接实际输出、源码和维护者结果;更新 当前状态 中受影响的条件和复用说明。历史记录保留原验证范围,只补导航,不把旧失败改成新版通过。无独立产物的会话只标明信息来源,不补造证据。

本次执行基线

2026-10-28,Windows PowerShell / Python 3.13.14:v1、v2 都实际运行,退出码均 0,按 JSON 结构分别与 v1 维护者结果、v2 维护者结果 完全一致;v1 同时匹配第一轮保存结果。新产物为 v2 本地结果。既有文件运行前后指纹相同,未发现字节码缓存。