gongwen-skill 2.0.0 → 2.2.0

package/.dsh/skills/gongwen-skill/SKILL.md

@@ -14,10 +14,9 @@ metadata:
 ---
 
 <!--
-公文文档格式化 Skill
-(c) 2026 Jose AI (https://www.linhut.cn)
-项目出处：AI 公文智能优化助手（https://github.com/linhut/document-ai-assistant）
-Licensed under the MIT License. See the LICENSE file for details.
+  (c) 2026 Jose AI (https://www.linhut.cn)
+  https://github.com/linhut/gongwen-skill
+  Licensed under the MIT License. See the LICENSE file for details.
 -->
 
 # 公文文档格式化 Skill（GB/T 9704）

package/.dsh/skills/gongwen-skill.md

@@ -14,10 +14,9 @@ metadata:
 ---
 
 <!--
-公文文档格式化 Skill
-(c) 2026 Jose AI (https://www.linhut.cn)
-项目出处：AI 公文智能优化助手（https://github.com/linhut/document-ai-assistant）
-Licensed under the MIT License. See the LICENSE file for details.
+  (c) 2026 Jose AI (https://www.linhut.cn)
+  https://github.com/linhut/gongwen-skill
+  Licensed under the MIT License. See the LICENSE file for details.
 -->
 
 # 公文文档格式化 Skill（GB/T 9704）

package/CHANGELOG.md

@@ -1,3 +1,44 @@
+<!--
+  (c) 2026 Jose AI (https://www.linhut.cn)
+  https://github.com/linhut/gongwen-skill
+  Licensed under the MIT License. See the LICENSE file for details.
+-->
+
+## v2.2.0 (2026-08-28)
+
+### Added
+- **内容要素检查规则真正生效**：修复 37 条 `content.*` 规则（通知事项/会议要素/请示理由等）此前"定义但从不执行"的问题，新增 `_check_content_field` 按字段名映射要素关键词做宽松检查，消除每次 check 的"未支持检查字段"告警
+- **版头检查规则生效**：修复 `header.*` 规则（CHK-CM002 令号检查、CHK-R003 主送机关检查）此前无分发分支的问题，新增 `_check_header_field`
+- **成文日期"右空四字"**：md2docx 渲染日期段新增右缩进 4em（GB/T 9704 规范），消除 CHK-C017 长期存在的日期右空四字检查项
+
+### Changed
+- **signature 段落选择器修正**：`_select_paragraphs` 的 `signature` target 不再包含 `date` 段落——修复 FIX-C013（署名居中）与 FIX-C013b（18pt）误把成文日期强制居中/放大字号的问题，日期段独立按"右对齐 + 右空四字 + 16pt"处理
+- **页码重复注入幂等化**：`_inject_even_page_footer_direct` 重写为幂等版，多次注入仅保留一个 even footerReference 与完整关系，杜绝 Word 打开报"文档损坏"（BUG-1）
+- **加粗+链接/代码组合不再整段加粗**：markdown_converter 单片段按自身 bold 标志处理，重建片段继承原 run 字体字号（BUG-2）
+- **标题启发式误判修复**：黑体/楷体/仿宋加粗正文句不再误判为标题（新增 `_SENTENCE_END` 句末标点保护，Level 1/2/3 三级判定）
+- **CHK-C030 整段加粗误报修复**：忽略纯标点 run、单句段落不报，多句整段加粗仍正确检出
+
+### Fixed
+- `is_title` vs `is_heading` 属性引用错误：`_check_ending`/`_check_content_field` 此前用不存在的 `is_title` 属性，导致标题段被误纳入正文统计
+- 一是/二是 领句段改用仿宋_GB2312（原误用楷体触发标题误判/正文字体误报）
+- 令号正则 `\d` 被 JS 转义破坏（`d`），导致含令号命令误报 CHK-CM002
+
+## v2.1.0 (2026-08-20)
+
+### Added
+- **格式规则完善**：为 24 种公文类型新增 30+ 条 check/fix 规则，提升规则覆盖率
+  - `news.yaml`：从 0 条规则扩展至 5 条（导语段/稿源信息/标题风格/标题字数/听取通报段检查）
+  - `notice.yaml`：新增标题格式和通知事项检查
+  - `communique.yaml`：新增公报签署和标题格式检查
+  - 12 个原只有 2 条规则的类型各新增 1 条检查规则（bill/bulletin/instruction/meeting/minutes/opinion/regulation/reply/report/resolution/summary/work_plan）
+- **版本发布清单**：RELEASE.md 扩展版本号检查点从 4 处代码→9 处（含文档/提示词/DSH 桥接）
+- **pre-commit hook**：`.githooks/pre-commit` 自动检查 4 处代码版本号一致性，阻止版本漂移的提交
+- **动态 PyPI 徽章**：README.md 的 PyPI 徽章改为动态版本号（`https://img.shields.io/pypi/v/gongwen-skill`），自动显示最新版本
+
+### Changed
+- RELEASE.md 全面更新：修复 12 处残留 1.12.x 引用，更新 npm 发布状态，新增 pre-commit hook 说明
+- 规则文件统一添加 `template_name` 和 `document_type` 字段（news.yaml 补齐）
+
 ## v2.0.0 (2026-08-20)
 
 ### Major

package/README.md

@@ -1,5 +1,6 @@
 <!--
 (c) 2026 Jose AI (https://www.linhut.cn)
+https://github.com/linhut/gongwen-skill
 Licensed under the MIT License. See the LICENSE file for details.
 -->
 
@@ -12,7 +13,7 @@ Licensed under the MIT License. See the LICENSE file for details.
 > 中文公文全流程处理工具——基于 **GB/T 9704《党政机关公文格式》** 国家标准，支持 **格式检查与修复、内容优化（Word 原生修订+批注/差异对比版）、模板生成、Markdown 转公文、版头版记页码注入、事实核验、风格增强** 等完整能力。原生支持 **DeepSeek Harness (DSH)** 技能系统，打包为可被 AI Agent 直接调用的 Skill，完全自包含，克隆即用。
 
 [![CI](https://img.shields.io/badge/CI-Passing-brightgreen)](https://github.com/linhut/gongwen-skill/actions)
-[![PyPI](https://img.shields.io/badge/PyPI-v2.0.0-blue)](https://pypi.org/project/gongwen-skill/)
+[![PyPI](https://img.shields.io/pypi/v/gongwen-skill)](https://pypi.org/project/gongwen-skill/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 ![Python](https://img.shields.io/badge/Python-3.10%2B-blue.svg)
 ![GB/T 9704](https://img.shields.io/badge/standard-GB%2FT%209704-red.svg)
@@ -336,7 +337,7 @@ DSH 采用 **Cordis 模块化微内核架构**：技能体系基于本地文件
 git clone https://github.com/linhut/gongwen-skill.git
 cd gongwen-skill
 pip install -r requirements.txt   # 或 pip install gongwen-skill（已上 PyPI）
-python -m gongwen --version       # 检验：gongwen-skill v2.0.0
+python -m gongwen --version       # 检验：gongwen-skill v2.2.0
 ```
 
 ### 方式一：作为 DSH Skill 注册（基于本地文件系统）
@@ -392,7 +393,7 @@ pnpm add -w gongwen-skill
   "dependencies": {
     "@deepseek-ai/dsh-base": "...",
     "@deepseek-ai/dsh-web-app": "...",
-    "gongwen-skill": "^2.0.0"
+    "gongwen-skill": "^2.2.0"
   },
   "dsh": {
     "profile": {
@@ -447,9 +448,9 @@ dsh --profile web
 | CLI 独立可执行（`python -m gongwen <命令>`） | ✅ |
 | PyPI 上架（`pip install gongwen-skill`） | ✅ |
 | 零外部运行时依赖（仅 python-docx/pydantic/pyyaml） | ✅ |
-| DSH 配置化排版参数（页边距/行距/字体/默认模板版本） | ✅ v2.0.0+ |
+| DSH 配置化排版参数（页边距/行距/字体/默认模板版本） | ✅ v2.2.0+ |
 
-### DSH 插件配置化（v2.0.0+）
+### DSH 插件配置化（v2.2.0+）
 
 DSH 插件支持通过配置文件管理排版参数，Agent 调用时自动注入，纯 CLI 用户不受影响。
 
@@ -573,7 +574,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.0.0（多渠道自检已确认最新）
+Skill 版本: v2.2.0（多渠道自检已确认最新）
 路径判定: B（内容优化）
 依据: 用户指定了已有文档，且要求"优化措辞"
 命令调用: 1. python -m gongwen optimize-content 会议通知.docx --changes changes.json --apply --paragraphs "5-8"

package/SKILL.md

@@ -14,10 +14,9 @@ metadata:
 ---
 
 <!--
-公文文档格式化 Skill
-(c) 2026 Jose AI (https://www.linhut.cn)
-项目出处：AI 公文智能优化助手（https://github.com/linhut/document-ai-assistant）
-Licensed under the MIT License. See the LICENSE file for details.
+  (c) 2026 Jose AI (https://www.linhut.cn)
+  https://github.com/linhut/gongwen-skill
+  Licensed under the MIT License. See the LICENSE file for details.
 -->
 
 # 公文文档格式化 Skill（GB/T 9704）

package/cordis.patch.yml

@@ -1,3 +1,7 @@
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+
 # dsh bundle layer: 公文全流程处理工具 (gongwen-skill, host + client)
 - insert:
     - id: gongwen-skill

package/dsh/client.js

@@ -1,5 +1,7 @@
 // 公文全流程处理工具 DSH client — 可视化配置面板（gongwen-skill，不做皮肤，仅设置面板）
-// (c) 2026 Jose AI (https://www.linhut.cn)  MIT License
+// (c) 2026 Jose AI (https://www.linhut.cn)
+// https://github.com/linhut/gongwen-skill
+// Licensed under the MIT License. See the LICENSE file for details.
 //
 // 在 DSH Web GUI 系统设置 → 插件配置 中渲染公文排版参数编辑界面。
 // 通过 /plugins/gongwen-skill/api/config (GET/POST) 与宿主端通信。

package/dsh/index.js

@@ -1,5 +1,7 @@
-// 公文全流程处理工具 - DSH plugin bridge (gongwen-skill, v2.0.0+)
-// (c) 2026 Jose AI (https://www.linhut.cn)  MIT License
+// 公文全流程处理工具 - DSH plugin bridge (gongwen-skill, v2.2.0+)
+// (c) 2026 Jose AI (https://www.linhut.cn)
+// https://github.com/linhut/gongwen-skill
+// Licensed under the MIT License. See the LICENSE file for details.
 //
 // 分层架构：
 // - Python CLI：纯工具层，通过 --config-overrides 接收规则覆盖 JSON

package/engine/__init__.py

@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 #
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 #
 # engine 包初始化文件

package/engine/auto_optimizer.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 内置 LLM 内容优化建议生成（v1.12.30 内容优化架构改进方案 改进 E）。
 

package/engine/chat_review.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 ChatReview —— 审稿意见对话提示模板。
 

package/engine/config.py

@@ -3,6 +3,7 @@
 # 公文文档格式化 Skill —— 独立引擎配置
 #
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 #
 # 本文件为独立发行版专用配置，替代原项目中依赖 PyInstaller / Electron /

package/engine/core/__init__.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 engine 包：独立发行版引擎核心。

package/engine/core/document/__init__.py

@@ -1,3 +1,4 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.

package/engine/core/document/_generator_helpers.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 Generator helper functions: table and page number field creation.
 Extracted from generator.py (tier-2 split).

package/engine/core/document/ai_structure_analyzer.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 AI Structure Analyzer — 基于AI的文档结构智能分析

package/engine/core/document/annotator.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 Word 原生批注注入器 —— 将内容优化建议以 <w:comment> 形式写入 .docx。
 

package/engine/core/document/editor.py

@@ -1,3 +1,9 @@
+# -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 Content revision engine for official document optimization.
 Produces comparison documents showing original vs revised content

package/engine/core/document/font_utils.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 Font utilities: Handle Chinese font settings correctly for Word documents.

package/engine/core/document/generator.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 Document generator: converts DocumentModel back into a .docx file.

package/engine/core/document/markdown_converter.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 Markdown → DocumentModel 转换器。
 从 modifier.py 提取（阶梯2 拆分）。
@@ -46,6 +51,32 @@ _MD_CODE_BLOCK_RE = re.compile(r'^`{3,}')
 # 行内代码 `code`
 _MD_INLINE_CODE_RE = re.compile(r'`([^`]+)`')
 
+# 加粗标记（**text** 或 __text__）
+_MD_BOLD_SEG_RE = re.compile(r'(\*\*[^*]+\*\*|__[^_]+__)')
+
+
+def _reconstruct_bold_segments(raw: str, cleaned: str):
+    """把含 **..** 的原始文本映射为 [(文本, 是否加粗), ...] 片段。
+
+    片段拼接结果与 cleaned 一致时才返回片段列表；否则（含链接/代码等被清理、
+    或文本被折叠）回退为整段（避免丢失文本）。
+    """
+    if not raw or ('**' not in raw and '__' not in raw):
+        return [(cleaned or "", False)]
+    segments = []
+    for part in _MD_BOLD_SEG_RE.split(raw):
+        if not part:
+            continue
+        if part.startswith('**') and part.endswith('**') and len(part) > 4:
+            segments.append((part[2:-2], True))
+        elif part.startswith('__') and part.endswith('__') and len(part) > 4:
+            segments.append((part[2:-2], True))
+        else:
+            segments.append((part, False))
+    if ''.join(s[0] for s in segments).strip() == (cleaned or "").strip():
+        return segments
+    return [(cleaned or "", False)]
+
 
 def convert_markdown(model: DocumentModel) -> int:
     """
@@ -196,6 +227,7 @@ def convert_markdown(model: DocumentModel) -> int:
         # --- 识别加粗标记 **text** ---
 
         has_bold = False
+        raw_before_bold = text  # 保存剥离 ** 前的原始文本，用于加粗段重构
         if _MD_BOLD_RE.search(text) or _MD_BOLD_UNDER_RE.search(text):
             has_bold = True
             text = _MD_BOLD_RE.sub(r'\1', text)
@@ -252,8 +284,35 @@ def convert_markdown(model: DocumentModel) -> int:
                         r.text = ""
 
                 if has_bold and not para.is_heading:
-                    for r in para.runs:
-                        r.format.bold = True
+                    # 仅加粗 **..** 标记的片段，避免整段误加粗（CHK-C030 修复）
+                    _segments = _reconstruct_bold_segments(raw_before_bold, para.text)
+                    if len(_segments) > 1:
+                        # 重建片段时继承原 run 的字体/字号，避免丢失字体（I20 修复）
+                        _base_format = None
+                        for _r in para.runs:
+                            if _r.text and (_r.format.font_name or _r.format.font_size_pt):
+                                _base_format = _r.format
+                                break
+                        _new_runs = []
+                        for _t, _b in _segments:
+                            if not _t:
+                                continue
+                            _nr = Run(index=len(_new_runs), text=_t,
+                                      format=RunFormat(
+                                          font_name=_base_format.font_name if _base_format else None,
+                                          font_size_pt=_base_format.font_size_pt if _base_format else 16.0,
+                                      ))
+                            if _b:
+                                _nr.format.bold = True
+                            _new_runs.append(_nr)
+                        para.runs = _new_runs
+                    else:
+                        # 单片段：按其自身 bold 标志处理——纯粗体段（**全段**）整段加粗；
+                        # raw/cleaned 不匹配回退的单片段 bold=False 保持不加粗（I20 修复：
+                        # 此前把回退也整段加粗，导致"加粗+链接/代码"段落整段变粗）
+                        if _segments and _segments[0][1]:
+                            for r in para.runs:
+                                r.format.bold = True
 
                 if is_list and list_indent_pt > 0 and not para.is_heading:
                     para.format.left_indent_pt = list_indent_pt

package/engine/core/document/models.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 Pydantic data models for the intermediate document representation.

package/engine/core/document/modifier.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 Document modifier: the single source of truth for all DocumentModel mutations.
@@ -73,19 +74,33 @@ def _select_paragraphs(model: DocumentModel, target: str) -> list[Paragraph]:
         return [p for p in model.paragraphs
                 if not p.is_heading and p.text.strip() and id(p) not in sig_set]
     elif target == "signature":
-        # 优先使用 role 字段
-        role_sig = [p for p in model.paragraphs if p.role in ('signature', 'date')]
+        # P2-24 修复：signature target 只匹配署名段（role='signature'），不再包含 date——
+        # 此前匹配 role in ('signature','date') 会把落款日期段一并选中，
+        # 导致 FIX-C013（署名居中）把日期改成 center、FIX-C013b（18pt）把日期改成 18pt，
+        # 违反 GB/T 9704 成文日期"右空四字、三号仿宋(16pt)"的规范。
+        # 日期段由 target="date" 分支独立处理（右对齐 + right_indent 保留）。
+        role_sig = [p for p in model.paragraphs if p.role == 'signature']
         if role_sig:
             return role_sig
-        non_empty = [p for p in model.paragraphs if p.text.strip()]
-        return non_empty[-2:] if len(non_empty) >= 2 else non_empty
+        # 仅当无署名 role 时，才允许位置回退（末两段：署名+日期）；
+        # 回退时仍只修署名语义的段落，不影响日期段对齐
+        non_empty = [p for p in model.paragraphs if p.text.strip() and p.role != 'date']
+        if len(non_empty) >= 2:
+            last = non_empty[-1].text.strip()
+            if re.match(r'^\d{4}年\d{1,2}月\d{1,2}日$', last) or re.match(r'^\d{4}[.\-/]\d{1,2}[.\-/]\d{1,2}$', last):
+                return non_empty[-1:]
+        return []
     elif target == "date":
         # 同 signature 的处理逻辑
         role_date = [p for p in model.paragraphs if p.role == 'date']
         if role_date:
             return role_date
         non_empty = [p for p in model.paragraphs if p.text.strip()]
-        return non_empty[-1:] if non_empty else []
+        if non_empty:
+            last = non_empty[-1].text.strip()
+            if re.match(r'^\d{4}年\d{1,2}月\d{1,2}日$', last) or re.match(r'^\d{4}[.\-/]\d{1,2}[.\-/]\d{1,2}$', last):
+                return non_empty[-1:]
+        return []
     elif target in ('salutation', 'introduction', 'transition', 'meeting_date', 'numbered_body'):
         # N2: 段落类型 target —— 使用 detect_paragraph_type 内容匹配
         return [p for p in model.paragraphs if detect_paragraph_type(p.text, p.role) == target]

package/engine/core/document/ooxml_parser.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 OOXML 原生文档解析器 —— 解决 python-docx 的局限。
 

package/engine/core/document/ooxml_workflow.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 OOXML 解包-编辑-打包工作流。
 

package/engine/core/document/parser.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 Document parser: converts a .docx file into DocumentModel.
@@ -50,6 +51,10 @@ _H1_WESTERN_PATTERN = re.compile(r'^[IVXLCDM]+\.\s+')
 _H2_WESTERN_PATTERN = re.compile(r'^[A-Z]\.\s+')
 _H4_WESTERN_PATTERN = re.compile(r'^[a-z]\.\s+')
 
+# 句末标点（P2-16 修复：标题不以这些标点结尾，正文强调句/引用句通常会以它们结尾，
+# 用于排除"黑体/楷体/仿宋加粗的正文短句"被误判为标题）
+_SENTENCE_END = ('。', '！', '？', '：', '；', '，', '.', '!', '?', ':', ';', ',')
+
 
 def _detect_heading_heuristic(
     text: str, runs: list[Run], para_format: ParagraphFormat
@@ -102,7 +107,13 @@ def _detect_heading_heuristic(
 
     # --- Level 1: 一级标题（黑体）---
     if has_font_signal and ("黑体" in font_lower or font_lower in ("simhei",)):
-        if alignment == "center" or is_bold or len(text_stripped) < 30:
+        # P2-16 修复：排除以句末标点结尾的正文强调句（如"重要提示：…"）。
+        # 一级标题通常较短且不以句号/冒号等结尾。
+        if alignment == "center":
+            return True, 1
+        if len(text_stripped) < 30 and not text_stripped.endswith(_SENTENCE_END):
+            return True, 1
+        if is_bold and not text_stripped.endswith(_SENTENCE_END):
             return True, 1
 
     # 格式信号："一、" + 加粗或黑体
@@ -114,9 +125,15 @@ def _detect_heading_heuristic(
     if _H1_WESTERN_PATTERN.match(text_stripped) and len(text_stripped) < 50:
         return True, 1
 
-    # --- Level 2: 二级标题（楷体 + 加粗）---
-    if has_font_signal and ("楷体" in font_lower or font_lower in ("kaiti", "楷体_gb2312")) and is_bold:
-        return True, 2
+    # --- Level 2: 二级标题（楷体，无需加粗）---
+    # GB/T 9704 二级标题为楷体，不加粗。若段落字体为楷体（含 楷体_GB2312），
+    # 即使内容为 "2.1" 等数字编号，也优先识别为二级标题而非三级标题，
+    # 避免 converter 的 "###"→二级标题与 check 的 "2.1"→三级标题启发式冲突。
+    # P2-16 修复：增加"不以句末标点结尾"约束，排除正文楷体引用句
+    # （如"会议指出，…。"）被误判为二级标题。
+    if has_font_signal and ("楷体" in font_lower or font_lower in ("kaiti", "楷体_gb2312")):
+        if len(text_stripped) < 40 and not text_stripped.endswith(_SENTENCE_END):
+            return True, 2
 
     # "（一）" 格式（无论字体如何，此模式足够唯一）
     if _H2_PATTERN.match(text_stripped) and len(text_stripped) < 50:
@@ -127,7 +144,8 @@ def _detect_heading_heuristic(
 
     # --- Level 3: 三级标题（仿宋加粗 或 "1." + 加粗）---
     if has_font_signal and ("仿宋" in font_lower or font_lower in ("fangsong", "仿宋_gb2312")) and is_bold:
-        if len(text_stripped) < 50:
+        # P2-16 修复：排除以句末标点结尾的仿宋加粗正文短句被误判为三级标题
+        if len(text_stripped) < 50 and not text_stripped.endswith(_SENTENCE_END):
             return True, 3
 
     if _H3_PATTERN.match(text_stripped) and is_bold and len(text_stripped) < 60:
@@ -339,6 +357,13 @@ def _assign_paragraph_roles(paragraphs: list[Paragraph]) -> None:
         if not para.role and _ATTACHMENT_RE.match(para.text.strip()):
             para.role = 'attachment'
 
+    # AI 声明段（末尾批注，如"（内容由GongWen-skill-AI生成，仅供参考）"）
+    # 标记为 annotation 角色，避免 check 将其误判为正文并报格式违规
+    _AI_DECL_MARKERS = ("由GongWen-skill-AI生成", "由AI生成", "仅供参考")
+    for idx, para in non_empty:
+        if not para.role and any(m in para.text for m in _AI_DECL_MARKERS):
+            para.role = 'annotation'
+
     # 其余非空段落默认为 body
     for idx, para in non_empty:
         if not para.role:

package/engine/core/document/parser_format.py

@@ -1,3 +1,9 @@
+# -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 Format and run-level parsing helpers for the Document Parser.
 

package/engine/core/document/reviewer_comments.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 五角色审稿批注嵌入 —— 将审稿意见以不同作者的 Word 批注嵌入文档。
 

package/engine/core/document/structure_analyzer.py

@@ -1,5 +1,6 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.
 """
 文档结构分析器 - 智能识别文档结构

package/engine/core/document/tracked_annotator.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 tracked + comments 单次 ZIP 注入器（优化方案 v4.0 F2/F4）。
 

package/engine/core/document/tracked_changes.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 修订追踪支持 —— Word 原生 <w:ins>/<w:del> 修订标记。
 

package/engine/core/document/tracked_common.py

@@ -1,4 +1,9 @@
 # -*- coding: utf-8 -*-
+#
+# (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
+# Licensed under the MIT License. See the LICENSE file for details.
+#
 """
 tracked 修订公共工具（P2-10 修复：消除 tracked_changes / tracked_annotator 重复代码）。
 

package/engine/core/rules/__init__.py

@@ -1,3 +1,4 @@
 # This file is part of the Official Document AI Assistant.
 # (c) 2026 Jose AI (https://www.linhut.cn)
+# https://github.com/linhut/gongwen-skill
 # Licensed under the MIT License. See the LICENSE file for details.