把 50 万字古籍做成 3 MB 安卓阅读器：一条从 Markdown 到 APK 的流水线

写了一部《周易》的读本，收工时是 72 卷、50.5 万字、A4 排版 704 页。到这一步，「它讲了什么」已经不是最难的问题，「别人怎么读到它」才是——在地铁上、在没网的地方、在手机上。

一个源，四件产物

规矩只有一条：HTML 是唯一成品，其余都从它派生。

APK 不是第二套实现，它就是那个文件加字体内嵌。

原页面从 CDN 取字体，联网没事，飞行模式就是一片宋体缺失。构建时改成内嵌子集：

pyftsubset NotoSerifSC-Regular.otf \ --text-file=charset.txt \ --unicodes="U+4DC0-4DFF,U+2630-2640" \ --flavor=woff2 --layout-features='*'

两处值得抄：

字符集从正文里扫，不靠猜。 全书实际用字 3,100 个，两个字重压缩后约 2.5 MB；换成完整 CJK 字体就是 20 MB。
别漏符号区段。 卦符 ䷀—䷿ 在 U+4DC0–U+4DFF，三爻符号 ☰—☷ 在 U+2630–U+2640，都不在 CJK 统一汉字区。按 \u4e00-\u9fff 取字集，这些字全变豆腐块。

结果：文件里外链清零，字体 base64 内嵌，1.75 MB，断网可开。

环境里没有 Android Studio，而一个 WebView 壳本来也不需要它。六步：

aapt2 compile → res.zip aapt2 link → 资源 + R.java + assets + manifest javac → classes d8 → classes.dex zipalign → 4 字节对齐 apksigner → v1/v2/v3

两个坑：

platform-34_r03.zip 是 404。 build-tools_r34-linux.zip 正常，配对的 platform 包已经下架；改用 platform-35_r02.zip 取 android.jar，manifest 里 targetSdk 34，没问题。
手机版式要用手机视口验，不是窄桌面窗口。 Chromium --window-size=420 不认 <meta name="viewport">，页面按桌面宽度渲染，右边被裁掉——一个假溢出。Playwright 用 is_mobile=True 复核，scrollWidth == 390，其实一点没溢出。差点去改一段本来就对的 CSS。

manifest 里零权限，连 INTERNET 都没有：

<uses-permission android:name="android.permission.INTERNET" /> <!-- 删掉 -->

壳里再加 setBlockNetworkLoads(true)，正文里就算混进一个 <img> 也发不出去。versionCode 15000 对应 1.50.0，下一版 15100，同一签名密钥可直接覆盖安装。

如果只发一个 1.75 MB 的整书页：只有一个 <title>、没有 description、没有 canonical，「未济卦解读」这种长尾词一个也接不住。

于是站点构建按 <h1> 切分同一份 HTML，逐段套模板：

生成器约 250 行 Python，一秒跑完：

python3 scripts/build-site.py # 70 页 + sitemap + robots + llms.txt

两条后见之明：

GitHub 附件有几个脾气：

非 ASCII 文件名会被洗掉。 道可道-易传-1.50.0.apk 传上去变成 -.-1.50.0.apk。附件名一律 ASCII，中文标题放 release 正文。
上传要带 Accept: application/vnd.github+json，否则 uploads.github.com 回一个 HTML 400，什么也不说。
打 v* tag 的 workflow 会自动挂上 PDF、APK 与提示词 PDF，发版就是打一个 tag。

书是 CC BY-NC-SA 4.0。APK 在 releases，3 MB，无权限，飞行模式可用。

站点、PDF、APK 都是「给人看」的，但学术与档案场景要的是「能被引用」。所以这一版又加了两处：

Zenodo 存档，DOI 10.5281/zenodo.24185930：成书 PDF、HTML、Markdown、提示词 PDF、APK 五件一并存缴，许可 CC BY-NC-SA 4.0，旧版 DOI 永不变更。
HuggingFace 数据集 q1z2q3/daokedao-yijing：72 卷全文可直接做语料检索，卡片里带 DOI 回指。

站点也补了一页 /cite/，GB/T 7714、APA、BibTeX 三式直接粘。一句话：书要能被找到，也要能被署名引用。