導(dǎo)讀：2024年底，黃華威研究組發(fā)布了第一版《BlockEmulator使用指南》（139頁），幫助眾多區(qū)塊鏈研究者快速上手這一開源實(shí)驗(yàn)平臺。時隔一年半，在 BlockEmulator 開源三周年之際的2026年5月13日，使用指南新版本（217頁）正式發(fā)布！本文將為你詳細(xì)梳理新版指南的主要更新內(nèi)容，帶你一覽 BlockEmulator 生態(tài)的最新進(jìn)展。

一、文檔規(guī)模大幅擴(kuò)充：從139頁到217頁

新版《BlockEmulator使用指南》在篇幅上實(shí)現(xiàn)了顯著增長，從2024年12月31日版本的145頁擴(kuò)展至2026年5月13日版本的217頁，增幅接近50%。這不僅僅是頁數(shù)的增加，更代表著 BlockEmulator 平臺功能、文檔質(zhì)量和用戶支持的全面提升。

文檔基本信息對比：

新版《BlockEmulator 使用指南》目錄：

二、新增三大核心章節(jié)，覆蓋全新功能

新版指南最大的變化在于新增了三個重量級章節(jié)，分別介紹了 BlockEmulator 生態(tài)的最新成果：

2.1 第六章：Broker2Earn 分支詳解

這是2024版完全沒有的全新章節(jié)，詳細(xì)介紹了 Broker2Earn（B2E）算法的使用方法與實(shí)驗(yàn)流程。

背景： Broker2Earn 是發(fā)表在 INFOCOM2024 的研究成果，為 BrokerChain 分片區(qū)塊鏈提供了招募 broker 角色的激勵機(jī)制。

本章核心內(nèi)容包括：

• - B2E協(xié)議的研究背景與動機(jī)；
• - Broker2Earn與BrokerChain的關(guān)系；
• - 協(xié)議的主要貢獻(xiàn)：激勵機(jī)制設(shè)計(jì)、優(yōu)化問題建模與算法、協(xié)議實(shí)現(xiàn)與實(shí)驗(yàn)驗(yàn)證
• - 基于“松弛與舍入”（Relax-and-Rounding）方法的在線近似算法；
• - 完整的實(shí)驗(yàn)操作流程（從代碼獲取到結(jié)果可視化）；
• - 詳細(xì)的參數(shù)配置說明與代碼結(jié)構(gòu)解析 - 實(shí)驗(yàn)案例展示與Python繪圖代碼。

亮點(diǎn)功能：

• - 阻塞式注入機(jī)制：每批交易必須全部上鏈后才注入下一批；
• - 未分配CTX重試機(jī)制：自動處理因broker余額不足而未能分配的跨分片交易；
• - 交易金額過濾：自動過濾超出broker承接能力的交易；
• - 逐Epoch統(tǒng)計(jì)記錄：自動輸出CSV文件便于數(shù)據(jù)分析。

2.2 第七章：BlockEmulator-X（v2.0）— 更好用的版本

這是本次升級最重要的新增內(nèi)容！BlockEmulator-X（簡稱 BE-X）是 2025 年下半年到 2026 年初由研究組葉光同學(xué)重構(gòu)的進(jìn)化版本。

BE-X 的四大改進(jìn)：

• 全新的日志記錄：使用Go官方標(biāo)準(zhǔn)庫log/slog，支持 Debug/Info/Warn/Error 四個等級，讓用戶能清晰追蹤程序執(zhí)行鏈路。
• 更簡易的配置方式：從yaml文件讀取全局配置，支持注釋，直觀理解各配置項(xiàng)。
• 更輕量的程序：減少單節(jié)點(diǎn)內(nèi)處理消息的線程數(shù)，簡化執(zhí)行邏輯并提升性能。
• 新功能：支持智能合約測試。

系統(tǒng)架構(gòu)升級：

• - 節(jié)點(diǎn)類型重新定義為Supervisor節(jié)點(diǎn)和ConsensusNode節(jié)點(diǎn)；
• - 支持通過NodeInfo（NodeID + ShardID）而非直接IP發(fā)送消息；
• - 引入libp2p網(wǎng)絡(luò)協(xié)議，支持NAT后節(jié)點(diǎn)加入實(shí)驗(yàn)環(huán)境；
• - 消息驅(qū)動模式優(yōu)化：從多線程并行處理改為單線程串行處理，避免數(shù)據(jù)并發(fā)問題。

存儲機(jī)制革新：

• - 保留區(qū)塊數(shù)據(jù)存儲（BoltDB）；
• - 賬戶狀態(tài)存儲拆分為兩棵MPT：“賬戶基本狀態(tài)”（復(fù)用geth的StateDB，支持EVM）和“賬戶所屬分片信息”；
• - 新增 LocationRoot 字段標(biāo)識賬戶分片位置。

2.3 第八章：用BE-X定制化測試智能合約

這是 BlockEmulator-X 最具突破性的新功能！用戶現(xiàn)在可以使用 BlockEmulator-X 測試智能合約的執(zhí)行情況。

兩大測試場景：

• 1. 智能合約功能性測試：驗(yàn)證單個函數(shù)正確性、狀態(tài)讀寫一致性；
• 2. 交易順序敏感性測試：測試不同交易順序?qū)ψ罱K執(zhí)行結(jié)果的影響。

BE-X測試智能合約的三大優(yōu)勢：

• - 交易按照確定性順序執(zhí)行，保證結(jié)果一致性；
• - 參數(shù)配置可控（出塊間隔、區(qū)塊大小等）；
• - 實(shí)驗(yàn)需求自定義（數(shù)據(jù)集輸入方式、智能合約類型、測試邏輯。

測試流程四步走：

• 1. Step 1：編寫并編譯智能合約（支持Remix IDE或Solc工具）；
• 2. Steps 2&3：生成“Trace文件”（內(nèi)置Trace文件生成器，通過txt文檔描述測試場景自動生成CSV交易數(shù)據(jù)集）；
• 3. Finally：運(yùn)行實(shí)驗(yàn)并查看結(jié)果。

三、現(xiàn)有章節(jié)全面升級

除了新增章節(jié)，原有章節(jié)也做了大量更新和優(yōu)化：

3.1 第一章：背景介紹

黃華威研究組論文列表大幅擴(kuò)充：2024版列舉了7篇論文，2026版擴(kuò)充至12篇，新增了：

• - BrokerChain完整版（ToN 2025）：“BrokerChain: A Blockchain Sharding Protocol by Exploiting Broker Accounts”；
• - ShardCutter（ToN 2026）：分片間賬戶圖劃分、負(fù)載均衡方案；
• - LiquidityPool（WWW 2026）：小散戶質(zhì)押參與金額敏感DeFi協(xié)議的收益保障方案。

社區(qū)數(shù)據(jù)更新：

• - 官網(wǎng)訪問國家/地區(qū)：從“超過70個”更新為“近100個”；
• - GitHub Stars：從250個增長至349個；
• - GitHub Forks：從65個增長至98個；
• - 微信群成員：從356名增長至463名。

技術(shù)論文正式發(fā)表： BlockEmulator技術(shù)論文已從 arXiv 預(yù)印本正式發(fā)表于 IEEE Transactions on Services Computing (TSC) 期刊（2025年，第18卷第2期，頁碼690-703）。新版提供了正式的 BibTeX 引用格式。

3.2 第四章：開始使用它做實(shí)驗(yàn)

新版增加了“4.5 設(shè)計(jì)用戶自定義的協(xié)議”小節(jié)，指導(dǎo)用戶如何進(jìn)行二次開發(fā)，設(shè)計(jì)自定義的區(qū)塊鏈協(xié)議。

3.3 第五章：分支介紹

章節(jié)標(biāo)題從“BlockEmulator的其他分支”更新為“BlockEmulator v1.0的其他分支”，明確區(qū)分了v1.0和v2.0的代碼分支。

3.4 第六章/第九章：技術(shù)問題匯總

• 章節(jié)位置從第6章調(diào)整至第9章；
• 內(nèi)容保持完整，繼續(xù)為用戶提供詳盡的問題解決方案。

3.5 第七章/第十章：歷史版本更新

新增兩條重要更新記錄：

• –2026年5月13日：BlockEmulator v2.0（BlockEmulator-X）發(fā)布；
• –2026年5月12日：Broker2Earn分支添加使用說明與調(diào)用方法。

3.6 第八章/第十一章：用戶社區(qū)維護(hù)

• 微信群成員數(shù)量更新（356→463人）；
• 新增云端部署IP設(shè)置問題的詳細(xì)問答（來自天津大學(xué)楊同學(xué)的實(shí)際問題及解決方案）；
• 新增網(wǎng)絡(luò)帶寬設(shè)置與控制的詳細(xì)說明。

四、文檔質(zhì)量與用戶體驗(yàn)提升

4.1 寫作團(tuán)隊(duì)擴(kuò)充

新版前言中明確了更多貢獻(xiàn)者：

• - 葉光、熊劍波：BlockEmulator-X（v2.0）的主要貢獻(xiàn)者，負(fù)責(zé)智能合約測試章節(jié)；
• - 陳欽德：Broker2Earn算法分支的主要貢獻(xiàn)者（2026年6月博士畢業(yè))；
• - 新增貢獻(xiàn)者：胡飛鴻、周陽、袁劍文博士。

4.2 表述更加精準(zhǔn)

多處表述進(jìn)行了優(yōu)化，例如：

• - BlockEmulator亮點(diǎn)描述更加簡潔專業(yè)；
• - 技術(shù)論文引用格式從arXiv預(yù)印本升級為正式期刊發(fā)表格式。

4.3 代碼示例更豐富

新增章節(jié)中包含大量可直接運(yùn)行的代碼示例：

• - Broker2Earn實(shí)驗(yàn)的完整Python繪圖代碼；
• - BlockEmulator-X的example_run.sh啟動腳本；
• - Trace文件生成器的使用示例；
• - 智能合約測試的完整流程代碼。

五、未來規(guī)劃更新

2024版規(guī)劃（已實(shí)現(xiàn)）：

• BlockEmulator 2.0版本（已實(shí)現(xiàn)為BlockEmulator-X）；
• BlockEmulator DAO社區(qū)（規(guī)劃中）。

2026版新規(guī)劃：

• 持續(xù)迭代BlockEmulator，嵌入更多最新研究成果；
• 支持更加完善的智能合約執(zhí)行環(huán)境；
• 可視化開發(fā)環(huán)境；
• 目標(biāo)：成為分片區(qū)塊鏈社區(qū)的標(biāo)準(zhǔn)實(shí)驗(yàn)工具。

六、如何獲取新版文檔

新版《BlockEmulator使用指南》（2026年5月13日版，217頁）下載方式：

新版文檔上傳至百度網(wǎng)盤，下載鏈接如下：

• BlockEmulator使用指南-黃華威-2026May3.pdf
• https://pan.baidu.com/s/1f5Otpqohqtx4JvpluCO4Fg?pwd=2468

七、寫在最后

從2024年底的“從入門到放棄”到2026年中的“從入門到精通”，這不僅僅是一個副標(biāo)題的改變，更代表著 BlockEmulator 平臺從“能用”到“好用”、從“實(shí)驗(yàn)工具”到“標(biāo)準(zhǔn)基礎(chǔ)設(shè)施”的跨越。

BlockEmulator-X 的推出，讓研究者告別低效、低質(zhì)且難以獲得認(rèn)可的“自建實(shí)驗(yàn)環(huán)境”，轉(zhuǎn)而利用被上百篇論文驗(yàn)證過的成熟框架，產(chǎn)出具備國際學(xué)術(shù)公信力的科研成果。

感謝所有社區(qū)用戶的反饋與支持，正是你們的每一個問題、每一個建議，推動著 BlockEmulator 不斷進(jìn)化。期待與大家一起，讓區(qū)塊鏈研究變簡單！

關(guān)于 BlockEmulator

BlockEmulator 是由中山大學(xué)黃華威研究組（HuangLab）開源的可支持多種共識協(xié)議的區(qū)塊鏈實(shí)驗(yàn)平臺，特色是支持區(qū)塊鏈跨分片機(jī)制。項(xiàng)目已獲 GitHub 350 Stars，被近100個國家/地區(qū)的用戶訪問使用。

• GitHub主頁：https://github.com/HuangLab-SYSU/block-emulator
• BlockEmulator-X：https://github.com/HuangLab-SYSU/block-emulator-x
• 官方網(wǎng)站：https://www.blockemulator.com
• 研究組主頁：http://xintelligence.pro