先分清三类“技术文档”对象
检索“区块链技术文档”时，常见结果会把协议规范、客户端配置说明和教程示例混在同一列表。对齐“你正在运行的版本”之前，应先固定对象层级：协议语义说明网络规则本身；客户端/节点说明写实现如何加载配置与升级；示例与教程只演示调用路径，不自动等于当前主网共识全集。把搜索摘要或第三方解读直接当成版本依据，会把过时边界漏掉。
本组对照只使用两个可核验的官方仓库入口：ethereum/execution-specs（执行层规范）与ethereum/yellowpaper（形式化黄皮书）。两者都在GitHub公开README中自我声明用途与维护状态，适合用来练习“先读仓库声明、再决定引用边界”。
execution-specs：按升级跟踪的可执行执行层规范
ethereum/execution-specs仓库标题与README将其定位为Ethereum Execution Layer Specifications（EELS）：用Python书写的可执行参考实现，并附带用于验证的测试用例；它提供对共识关键行为的共享、可运行描述，测试可生成用于校验执行客户端的fixtures。仓库描述同时写明“Specification for the Execution Layer. Tracking network upgrades.”，即执行层规范入口并跟踪网络升级。
因此，当你要核对“某次升级后执行层规则如何表述”时，应优先打开该仓库当前分支/标签与其README的EELS定位，而不是假设任意历史PDF已经自动覆盖后续升级。本篇不运行本地测试套件，也不声称某一客户端已在某高度激活某特性；只固定文档入口的自我描述。
yellowpaper：形式规范入口，但带明确过时边界
ethereum/yellowpaper把黄皮书定位为以太坊协议的形式化定义，并在README以“Repository Currently Outdated”声明：黄皮书已过时，反映的是截至Shanghai网络升级的以太坊规范；Shanghai在主网于区块17,034,870（2023年4月）激活；并写明尚未包含Cancun升级引入的变更。页面同时提示另有Python执行层规范在积极维护。
对齐运行版本时，黄皮书适合作为“形式化文本 + 明确截止升级”的对照物，不能因为PDF仍可下载就写成“现行主网全部共识规则”。若文档任务需要Cancun及之后的执行层变更，应回到execution-specs一类仍在跟踪升级的入口，并在引用中标注你打开的是哪一仓库、哪一自我声明段落。
可执行的版本对齐清单
建议顺序：写下你要核对的运行对象（主网高度/客户端版本/本地分叉名）；打开execution-specs README确认EELS与“tracking network upgrades”定位；打开yellowpaper README摘录Outdated、Shanghai区块与“不含Cancun”句；再决定协议语义引用落在哪一层，客户端配置与示例是否只作辅助。搜索引擎上的“区块链技术文档”标题不能替代仓库自我声明。
本篇不比较客户端优劣，不给出投资含义，也不把形式规范写成审计结论。对“区块链技术文档”，先分清协议规范、实现说明与示例，再谈能否对齐你正在运行的版本。