原始资料 · reports/evidence-2026-11-02-architecture/check_review.py · 以可阅读文本展示,HTML 与脚本不会在页面中执行。
"""本轮文档核验:记录业务源码摘要,检查当前文档链接和代码围栏。 只读取业务源码;输出仅在本轮 evidence 目录,旧报告与测试数据不变。 before/after 比较证明本轮没有修改业务源码,不证明运行行为完全等价。 """ import hashlib import json import re import sys from pathlib import Path from urllib.parse import unquote ROOT = Path(__file__).resolve().parents[3] OUT = Path(__file__).resolve().parent DOCS = [ 'README.md', 'goal.md', 'docs/README.md', 'docs/architecture.md', 'docs/v0.5-design.md', 'docs/production-architecture.md', 'docs/backend-web3-roadmap.md', 'docs/development-plan.md', 'docs/web3-development.md', 'docs/web3-testing.md', 'docs/windows-local-run.md', 'docs/testing-guide.md', 'docs/interview-guide.md', 'docs/current-progress.md', 'docs/flash-sale-design.md', 'docs/reports/2026-11-02-architecture-review.md', ] def source_manifest(): paths = [ROOT / 'go.mod', ROOT / 'go.sum'] for folder in ['backend', 'chaintrade', 'cmd', 'api', 'deploy', 'scripts', 'frontend/src', 'frontend/tests', 'frontend/scripts', 'contracts/src', 'contracts/tests', 'contracts/scripts']: paths.extend(p for p in (ROOT / folder).rglob('*') if p.is_file() and '__pycache__' not in p.parts) paths.extend(ROOT.glob('Dockerfile*')) for folder in ['frontend', 'contracts']: paths.extend(p for p in (ROOT / folder).iterdir() if p.is_file() and p.suffix in ['.json', '.ts', '.html']) paths.extend(ROOT.glob('run-*')) return {p.relative_to(ROOT).as_posix(): hashlib.sha256(p.read_bytes()).hexdigest() for p in sorted(set(paths)) if p.is_file()} if sys.argv[1:] == ['snapshot']: manifest = source_manifest() (OUT / 'source-before.json').write_text( json.dumps(manifest, ensure_ascii=False, indent=2), encoding='utf-8') print(f'source files captured: {len(manifest)}') sys.exit(0) errors = [] for name in DOCS: p = ROOT / name if not p.is_file(): errors.append(f'missing document: {name}') continue content = p.read_text(encoding='utf-8-sig') # 屏蔽围栏与行内代码,避免将教程中的链接模板误判为实际导航。 fence = None prose = [] for line in content.splitlines(): m = re.match(r'^\s*(`{3,}|~{3,})', line) if m: marker = m.group(1) if fence is None: fence = marker elif marker[0] == fence[0] and len(marker) >= len(fence): fence = None elif fence is None: prose.append(line) if fence is not None: errors.append(f'unclosed fence: {name}') body = re.sub(r'`[^`\n]+`', '', '\n'.join(prose)) for target in re.findall(r'\]\(([^)]+)\)', body): target = target.strip().strip('<>') if re.match(r'^[a-zA-Z][a-zA-Z0-9+.-]*:', target) or target.startswith('#'): continue target = unquote(target.split('#', 1)[0]) if target and not (p.parent / target).exists(): errors.append(f'broken link: {name} -> {target}') before = json.loads((OUT / 'source-before.json').read_text(encoding='utf-8')) after = source_manifest() changed = sorted(k for k in set(before) | set(after) if before.get(k) != after.get(k)) result = {'documents_checked': DOCS, 'source_files_checked': len(after), 'source_changes': changed, 'errors': errors, 'passed': not errors and not changed} (OUT / 'document-check.json').write_text( json.dumps(result, ensure_ascii=False, indent=2), encoding='utf-8') (OUT / 'source-after.json').write_text( json.dumps(after, ensure_ascii=False, indent=2), encoding='utf-8') print(json.dumps(result, ensure_ascii=False, indent=2)) sys.exit(0 if result['passed'] else 1) |