110 lines
4.0 KiB
Python
110 lines
4.0 KiB
Python
"""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()
|