简介《区块链项目创业计划书》以PDF单文档形式呈现面向区块链与数字经济领域的创业者、项目策划人员及投资分析初学者用于了解完整计划书的结构与论证思路。压缩包内仅含1个PDF文件体积约1.22MB无需额外软件即可打开阅读。文档从产业背景与必要性切入结合5G、工业互联网、人工智能、大数据中心等新型数字基础设施趋势梳理行业市场环境、项目基本情况与建设目标并给出主要经济指标一览表。正文包含投资总额约33290.80万元、建设投资与流动资金占比、营业收入、净利润、财务内部收益率、财务净现值及投资回收期等测算可作为撰写同类立项报告或商业计划书的参考模板。读者可借此熟悉章节编排、数据口径与财务分析框架用于课程作业、路演材料或可行性研究的前期构思。目前已有320人学习下载。1. 投资人打开这份 PDF 只看四页一份区块链项目的创业计划书做成 PDF 交付之后真实阅读路径和作者想象的不一样。绝大多数读者不会从头翻到尾先扫第一页确认项目定位再跳到 Token 分配表看总量和创始团队份额然后翻到技术那一页看共识机制和链的选型最后看融资条款与资金用途。剩下几十页只有在前四页被认可之后才会被认真读。对写文档的工程师来说这意味着计划书不是「写完导出」的 Word 稿而是一份机器和人都能校验的产物分配表的每一行要能对上账每一版 PDF 要能追溯来源扫描件要能被 PDF 解析工具读出文字。下面从章节骨架讲到用 Markdown 编译出可版本管理的 PDF再讲到用脚本把 PDF 里的分配表抠出来做一致性对账。2. 区块链项目创业计划书的章节骨架与链上技术参数2.1 链上技术参数别写形容词写数字和口径融资用的计划书里最容易出问题的一章是「技术方案」。多数稿子写成「采用高性能共识、支持高并发、可扩展性强」这种描述在投资方的技术顾问眼里等于零信息。常见做法是把技术章节压缩成一张参数表每一条都带口径什么环境测的、几个节点、什么类型的交易。自建 L1、应用链 SDK、Rollup 三条路线选哪条要用一句话说清理由而不是罗列优缺点——投资人想知道的是你为什么选以及这个选择带来的取舍。参数模糊写法可被追问的写法口径来源共识高性能 PoSBFT 类共识创世验证者 21 个出块 2s单块最终性测试网区块浏览器吞吐十万级 TPS原生转账 3000 TPS3 节点 4C8G合约调用 300 TPS压测脚本与日志节点门槛门槛低4 vCPU / 16 GB / 1 TB NVMe建议公网带宽 50 Mbps部署文档状态存储链上链下热状态存 KV 库历史区块归档对象存储每 10 万块打快照运维手册跨链支持多链轻客户端验证 5/9 多签兜底信任假设写在桥合约审计报告里审计报告这张表的价值在于它可以被复用。计划书、技术白皮书、官网、招聘 JD 里出现的同一组数字应该从同一份源文件生成而不是各处手抄。我一般会把参数写成 YAML再用脚本渲染成 Markdown 表格# chain-params.yaml —— 计划书/白皮书/官网共用这一份源数据 chain: type: appchain # appchain | rollup | l1 consensus: tendermint-bft block_time_ms: 2000 finality: single_block # 单块最终性还是需要 N 个确认 validators: genesis_count: 21 max_count: 100 throughput: # 吞吐必须带测试环境否则数字无意义 native_transfer_tps: 3000 contract_call_tps: 300 env: 3 nodes / 4C8G / LAN measured_at: testnet-Q3参数说明上finality和measured_at是两个最容易被追问的字段前者决定交易所和钱包要等几个确认后者决定这个数字还能不能引用。写「单块最终性」就要准备好解释验证者集合多大、作恶阈值多少写不出阈值就老实写「6 个确认后视为最终」比含糊其辞安全得多。2.2 Token 分配与解锁一张能对上账的表Token 经济模型是计划书里唯一会被反复计算的章节。创始人份额、私募轮、生态基金、团队激励、流动性储备这几个类别的占比相加必须是 100%任何取整误差都会被一眼看出来。更关键的是解锁节奏cliff 多久、线性期多长、TGE 当天释放多少这三列如果和后面的资金规划对不上整份文档的可信度就没了。类别占比TGE 释放Cliff线性期说明社区与生态40%5%无48 个月按季度拨付需治理提案团队与顾问18%0%12 个月36 个月按月线性离职回购私募轮15%10%6 个月24 个月分两批价格不同财库15%0%12 个月60 个月由多签地址管理流动性7%100%无无上线即注入公募5%100%无无—写表的时候有个细节容易被忽略解锁表讲的是「释放」不是「流通」。TGE 释放 5% 不等于 TGE 就有 5% 在市场上卖中间还有做市、质押锁仓、基金会持仓等环节。计划书里最好把「释放量」和「预估流通量」分成两张表否则第一年的通胀曲线会算错一个数量级。占比这一列可以用脚本从源数据渲染避免手工改表格时漏改合计# build_allocation_table.py —— 从 allocation.json 生成 Markdown 表格 import json rows json.load(open(allocation.json, encodingutf-8)) total sum(r[pct] for r in rows) # 比例合计必须严格等于 100取整误差容忍到 1e-6 assert abs(total - 100) 1e-6, f分配比例合计为 {total}%请检查取整方式 print(| 类别 | 占比 | TGE 释放 | Cliff | 线性期 |) print(| --- | --- | --- | --- | --- |) for r in rows: print(f| {r[name]} | {r[pct]}% | {r[tge]}% | {r[cliff]} | {r[vesting]} |)assert那一行是整个脚本的重点。取整时如果有人把 33.333% 写成 33.33%六行加起来会是 99.99%肉眼很难发现脚本一跑就报错。allocation.json同时是官网代币页面和链上合约初始化的输入这样才能保证白皮书、计划书、合约三处一致。2.3 路线图与资金用途里程碑要能被验证路线图最容易写成「2025 Q1 生态建设、Q2 全球化布局」这类无法验证的句子。可行的写法是每个里程碑绑定一个可观测的完成标准并且标明依赖关系。资金用途则按类别给出比例和绝对金额注意比例是按融资额算还是按总预算算两种口径混用是常见错误。里程碑时间窗可验证完成标准前置依赖测试网第 1—2 季度公开测试网出块稳定 30 天验证者 ≥ 21共识模块完成安全审计第 3 季度两家机构报告公开高危问题全部关闭合约冻结主网第 4 季度创世区块上线浏览器可查审计通过TGE主网后 1 季度代币合约部署解锁表公示合规意见出具2.4 计划书和技术白皮书的分工边界两份文档经常被混着写结果是同一组参数出现两个版本尽调时被逐条对照。合理的分工是白皮书讲协议、形式化定义、共识证明和治理流程面向工程师计划书讲市场、竞争、团队、财务模型和里程碑面向投资人。重叠部分只有链上参数表和 Token 分配表而且这两张表必须从同一份源数据渲染出来。内容重合不是问题数字冲突才是问题。我一般会在仓库里放一个data/目录装 YAML 和 JSON计划书与白皮书各自的 Markdown 都通过脚本把表格插进去谁都不手写数字。这样修改一次参数两份 PDF 下一版自动同步。3. 用 Markdown 加 Pandoc 把区块链计划书编译成可版本管理的 PDF3.1 为什么草稿用 VSCode 转 PDF交付用 Pandoc写作阶段最快的路径是 vscode 用 markdown 转 pdf 的插件装完点一下就能出稿看排版、给同事传阅都够用。但它的短板在长文档交叉引用、图表自动编号、目录页码在内容增删后会错位中文字体也只能吃系统默认。正式交付的版本常见做法是走 Pandoc XeLaTeX源文件依旧是 MarkdownGit 里能 diff编译结果稳定。目录结构建议这样分data/放参数源数据chapters/放各章 Markdownassets/放架构图build/放产物并加进.gitignore。产物不进版本库源文件和编译脚本进。3.2 最小可跑命令与中文排版头文件# 单文件编译Markdown - PDF中文字体走 XeLaTeX pandoc plan.md \ --pdf-enginexelatex \ --toc --toc-depth2 \ --include-in-headerheader.tex \ -V geometry:margin2.2cm \ -V mainfontNoto Serif CJK SC \ -o build/blockchain-bp.pdf--pdf-enginexelatex是中文场景的硬性选择pdflatex 处理 CJK 断行会出问题。--toc-depth2只把一级和二级标题放进目录避免目录占掉三页。字体参数在不同系统上名字不一样Linux 上常见 Noto Serif CJK SCmacOS 上可能是 Songti SC写进 Makefile 时最好用变量抽出不要散落在命令里。header.tex控制那些 Markdown 表达不了的排版细节\usepackage{ctex} \usepackage{booktabs} % 三线表替代默认的网格表格 \usepackage{longtable} % 分配表跨页时表头自动重复 \usepackage{fancyhdr} \pagestyle{fancy} \fancyfoot[C]{\thepage} % 段首缩进两字符避免中文段落顶格 \setlength{\parindent}{2em} \setlength{\parskip}{0.4em} % 表格行距收紧防止长表撑爆页面 \renewcommand{\arraystretch}{1.15}四个参数的取舍值得说清楚。booktabs让表格去掉竖线在打印和缩放阅读时都比网格表清楚longtable是为了那张六行的 Token 分配表——在 A4 上它经常正好卡在分页处不处理的话表头会丢\parindent设成 2em 是中文排版习惯Markdown 转出来的段落默认顶格读起来很挤\arraystretch调到 1.15 以上含中英文混排的单元格会出现文字贴线的情况。3.3 数字与金额的排版约定计划书里的金额、占比、时间必须统一格式否则同一份文档里出现$1,000,000、100万美金、1M USD三种写法读者会怀疑数据来源不同。建议在 Markdown 源文件里只写机器可读的裸值格式交给模板。项目约定写法反例原因融资金额8,000,000 USD800 万美金千分位便于核对位数代币总量1,000,000,00010 亿与合约里的整数一致占比18.00%18统一两位小数合计校验方便时间窗2025-Q2明年二季度可排序、可被脚本解析合约地址0x 开头 40 位省略前半段读者要能复制去浏览器验证3.4 用 Makefile 让每一版 PDF 带 commit 号发给投资人的 PDF 如果只叫plan.pdf两周后没人说得清手里那份是哪一版。把 commit 短哈希编进文件名再把编译时间写进页脚是成本最低的追踪手段。COMMIT : $(shell git rev-parse --short HEAD) DATE : $(shell date %Y%m%d) OUT : build/blockchain-bp-$(DATE)-$(COMMIT).pdf all: $(OUT) $(OUT): chapters/*.md data/*.json header.tex mkdir -p build pandoc chapters/*.md \ --pdf-enginexelatex --toc \ --include-in-headerheader.tex \ -V date$(DATE) rev $(COMMIT) \ -o $ echo built $ clean: rm -rf build$(OUT)依赖里把data/*.json写进去是关键改了分配比例但忘了重新编译Make 会提醒你。git rev-parse --short HEAD要求工作区干净后再编译否则文件名里的哈希和实际内容对不上——这条纪律比脚本本身重要。4. PDF 解析与一致性校验把 Token 分配表抠出来对账4.1 用 pdfplumber 提取分配表收到一份别人发来的计划书 PDF想快速核对分配比例或者要把 PDF 转 Word 交给法务改注释第一步都是把表格结构化地读出来。文本层完整的 PDF 用 pdfplumber 最省事它对表格线的识别比纯文本抽取可靠。import pdfplumber # 表格线明确的 PDF用 lines 策略最稳无线框表格改用 text 策略 TABLE_SETTINGS { vertical_strategy: lines, horizontal_strategy: lines, snap_tolerance: 4, # 线条吸附容差像素表线略歪时调大 edge_min_length: 12, # 短于此长度的线段忽略过滤装饰线 intersection_tolerance: 5, } with pdfplumber.open(blockchain-bp.pdf) as pdf: for i, page in enumerate(pdf.pages): tables page.extract_tables(TABLE_SETTINGS) for t in tables: # 表头里出现「占比」才认定为分配表避免抓到财务表 header .join(c or for c in t[0]) if 占比 in header: print(f--- page {i 1} ---) for row in t: print(row)参数说明snap_tolerance控制两根相近的线是否算同一条扫描件或低分辨率导出经常需要从默认 3 调到 6 以上edge_min_length用来过滤表头下方的装饰性短横线调太小会把装饰线当成分隔线切出多余的列intersection_tolerance影响列与行的交点判定中英文混排导致列宽不均时适当放大。如果表线是虚线或表格没有边框改用{vertical_strategy: text, horizontal_strategy: text}代价是容易把金额里的小数点误判为列边界。4.2 总量守恒与解锁曲线的自动校验抽出表格只是第一步真正有价值的是把「比例合计」和「解锁曲线」自动化验证。手算一遍要十分钟脚本跑一遍要一秒而且不会漏。from decimal import Decimal def check(total_pct, tge_map, months48): # 1) 比例合计必须为 100 s sum(Decimal(str(v)) for v in total_pct.values()) assert s Decimal(100), f占比合计 {s}不等于 100 # 2) 逐年累计释放量检查是否有年份出现断崖或倒挂 curve [] for m in range(0, months 1): released Decimal(0) for name, pct in total_pct.items(): tge, cliff, linear tge_map[name] if m cliff: r Decimal(str(tge)) else: step min(m - cliff, linear) r Decimal(str(tge)) (Decimal(str(pct)) - Decimal(str(tge))) \ * Decimal(step) / Decimal(linear) released r curve.append((m, released)) # 3) 单月释放增量超过总量 3% 时打印告警 for (m0, a), (m1, b) in zip(curve, curve[1:]): if b - a Decimal(3): print(f预警第 {m1} 月单月释放 {b - a}%可能存在解锁悬崖) return curve逻辑上有三个检查点比例合计的严格相等捕获取整误差逐年累计释放量用来画解锁曲线读者看图比看表快单月增量告警针对的是「多个类别 cliff 撞在同一个月」的情况这类设计在图上表现为一根竖直的尖刺容易被解读为砸盘信号写计划书时通常要主动错开。Decimal而不是float是必须的0.1 加 0.2 在二进制浮点下不等于 0.3占比校验会随机失败。4.3 扫描件、中文乱码与页面歪斜的处理技术顾问发回来的往往是打印后重新扫描的 PDF文字层丢失直接抽取会得到空字符串。判断方法很简单先看文本层有没有内容# 文本层抽取能出中文说明是可解析的 PDF pdftotext -layout plan.pdf - | head -40 # 统计每页字符数大量页面为 0 说明是扫描件需要走 OCR pdftotext plan.pdf - | tr -d [:space:] | wc -m # 页面旋转或歪斜统一摆正后再做 OCR识别率差别很大 qpdf --rotate90:1-z plan.pdf plan-rotated.pdf症状常见原因处理方式抽出全是乱码字体未嵌入缺 ToUnicode 映射走 OCR不要硬修字体映射表格列错位页面歪斜 1—3 度先做歪斜校正再解析每页字符数为 0纯图片扫描件300 dpi 渲染后 OCR数字被识别成字母低分辨率或中英混排提高渲染 dpi限制字符集文件体积异常大未压缩的位图用 Ghostscript 降采样后归档歪斜校正是最容易被跳过的一步。哪怕只偏 2 度表格线的交点判定就会整体漂移snap_tolerance调到多大都救不回来。先摆正、再提高分辨率、最后才调整 pdfplumber 的参数顺序反了会浪费很多时间在调参上。5. 交付前的最后一公里元数据、水印与版本比对5.1 写入可追溯的文档指纹PDF 元数据是判断版本的第一手线索但多数 Markdown 转换默认把它留空。编译后补一段元数据写入成本几秒钟后面省掉大量「你手上那份是哪版」的对话# 写入标题、作者与自定义版本字段 exiftool -TitleBlockchain Project Business Plan \ -AuthorCore Team \ -Subjectrev $(git rev-parse --short HEAD) \ -Keywordsblockchain,whitepaper,business-plan \ build/blockchain-bp.pdf # 线性化让阅读器先加载第一页大文件打开更快 qpdf --linearize build/blockchain-bp.pdf build/blockchain-bp-final.pdf--linearize对三十页以上、带架构图的文件效果明显阅读器不用等整个文件下载完就能显示首页。这一点在移动端看 PDF 的场景里差别很大。5.2 用文本比对代替肉眼找差异两版计划书之间的改动肉眼翻一遍容易漏掉数字变化。可靠的做法是把 PDF 抽成文本再做 diff重点盯数字行pdftotext -layout v1.pdf v1.txt pdftotext -layout v2.pdf v2.txt diff -u v1.txt v2.txt | grep -E ^[-].*[0-9]只过滤带数字的增删行是因为技术方案的措辞调整通常无害而占比、金额、时间窗的变动必须逐条确认而且往往要同步回白皮书和合约初始化脚本。这一步跑完再发版本能挡掉大部分前后不一致的问题。5.3 分发给不同对象的版本与水印给投资机构、审计方、社区三方的版本最好加不同的页脚水印出现外传时能定位来源。水印不要用图片覆盖改成页脚文字更轻\usepackage{draftwatermark} % 或直接在页脚插入受控字符串 \fancyfoot[L]{\footnotesize CONFIDENTIAL · For \recipient · rev \revid}\recipient在 Makefile 里通过-V传入同一份源文件编译出多个受控版本内容完全一致只有页脚不同。这样既能追溯也避免了维护多套 Markdown 分支带来的内容漂移。分发前最后一步是体积控制。计划书里放了太多高分辨率架构图和截图时文件很容易膨胀到几十 MB邮件网关直接拒收。用 Ghostscript 降到 150 dpi、转成 PDF/A 归档格式通常能压掉七成体积且不影响屏幕阅读gs -sDEVICEpdfwrite -dPDFA2 -dPDFACompatibilityPolicy1 \ -dDownsampleColorImagestrue -dColorImageResolution150 \ -dNOPAUSE -dBATCH -sOutputFileplan-archive.pdf plan-final.pdf压缩后务必再跑一次 5.2 的文本比对确认抽出的数字和压缩前完全一致——图片降采样偶尔会影响扫描件页面的 OCR 结果而计划书里恰恰可能夹着几页扫描的合规意见附件。本文还有配套的精品资源点击获取 区块链计划书 PDF 自动化：Markdown 编译与 Token 分配校验
简介《区块链项目创业计划书》以PDF单文档形式呈现面向区块链与数字经济领域的创业者、项目策划人员及投资分析初学者用于了解完整计划书的结构与论证思路。压缩包内仅含1个PDF文件体积约1.22MB无需额外软件即可打开阅读。文档从产业背景与必要性切入结合5G、工业互联网、人工智能、大数据中心等新型数字基础设施趋势梳理行业市场环境、项目基本情况与建设目标并给出主要经济指标一览表。正文包含投资总额约33290.80万元、建设投资与流动资金占比、营业收入、净利润、财务内部收益率、财务净现值及投资回收期等测算可作为撰写同类立项报告或商业计划书的参考模板。读者可借此熟悉章节编排、数据口径与财务分析框架用于课程作业、路演材料或可行性研究的前期构思。目前已有320人学习下载。1. 投资人打开这份 PDF 只看四页一份区块链项目的创业计划书做成 PDF 交付之后真实阅读路径和作者想象的不一样。绝大多数读者不会从头翻到尾先扫第一页确认项目定位再跳到 Token 分配表看总量和创始团队份额然后翻到技术那一页看共识机制和链的选型最后看融资条款与资金用途。剩下几十页只有在前四页被认可之后才会被认真读。对写文档的工程师来说这意味着计划书不是「写完导出」的 Word 稿而是一份机器和人都能校验的产物分配表的每一行要能对上账每一版 PDF 要能追溯来源扫描件要能被 PDF 解析工具读出文字。下面从章节骨架讲到用 Markdown 编译出可版本管理的 PDF再讲到用脚本把 PDF 里的分配表抠出来做一致性对账。2. 区块链项目创业计划书的章节骨架与链上技术参数2.1 链上技术参数别写形容词写数字和口径融资用的计划书里最容易出问题的一章是「技术方案」。多数稿子写成「采用高性能共识、支持高并发、可扩展性强」这种描述在投资方的技术顾问眼里等于零信息。常见做法是把技术章节压缩成一张参数表每一条都带口径什么环境测的、几个节点、什么类型的交易。自建 L1、应用链 SDK、Rollup 三条路线选哪条要用一句话说清理由而不是罗列优缺点——投资人想知道的是你为什么选以及这个选择带来的取舍。参数模糊写法可被追问的写法口径来源共识高性能 PoSBFT 类共识创世验证者 21 个出块 2s单块最终性测试网区块浏览器吞吐十万级 TPS原生转账 3000 TPS3 节点 4C8G合约调用 300 TPS压测脚本与日志节点门槛门槛低4 vCPU / 16 GB / 1 TB NVMe建议公网带宽 50 Mbps部署文档状态存储链上链下热状态存 KV 库历史区块归档对象存储每 10 万块打快照运维手册跨链支持多链轻客户端验证 5/9 多签兜底信任假设写在桥合约审计报告里审计报告这张表的价值在于它可以被复用。计划书、技术白皮书、官网、招聘 JD 里出现的同一组数字应该从同一份源文件生成而不是各处手抄。我一般会把参数写成 YAML再用脚本渲染成 Markdown 表格# chain-params.yaml —— 计划书/白皮书/官网共用这一份源数据 chain: type: appchain # appchain | rollup | l1 consensus: tendermint-bft block_time_ms: 2000 finality: single_block # 单块最终性还是需要 N 个确认 validators: genesis_count: 21 max_count: 100 throughput: # 吞吐必须带测试环境否则数字无意义 native_transfer_tps: 3000 contract_call_tps: 300 env: 3 nodes / 4C8G / LAN measured_at: testnet-Q3参数说明上finality和measured_at是两个最容易被追问的字段前者决定交易所和钱包要等几个确认后者决定这个数字还能不能引用。写「单块最终性」就要准备好解释验证者集合多大、作恶阈值多少写不出阈值就老实写「6 个确认后视为最终」比含糊其辞安全得多。2.2 Token 分配与解锁一张能对上账的表Token 经济模型是计划书里唯一会被反复计算的章节。创始人份额、私募轮、生态基金、团队激励、流动性储备这几个类别的占比相加必须是 100%任何取整误差都会被一眼看出来。更关键的是解锁节奏cliff 多久、线性期多长、TGE 当天释放多少这三列如果和后面的资金规划对不上整份文档的可信度就没了。类别占比TGE 释放Cliff线性期说明社区与生态40%5%无48 个月按季度拨付需治理提案团队与顾问18%0%12 个月36 个月按月线性离职回购私募轮15%10%6 个月24 个月分两批价格不同财库15%0%12 个月60 个月由多签地址管理流动性7%100%无无上线即注入公募5%100%无无—写表的时候有个细节容易被忽略解锁表讲的是「释放」不是「流通」。TGE 释放 5% 不等于 TGE 就有 5% 在市场上卖中间还有做市、质押锁仓、基金会持仓等环节。计划书里最好把「释放量」和「预估流通量」分成两张表否则第一年的通胀曲线会算错一个数量级。占比这一列可以用脚本从源数据渲染避免手工改表格时漏改合计# build_allocation_table.py —— 从 allocation.json 生成 Markdown 表格 import json rows json.load(open(allocation.json, encodingutf-8)) total sum(r[pct] for r in rows) # 比例合计必须严格等于 100取整误差容忍到 1e-6 assert abs(total - 100) 1e-6, f分配比例合计为 {total}%请检查取整方式 print(| 类别 | 占比 | TGE 释放 | Cliff | 线性期 |) print(| --- | --- | --- | --- | --- |) for r in rows: print(f| {r[name]} | {r[pct]}% | {r[tge]}% | {r[cliff]} | {r[vesting]} |)assert那一行是整个脚本的重点。取整时如果有人把 33.333% 写成 33.33%六行加起来会是 99.99%肉眼很难发现脚本一跑就报错。allocation.json同时是官网代币页面和链上合约初始化的输入这样才能保证白皮书、计划书、合约三处一致。2.3 路线图与资金用途里程碑要能被验证路线图最容易写成「2025 Q1 生态建设、Q2 全球化布局」这类无法验证的句子。可行的写法是每个里程碑绑定一个可观测的完成标准并且标明依赖关系。资金用途则按类别给出比例和绝对金额注意比例是按融资额算还是按总预算算两种口径混用是常见错误。里程碑时间窗可验证完成标准前置依赖测试网第 1—2 季度公开测试网出块稳定 30 天验证者 ≥ 21共识模块完成安全审计第 3 季度两家机构报告公开高危问题全部关闭合约冻结主网第 4 季度创世区块上线浏览器可查审计通过TGE主网后 1 季度代币合约部署解锁表公示合规意见出具2.4 计划书和技术白皮书的分工边界两份文档经常被混着写结果是同一组参数出现两个版本尽调时被逐条对照。合理的分工是白皮书讲协议、形式化定义、共识证明和治理流程面向工程师计划书讲市场、竞争、团队、财务模型和里程碑面向投资人。重叠部分只有链上参数表和 Token 分配表而且这两张表必须从同一份源数据渲染出来。内容重合不是问题数字冲突才是问题。我一般会在仓库里放一个data/目录装 YAML 和 JSON计划书与白皮书各自的 Markdown 都通过脚本把表格插进去谁都不手写数字。这样修改一次参数两份 PDF 下一版自动同步。3. 用 Markdown 加 Pandoc 把区块链计划书编译成可版本管理的 PDF3.1 为什么草稿用 VSCode 转 PDF交付用 Pandoc写作阶段最快的路径是 vscode 用 markdown 转 pdf 的插件装完点一下就能出稿看排版、给同事传阅都够用。但它的短板在长文档交叉引用、图表自动编号、目录页码在内容增删后会错位中文字体也只能吃系统默认。正式交付的版本常见做法是走 Pandoc XeLaTeX源文件依旧是 MarkdownGit 里能 diff编译结果稳定。目录结构建议这样分data/放参数源数据chapters/放各章 Markdownassets/放架构图build/放产物并加进.gitignore。产物不进版本库源文件和编译脚本进。3.2 最小可跑命令与中文排版头文件# 单文件编译Markdown - PDF中文字体走 XeLaTeX pandoc plan.md \ --pdf-enginexelatex \ --toc --toc-depth2 \ --include-in-headerheader.tex \ -V geometry:margin2.2cm \ -V mainfontNoto Serif CJK SC \ -o build/blockchain-bp.pdf--pdf-enginexelatex是中文场景的硬性选择pdflatex 处理 CJK 断行会出问题。--toc-depth2只把一级和二级标题放进目录避免目录占掉三页。字体参数在不同系统上名字不一样Linux 上常见 Noto Serif CJK SCmacOS 上可能是 Songti SC写进 Makefile 时最好用变量抽出不要散落在命令里。header.tex控制那些 Markdown 表达不了的排版细节\usepackage{ctex} \usepackage{booktabs} % 三线表替代默认的网格表格 \usepackage{longtable} % 分配表跨页时表头自动重复 \usepackage{fancyhdr} \pagestyle{fancy} \fancyfoot[C]{\thepage} % 段首缩进两字符避免中文段落顶格 \setlength{\parindent}{2em} \setlength{\parskip}{0.4em} % 表格行距收紧防止长表撑爆页面 \renewcommand{\arraystretch}{1.15}四个参数的取舍值得说清楚。booktabs让表格去掉竖线在打印和缩放阅读时都比网格表清楚longtable是为了那张六行的 Token 分配表——在 A4 上它经常正好卡在分页处不处理的话表头会丢\parindent设成 2em 是中文排版习惯Markdown 转出来的段落默认顶格读起来很挤\arraystretch调到 1.15 以上含中英文混排的单元格会出现文字贴线的情况。3.3 数字与金额的排版约定计划书里的金额、占比、时间必须统一格式否则同一份文档里出现$1,000,000、100万美金、1M USD三种写法读者会怀疑数据来源不同。建议在 Markdown 源文件里只写机器可读的裸值格式交给模板。项目约定写法反例原因融资金额8,000,000 USD800 万美金千分位便于核对位数代币总量1,000,000,00010 亿与合约里的整数一致占比18.00%18统一两位小数合计校验方便时间窗2025-Q2明年二季度可排序、可被脚本解析合约地址0x 开头 40 位省略前半段读者要能复制去浏览器验证3.4 用 Makefile 让每一版 PDF 带 commit 号发给投资人的 PDF 如果只叫plan.pdf两周后没人说得清手里那份是哪一版。把 commit 短哈希编进文件名再把编译时间写进页脚是成本最低的追踪手段。COMMIT : $(shell git rev-parse --short HEAD) DATE : $(shell date %Y%m%d) OUT : build/blockchain-bp-$(DATE)-$(COMMIT).pdf all: $(OUT) $(OUT): chapters/*.md data/*.json header.tex mkdir -p build pandoc chapters/*.md \ --pdf-enginexelatex --toc \ --include-in-headerheader.tex \ -V date$(DATE) rev $(COMMIT) \ -o $ echo built $ clean: rm -rf build$(OUT)依赖里把data/*.json写进去是关键改了分配比例但忘了重新编译Make 会提醒你。git rev-parse --short HEAD要求工作区干净后再编译否则文件名里的哈希和实际内容对不上——这条纪律比脚本本身重要。4. PDF 解析与一致性校验把 Token 分配表抠出来对账4.1 用 pdfplumber 提取分配表收到一份别人发来的计划书 PDF想快速核对分配比例或者要把 PDF 转 Word 交给法务改注释第一步都是把表格结构化地读出来。文本层完整的 PDF 用 pdfplumber 最省事它对表格线的识别比纯文本抽取可靠。import pdfplumber # 表格线明确的 PDF用 lines 策略最稳无线框表格改用 text 策略 TABLE_SETTINGS { vertical_strategy: lines, horizontal_strategy: lines, snap_tolerance: 4, # 线条吸附容差像素表线略歪时调大 edge_min_length: 12, # 短于此长度的线段忽略过滤装饰线 intersection_tolerance: 5, } with pdfplumber.open(blockchain-bp.pdf) as pdf: for i, page in enumerate(pdf.pages): tables page.extract_tables(TABLE_SETTINGS) for t in tables: # 表头里出现「占比」才认定为分配表避免抓到财务表 header .join(c or for c in t[0]) if 占比 in header: print(f--- page {i 1} ---) for row in t: print(row)参数说明snap_tolerance控制两根相近的线是否算同一条扫描件或低分辨率导出经常需要从默认 3 调到 6 以上edge_min_length用来过滤表头下方的装饰性短横线调太小会把装饰线当成分隔线切出多余的列intersection_tolerance影响列与行的交点判定中英文混排导致列宽不均时适当放大。如果表线是虚线或表格没有边框改用{vertical_strategy: text, horizontal_strategy: text}代价是容易把金额里的小数点误判为列边界。4.2 总量守恒与解锁曲线的自动校验抽出表格只是第一步真正有价值的是把「比例合计」和「解锁曲线」自动化验证。手算一遍要十分钟脚本跑一遍要一秒而且不会漏。from decimal import Decimal def check(total_pct, tge_map, months48): # 1) 比例合计必须为 100 s sum(Decimal(str(v)) for v in total_pct.values()) assert s Decimal(100), f占比合计 {s}不等于 100 # 2) 逐年累计释放量检查是否有年份出现断崖或倒挂 curve [] for m in range(0, months 1): released Decimal(0) for name, pct in total_pct.items(): tge, cliff, linear tge_map[name] if m cliff: r Decimal(str(tge)) else: step min(m - cliff, linear) r Decimal(str(tge)) (Decimal(str(pct)) - Decimal(str(tge))) \ * Decimal(step) / Decimal(linear) released r curve.append((m, released)) # 3) 单月释放增量超过总量 3% 时打印告警 for (m0, a), (m1, b) in zip(curve, curve[1:]): if b - a Decimal(3): print(f预警第 {m1} 月单月释放 {b - a}%可能存在解锁悬崖) return curve逻辑上有三个检查点比例合计的严格相等捕获取整误差逐年累计释放量用来画解锁曲线读者看图比看表快单月增量告警针对的是「多个类别 cliff 撞在同一个月」的情况这类设计在图上表现为一根竖直的尖刺容易被解读为砸盘信号写计划书时通常要主动错开。Decimal而不是float是必须的0.1 加 0.2 在二进制浮点下不等于 0.3占比校验会随机失败。4.3 扫描件、中文乱码与页面歪斜的处理技术顾问发回来的往往是打印后重新扫描的 PDF文字层丢失直接抽取会得到空字符串。判断方法很简单先看文本层有没有内容# 文本层抽取能出中文说明是可解析的 PDF pdftotext -layout plan.pdf - | head -40 # 统计每页字符数大量页面为 0 说明是扫描件需要走 OCR pdftotext plan.pdf - | tr -d [:space:] | wc -m # 页面旋转或歪斜统一摆正后再做 OCR识别率差别很大 qpdf --rotate90:1-z plan.pdf plan-rotated.pdf症状常见原因处理方式抽出全是乱码字体未嵌入缺 ToUnicode 映射走 OCR不要硬修字体映射表格列错位页面歪斜 1—3 度先做歪斜校正再解析每页字符数为 0纯图片扫描件300 dpi 渲染后 OCR数字被识别成字母低分辨率或中英混排提高渲染 dpi限制字符集文件体积异常大未压缩的位图用 Ghostscript 降采样后归档歪斜校正是最容易被跳过的一步。哪怕只偏 2 度表格线的交点判定就会整体漂移snap_tolerance调到多大都救不回来。先摆正、再提高分辨率、最后才调整 pdfplumber 的参数顺序反了会浪费很多时间在调参上。5. 交付前的最后一公里元数据、水印与版本比对5.1 写入可追溯的文档指纹PDF 元数据是判断版本的第一手线索但多数 Markdown 转换默认把它留空。编译后补一段元数据写入成本几秒钟后面省掉大量「你手上那份是哪版」的对话# 写入标题、作者与自定义版本字段 exiftool -TitleBlockchain Project Business Plan \ -AuthorCore Team \ -Subjectrev $(git rev-parse --short HEAD) \ -Keywordsblockchain,whitepaper,business-plan \ build/blockchain-bp.pdf # 线性化让阅读器先加载第一页大文件打开更快 qpdf --linearize build/blockchain-bp.pdf build/blockchain-bp-final.pdf--linearize对三十页以上、带架构图的文件效果明显阅读器不用等整个文件下载完就能显示首页。这一点在移动端看 PDF 的场景里差别很大。5.2 用文本比对代替肉眼找差异两版计划书之间的改动肉眼翻一遍容易漏掉数字变化。可靠的做法是把 PDF 抽成文本再做 diff重点盯数字行pdftotext -layout v1.pdf v1.txt pdftotext -layout v2.pdf v2.txt diff -u v1.txt v2.txt | grep -E ^[-].*[0-9]只过滤带数字的增删行是因为技术方案的措辞调整通常无害而占比、金额、时间窗的变动必须逐条确认而且往往要同步回白皮书和合约初始化脚本。这一步跑完再发版本能挡掉大部分前后不一致的问题。5.3 分发给不同对象的版本与水印给投资机构、审计方、社区三方的版本最好加不同的页脚水印出现外传时能定位来源。水印不要用图片覆盖改成页脚文字更轻\usepackage{draftwatermark} % 或直接在页脚插入受控字符串 \fancyfoot[L]{\footnotesize CONFIDENTIAL · For \recipient · rev \revid}\recipient在 Makefile 里通过-V传入同一份源文件编译出多个受控版本内容完全一致只有页脚不同。这样既能追溯也避免了维护多套 Markdown 分支带来的内容漂移。分发前最后一步是体积控制。计划书里放了太多高分辨率架构图和截图时文件很容易膨胀到几十 MB邮件网关直接拒收。用 Ghostscript 降到 150 dpi、转成 PDF/A 归档格式通常能压掉七成体积且不影响屏幕阅读gs -sDEVICEpdfwrite -dPDFA2 -dPDFACompatibilityPolicy1 \ -dDownsampleColorImagestrue -dColorImageResolution150 \ -dNOPAUSE -dBATCH -sOutputFileplan-archive.pdf plan-final.pdf压缩后务必再跑一次 5.2 的文本比对确认抽出的数字和压缩前完全一致——图片降采样偶尔会影响扫描件页面的 OCR 结果而计划书里恰恰可能夹着几页扫描的合规意见附件。本文还有配套的精品资源点击获取