日志批量导出教学材料 / 后续独立改动

全部背景与源码为虚构教学项目，不是公司资料或真实网络服务。
来源：维护者于 2026-10-28 在 Python 3.13.14 本机执行探针；下面的结果不代表阅读者已经在本机执行。
源码中的列表和接收端只模拟输出，未验证真实网络或持久化。

原文件可逐项下载，地址列在每节开头。若需保存源码和结果，请直接下载原文件并核对 SHA-256；不要从本 TXT 还原原始字节。本 TXT 用于阅读，换行可能与原文件不同。无需运行源码即可整理已有证据。

===== materials/v2/idempotent_sink.py =====
原文件: https://yzh0013.cloud/downloads/knowledge-workflow/examples/log-export/vault/materials/v2/idempotent_sink.py
SHA-256: a24df08c000ea0fc53da8f0996c2296982c5948a55fa95c644a1b4cf2fb061fc

"""In-process teaching sink. Not a real network service or durable database."""


class IdempotentSink(list):
    def __init__(self):
        super().__init__()
        self.seen = {}
        self.lost_ack = False

    def append(self, record):
        key, payload = record['id'], record['payload']
        if key in self.seen:
            if self.seen[key] != payload:
                raise ValueError('same record id with different payload')
            return
        self.seen[key] = payload
        super().append(dict(record))
        if key == 'L-102' and not self.lost_ack:
            self.lost_ack = True
            raise RuntimeError('record stored, acknowledgement lost')

    def forget_dedup_state(self):
        self.seen.clear()

===== materials/v2/observations.json =====
原文件: https://yzh0013.cloud/downloads/knowledge-workflow/examples/log-export/vault/materials/v2/observations.json
SHA-256: b91fe340fd5297dc0b6a7a34e22f347ad473efc352e5e5231269858c58fc61b6

{
  "scope": "In-process teaching fixtures only; no real network, disk persistence, or product acceptance.",
  "files": {
    "v1/batchpub_after.py": "31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac",
    "v2/idempotent_sink.py": "a24df08c000ea0fc53da8f0996c2296982c5948a55fa95c644a1b4cf2fb061fc",
    "v2/probe_dedup.py": "853844dd0435db05557c74e44704d887d9f413cd5ea15cf5ed3133a911235c68"
  },
  "first_attempt": {
    "pending": [
      {
        "id": "L-101",
        "payload": "A"
      },
      {
        "id": "L-102",
        "payload": "B"
      }
    ],
    "stored": [
      {
        "id": "L-101",
        "payload": "A"
      },
      {
        "id": "L-102",
        "payload": "B"
      }
    ],
    "error": "record stored, acknowledgement lost"
  },
  "same_receiver_retry": {
    "pending": [],
    "stored": [
      {
        "id": "L-101",
        "payload": "A"
      },
      {
        "id": "L-102",
        "payload": "B"
      }
    ],
    "duplicate_free": true
  },
  "id_conflict": "same record id with different payload",
  "after_dedup_reset": {
    "stored": [
      {
        "id": "L-101",
        "payload": "A"
      },
      {
        "id": "L-102",
        "payload": "B"
      },
      {
        "id": "L-101",
        "payload": "A"
      },
      {
        "id": "L-102",
        "payload": "B"
      }
    ],
    "duplicate_free": false
  }
}

===== materials/v2/probe_dedup.py =====
原文件: https://yzh0013.cloud/downloads/knowledge-workflow/examples/log-export/vault/materials/v2/probe_dedup.py
SHA-256: 853844dd0435db05557c74e44704d887d9f413cd5ea15cf5ed3133a911235c68

"""Execute the version-2 teaching conditions and expose the remaining boundary."""
import hashlib
import importlib.util
import json
from pathlib import Path
from idempotent_sink import IdempotentSink

ROOT = Path(__file__).resolve().parent
CLIENT = ROOT.parent / 'v1/batchpub_after.py'
spec = importlib.util.spec_from_file_location('client', CLIENT)
client = importlib.util.module_from_spec(spec)
spec.loader.exec_module(client)


def records():
    return [{'id': 'L-101', 'payload': 'A'}, {'id': 'L-102', 'payload': 'B'}]


def run():
    pending, sink = records(), IdempotentSink()
    error = None
    try:
        client.flush(pending, sink, closed=True)
    except RuntimeError as caught:
        error = str(caught)
    first = {'pending': list(pending), 'stored': list(sink), 'error': error}
    client.flush(pending, sink, closed=True)
    same_process = {'pending': list(pending), 'stored': list(sink), 'duplicate_free': list(sink) == records()}
    conflict = None
    try:
        sink.append({'id': 'L-101', 'payload': 'different'})
    except ValueError as caught:
        conflict = str(caught)
    sink.forget_dedup_state()
    client.flush(records(), sink, closed=True)
    after_reset = {'stored': list(sink), 'duplicate_free': len(sink) == 2}
    return {
        'scope': 'In-process teaching fixtures only; no real network, disk persistence, or product acceptance.',
        'files': {str(path.relative_to(ROOT.parent)).replace('\\','/'): hashlib.sha256(path.read_bytes()).hexdigest()
                  for path in [CLIENT, ROOT/'idempotent_sink.py', ROOT/'probe_dedup.py']},
        'first_attempt': first,
        'same_receiver_retry': same_process,
        'id_conflict': conflict,
        'after_dedup_reset': after_reset,
    }


if __name__ == '__main__':
    print(json.dumps(run(), indent=2, ensure_ascii=False))

