A. 范围与运行契约

本技能专用于编写 HTML 并将其转换为印刷级 PDF。

主要输出目标：

• 在 Linux 运行时环境下实现稳定的分页与可预测的版面布局。
• 文本内容可搜索、可选中（禁止使用截图式降级方案）。
• 产出专业、引文安全的长篇幅文档。

B. 硬性约束（严禁违反）

B1. 转换入口点

对于 HTML→PDF 转换，仅允许使用 html_to_pdf。

禁止行为：

• 截图/打印模拟或手动浏览器打印
• 直接调用底层本地脚本执行转换

原因：图像拼接路径会损害文字质量，并导致分页不连续。

B2. 渲染安全规则

• 不得手动注入 Paged.js；运行时流水线已负责加载。
• 不得依赖 CSS 计数器（counter-reset、counter-increment、counter()）。
• 不得使用运行时图表引擎（ECharts、Chart.js、D3、Plotly 等）。
• 图表应预先渲染为静态图像，并优先采用横向宽高比（landscape aspect ratio）。
• 禁止使用装饰性 emoji / 图标字形，除非用户明确要求。

C. 意图解析

执行前须对任务进行意图分类：

澄清策略：

• 若请求明确，直接执行。
• 若存在歧义，仅通过一个精简的检查清单进行一次澄清：
  • 文档类型/主题
  • 是否需要封面
  • 字数或页数边界
  • 语言与格式偏好

重要澄清行为规范：

• 针对意图最多仅发起一轮澄清。
• 此后须基于显式假设执行，不得反复追问。

D. 内容治理

D1. 语言策略

• 中文用户查询 → 输出中文内容
• 英文用户查询 → 输出英文内容
• 用户指定语言 → 严格遵循

D2. 提纲策略

• 用户提供提纲 → 严格保留层级与顺序，禁止静默重构
• 未提供提纲 → 按文档类型自主选择结构，并保持叙述连贯性

D3. 引文完整性

• 严禁虚构参考文献。
• 每条引文均须可验证（作者/标题/年份/来源）。
• 重复引用同一来源时，须保持引文编号一致。

本技能推荐引文格式：IEEE 数字编号制（IEEE numeric）。

参考文献列表示例：

[1] R. Patel and L. Chen, "A comparative study on model routing," Journal of Applied AI, vol. 8, no. 3, pp. 44-58, 2025.
[2] M. Rivera, Systems Design Handbook, 2nd ed. New York, NY, USA: Northbridge Press, 2024.
[3] T. Huang, "Model evaluation checklist," Research Notes, https://example.org/eval (accessed Feb. 14, 2026).

E. 转换保真度检查清单

在转换已有材料（翻译/重写/格式化）时，须保持源内容保真度：

E1. 链接

• 保留原始 href 中的目标 URL。
• 不得将链接替换为纯文本。
• 确保转换调用中启用 preserve_links=true。

E2. 图像

采用三阶段校验：

1. 统计提取的图像资源数量
2. 统计 HTML 中 标签数量
3. 验证转换后图像统计信息

E3. 结构

• 保留源内容的章节顺序及锚点语义。
• 维持图表/表格的位置与编号意图。
• 若源内容无封面，则不得自动添加合成封面。

F. 实现蓝图

F1. 禁止模式

图表图像策略：

• 优先采用横向图表（width > height），以减少分页断点异常。

F2. 溢出防护（必需基线）

/* 保证可打印区块位于页面宽度内 */
pre, table, figure, img, svg, .diagram, blockquote, .eq-block {
  max-inline-size: 100%;
  box-sizing: border-box;
}

pre {
  overflow-x: auto;
  white-space: pre-wrap;
  overflow-wrap: anywhere;
}

figure img, figure svg {
  max-inline-size: 82%;
  max-block-size: 42vh;
  height: auto;
}

table { overflow-x: auto; }
.katex-display { overflow-x: auto; }
code { overflow-wrap: anywhere; }
a { overflow-wrap: anywhere; }
tr { break-inside: avoid; }

body {
  text-align: justify;
  text-align-last: start;
}

F3. 页面模型配置

@page {
  size: A4;
  margin: 2.4cm 1.9cm;
  @top-center { content: string(doc_title); }
  @bottom-center { content: counter(page); }
}

@page :first {
  @top-center { content: none; }
  @bottom-center { content: none; }
}

@page titlepage {
  @top-center { content: none; }
  @bottom-center { content: none; }
}

@page contents {
  @top-center { content: none; }
  @bottom-center { content: none; }
}

body { string-set: doc_title ""; }
h1 { string-set: doc_title content(); }
.cover-page { page: titlepage; }
.toc-sheet { page: contents; }

分页注意事项：

• 仅对紧凑单元（单个图表、单行、提示框等）应用 break-inside: avoid。
• 切勿对大型容器（章/节包装器）应用该属性。
• 对跨页表格，使用 thead { display: table-header-group; } 保证表头重复显示。

F4. 视觉导向

默认目标是 印刷学术风格（print-academic），而非仪表盘美学风格。

应避免：

• 厚重卡片外壳
• KPI 磁贴墙
• 深色装饰性标题栏
• 过度放大的圆角/阴影装饰元素

应优先采用：

• 简洁标题 + 细分割线
• 信息密度高的表格
• 克制的灰度配色方案
• 简洁、高对比度的字体排印

字号比例建议：

• 正文：11pt
• 副标题：14pt
• 一级标题：18–20pt
• 行高：1.6–1.7

F. 封面页规则

全出血基线样式：

*,
*::before,
*::after { box-sizing: border-box; }

html, body {
  margin: 0;
  padding: 0;
}

@page :first {
  margin: 0;
}

.cover-page {
  inline-size: 210mm;
  block-size: 297mm;
  position: relative;
  display: grid;
  place-items: center;
  overflow: hidden;
  break-after: page;
}

封面变体：

• 极简型：白色背景，标题/元信息居中，无任何装饰
• 设计型：低饱和度几何图形/渐变，中心区域留白供标题使用

若使用图像背景，请勿使用 CSS background-image；应使用绝对定位的 ：

  
  
...

.cover-photo {
  position: absolute;
  inset: 0;
  inline-size: 100%;
  block-size: 100%;
  object-fit: cover;
  object-position: center;
  z-index: 0;
}

.cover-layer {
  position: absolute;
  inset-block-start: 50%;
  inset-inline-start: 50%;
  transform: translate(-50%, -50%);
  z-index: 1;
}

F5. 编号、参考文献与目录（TOC）

使用标记中显式声明的标签，而非 CSS 计数器。

  
  



  ...

  
Latency by Scenario

$$f(x)=x^2+1$$

figcaption::before {
  content: attr(data-caption) " ";
  font-weight: 700;
}

caption::before {
  content: attr(data-caption) " ";
  font-weight: 700;
}

.eq-block::after {
  content: attr(data-eq);
  float: right;
}

锚点放置规则：

• 将 id 设置于最高层级逻辑容器（如 figure、table 或章节包装器），而非内联的标题文本上。

带自动计算页码的 TOC 示例：

.toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
}

.toc-list li { margin: 0.45em 0; }

.toc-list a {
  display: flex;
  gap: 0.5em;
  color: inherit;
  text-decoration: none;
}

.toc-list a::after {
  margin-inline-start: auto;
  content: target-counter(attr(href url), page);
}

可选的文中页码引用：

a.page-ref::after {
  content: " (p." target-counter(attr(href url), page) ")";
  opacity: 0.72;
  font-size: 0.86em;
}

F6. 公式与图表策略

• 数学公式使用 KaTeX 并启用自动渲染。
• 保持公式颜色中性且适合印刷输出。
• Mermaid 图表需保持拓扑结构简单；若渲染不稳定，应替换为静态图像。

F7. 可复用布局模式

定义块（definition block）：

.definition {
  border-inline-start: 3px solid #475569;
  padding-inline-start: 1rem;
  margin: 1rem 0;
}

.definition-title { font-weight: 700; }
.definition-body { font-style: italic; }

流程块（procedure block）：

.procedure {
  border: 1px solid #cbd5e1;
  padding: 0.75rem;
  background: #f8fafc;
}

固定尺寸居中徽章必须使用 Flexbox：

.badge-index {
  inline-size: 1.7em;
  block-size: 1.7em;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  border: 1px solid #cbd5e1;
  border-radius: 999px;
}

F8. 引文锚点与脚注

参考文献锚点一致性要求：

• 每个 [n] 必须唯一对应一个
• 。
• 不得存在悬空的参考文献 ID。

a.citation {
  color: #1f2937;
  text-decoration: none;
  vertical-align: super;
  font-size: 0.78em;
}

.ref-list li {
  padding-inline-start: 2em;
  text-indent: -2em;
}

分页式脚注模式：

.fn {
  float: footnote;
}

.fn::footnote-call {
  content: counter(footnote);
  vertical-align: super;
  font-size: 0.78em;
}

.fn::footnote-marker {
  content: counter(footnote) ". ";
}

@page {
  @footnote {
    margin-top: 1.1em;
    border-top: 1px solid #d1d5db;
    padding-top: 0.55em;
  }
}

F9. 布局调优指南

当页数或版面未达预期目标时，按以下优先级顺序调整：

G. 保真度关卡

最终交付前须运行全部关卡检查。

G1. 超链接

• 确保外部链接保留原始 href。
• 在转换调用中强制启用 preserve_links=true。

G2. 图像（三阶段校验）

1. 源文件图像提取数量（基准值）
2. HTML 中 标签数量及其映射关系
3. 转换后结果图像校验

G3. 锚点完整性

• 交叉引用必须指向真实存在的 ID。
• id 应置于顶层容器（figure、章节包装器等），而非内部文本节点。
• 对于 TOC 和页码引用，须使用支持打印感知的链接，并启用页码目标解析（target-counter）。

G4. 结构一致性（适用于转换类任务）

• 除非用户明确要求重构，否则须保持源内容的章节顺序。
• 若源内容无封面，不得自动插入封面页（除非用户明确要求）。