📘 总控摘要 ⏱ 任务流 🧭 母图总控 🧩 证明总图 🛡 复核作战图 🗂 证据索引 📋 覆盖率 🏦 金库收口 🪪 注册中心 💹 经济模型

📦 源码引用真实物理拓扑图

统一纳入白皮书级导航体系，用于把源码依赖、功能拓扑与证据页入口做成可回跳的开发者回证走廊。

开发者回证入口

源码追踪：快速看模块真实调用关系互动增强：标签切换、哈希定位、前后切换页面联动：从源码拓扑直接回总控、证据与复核页

开发者回证版：回 5 步任务流继续下钻母图总控：先看业务平面，再回源码依赖复核作战图：把源码关系转成复核动作证据索引：回 query / receipt / log 原文金库单页：对照资金闭环与执行门禁注册中心单页：对照 canonical key 与 resolve 经济模型单页：对照 Gas 双模型与 treasury 10% 合约引擎页：核对 Wasm 执行与 Query 路径

源码拓扑的定位

这页负责回答“模块之间实际上怎样互相引用”，不是只给业务叙述，而是给开发者和复核者一个最短的代码入口图。

适合先看 `overview.html` 再回本页核真实依赖。
适合从本页继续跳去 `foundation.html`、`registry.html`、`economy.html` 看收口原文。

回母图回证明链

互动效果的作用

标签切换会同步 URL hash，便于分享具体视图；前后切换按钮让审查者能顺序走查，不必回到顶部重新点选。

支持直接打开 `#tab-p2p` 这类深链接。
支持前一张 / 后一张快速切换模块。

打开核心全景图打开全量依赖图

与证据页的边界

本页解决“代码关系在哪里”，不解决“链上证据是否闭环”；后者仍必须回 `evidence_index.html`、`foundation.html`、`registry.html` 等页面取原文。

源码拓扑可支撑理解，不可替代 query / tx / receipt。
收口结论仍以真实原始证据为准。

回证据索引回复核作战图

图表说明：这张图通过 go list 扫描 MSG 项目所有包的引用关系，并过滤标准库与第三方库。它最适合做第一跳，用来判断共识、经济、P2P、存储等系统模块怎样在源码层真正互相调用。

点击图片可在新标签页查看高清原图；若要继续核业务闭环，请回 `overview.html` 或 `evidence_index.html`。

图表说明：这张图聚焦 pkg/consensus 包与内部子文件依赖，适合对照 Round-Robin、DAR 与资格裁剪逻辑，帮助审查共识实现和页面叙述是否一致。

建议联动打开 `consensus.html` 和 `review_playbook.html`，把源码依赖与复核路径拼起来。

图表说明：这张图展示 pkg/p2p 内部基于 go-libp2p 的网络发现、DHT 路由、节点连接与广播封装，适合核对组网页和源码入口是否一致。

建议联动 `p2p.html`、`p2p_nat.html` 与 `dual_node_startup_topology.html`。

图表说明：展示包含 Dilithium-5 在内的 pkg/quantum 核心库依赖，以及它怎样向外暴露给节点启动、交易验签、合约查询与 API 层使用。

建议联动 `quantum.html`、`genesis_startup.html`、`quantum_startup.html`。

图表说明：展示 pkg/wallet 的内部结构，包括助记词、量子私钥管理、签名流程等关键组件的实际引用路径。

建议联动 `wallet.html`、`ai_wallet.html` 和 `keplr.html`，区分钱包底座、自动化能力和生态接入边界。

图表说明：展示 pkg/storage 对 BadgerDB 封装、区块 JSON 序列化、状态快照与恢复的调用路径，适合核对“当前证据阶段使用 JSON、主网目标 BadgerDB v4”的口径是否落在代码结构上。

建议联动 `storage.html`、`blockchain.html` 与 `nodeops.html`。

图表说明：这是最完整的一张图，包含 MSG 公链依赖的外部库与标准库，适合在第三方依赖冲突、版本兼容、跨模块引用异常时做全量追踪。

图较大，适合新标签页查看原图；用于定位依赖问题，不直接等于链上闭环证据。

📄 为什么源码依赖图必须纳入统一导航

// 这页解决的问题：
// 1. 告诉开发者“真实代码关系在哪里”，避免只靠叙述页想象模块边界。
// 2. 让 review_playbook / evidence_index / overview 可以把“功能叙述 -> 源码入口 -> 原始证据”串成固定走廊。
// 3. 帮助复核者判断某个 claim 是否真有对应代码底座，而不是只在页面里出现名词。
//
// 但注意：
// - 源码依赖图不替代 query / tx / receipt / log。
// - 它是源码入口图，不是最终完成证明。

📄 如何使用这页做开发者回证

// 推荐顺序：
// 1. 先从 overview.html 看业务平面和收口主线。
// 2. 再回本页定位代码依赖入口。
// 3. 再去 foundation.html / registry.html / economy.html / evidence_index.html 看 query 与 receipt 原文。
// 4. 最后用 review_playbook.html 固化复核输出。
//
// 互动增强：
// - 标签切换会写入 URL hash，便于分享具体视图。
// - 上一张 / 下一张可顺序巡检所有拓扑图。
// - 快捷入口可直接回总控、证据和收口页。

📄 边界说明: 源码拓扑不等于链上证据闭环

// 不能把这页当成以下结论的直接证明：
// 1. foundation_treasury_v2 双门槛已完整闭环；
// 2. genesis_registry_v1 canonical key 已最终收口；
// 3. Gas 10% -> treasury 入账已拿到 before/after + receipt 原文。
//
// 这些结论仍必须回：
// - foundation.html
// - registry.html
// - economy.html
// - evidence_index.html
//
// 也就是说：
// 源码拓扑 = 帮你找入口；
// 原始证据 = 决定能否下结论。