feat: export core Hermes skills

2026-07-15 02:45:56 +00:00
parent a028b63eda
commit 54711fee2a
308 changed files with 41310 additions and 1 deletions
@@ -0,0 +1,95 @@
+# 格式复核常见模式与数值参考
+
+## firstLine 缩进一致性
+
+不同合同模板的 firstLine 值不同，但同一合同内应一致。
+
+### 常见值
+- 政府示范文本（仿宋）：通常 firstLine=600（约 10.5pt 字号的两倍字符缩进）或 596/602（±2 的微小差异属正常）
+- 正文段落和条款标题通常使用相同的 firstLine 值
+- 数值偏差 > 20 即视为不一致
+
+### 2026-06-26 计生合同教训
+新增条款段落 firstLine=753，现有段落 firstLine=596/600/602。差值 153 twips ≈ 2.7mm，视觉上明显不一致。
+**根因**：editor 使用 `add_clause` 时段落属性从未正确匹配的相邻段落克隆。
+
+### 检查方法
+```python
+# 提取所有段落的 firstLine 值
+for i, p in enumerate(all_ps):
+    pPr = p.find(qn('pPr'))
+    if pPr is not None:
+        ind = pPr.find(qn('ind'))
+        if ind is not None:
+            fl = ind.get(qn('firstLine'))
+            if fl:
+                print(f"P{i}: firstLine={fl}")
+```
+将新增段落的 firstLine 与原文同级段落对比，超出 ±20 视为不一致。
+
+## 加粗（bold）一致性
+
+### 规则
+- 中文合同中"第X条"编号部分**始终加粗**（bold=True）
+- 条款标题文字（"第X条"之后的部分）可能加粗也可能不加粗，取决于原文模式
+- 新增条款标题的加粗应与**最近的原文条款标题**一致
+
+### 常见模式
+| 模式 | 示例 | 原文样式 |
+|------|------|----------|
+| 全加粗 | "第一条、项目名称、时间" | 整个 run bold=True |
+| 编号加粗 | "第七条、" bold + "项目费用" not bold | 编号 run 和标题 run 分开 |
+| 仅编号加粗 | "第八条" bold + "、违约责任" not bold | 编号和内容分开 |
+
+### 2026-06-26 计生合同教训
+新增 P31 "第九条、第三方侵权责任" 和 P33 "第十条、转包与分包" 整体 bold=False。但原文所有条款标题中"第X条"均为 bold=True。最近的原文标题 P29 "第八条" bold=True。
+
+### 检查方法
+对每个 WB INS 新增条款标题段落，检查其 INS run 的 rPr 中是否有 `<w:b/>` 或 `<w:b w:val="1"/>`。与最近的原文条款标题段落的 bold 状态对比。
+
+## hint='eastAsia' 属性
+
+### 规则
+中文文档的 WB INS run 的 rFonts 应有 `w:hint="eastAsia"`。缺失会导致某些渲染器回退到非 CJK 字体。
+
+### 2026-06-26 计生合同教训
+P35 INS "第十一条" 和 P37 INS "第十二条" 的 rFonts 缺少 hint 属性。其他所有 WB INS run 均有 hint='eastAsia'。
+
+### 检查方法
+```python
+for ins in body.iter(qn('ins')):
+    if ins.get(qn('author')) != 'WB':
+        continue
+    for r in ins.findall(qn('r')):
+        rpr = r.find(qn('rPr'))
+        if rpr is None:
+            continue
+        rfonts = rpr.find(qn('rFonts'))
+        if rfonts is not None:
+            hint = rfonts.get(qn('hint'))
+            if hint != 'eastAsia':
+                # 标记为缺失
+```
+
+## x2t 视觉验证的局限性
+
+### 字体回退
+OnlyOffice 容器（`nextcloud-onlyoffice-1`）可能未安装合同使用的字体。当 x2t 找不到指定字体时：
+- 所有文本回退到 WenQuanYi Zen Hei Mono（等宽 CJK 字体）
+- **加粗状态无法通过 x2t PDF 验证**——回退字体下 bold 始终为 False
+- 字体族名称也无法验证——所有文本显示为同一回退字体
+
+### 适用场景
+x2t 仍可用于验证：
+- 内容完整性（文本是否缺失、是否被截断）
+- 分页和布局
+- 段落是否存在（标题/正文分离检查）
+- 文本溢出（截断警告）
+
+### 不适用场景
+x2t **不能**用于验证：
+- 字体族（仿宋/宋体/黑体）
+- 加粗/斜体
+- 字号精确值
+
+**字体和格式属性必须以 XML 为准。**