Files
aigc-home/docs/hel-892/frames-document-evidence/render_report.py
T

110 lines
4.0 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Readable complete Chinese definitions and fixed source index from delivered data."""
from __future__ import annotations
import hashlib
import json
from pathlib import Path
OUT = Path(__file__).resolve().parent
def main():
lines = [
"# 截取视频每一帧固定参考中文说明",
"",
"31新顶层保存位置(28标量含null+3历史对象)+0新注释;旧21图618保存位置+15注释逐对象不变。22图649位置+15注释展示,155定稿0、实跑0、新增转换0。",
"",
"复用SQLite来源库→正常GET详情→现有说明抽屉;仅新增source_reviews说明块和显式受信摘要,不改变转换/执行链。来源索引local_file以docs/hel-892/frames-document-evidence为解析基准。",
"",
]
index = []
for i in range(1):
b = json.loads((OUT / f"definition-{i}.json").read_bytes())
lines += [
"## " + Path(b["source_path"]).stem,
"",
b["user_overview"],
"",
b["notice"],
"",
"源路径:`" + b["source_path"] + "`",
"",
"SHA1:" + b["source_sha1"],
"",
"原字节SHA256:" + b["source_sha256"],
"",
"规范全图SHA256:" + b["canonical_sha256"],
"",
*[v + "\n" for v in b["versions"]],
"### 具体连线与处理条件",
"",
*[v + "\n" for v in b["flow"]],
"### 使用与核对",
"",
*[v + "\n" for v in b["steps"]],
"### 逐保存位置说明",
"",
]
for j, f in enumerate(b["fields"], 1):
lines += [
f"#### {j}. 节点{f['node_id']} · {f['label']}({f['field']})",
"",
f["effect"],
"",
"```json",
json.dumps(f["value"], ensure_ascii=False, indent=2),
"```",
"",
f"类:{f['class_type']};JSON类型:{f['json_type']};角色:{f['role']}。",
"",
"源位置:`" + f["pointer"] + "`",
"",
"定义默认:" + f["schema_default"] + ";单位:" + f["unit"],
"",
"范围/条件:" + f["limits"],
"",
f["execution_note"],
"",
"依据:",
]
for k in f["evidence"]:
e = b["sources"][k]
lines += [
f"- [{k}] {e['claim']};{e['file']} {e['lines'][0]}~{e['lines'][1]}行;"
f"commit {e['commit']};SHA256 {e['sha256']};{e['url']}"
]
lines += [""]
lines += ["### 零保存节点与源注释", ""]
for z in b["zero_saved_nodes"]:
lines += [z["node_id"] + " " + z["class_type"] + ":" + z["effect"], ""]
for n in b["comments"]:
lines += [
"节点" + n["node_id"] + ",位置`" + n["pointer"] + "`",
"",
n["meaning"],
"",
"```text",
n["text"],
"```",
"",
]
lines += ["### 固定原件索引", ""]
for k, e in enumerate(b["sources"]):
data = (OUT / e["local_file"]).read_bytes()
assert hashlib.sha256(data).hexdigest() == e["sha256"]
lines += [
f"{k}. {e['claim']};{e['file']} 第{e['lines'][0]}~{e['lines'][1]}行;"
f"提交{e['commit']};SHA256 {e['sha256']};{e['url']}",
"",
]
index.append(dict(document=b["source_path"], **e))
(OUT.parent / "截取视频每一帧固定参考中文说明.md").write_text("\n".join(lines).rstrip() + "\n")
(OUT / "fixed-source-index.json").write_text(
json.dumps(index, ensure_ascii=False, indent=2) + "\n"
)
if __name__ == "__main__":
main()