简介友益文书8.7.5映山红心系黄英版是一套面向内容作者、站长及办公人员的EXE电子书制作工具适合将图文资料整理、打包为可独立运行的电子书也便于研究电子书生成流程与界面定制。压缩包共15个文件约2.26MB以可执行主程序为核心并配有界面图标、主题样式、交互脚本、应用清单、帮助示例与说明文档分别承担视觉呈现、页面交互、配置声明和使用提示等作用结构紧凑便于快速了解工具组成。已有379人学习说明其在电子书制作与软件研究场景中具有一定关注度。读者可据此了解目录树组织、页面模板、主题外观和打包发布的基本构成也可结合帮助示例与说明文字摸索界面定制、资源引用及独立电子书输出方式。破解版本仅供学习研究适合需要轻量级电子书制作工具或希望分析同类软件实现思路的读者参考。1. 编译机上好好的发出去白屏exe 电子书最容易栽在装完那一刻上周帮人看一个分发事故素材整理了两周用友益文书 8.7.5 编译出的单文件 exe在自己电脑上翻页、搜目录、看图全正常发给十几个人三个人打开是白板两个人报「脚本错误」还有一个直接被杀软隔离。重装了三遍工具也没用——问题根本不在安装在编译机和阅读机的环境差。exe 电子书制作工具这类软件的安装向导点下一步只占五分钟剩下全是环境活内核版本、字体、路径、临时目录、打包参数任何一项没对齐编译出来的书在别人机器上就是黑匣子。这篇按我自己装 8.7.5 的顺序把装前清单、首次配置、素材与编译参数、翻车排查、验证方法一条条走完。适合要把 txt、doc、图片打包成单文件 exe 分发的资料整理岗和内部培训场景。2. 装前清单Windows 版本、内核组件与路径这四项先确认安装包双击之前先把这台机器的底摸清。友益文书 8.7.5 本身是个体积不大的原生程序装起来快但它依赖的东西分布在系统各处出问题时表现又都像「软件坏了」很容易把排查方向带偏。我一般先花十分钟做四项确认系统版本与位数、mshtml 内核组件、磁盘路径长度、当前用户权限。这四项过关后面九成的玄学问题不会出现。2.1 系统版本与位数32 位程序跑在 64 位系统上的两个真实后果这类电子书编译工具主体基本是 32 位原生程序在 64 位 Win10、Win11 上通过 WOW64 层运行界面和功能都正常但有两个后果必须提前知道。第一是地址空间32 位进程可用内存远低于 4GB实际能稳定吃下的素材总量通常在几百 MB 量级素材一多就卡在编译进度条末端。第二是文件系统重定向程序往 System32、Program Files 写文件会被悄悄转到别处你改的模板看似保存成功下次启动又变回原样。版本下限按 Win7 SP1 起算比较稳我自己的编译机固定在 Win10 21H2 以上Win11 也跑得通但 Win11 上要多做一步内核确认见下一节。位数不用纠结64 位系统直接装 32 位程序即可不需要找所谓的 64 位版本。# 确认系统版本、内部版本号与位数输出结果对照下面的判断标准 $os Get-CimInstance Win32_OperatingSystem [PSCustomObject]{ Caption $os.Caption # 例如 Microsoft Windows 10 专业版 Version $os.Version # 10.0.19044 这类内部版本号 Build $os.BuildNumber # 19044 / 22000 / 22621 OSArch $os.OSArchitecture # 64 位 / 32 位 FreeSpace [math]::Round((Get-PSDrive C).Free / 1GB, 1) # C 盘剩余 GB } | Format-List判断标准很直接Build低于 7601 的老系统不要装了缺少后续补丁会导致预览控件加载失败FreeSpace低于 20GB 的先清盘编译过程中会在临时目录生成接近成品体积的中间文件空间不够会以「编译失败」的名义报出来实际是磁盘写满。最后一行不是凑数我在一台只剩 3GB 的机器上排了两个小时最后发现是临时文件写不进去。2.2 内核组件确认mshtml 与 IE 模式在 Win10/Win11 上还剩什么exe 电子书的阅读界面绝大多数是基于 WebBrowser 控件渲染的底层就是 mshtml.dll。Win11 已经把 IE11 桌面应用退役了但 mshtml.dll 这个组件仍然留在系统里所以书能打开问题在于控件默认可能以 IE7 兼容模式渲染你排版时用的 flex、圆角、自定义字体全部失效预览里看着正常是因为编译机注册表里有别的程序留下的兼容性设置。先确认组件在不在、版本是多少# 检查 mshtml 内核组件是否存在及其文件版本 $dll Join-Path $env:SystemRoot System32\mshtml.dll if (Test-Path $dll) { $v (Get-Item $dll).VersionInfo 存在: $dll 文件版本: $($v.FileVersion) # 11.x 开头说明 IE11 内核仍在 产品版本: $($v.ProductVersion) } else { 缺失: 系统被精简过预览和阅读都会失败需要修复系统组件 }FileVersion显示 11.x说明内核还在可以继续。显示为空或者文件不存在说明这台机器是被精简过的镜像装完工具点预览会直接报错别浪费时间调模板先修系统。接着把当前程序的内核模拟模式写进注册表。这个键是每个 exe 单独生效的值11001表示强制用 IE11 标准模式11000是 IE10 标准模式老模板用11000反而更稳。# 为编译工具指定 IE11 标准渲染模式避免预览与实际输出不一致 $exeName YouyiBook.exe # 换成安装目录里实际的主程序文件名 $key HKCU:\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION if (-not (Test-Path $key)) { New-Item -Path $key -Force | Out-Null } New-ItemProperty -Path $key -Name $exeName -Value 11001 -PropertyType DWord -Force | Out-Null Get-ItemProperty -Path $key -Name $exeName键写在HKCU下只对当前用户生效不需要管理员权限出问题删掉这一项就恢复原状比改 HKLM 安全得多。注意程序名必须与实际 exe 完全一致包括大小写写错了不生效而且不报错——这是最容易白忙一场的地方。改完必须完全退出程序再启动托盘里残留的进程不算退出。2.3 路径与权限中文路径、空格、260 字符三项检查安装路径这条建议听起来老套但每次事故都能对上号不要装进Program Files不要放在带中文和空格的目录下整条路径控制在 60 个字符以内。原因不是程序不支持中文而是编译过程中会把相对路径拼成绝对路径传给内核去加载资源路径里一旦有空格没转义图片就变成红叉。我固定的目录约定是这样装在 D 盘一个短名字目录下# 建立规范的三段式目录程序、工程、输出互相分离 $root D:\BookTools # 根目录短、纯英文、无空格 $dirs ( $root\Youyi875, # 程序安装目录 $root\Projects, # 工程文件.wy 之类集中放这里 $root\Output, # 编译产物 $root\_TemplateBak # 模板原样备份改坏了好回滚 ) foreach ($d in $dirs) { if (-not (Test-Path $d)) { New-Item -ItemType Directory -Path $d -Force | Out-Null } OK $d 长度$($d.Length) }每个目录各管一件事好处是升级或重装程序时直接删Youyi875工程和模板备份都还在。脚本里把路径长度打出来是习惯动作超过 60 就要警惕超过 200 基本可以肯定会踩到 260 字符上限——素材目录层级一深加载附件时就会报「找不到文件」而文件明明躺在那里。权限方面用普通用户账户安装和运行即可不要图省事全程管理员。管理员运行会让程序把配置写到管理员账户的配置目录下换成普通账户启动后所有设置凭空消失看起来像「配置不保存」的 bug。2.4 版本取舍8.7.5 与旧版之间该怎么选8.7.5 相比更早的版本主要价值在模板结构和输出格式的支持范围上对新系统也更友好。但升级不是无脑的如果手上已经有一套跑了很多项目的旧模板直接拿新版打开有可能出现目录层级错位、样式丢失。我的做法是先在 8.7.5 里用旧模板编译一个最小样例三章、五张图能正常翻页、目录能跳转再决定把正式工程迁过来。另一个必须说的是安装包来源。网上流传的一些所谓改动版安装包常见问题是模板目录被替换、精简掉了预览组件、夹带额外的东西装完能启动但编译出来的书在别人机器上白屏或者被杀软拦。判断方法很简单解压后看文件清单正常的安装包目录结构完整、模板文件夹里有成套文件再看安装后主程序目录的大小和文件数跟官方说明对不上就别用。花十分钟核对比后面查三天白屏划算。3. 安装与首次启动路径、字体、临时目录三处必须改安装过程本身没什么可讲的值得写的是装完之后那十分钟的配置。默认配置是按开发者的机器假设的字体用系统默认、临时目录用%TEMP%、预览用兼容模式。这三项在你的机器上大概率不对而且不对时的表现全都不是报错是「看起来正常发出去不对」属于典型的后悔药场景。3.1 安装包落地与目录核对拿到安装包先别双击。丢到一个临时目录解压开看一眼结构确认模板文件和主程序都在再执行安装。# 解压到临时目录并列出关键文件确认包结构完整 $pkg D:\Download\youyi875.zip # 换成实际安装包路径 $tmp D:\Download\_unpack Expand-Archive -Path $pkg -DestinationPath $tmp -Force Get-ChildItem $tmp -Recurse -File | Where-Object { $_.Extension -in .exe,.dll,.chm,.css,.html } | Select-Object {n相对路径;e{$_.FullName.Replace($tmp,)}}, Length | Sort-Object 相对路径 | Format-Table -AutoSize这一步看三样主 exe 在不在最外层、有没有独立的模板或皮肤目录、有没有多余的 exe。正常的包应该只有一个主程序多出来的可执行文件不管叫什么名字都值得警惕。模板目录里如果只有一两个文件说明模板被精简过编译出来的书样式会很单调而且缺的样式在预览里看不出来。长度列用来估算体积主程序加资源通常是几十 MB 量级明显偏小就要怀疑被裁过。3.2 安装路径的选择与写入验证安装向导走到路径那一步手动改成 2.3 节建好的D:\BookTools\Youyi875。不要接受默认的C:\Program Files (x86)\...。装完之后立刻验证程序有没有写权限方法是在程序目录里建一个测试文件# 验证安装目录可写避免模板修改被 UAC 虚拟化重定向 $app D:\BookTools\Youyi875 $probe Join-Path $app _write_test.txt try { probe | Out-File -FilePath $probe -Encoding ASCII -ErrorAction Stop 可写: $app Remove-Item $probe -Force } catch { 不可写: $($_.Exception.Message) —— 换目录重装别用管理员权限硬顶 } # 顺带确认没有写到虚拟化目录里 $virt $env:LOCALAPPDATA\VirtualStore if (Test-Path $virt) { Get-ChildItem $virt -Recurse -Depth 2 -ErrorAction SilentlyContinue | Select-Object FullName }第一段判断当前用户对这个目录有没有直接写权限。写不进去的时候不要用「以管理员身份运行」绕过去那样配置会跟着管理员账户走换账户就丢。第二段是查 UAC 虚拟化留下的痕迹如果VirtualStore下面出现了这个程序的目录说明之前的运行已经发生了重定向模板的修改实际写到了那里程序目录里的文件根本没变——这个坑非常隐蔽现象是「改了模板重开又回去了」。3.3 首次启动的三处设置程序第一次启动进设置里改三样改完重启程序确认生效。第一处是默认字体。不要用「微软雅黑」这类在新系统上才普及的字体读者的机器可能是老系统或者精简系统缺字体时会回退成宋体行距和字宽全变排版挤成一团。稳妥做法是正文用宋体、标题用黑体这两款在 Windows 上几乎不会缺。设置里如果有「嵌入字体」选项视体积决定中文字体嵌进去动辄十几 MB。第二处是临时目录。默认的%TEMP%可能落在C:\Users\张三\AppData\Local\Temp这种带中文用户名的路径下编译中间文件和素材拼接时容易出编码问题。改成固定短路径# 建立专用临时目录并在环境变量层面指向它只影响当前用户 $tmp D:\BookTools\_Temp New-Item -ItemType Directory -Path $tmp -Force | Out-Null [Environment]::SetEnvironmentVariable(TEMP, $tmp, User) [Environment]::SetEnvironmentVariable(TMP, $tmp, User) 已设置 TEMP/TMP - $tmp 需重新登录或重启程序生效改用户级环境变量对系统其他程序影响有限但保险起见如果这台机器还要跑别的构建任务就只在电子书工具的设置界面里单独指定临时目录不动环境变量。改完记得清一次目录之前失败留下的半成品文件会干扰下一次编译。第三处是预览内核。2.2 节写注册表是全局手段程序设置里如果自带「预览内核 / 渲染模式」下拉项优先用程序内的设置它对当前工程单独生效不影响别的软件。两者都设置时以程序内设置为准。3.4 用一个最小样例验证安装是否成功配置改完不要直接上正式工程先做一个三章的最小样例一个封面、两章正文、一张图、一个内部跳转链接。编译一次输出到D:\BookTools\Output双击打开。验证点按顺序过一遍封面图能不能显示、目录树能不能展开、点目录能不能跳到对应章节、翻页按钮是否正常、图片是否清晰、关闭再打开是否记住上次阅读位置。六项全过说明安装和基础配置没问题可以进正式工程。任何一项不过先回 2.2 查内核再看临时目录里有没有残留文件。提示最小样例保留下来别删后面每次升级版本或换机器都拿它先跑一遍五分钟能省掉半天。4. 素材与编译从散装文件到能发出去的单文件 exe工程能做多大取决于素材整理得多规矩成品能不能发出去取决于编译参数怎么设。这一章是整篇里最费时间的部分因为大部分翻车不是装错是素材和参数没对齐。4.1 素材规范化txt 编码、图片尺寸、文件名文本编码是最常见的第一道坎。老的电子书工具读 txt 默认按 GBK/ANSI 解释素材如果是 UTF-8 无 BOM打开就是满屏问号反过来工具按 UTF-8 读而文件是 GBK也是一堆乱码。稳妥做法是统一转成 UTF-8 带 BOM绝大多数版本能正确识别实在不行再退回 GBK。# 批量把素材 txt 转成 UTF-8 with BOM并统计异常文件 import pathlib src pathlib.Path(rD:\BookTools\Projects\demo\src) report [] for f in src.rglob(*.txt): raw f.read_bytes() for enc in (utf-8-sig, utf-8, gb18030): try: text raw.decode(enc) break except UnicodeDecodeError: continue else: report.append((f.name, 无法识别编码)) continue # utf-8-sig 写入会自动加 BOM保证工具能识别编码 f.write_text(text, encodingutf-8-sig) report.append((f.name, f源编码{enc} 字符数{len(text)})) for name, msg in report: print(f{name:40}{msg})逐个尝试utf-8-sig、utf-8、gb18030三种编码解码第一个成功的就用它然后统一写成带 BOM 的 UTF-8。gb18030放在最后作为兜底它能覆盖绝大部分 GBK 内容但会有极小概率把二进制文件误判成文本所以只对*.txt跑。输出的报告里如果有「无法识别编码」那多半不是文本文件改名后缀或者手工处理不要硬转。图片方面阅读界面是 32 位进程内嵌浏览器控件渲染的单张图超过 3MB、总图片超过 200MB翻页就会明显卡顿编译阶段也容易卡在进度条末端。批量压一下# 批量压缩图片长边限制 1600pxJPEG 质量 82原图另存备份 import pathlib from PIL import Image src pathlib.Path(rD:\BookTools\Projects\demo\images) bak src.parent / images_raw bak.mkdir(exist_okTrue) for f in list(src.glob(*)): if f.suffix.lower() not in (.jpg, .jpeg, .png, .bmp): continue before f.stat().st_size im Image.open(f) im im.convert(RGB) if f.suffix.lower() ! .png else im im.thumbnail((1600, 1600), Image.LANCZOS) # 长边压到 1600等比缩放 out f.with_suffix(.jpg) if f.suffix.lower() ! .png else f im.save(out, quality82, optimizeTrue) # 质量 82 是清晰度与体积的平衡点 after out.stat().st_size print(f{f.name:30}{before//1024}KB - {after//1024}KB)thumbnail是等比缩放并且会就地修改尺寸不会拉伸变形quality82是反复试出来的平衡点再低文字截图边缘会出现明显噪点再高体积降不下来。原图没有自动搬走脚本里留了备份目录变量实际使用时先把原图复制一份过去再跑避免压过头无法回退。文件名只用英文、数字、下划线和中划线不要用空格、括号、井号。这些字符在内部链接和资源引用里都会被转义转义一旦漏掉就是图片裂开。4.2 章节树层级、命名与排序章节树的层级建议不超过三层卷、章、节。再深目录面板就要滚动读者找不到位置。命名上加两位数字前缀保证排序稳定01_、02_不要依赖工具按名称自然排序不同版本的排序规则不完全一致。每章一个独立目录正文和这一章的图片放一起目录结构就是书的结构# 工程目录结构示例mkdir -p 一次建好骨架 mkdir -p D:/BookTools/Projects/demo/{src/ch01,src/ch02,src/ch03,images,template,out} # 章节目录带序号前缀保证在不同排序规则下顺序一致 # src/ch01/ - 第一章正文 该章专属图片 # images/ - 全书公用图片封面、图标、装饰 # template/ - 模板文件副本原件放 _TemplateBak工程和输出分离out目录只放编译产物每次编译前清空避免旧文件混在里面导致「版本不对」的错觉。模板目录里放的是当前工程的模板副本调样式只改这里_TemplateBak里那份原封不动留着当后悔药——这句话不是客套我至少两次因为改错一个 CSS 选择器导致整本书的标题全部消失全靠备份五分钟恢复。4.3 模板替换与样式覆盖的正确姿势大多数模板由 HTML CSS 组成改样式只动 CSS不要动结构文件里的占位标记。占位标记是程序编译时替换章节内容和目录的地方删掉一个标签整章内容就会消失而且预览里不一定能立刻发现。改之前先备份、再改、改完做差异对比# 备份模板并记录改动前后的差异出问题能一眼看出改了啥 $work D:\BookTools\Projects\demo\template $bak D:\BookTools\_TemplateBak\$(Get-Date -Format yyyyMMdd_HHmm) New-Item -ItemType Directory -Path $bak -Force | Out-Null Copy-Item $work\* $bak -Recurse -Force 已备份到 $bak # 改完样式后对比备份与当前目录 Compare-Object (Get-ChildItem $bak -Recurse -File | Select-Object -Expand Name) (Get-ChildItem $work -Recurse -File | Select-Object -Expand Name)备份目录带时间戳每次改之前跑一遍历史版本都留着。对比那一步输出为空说明文件清单没变只有内容变化如果输出了多出来或者少掉的文件先确认是不是误删。样式改动本身建议一次只改一处改完立刻编译最小样例看效果——批量改完再编译出了问题根本不知道是哪一行引起的。另外一个常被忽略的点模板里如果引用了外部字体、外部图片、CDN 上的样式表读者断网打开就是默认样式甚至白屏。所有资源必须内嵌或用相对路径引用工程内的文件编译前全文搜一遍http://和https://有一个删一个。4.4 编译输出参数格式、图标、压缩与保护的取舍编译对话框里的参数不多但每一个都直接影响成品能不能用。参数可选值实际影响我的取值输出形式单文件 exe / exe 数据目录单文件方便分发但体积大、启动慢带数据目录启动快但必须整个文件夹一起发资料内部分发用单文件超过 300MB 改带目录压缩级别不压缩 / 普通 / 最大最大压缩能省 30% 左右体积但编译时间和首次打开的解压时间都会翻倍普通体积换启动速度程序图标ico 文件影响观感和部分杀软的启发式判断图标尺寸建议 256×256 多尺寸打包256 多尺寸 ico打开密码空 / 自定义只是阅读门槛不是加密别放真正敏感的内容对外分发时设内部不设窗口尺寸固定 / 可调 / 最大化固定尺寸在不同分辨率下可能显示不全可调 初始 1024×768分卷关闭 / 按体积单文件过大时用但读者体验差需要先把所有分卷放同一目录尽量不分卷关于压缩有一点要注意最大压缩出来的单文件 exe每打开一次都要先解压到临时目录机械硬盘或者杀软实时扫描开着的情况下首次打开可能要等十几秒读者会以为程序卡死。普通压缩在绝大多数场景下是更好的选择。编译前把上一次的输出清干净避免拿错文件# 清空输出目录并编译后核对产物 $out D:\BookTools\Output Get-ChildItem $out -File | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-1) } | Remove-Item -Force Get-ChildItem $out -File | Select-Object Name, {n大小MB;e{[math]::Round($_.Length/1MB,2)}}, LastWriteTime | Format-Table只删一天前的旧文件是防止误删别人正在用的产物。编译完成后看输出的名字、体积、修改时间三项体积明显偏小通常是素材没打进去偏大通常是原图没压缩。4.5 体积与内存32 位进程的天花板在哪单文件成品控制在 200MB 以内比较舒服超过 500MB 就要考虑带数据目录的形式。原因在 2.1 节提过32 位进程编译时要同时把素材读进内存、压缩、写盘素材总量逼近内存上限时表现是进度条卡在 90% 以上不动任务管理器里内存占用顶到 1.5GB 左右然后程序无响应。真遇到超大素材处理顺序是先压图通常能砍掉一半以上、再拆分卷、最后才考虑换输出形式。不要先去改虚拟内存或者加大页面文件那解决不了 32 位地址空间的硬限制。5. 避坑与排查五条翻车记录每条都找得到根因这一章的每条都是「现象看着像 A实际是 B」的类型。按现象查别按猜测查。5.1 编译机正常读者打开白屏现象自己机器上翻页、跳转全正常发出去有人打开只有窗口背景内容区一片白。原因读者的机器上内核渲染被策略限制或者素材里有外部链接资源http 图片、CDN 样式断网或者内网环境下加载失败还有一种情况是 Windows 的「阻止来自 Internet 的文件」标记从网上下载的 exe 会被打上 Zone.Identifier脚本直接被拦。解决编译前全文搜一遍外链并全部改成内嵌资源分发时把成品打成 zip让读者解压后再运行解压过程会去掉部分标记同时提供一句说明告知若出现白屏右键属性点「解除锁定」。5.2 成品被杀软直接隔离现象编译出来的 exe 在编译机上没事发到别人机器上几秒钟内被删除或者隔离日志里写「释放器」或者「可疑打包程序」。原因单文件电子书本质上是把一堆资源打包进一个 exe运行时释放到临时目录再加载行为特征和某些不受欢迎的程序高度相似如果程序图标、版本信息缺失启发式判断更容易命中。解决编译时填完整的版本信息产品名、版本号、公司名留空也可以但别乱填用正规的多尺寸 ico分发给外部时打包成 zip 附一份说明如果长期对外分发考虑给 exe 做代码签名签过名的文件误报率明显下降。不要试图通过改壳、加花指令来绕过那只会让误报更严重。5.3 中文目录下编译图片全部显示不出来现象素材放在D:\资料\项目A\下面编译能过打开后文字正常图片位置全是红叉。原因渲染层加载本地资源时对路径做了 URL 解析中文和空格没有正确转义请求直接失败。看起来是图片问题其实是路径问题。解决整个工程迁到纯英文短路径下如D:\BookTools\Projects\proj_a文件名也一并改成英文数字下划线。迁移后重新编译不要在原目录上改文件名试图绕过缓存里的旧路径还在。5.4 编译卡在 99% 不动现象进度条走到最后一段停住界面无响应等十分钟也没结果。原因三种可能——单张图过大超过 20MB 的扫描图很常见、素材总量逼近 32 位进程内存上限、临时目录所在磁盘空间不足。解决按顺序排查先看任务管理器里进程内存是否顶到 1.5GB 以上是则压图分批再看临时目录所在盘剩余空间低于成品预估体积的两倍就会失败最后清空临时目录重试。清临时目录这一步经常被跳过但失败留下的半成品文件会导致每次重试都在同一个位置卡住。5.5 换了台机器模板和设置全没了现象在 A 机器上配好的模板、字体、临时目录设置复制程序目录到 B 机器后打开全是默认值模板也变回原样。原因程序的部分配置写在用户配置目录或者注册表里不在安装目录下如果之前用管理员权限运行过配置还写到了管理员账户的配置目录下普通账户启动自然读不到。解决迁移时同时带走安装目录、用户配置目录一般在%APPDATA%和%LOCALAPPDATA%下的对应文件夹、以及注册表里HKCU\Software下对应的项。统一用普通用户权限运行避免配置分叉。迁移完成后按第 3 章的三处设置重新核对一遍比事后查「为什么设置不生效」快得多。6. 装完怎么验证三机 一表二十分钟闭环编译出来的 exe 在编译机上跑通不算数编译机的环境是最全的什么都装过什么问题都暴露不出来。我固定的验证方法是三台机器加一张检查表二十分钟能跑完。第一台是干净虚拟机装好系统后什么都不装不装 Office、不装运行库、不装任何浏览器插件模拟最朴素的读者环境。第二台是实体机Win11 最新补丁开着杀软实时防护验证误报和兼容性。第三台断网验证有没有隐藏的外链依赖。三台机器上做同一套动作双击打开、等首屏出现、展开全部目录、点三处跳转、翻十页、找一张图、用一次搜索、关闭再打开。检查表按下面这几项对不通过时按右列的顺序查检查项判定标准不通过先看什么启动速度干净环境 5 秒内出首屏压缩级别是否设成了最大、临时目录是否在慢盘首屏内容封面与目录同时可见模板占位标记是否被误删、外链资源是否残留目录跳转点任意章节能定位章节树层级是否超过三层、锚点命名是否含特殊字符图片显示全部清晰无红叉路径是否纯英文、单图是否超过 3MB搜索关键词能命中且高亮编码是否统一为 UTF-8 BOM断网打开内容完整无缺是否存在 http 外链杀软扫描不被隔离版本信息、图标是否完整最后一台机器上跑一遍启动耗时记录方便对比不同压缩级别的差异# 记录成品在干净环境下的启动耗时用于对比压缩级别的影响 $exe D:\BookTools\Output\demo_book.exe $times 1..5 | ForEach-Object { $sw [System.Diagnostics.Stopwatch]::StartNew() $p Start-Process -FilePath $exe -PassThru Start-Sleep -Milliseconds 300 $p.WaitForInputIdle(15000) | Out-Null # 等主窗口进入可交互状态 $sw.Stop() Start-Sleep -Seconds 2 $p.CloseMainWindow() | Out-Null $p.WaitForExit(5000) | Out-Null [math]::Round($sw.Elapsed.TotalSeconds, 2) } 五次启动耗时(秒): $($times -join , ) 平均: $([math]::Round(($times | Measure-Object -Average).Average, 2)) 秒WaitForInputIdle等的是窗口进入可交互状态比单纯等进程启动更贴近读者的真实感受等待上限设 15 秒超时说明首屏加载有问题直接判定不通过。跑五次取平均避开首次运行的磁盘缓存影响。如果平均超过 5 秒把压缩级别从最大降到普通再测一次通常能省一半时间。三台机器全部过完再算一次产物的哈希留档以后有人反馈「打开不对」先对哈希确认拿到的是不是同一个文件# 产物留档哈希 体积 编译时间写进随包说明 $f Get-Item D:\BookTools\Output\demo_book.exe $h Get-FileHash $f.FullName -Algorithm SHA256 [PSCustomObject]{ 文件 $f.Name 大小MB [math]::Round($f.Length/1MB, 2) SHA256 $h.Hash.Substring(0,16) ... 编译于 $f.LastWriteTime } | Format-List哈希只取前 16 位写进说明文档就够用完整值留在自己的记录里。这个习惯救过我一次对方坚持说文件有问题一比哈希发现他打开的是上一版白查半天。从那以后我每次编译完不管多急都强制走一遍断网虚拟机加杀软实机这两步宁可晚发半天也不发一个「在我这儿是好的」出去。这套 8.7.5 的安装包、模板备份目录和上面的检查脚本我整理在一起了照着第 2 章的清单对一遍环境再动手能少走不少弯路。希望帮到你。本文还有配套的精品资源点击获取
