
Typora Theme Pack · 功能说明
把模式和正文交给明确选好的外部转换器,检查这次是否真的成功。现在除了命令行,Typora 的“原版 / 公司 / 个人”三项导出菜单也走这条管道。
当前情况:失败保留旧文件、坏 PDF 拒收这些保护在源码里,GitHub 自动测试最近一次在 10 月 20 日通过;三项菜单已经配好,但还没在 Typora 里实际点过。新的导出仍核对实际文件,不能借旧 PDF 报成功。
项目源码:公开仓库


Typora Theme Pack · 功能说明
把模式和正文交给明确选好的外部转换器,检查这次是否真的成功。现在除了命令行,Typora 的“原版 / 公司 / 个人”三项导出菜单也走这条管道。
当前情况:失败保留旧文件、坏 PDF 拒收这些保护在源码里,GitHub 自动测试最近一次在 10 月 20 日通过;三项菜单已经配好,但还没在 Typora 里实际点过。新的导出仍核对实际文件,不能借旧 PDF 报成功。
项目源码:公开仓库


用途与实际影响
有些转换器没有生成文件却返回成功;只检查目标是否存在,就可能把上一次 PDF 冒充本次成果。
原来已有一份 PDF,这次转换器报错。脚本只清本次暂存文件,旧 PDF 保留,并返回真实错误。
获得本次生成且可解析的 PDF,或者具体失败原因;不靠旧文件大小判成功。

用途与实际影响
有些转换器没有生成文件却返回成功;只检查目标是否存在,就可能把上一次 PDF 冒充本次成果。
原来已有一份 PDF,这次转换器报错。脚本只清本次暂存文件,旧 PDF 保留,并返回真实错误。
获得本次生成且可解析的 PDF,或者具体失败原因;不靠旧文件大小判成功。

新 PDF 真实生成、能打开且有页面,原文没有被改动后,才替换目标文件。
转换失败或新文件无效时保留旧 PDF,并报告这次没有交付。
转换器、输入文件或输出位置不可用时,在替换前停止。

新 PDF 真实生成、能打开且有页面,原文没有被改动后,才替换目标文件。
转换失败或新文件无效时保留旧 PDF,并报告这次没有交付。
转换器、输入文件或输出位置不可用时,在替换前停止。

先运行 python tools/ 记录兼容转换器,或本次在 export_pdf.py 指定 --converter;再选 Markdown、模式与输出。想从 Typora 菜单导出,运行一次 configure_typora_menu.py 写好三项菜单,之后在“文件 → 导出”里选。
- 要导出的 Markdown
- 选定的版式与 PDF 目标
- 如尚未配置,指定已有兼容转换器


先运行 python tools/ 记录兼容转换器,或本次在 export_pdf.py 指定 --converter;再选 Markdown、模式与输出。想从 Typora 菜单导出,运行一次 configure_typora_menu.py 写好三项菜单,之后在“文件 → 导出”里选。
- 要导出的 Markdown
- 选定的版式与 PDF 目标
- 如尚未配置,指定已有兼容转换器


这里保留实现、关键条件、精确入口、历史记录和验证结果。
源码 22 个测试定义,最近一次 GitHub 自动测试 2026-10-20 16:55 成功;菜单配置已核对,实际点击待验收;本次未运行


- configure_converter.py 原子保存 typora-theme-pack.local.v1;相对路径按配置目录解析。本机配置指向一个已存在的 Markdown 转 PDF 转换脚本,配置里不含任何凭据。
- configure_typora_menu.py 只更新 Typora 的三个自定义导出槽,先备份原配置再原子替换,菜单名为原版/公司/个人;三项都调用 typora_export_launcher.ps1,启动器每次从 PCConfig 登记读取 Python,再把输入和模式交给导出脚本。不传固定输出路径,默认存在文稿旁并带对应后缀。
- export_pdf.py 生成 profile CSS 临时文件,调用 sys.executable + converter,带 --input、--output、--css-file、--document-style-policy、--require-style 和可选 --expected-pages。精确页数由兼容转换器验证;主题包自己的底线是至少一页。

这里保留实现、关键条件、精确入口、历史记录和验证结果。
源码 22 个测试定义,最近一次 GitHub 自动测试 2026-10-20 16:55 成功;菜单配置已核对,实际点击待验收;本次未运行


- configure_converter.py 原子保存 typora-theme-pack.local.v1;相对路径按配置目录解析。本机配置指向一个已存在的 Markdown 转 PDF 转换脚本,配置里不含任何凭据。
- configure_typora_menu.py 只更新 Typora 的三个自定义导出槽,先备份原配置再原子替换,菜单名为原版/公司/个人;三项都调用 typora_export_launcher.ps1,启动器每次从 PCConfig 登记读取 Python,再把输入和模式交给导出脚本。不传固定输出路径,默认存在文稿旁并带对应后缀。
- export_pdf.py 生成 profile CSS 临时文件,调用 sys.executable + converter,带 --input、--output、--css-file、--document-style-policy、--require-style 和可选 --expected-pages。精确页数由兼容转换器验证;主题包自己的底线是至少一页。

- 在外部执行前后核对源 SHA-256;成功后由 pypdf.PdfReader 解析实际暂存 PDF(
.typora-export-*.staged.pdf),至少一页才 os.replace。
- finally 尝试清理本次 CSS 与暂存文件,清理错误不覆盖原失败结果。


- 在外部执行前后核对源 SHA-256;成功后由 pypdf.PdfReader 解析实际暂存 PDF(
.typora-export-*.staged.pdf),至少一页才 os.replace。
- finally 尝试清理本次 CSS 与暂存文件,清理错误不覆盖原失败结果。



| 名词 | 意思 |
|---|---|
| 本次暂存 | 使用新路径,旧目标不能充当新输出证据。 |
| 摘要检查 | 发现原文发生变化,不能保证外部程序从未写过它。 |

新 PDF 检查通过,才替换上一次成果



新 PDF 检查通过,才替换上一次成果

解决什么
源摘要变化时拒绝成功,但这是检测而不是对外部程序的写入隔离。

- 包不实现底层 PDF 排版;兼容引擎由用户既有配置提供。
- 不会自动恢复被其他程序修改的源文档。
- 无输出、损坏 PDF、0 页或非零退出: 保留旧目标并报告失败。
- 源摘要变化: 拒绝交付,不把变动文件对应的 PDF 写成已验证。

解决什么
源摘要变化时拒绝成功,但这是检测而不是对外部程序的写入隔离。

- 包不实现底层 PDF 排版;兼容引擎由用户既有配置提供。
- 不会自动恢复被其他程序修改的源文档。
- 无输出、损坏 PDF、0 页或非零退出: 保留旧目标并报告失败。
- 源摘要变化: 拒绝交付,不把变动文件对应的 PDF 写成已验证。

- 交付和校验
- 本机配置
- 失败路径与原件保全
- 源码里有 22 个测试定义,覆盖旧 PDF 保留、无输出、损坏、0 页、非零退出和原子替换,10 月 20 日新增的一项查导出不依赖只给预览用的 Pillow;最近一次 GitHub 自动测试是 2026-10-20 16:55(提交 9cefc0e,整次工作流成功,日志这次没读)。更早:2026-09-29 01:51 那次 21 项全部通过,20 项通过是 cf6d710 阶段的结果。这次没有运行测试。
- 仓库现存三份样张各 2 页、都能解析,只证明已有文件;这次没有新生成 PDF。
- 三项菜单都已改为调用启动器,配置核对无误;但没有在 Typora 里实际点过,菜单导出成功与否待验收。
连接选中的样式和外部引擎,负责这一份输出的交付判断;Typora 菜单只是这条管道的另一个启动方式。

- 交付和校验
- 本机配置
- 失败路径与原件保全
- 源码里有 22 个测试定义,覆盖旧 PDF 保留、无输出、损坏、0 页、非零退出和原子替换,10 月 20 日新增的一项查导出不依赖只给预览用的 Pillow;最近一次 GitHub 自动测试是 2026-10-20 16:55(提交 9cefc0e,整次工作流成功,日志这次没读)。更早:2026-09-29 01:51 那次 21 项全部通过,20 项通过是 cf6d710 阶段的结果。这次没有运行测试。
- 仓库现存三份样张各 2 页、都能解析,只证明已有文件;这次没有新生成 PDF。
- 三项菜单都已改为调用启动器,配置核对无误;但没有在 Typora 里实际点过,菜单导出成功与否待验收。
连接选中的样式和外部引擎,负责这一份输出的交付判断;Typora 菜单只是这条管道的另一个启动方式。
复制 AI 续作说明
项目:转换器与 PDF 交付;仓库:wlyaaaaa/typora-theme-pack;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。








