#!/usr/bin/env python3 """Replay Easel's unchanged new/revise CLI with public-page rehearsal inputs. Python standard library only. No network, model, OpenClaw, or interview is used. Default: verify the checked-in artifacts. --out: create a new artifact folder. """ from __future__ import annotations import argparse import hashlib import json import os from pathlib import Path import runpy import shutil import subprocess import sys import tempfile HERE = Path(__file__).resolve().parent UPSTREAM_SHA = "a097ddfbb704c9d1eeb1db49a056fdbca9c2351a" TOPIC = "网站研究文档404修复演练" ARTIFACTS = ("card-v1.md", "card-v2.md", "gallery.html") def read_json(name): return json.loads((HERE / name).read_text(encoding="utf-8")) def make_gallery(versions, provenance): payload = json.dumps({"versions": versions, "provenance": provenance}, ensure_ascii=False) payload = payload.replace("<", "\\u003c") return GALLERY.replace("__CARD_DATA__", payload) def replay(): provenance = read_json("provenance.json") assert provenance["upstream_commit"] == UPSTREAM_SHA, "Unexpected upstream revision" for name, digest in provenance["upstream_files_unmodified"].items(): actual = hashlib.sha256((HERE / "upstream" / name).read_bytes()).hexdigest() assert actual == digest, f"Vendored upstream file changed: {name}" initial, revision = read_json("input-v1.json"), read_json("input-v2.json") card_cli = HERE / "upstream/skills/builtin/skill-record-card/scripts/card.py" with tempfile.TemporaryDirectory(prefix="easel-card-replay-") as directory: scratch = Path(directory) env = {**os.environ, "EASEL_ROOT": str(scratch), "PYTHONDONTWRITEBYTECODE": "1"} def call(*args): result = subprocess.run([sys.executable, str(card_cli), *args], cwd=scratch, env=env, text=True, capture_output=True) if result.returncode: raise RuntimeError(f"card.py {args[0]} failed: {result.stderr or result.stdout}") return result.stdout call("selftest") created = json.loads(call("new", "--topic", TOPIC, "--data", str(HERE / "input-v1.json"), "--date", provenance["fixture_date"])) assert created["card"] == "card-001" and created["version"] == 1 card_path = Path(created["path"]) assert card_path.resolve().is_relative_to(scratch.resolve()) v1 = card_path.read_text(encoding="utf-8") args = ["revise", "--topic", TOPIC, "--card", "001", "--date", provenance["fixture_date"], "--change", revision["change"]] for field, value in revision["fields"].items(): args.extend(["--" + field.replace("_", "-"), value]) if revision["replace_ai_notes"]: args.append("--replace-ai-notes") for note in revision["ai_notes"]: args.extend(["--ai-note", note]) revised = json.loads(call(*args)) assert revised["card"] == "card-001" and revised["version"] == 2 v2 = card_path.read_text(encoding="utf-8") assert call("show", "--topic", TOPIC, "--card", "001").strip() == v2.strip() listing = call("list", "--topic", TOPIC) assert "card-001" in listing and "v2" in listing and "card-002" not in listing # Read the actual outputs through the pinned upstream parser, not a second renderer. previous_root = os.environ.get("EASEL_ROOT") previous_bytecode = sys.dont_write_bytecode os.environ["EASEL_ROOT"] = str(scratch) sys.dont_write_bytecode = True try: upstream = runpy.run_path(str(card_cli)) first = upstream["parse_versions"](v1) versions = upstream["parse_versions"](v2) finally: sys.dont_write_bytecode = previous_bytecode if previous_root is None: os.environ.pop("EASEL_ROOT", None) else: os.environ["EASEL_ROOT"] = previous_root assert [version["num"] for version in versions] == [1, 2] assert versions[0] == first[0], "Revision changed historical v1" assert versions[0]["quotes"] == versions[1]["quotes"] == [], "No user interview quotes exist" for field in upstream["FIELDS"]: assert versions[0]["fields"][field] == initial[field] assert versions[1]["fields"][field] == revision["fields"].get(field, initial[field]) assert versions[1]["ai_notes"] == revision["ai_notes"] assert versions[0]["ai_notes"] == initial["ai_notes"] # Normalize only trailing blank lines in the published Markdown copies. return {"card-v1.md": v1.rstrip("\n") + "\n", "card-v2.md": v2.rstrip("\n") + "\n", "gallery.html": make_gallery(versions, provenance)} GALLERY = ''' 一次404修复，怎样变成两版经验卡
COGINE · OPENCLAW 维护者演练

一次 404 修复，
怎样变成两版经验卡

维护者用本项目已完成的链接修复作演练：把公开观察整理成 v1，再用同一张卡的 revise 加入证据边界，保留完整历史。页面内容来自实际运行 Easel card.py 后的文件。

这是公开资料的维护者演练，未进行用户口述访谈。所有结构化正文与编辑建议均由助手整理；没有受访者采纳确认，不能当作本人经验终稿。

AI 补充与提炼 · 未经受访者确认

    用户原话

    无。没有用模拟回答冒充用户口述；脚本 Markdown 的空摘录占位不表示发生过访谈。

    ''' def main(): parser = argparse.ArgumentParser(description=__doc__) group = parser.add_mutually_exclusive_group() group.add_argument("--out", type=Path, help="Create a new output directory; never overwrite") group.add_argument("--verify", action="store_true", help="Verify checked-in outputs (default)") args = parser.parse_args() if args.out and args.out.exists(): parser.error("--out must name a new directory") artifacts = replay() if args.out: args.out.mkdir(parents=True, exist_ok=False) for name, text in artifacts.items(): (args.out / name).write_text(text, encoding="utf-8") # Keep gallery downloads functional in a standalone replay folder. for name in ("input-v1.json", "input-v2.json", "provenance.json", "LICENSE.apache-2.0.txt", "reproduce.py"): shutil.copyfile(HERE / name, args.out / name) shutil.copytree(HERE / "upstream", args.out / "upstream", ignore=shutil.ignore_patterns("__pycache__")) print("PASS: upstream selftest/new/revise/list/show; v1 history and attribution retained; artifacts written.") else: for name, text in artifacts.items(): assert (HERE / name).read_text(encoding="utf-8") == text, f"Artifact differs: {name}" print("PASS: upstream hashes, CLI replay, five fields, inherited v1, replaced v2 notes, and all 3 artifacts match.") if __name__ == "__main__": main()