imprint-pdf 0.11.0__tar.gz

imprint_pdf-0.11.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Imprint contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

imprint_pdf-0.11.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: imprint-pdf
+Version: 0.11.0
+Summary: AI-native, print-grade Chinese PDF generator: Markdown in, publisher-quality PDF out, with a 0-100 print-quality report.
+Author: Imprint
+License: MIT
+Keywords: pdf,markdown,chinese,typography,weasyprint,print
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Documentation
+Classifier: Topic :: Printing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: markdown-it-py>=3.0
+Requires-Dist: mdit-py-plugins>=0.4
+Requires-Dist: WeasyPrint>=61
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: Pygments>=2.15
+Requires-Dist: pdfplumber>=0.11
+Requires-Dist: PyMuPDF>=1.24
+Provides-Extra: charts
+Requires-Dist: mermaidx>=0.1; extra == "charts"
+Provides-Extra: mcp
+Requires-Dist: mcp<2.0,>=1.2; extra == "mcp"
+Dynamic: license-file
+
+# Imprint · 印记
+
+> **Markdown 进，出版社级 PDF 出，自带 0–100 印刷级质检报告。**
+
+[English](README.en.md) · [简体中文](README.md)
+
+Imprint 是一个 AI 原生的中文印刷级 PDF 生成器。它把 Markdown 当成草稿，把 PDF 当成成品——按出版物的标准排版：宋体正文、黑体标题、首行缩进、标点避头尾、目录页码精确、表格跨页重复表头、代码不截断。生成之后，机器自动给这份 PDF 打分：**0–100 印刷级评分，逐项给出证据**。
+
+<p align="center">
+  <img alt="PyPI" src="https://img.shields.io/pypi/v/imprint-pdf.svg">
+  <img alt="npm" src="https://img.shields.io/npm/v/imprint-pdf.svg">
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/imprint-pdf.svg">
+  <img alt="License" src="https://img.shields.io/pypi/l/imprint-pdf.svg">
+  <img alt="Downloads" src="https://img.shields.io/pypi/dm/imprint-pdf.svg">
+  <img alt="CI" src="https://github.com/263311487-ux/imprint-pdf/actions/workflows/ci.yml/badge.svg">
+  <img alt="Stars" src="https://img.shields.io/github/stars/263311487-ux/imprint-pdf">
+</p>
+
+## 快速开始（零配置）
+
+```bash
+# 方式一：一行命令（自动安装引擎，跨平台）
+npx imprint-pdf 论文.md
+
+# 方式二：pip 安装
+pip install imprint-pdf
+imprint 论文.md
+
+# 常用命令
+npx imprint-pdf --new report     # 从模板起稿
+npx imprint-pdf --list-themes    # 22 套主题
+npx imprint-pdf 论文.md --theme academic --out 论文.pdf
+```
+
+![封面](examples/qa/sample-01.png)
+
+![目录](examples/qa/sample-02.png)
+
+![正文](examples/qa/sample-04.png)
+
+![提示框](examples/qa/alerts-03.png)
+
+![mermaid 流程图](examples/qa/charts-03.png)
+
+## 主题画廊（22 套 · 全部通过印刷级质检）
+
+<p align="center">
+<img src="examples/qa/modern-01.png" width="150" alt="modern"/>
+<img src="examples/qa/academic-01.png" width="150" alt="academic"/>
+<img src="examples/qa/nord-01.png" width="150" alt="nord"/>
+<img src="examples/qa/sepia-01.png" width="150" alt="sepia"/>
+<img src="examples/qa/newspaper-01.png" width="150" alt="newspaper"/>
+</p>
+<p align="center">
+<img src="examples/qa/catppuccin-01.png" width="150" alt="catppuccin"/>
+<img src="examples/qa/mono-01.png" width="150" alt="mono"/>
+<img src="examples/qa/jade-01.png" width="150" alt="jade"/>
+<img src="examples/qa/coffee-01.png" width="150" alt="coffee"/>
+<img src="examples/qa/ocean-01.png" width="150" alt="ocean"/>
+</p>
+<p align="center">
+<img src="examples/qa/lavender-01.png" width="150" alt="lavender"/>
+<img src="examples/qa/rose-01.png" width="150" alt="rose"/>
+<img src="examples/qa/pine-01.png" width="150" alt="pine"/>
+<img src="examples/qa/wine-01.png" width="150" alt="wine"/>
+<img src="examples/qa/graphite-01.png" width="150" alt="graphite"/>
+</p>
+<p align="center">
+<img src="examples/qa/midnight-01.png" width="150" alt="midnight"/>
+<img src="examples/qa/coral-01.png" width="150" alt="coral"/>
+<img src="examples/qa/amber-01.png" width="150" alt="amber"/>
+<img src="examples/qa/mint-01.png" width="150" alt="mint"/>
+<img src="examples/qa/sand-01.png" width="150" alt="sand"/>
+</p>
+<p align="center">
+<img src="examples/qa/minimal-01.png" width="150" alt="minimal"/>
+<img src="examples/qa/ink-01.png" width="150" alt="ink"/>
+<img src="examples/qa/gongwen-01.png" width="150" alt="gongwen 公文"/>
+</p>
+
+## 双栏学术论文模板
+
+`imprint --new paper` 一键生成双栏学术论文：摘要/关键词通栏，正文双栏排版，标题不落页尾、表格不跨栏截断、行内公式不断行。
+
+<p align="center">
+<img src="examples/qa/paper-03.png" width="260" alt="paper 双栏正文"/>
+<img src="examples/qa/paper-04.png" width="260" alt="paper 双栏图表"/>
+</p>
+
+英文论文用 `imprint --new ieee`：IEEE 风格（Times 10pt 紧凑双栏 + IEEE 蓝），
+`lang: en` 自动切换文档语言标签，Abstract / Index Terms 通栏。
+
+<p align="center">
+<img src="examples/qa/ieee-03.png" width="300" alt="ieee 双栏英文论文"/>
+</p>
+
+## 党政机关公文（GB/T 9704 红头文件）
+
+`imprint --new gongwen` 一键生成符合《党政机关公文格式》的红头文件：
+红色发文机关标志、发文字号、红色分隔线（★）、黑体标题、仿宋三号正文、
+右对齐落款与成文日期。
+
+<p align="center">
+<img src="examples/qa/gongwen-01.png" width="300" alt="gongwen 红头文件"/>
+</p>
+
+换肤 = 一行命令：`imprint paper.md --theme wine`；**不指定也会智能换肤**——自动分析内容气质选主题并说明理由（如周报自动用 `graphite`，论文自动用 `academic`）。
+
+## 为什么是 Imprint
+
+大多数 Markdown→PDF 工具（pandoc 默认、md2pdf 系、Chrome 打印）只是"把文字倒进页面"。Imprint 的三个差异点：
+
+- **中文印刷级**——严格按《中文排版需求》：避头尾禁则、首行缩进 2 字符、中英文混排字距、孤行寡行控制
+- **设计系统即主题**——每套主题是一组 DTCG 设计令牌（色板/字体配对/间距/装饰），换肤 = 换一行
+- **印刷级质检报告**——每个 PDF 生成后自动评分 0–100，检查文本可选、字体子集嵌入、标点违规、目录页码、PDF/UA 无障碍标签，证据可查
+
+## 快速开始
+
+```bash
+pip install imprint-pdf
+# 图表支持（可选）
+pip install imprint-pdf[charts]
+# MCP server（可选，Agent 一句话出报告）
+pip install imprint-pdf[mcp]
+
+imprint paper.md -o paper.pdf
+imprint paper.md --theme sepia --compress
+# 从模板起稿（报告/书籍/简历/技术文档/信函）
+imprint --new report -o my_report.md
+# 启动 MCP server（stdio），供 Claude Code / Cursor / DeepSeek Harness 等接入
+imprint-mcp
+```
+
+输出结尾是一张质检报告：
+
+```
+印刷级质检报告
+==============================================
+ ✓ 文本可选              15.0/15.0   平均每页 722 字符
+ ✓ 字体子集嵌入            15.0/15.0   5/5 字体已嵌入
+ ✓ 元数据完整              3.0/3.0    标题「印记」
+ ✓ 标点避头尾             15.0/15.0   0 违规
+ ✓ 孤行寡行               9.0/9.0    0 处
+ ✓ 目录页码              15.0/15.0   核对 15 条
+ ✓ 页码存在               2.0/2.0    8/9 页含页码
+ ✓ PDF/UA 标签          3.0/3.0    Tagged PDF
+ ✓ 主题字体生效             3.0/3.0    命中 songti
+ ✓ 主题对比度              5.0/5.0    正文 17.0:1 …
+ ✓ 缺字检测               5.0/5.0    无缺字回退
+ ✓ 内容溢出               5.0/5.0    无内容越界
+ ✓ 图片清晰度              5.0/5.0    全部达标
+ ----------------------------------------------
+ 总分 100.0/100 · 等级 A+ · 9 页
+```
+
+## 特性
+
+- **封面 + 目录**：frontmatter 里的 `title / author / date` 自动生成封面，标题自动生成可点击目录（页码精确）
+- **智能换肤**：不指定主题时，按标题/关键词/正文信号自动推荐（含理由）；显式指定优先
+- **主题系统**：22 套主题（见下方画廊）——现代杂志 / 学术书卷 / 北欧极简 / 护眼纸色 / 报纸头版 / 柔和粉彩 / 纯黑白 / 玉石绿 / 咖啡暖棕 / 海洋蓝 / 薰衣草紫 / 樱粉 / 松林绿 / 勃艮第酒红 / 石墨灰 / 深夜蓝纸（暗色）/ 珊瑚橙 / 琥珀金 / 薄荷青 / 沙漠沙色 / **极简（minimal）** / **线装书（ink，宣纸+印章红）**，自定义主题 = 一个 JSON 文件
+- **GitHub 风格提示框**：`> [!NOTE]` / `[!TIP]` / `[!WARNING]` / `[!IMPORTANT]` / `[!CAUTION]` 自动渲染为印刷级彩色提示卡，见 `examples/alerts.md`
+- **Mermaid 图表**：` ```mermaid ` 代码块自动渲染为矢量图（中文正常、无限缩放），未装引擎时优雅回退代码块，见 `examples/charts.md`
+- **数学公式**：`$行内公式$` / `$$块级公式$$` 渲染为矢量 SVG（matplotlib mathtext，无数学字体依赖），见 `examples/math.md`
+- **模板系统**：`imprint --new report|book|resume|techdoc|letter|paper|gongwen|ieee` 一键起稿，模板自带对应排版气质（石墨灰报告 / 米黄书稿 / 等宽简历 / 海洋蓝技术文档 / 薰衣草信函 / 双栏学术论文 / 红头公文 / IEEE 英文论文）
+- **图片压缩**：`--compress` 自动降采样超大图并重编码（实测 11.7MB → 1.4MB）
+- **字体体检**：生成前自动检查主题字体本机是否可用，缺失时明确警告
+- **中文规范**：避头尾禁则、首行缩进、中英文混排、英文段落自动连字
+- **表格跨页**：表头自动重复、行不截断
+- **代码高亮**：Pygments 着色、整体换页不截断
+- **缺字检测**：渲染后扫描 LastResort/notdef 回退（豆腐块），脚注、箭头等符号缺字自动暴露
+- **PDF/UA**：默认输出无障碍标签版
+- **AI 原生**：CLI 一行命令；内置 MCP server（`imprint-mcp`），Agent 一句话出报告（tools: render_markdown / list_themes / validate_pdf / new_document）
+- **对比度合规**：每套主题自动通过 WCAG 印刷检查（正文 ≥7:1、小字 ≥4.5:1、装饰 ≥3:1）
+
+## 对比
+
+| | pandoc 默认 | Chrome 打印 | Imprint |
+|---|---|---|---|
+| 中文印刷级 | 弱 | 弱 | **按规范** |
+| 设计系统主题 | 无 | 无 | **DTCG tokens** |
+| 质检报告 0–100 | 无 | 无 | **自带** |
+| 数学公式 | 插件级 | 无 | **矢量内嵌** |
+| 模板起稿 | 无 | 无 | **8 套内置** |
+| 双栏学术排版 | 无 | 无 | **内置** |
+| 公文格式（红头文件） | 无 | 无 | **内置** |
+| WCAG 对比度检查 | 无 | 无 | **内置** |
+| PDF/UA 无障碍 | 手动 | 无 | **默认** |
+
+## 文档
+
+- [完美 PDF 标准](docs/完美PDF标准.md)——"完美"的定义与验收门槛
+- [极致借鉴清单](docs/极致借鉴清单_技术选型_20260819.md)——每个环节的社区选型与实测结论
+
+## 路线图
+
+- 更多主题（minimal / ink 已上线，22 套）
+- npm 分发 `npx imprint`（已上线）
+- 双栏 / 学术模板（已上线）
+- PyPI 发布
+- 更多双栏模板（IEEE / 公文 / 病历等）
+
+## License
+
+MIT

imprint_pdf-0.11.0/README.md

@@ -0,0 +1,204 @@
+# Imprint · 印记
+
+> **Markdown 进，出版社级 PDF 出，自带 0–100 印刷级质检报告。**
+
+[English](README.en.md) · [简体中文](README.md)
+
+Imprint 是一个 AI 原生的中文印刷级 PDF 生成器。它把 Markdown 当成草稿，把 PDF 当成成品——按出版物的标准排版：宋体正文、黑体标题、首行缩进、标点避头尾、目录页码精确、表格跨页重复表头、代码不截断。生成之后，机器自动给这份 PDF 打分：**0–100 印刷级评分，逐项给出证据**。
+
+<p align="center">
+  <img alt="PyPI" src="https://img.shields.io/pypi/v/imprint-pdf.svg">
+  <img alt="npm" src="https://img.shields.io/npm/v/imprint-pdf.svg">
+  <img alt="Python" src="https://img.shields.io/pypi/pyversions/imprint-pdf.svg">
+  <img alt="License" src="https://img.shields.io/pypi/l/imprint-pdf.svg">
+  <img alt="Downloads" src="https://img.shields.io/pypi/dm/imprint-pdf.svg">
+  <img alt="CI" src="https://github.com/263311487-ux/imprint-pdf/actions/workflows/ci.yml/badge.svg">
+  <img alt="Stars" src="https://img.shields.io/github/stars/263311487-ux/imprint-pdf">
+</p>
+
+## 快速开始（零配置）
+
+```bash
+# 方式一：一行命令（自动安装引擎，跨平台）
+npx imprint-pdf 论文.md
+
+# 方式二：pip 安装
+pip install imprint-pdf
+imprint 论文.md
+
+# 常用命令
+npx imprint-pdf --new report     # 从模板起稿
+npx imprint-pdf --list-themes    # 22 套主题
+npx imprint-pdf 论文.md --theme academic --out 论文.pdf
+```
+
+![封面](examples/qa/sample-01.png)
+
+![目录](examples/qa/sample-02.png)
+
+![正文](examples/qa/sample-04.png)
+
+![提示框](examples/qa/alerts-03.png)
+
+![mermaid 流程图](examples/qa/charts-03.png)
+
+## 主题画廊（22 套 · 全部通过印刷级质检）
+
+<p align="center">
+<img src="examples/qa/modern-01.png" width="150" alt="modern"/>
+<img src="examples/qa/academic-01.png" width="150" alt="academic"/>
+<img src="examples/qa/nord-01.png" width="150" alt="nord"/>
+<img src="examples/qa/sepia-01.png" width="150" alt="sepia"/>
+<img src="examples/qa/newspaper-01.png" width="150" alt="newspaper"/>
+</p>
+<p align="center">
+<img src="examples/qa/catppuccin-01.png" width="150" alt="catppuccin"/>
+<img src="examples/qa/mono-01.png" width="150" alt="mono"/>
+<img src="examples/qa/jade-01.png" width="150" alt="jade"/>
+<img src="examples/qa/coffee-01.png" width="150" alt="coffee"/>
+<img src="examples/qa/ocean-01.png" width="150" alt="ocean"/>
+</p>
+<p align="center">
+<img src="examples/qa/lavender-01.png" width="150" alt="lavender"/>
+<img src="examples/qa/rose-01.png" width="150" alt="rose"/>
+<img src="examples/qa/pine-01.png" width="150" alt="pine"/>
+<img src="examples/qa/wine-01.png" width="150" alt="wine"/>
+<img src="examples/qa/graphite-01.png" width="150" alt="graphite"/>
+</p>
+<p align="center">
+<img src="examples/qa/midnight-01.png" width="150" alt="midnight"/>
+<img src="examples/qa/coral-01.png" width="150" alt="coral"/>
+<img src="examples/qa/amber-01.png" width="150" alt="amber"/>
+<img src="examples/qa/mint-01.png" width="150" alt="mint"/>
+<img src="examples/qa/sand-01.png" width="150" alt="sand"/>
+</p>
+<p align="center">
+<img src="examples/qa/minimal-01.png" width="150" alt="minimal"/>
+<img src="examples/qa/ink-01.png" width="150" alt="ink"/>
+<img src="examples/qa/gongwen-01.png" width="150" alt="gongwen 公文"/>
+</p>
+
+## 双栏学术论文模板
+
+`imprint --new paper` 一键生成双栏学术论文：摘要/关键词通栏，正文双栏排版，标题不落页尾、表格不跨栏截断、行内公式不断行。
+
+<p align="center">
+<img src="examples/qa/paper-03.png" width="260" alt="paper 双栏正文"/>
+<img src="examples/qa/paper-04.png" width="260" alt="paper 双栏图表"/>
+</p>
+
+英文论文用 `imprint --new ieee`：IEEE 风格（Times 10pt 紧凑双栏 + IEEE 蓝），
+`lang: en` 自动切换文档语言标签，Abstract / Index Terms 通栏。
+
+<p align="center">
+<img src="examples/qa/ieee-03.png" width="300" alt="ieee 双栏英文论文"/>
+</p>
+
+## 党政机关公文（GB/T 9704 红头文件）
+
+`imprint --new gongwen` 一键生成符合《党政机关公文格式》的红头文件：
+红色发文机关标志、发文字号、红色分隔线（★）、黑体标题、仿宋三号正文、
+右对齐落款与成文日期。
+
+<p align="center">
+<img src="examples/qa/gongwen-01.png" width="300" alt="gongwen 红头文件"/>
+</p>
+
+换肤 = 一行命令：`imprint paper.md --theme wine`；**不指定也会智能换肤**——自动分析内容气质选主题并说明理由（如周报自动用 `graphite`，论文自动用 `academic`）。
+
+## 为什么是 Imprint
+
+大多数 Markdown→PDF 工具（pandoc 默认、md2pdf 系、Chrome 打印）只是"把文字倒进页面"。Imprint 的三个差异点：
+
+- **中文印刷级**——严格按《中文排版需求》：避头尾禁则、首行缩进 2 字符、中英文混排字距、孤行寡行控制
+- **设计系统即主题**——每套主题是一组 DTCG 设计令牌（色板/字体配对/间距/装饰），换肤 = 换一行
+- **印刷级质检报告**——每个 PDF 生成后自动评分 0–100，检查文本可选、字体子集嵌入、标点违规、目录页码、PDF/UA 无障碍标签，证据可查
+
+## 快速开始
+
+```bash
+pip install imprint-pdf
+# 图表支持（可选）
+pip install imprint-pdf[charts]
+# MCP server（可选，Agent 一句话出报告）
+pip install imprint-pdf[mcp]
+
+imprint paper.md -o paper.pdf
+imprint paper.md --theme sepia --compress
+# 从模板起稿（报告/书籍/简历/技术文档/信函）
+imprint --new report -o my_report.md
+# 启动 MCP server（stdio），供 Claude Code / Cursor / DeepSeek Harness 等接入
+imprint-mcp
+```
+
+输出结尾是一张质检报告：
+
+```
+印刷级质检报告
+==============================================
+ ✓ 文本可选              15.0/15.0   平均每页 722 字符
+ ✓ 字体子集嵌入            15.0/15.0   5/5 字体已嵌入
+ ✓ 元数据完整              3.0/3.0    标题「印记」
+ ✓ 标点避头尾             15.0/15.0   0 违规
+ ✓ 孤行寡行               9.0/9.0    0 处
+ ✓ 目录页码              15.0/15.0   核对 15 条
+ ✓ 页码存在               2.0/2.0    8/9 页含页码
+ ✓ PDF/UA 标签          3.0/3.0    Tagged PDF
+ ✓ 主题字体生效             3.0/3.0    命中 songti
+ ✓ 主题对比度              5.0/5.0    正文 17.0:1 …
+ ✓ 缺字检测               5.0/5.0    无缺字回退
+ ✓ 内容溢出               5.0/5.0    无内容越界
+ ✓ 图片清晰度              5.0/5.0    全部达标
+ ----------------------------------------------
+ 总分 100.0/100 · 等级 A+ · 9 页
+```
+
+## 特性
+
+- **封面 + 目录**：frontmatter 里的 `title / author / date` 自动生成封面，标题自动生成可点击目录（页码精确）
+- **智能换肤**：不指定主题时，按标题/关键词/正文信号自动推荐（含理由）；显式指定优先
+- **主题系统**：22 套主题（见下方画廊）——现代杂志 / 学术书卷 / 北欧极简 / 护眼纸色 / 报纸头版 / 柔和粉彩 / 纯黑白 / 玉石绿 / 咖啡暖棕 / 海洋蓝 / 薰衣草紫 / 樱粉 / 松林绿 / 勃艮第酒红 / 石墨灰 / 深夜蓝纸（暗色）/ 珊瑚橙 / 琥珀金 / 薄荷青 / 沙漠沙色 / **极简（minimal）** / **线装书（ink，宣纸+印章红）**，自定义主题 = 一个 JSON 文件
+- **GitHub 风格提示框**：`> [!NOTE]` / `[!TIP]` / `[!WARNING]` / `[!IMPORTANT]` / `[!CAUTION]` 自动渲染为印刷级彩色提示卡，见 `examples/alerts.md`
+- **Mermaid 图表**：` ```mermaid ` 代码块自动渲染为矢量图（中文正常、无限缩放），未装引擎时优雅回退代码块，见 `examples/charts.md`
+- **数学公式**：`$行内公式$` / `$$块级公式$$` 渲染为矢量 SVG（matplotlib mathtext，无数学字体依赖），见 `examples/math.md`
+- **模板系统**：`imprint --new report|book|resume|techdoc|letter|paper|gongwen|ieee` 一键起稿，模板自带对应排版气质（石墨灰报告 / 米黄书稿 / 等宽简历 / 海洋蓝技术文档 / 薰衣草信函 / 双栏学术论文 / 红头公文 / IEEE 英文论文）
+- **图片压缩**：`--compress` 自动降采样超大图并重编码（实测 11.7MB → 1.4MB）
+- **字体体检**：生成前自动检查主题字体本机是否可用，缺失时明确警告
+- **中文规范**：避头尾禁则、首行缩进、中英文混排、英文段落自动连字
+- **表格跨页**：表头自动重复、行不截断
+- **代码高亮**：Pygments 着色、整体换页不截断
+- **缺字检测**：渲染后扫描 LastResort/notdef 回退（豆腐块），脚注、箭头等符号缺字自动暴露
+- **PDF/UA**：默认输出无障碍标签版
+- **AI 原生**：CLI 一行命令；内置 MCP server（`imprint-mcp`），Agent 一句话出报告（tools: render_markdown / list_themes / validate_pdf / new_document）
+- **对比度合规**：每套主题自动通过 WCAG 印刷检查（正文 ≥7:1、小字 ≥4.5:1、装饰 ≥3:1）
+
+## 对比
+
+| | pandoc 默认 | Chrome 打印 | Imprint |
+|---|---|---|---|
+| 中文印刷级 | 弱 | 弱 | **按规范** |
+| 设计系统主题 | 无 | 无 | **DTCG tokens** |
+| 质检报告 0–100 | 无 | 无 | **自带** |
+| 数学公式 | 插件级 | 无 | **矢量内嵌** |
+| 模板起稿 | 无 | 无 | **8 套内置** |
+| 双栏学术排版 | 无 | 无 | **内置** |
+| 公文格式（红头文件） | 无 | 无 | **内置** |
+| WCAG 对比度检查 | 无 | 无 | **内置** |
+| PDF/UA 无障碍 | 手动 | 无 | **默认** |
+
+## 文档
+
+- [完美 PDF 标准](docs/完美PDF标准.md)——"完美"的定义与验收门槛
+- [极致借鉴清单](docs/极致借鉴清单_技术选型_20260819.md)——每个环节的社区选型与实测结论
+
+## 路线图
+
+- 更多主题（minimal / ink 已上线，22 套）
+- npm 分发 `npx imprint`（已上线）
+- 双栏 / 学术模板（已上线）
+- PyPI 发布
+- 更多双栏模板（IEEE / 公文 / 病历等）
+
+## License
+
+MIT

imprint_pdf-0.11.0/imprint/__init__.py

@@ -0,0 +1,3 @@
+"""Imprint: AI-native, print-grade Chinese PDF generator."""
+
+__version__ = "0.11.0"

imprint_pdf-0.11.0/imprint/__main__.py

@@ -0,0 +1,4 @@
+from imprint.cli import main
+
+if __name__ == "__main__":
+    main()

imprint_pdf-0.11.0/imprint/cli.py

@@ -0,0 +1,138 @@
+"""Imprint command-line interface."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from . import __version__
+from .converter import build_document, md_to_html
+from .fonts import missing_font_slots
+from .recommend import recommend_theme
+from .render import compress_pdf, render_pdf
+from .theme import theme_css
+from .themes import list_themes
+from .validator import validate_pdf
+
+
+def _enable_utf8_io() -> None:
+    """Windows consoles default to a legacy codepage; force UTF-8 output so
+    Chinese report text never crashes print()."""
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8", errors="replace")
+        except (AttributeError, ValueError):
+            pass
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="imprint",
+        description="AI 原生 · 印刷级中文 PDF 生成器：Markdown 进，出版社级 PDF 出，自带 0-100 印刷级质检报告。",
+    )
+    p.add_argument("input", nargs="?", default=None, help="输入 Markdown 文件（支持 frontmatter: title/author/date/subtitle/keywords/theme）")
+    p.add_argument("-o", "--output", default=None, help="输出 PDF 路径（默认 input.pdf）")
+    p.add_argument("--theme", default=None, help="主题名（默认读 frontmatter 或 modern）")
+    p.add_argument("--themes-dir", default=None, help="额外主题目录（*.json）")
+    p.add_argument("--no-validate", action="store_true", help="跳过印刷级质检")
+    p.add_argument("--report", default=None, help="把质检报告另存为 JSON")
+    p.add_argument("--compress", action="store_true", help="生成后激进压缩（清除冗余对象）")
+    p.add_argument("--no-pdf-ua", action="store_true", help="不输出 PDF/UA 标签版")
+    p.add_argument("--new", metavar="TEMPLATE", default=None, help="从模板生成新文档: report/book/resume/techdoc/letter")
+    p.add_argument("--list-templates", action="store_true", help="列出可用模板")
+    p.add_argument("--list-themes", action="store_true", help="列出可用主题")
+    p.add_argument("--version", action="version", version=f"imprint {__version__}")
+    return p
+
+
+def _new_document(template: str, out: Path | None) -> int:
+    from importlib.resources import files
+
+    tpl = template.removesuffix(".md")
+    path = Path(str(files("imprint.templates").joinpath(f"{tpl}.md")))
+    if not path.exists():
+        print(f"错误: 模板 {template} 不存在（可用: {list_templates()}）", file=sys.stderr)
+        return 1
+    target = out or Path(f"{tpl}.md")
+    target.write_text(path.read_text(encoding="utf-8"), encoding="utf-8")
+    print(f"已生成 {target}，渲染: imprint {target}")
+    return 0
+
+
+def list_templates() -> str:
+    from importlib.resources import files
+
+    tpl_dir = files("imprint.templates")
+    names = sorted(
+        p.name.removesuffix(".md")
+        for p in tpl_dir.iterdir()
+        if p.name.endswith(".md")
+    )
+    return " / ".join(names)
+
+
+def main(argv: list[str] | None = None) -> int:
+    _enable_utf8_io()
+    args = build_parser().parse_args(argv)
+    if args.list_templates:
+        print(list_templates())
+        return 0
+    if args.new:
+        return _new_document(args.new, Path(args.output) if args.output else None)
+    if args.list_themes:
+        for name in list_themes(args.themes_dir):
+            print(name)
+        return 0
+
+    if not args.input:
+        build_parser().print_help()
+        return 1
+    src = Path(args.input)
+    if not src.exists():
+        print(f"错误: 找不到输入文件 {src}", file=sys.stderr)
+        return 1
+
+    conv = md_to_html(src.read_text(encoding="utf-8"))
+    meta = conv.meta
+    theme_name = args.theme or (meta.get("theme") or "").strip().lower()
+    theme_note = None
+    if not theme_name:
+        theme_name, theme_note = recommend_theme(meta, conv.text)
+    css, theme = theme_css(theme_name, args.themes_dir)
+    if theme_note:
+        print(f"主题：{theme_name}（{theme_note}）")
+    html = build_document(conv)
+
+    for slot in missing_font_slots(theme):
+        print(f"警告: 主题 {theme_name} 的{slot}字体在本机不可用，已回退系统字体", file=sys.stderr)
+
+    out = Path(args.output) if args.output else src.with_suffix(".pdf")
+    out.parent.mkdir(parents=True, exist_ok=True)
+    pages = render_pdf(html, css, out, pdf_ua=not args.no_pdf_ua, base_url=src.parent)
+    if args.compress:
+        saved = compress_pdf(out)
+        print(f"已压缩，节省 {saved/1024:.0f} KB" if saved else "无图片可压缩，文件保持原样")
+
+    if args.no_validate:
+        print(f"已生成 {out}（{pages} 页，主题 {theme_name}）")
+        return 0
+
+    report = validate_pdf(
+        out,
+        toc_entries=[] if str(meta.get("layout") or "").strip().lower() == "gongwen" else [(i.text, i.href) for i in conv.toc],
+        serif_hint=meta.get("theme-font-hint") or "Songti",
+        theme_colors=theme["tokens"].get("color"),
+    )
+    print(report.print_table())
+    if args.report:
+        Path(args.report).write_text(
+            json.dumps(report.to_dict(), ensure_ascii=False, indent=2),
+            encoding="utf-8",
+        )
+    return 0 if report.score >= 80 else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())