gongwen-skill 2.6.1 → 2.8.0

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

@@ -103,6 +103,7 @@ metadata:
    ```
    - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
    - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
+   - GitHub 不可达且触发 DNS 诊断时（系统解析为保留/Fake-IP 段），`check-update --json` 会输出 `dns_diagnosis` 字段（含 `hosts_suggestions`），如实向用户转述排查建议即可
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -258,21 +259,23 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ## 用户交互指引（Agent 必须遵守）
 
+> **终端用户也可直接运行 `python -m gongwen wizard`**：交互式向导以菜单方式完成同样的 A/B/C/D 路径选择与逐步确认（详见下文「向导式交互」小节）。Agent 读到本条时，若用户表示「不熟悉命令/不想记参数」，应主动引导其使用向导，而非逐字念命令行参数。
+
 ### 第一步：确认路径（必须，严禁跳过）
 
-用通俗语言问用户走哪条路，**不允许跳过**：
+用通俗语言问用户走哪条路，**不允许跳过**。向导模式与对话模式共用同一套路径：
 
 > 这个工具支持四种处理方式：
-> - **格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
-> - **内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
-> - **生成模板**：直接生成一份空白公文模板，按国标设好版式
-> - **一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
+> - **A. 格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
+> - **B. 内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
+> - **C. 生成模板**：直接生成一份空白公文模板，按国标设好版式
+> - **D. 一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -280,6 +283,29 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ---
 
+### 向导式交互（`wizard` 命令）
+
+当用户**不熟悉命令行**、希望**逐步确认后再执行**，或 Agent 需要**把交互决策委托给工具**时，使用向导：
+
+```
+python -m gongwen wizard                        # 终端交互：菜单选 A/B/C/D → 逐项填参 → 预览确认 → 执行
+python -m gongwen wizard --answers 答案.json     # Agent 非交互：跳过提问直接执行
+python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行的命令，不真正执行
+```
+
+- **路径菜单**：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）
+- **交互流程**：选择路径 → 收集参数（公文类型支持 序号 / id / 中文名，如 `1`、`notice`、`通知`）→ A/B/D 先预览再 y/n 确认 → 执行；C 无修改风险直接执行
+- **`--answers` JSON 扁平结构**（Agent 场景，顶层带 `path`）：
+  ```json
+  {"path": "A", "input": "原文.docx", "doc_type": "notice", "output": "成品.docx", "apply": true}
+  ```
+  - 字段缺失：非交互模式直接报错并列出缺失项（不静默、不进交互菜单）
+  - 不写 `apply` 时 A/B/D **仅预览不执行**（安全默认）；`apply: true` 跳过确认直接执行
+  - 非交互执行机制：`subprocess` 调用 `sys.executable -m gongwen <子命令>`，输出流式透传，Agent 可直接解析子命令原始输出
+- **`--dry-run`**：只打印将执行的命令；A/B 会同时打印「预览」与「执行」两条命令，便于 Agent 预演与调试
+
+---
+
 ## 执行标准总则（所有路径共享）
 
 ### Agent 行为准则
@@ -295,7 +321,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -846,10 +872,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 
 ---
 
-## 附录：全部命令速查（24 个，按用途分组）
+## 附录：全部命令速查（25 个，按用途分组）
 
 > Agent 遇到用户需求时，先在此表定位对应命令；命令用法不明确时运行 `python -m gongwen <命令> --help` 查看完整参数。
 
+### 🧭 向导式交互
+
+| 命令 | 用途 | 最小用法 |
+|------|------|---------|
+| `wizard` | 交互式路径引导（A/B/C/D）+ 一键执行；Agent 用 `--answers` 非交互 / `--dry-run` 只打印命令 | `python -m gongwen wizard` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -894,15 +926,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 | `table-signs` | 从名单批量生成会议桌签 | `python -m gongwen table-signs 名单.txt -o 桌签.docx` |
 | `review` | 生成公文审稿流转单（五/三角色） | `python -m gongwen review report -o 审稿单.docx` |
 | `handoff` | 跨会话交接（长任务收尾必写） | `python -m gongwen handoff --write` |
-| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
-| `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态；GitHub 不可达时 DNS 诊断） | `python -m gongwen check-update` |
+| `font` | 公文标准字体管理（安装/检查/列出；下载失败时自动安全 DNS 直连兜底） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复
 
 | 命令 | 用途 | 最小用法 |
 |------|------|---------|
-| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格等 | `python -m gongwen doctor` |
+| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格/网络 DNS 等 | `python -m gongwen doctor` |
 | `doctor --json` | JSON 结构化输出（便于 Agent 解析） | `python -m gongwen doctor --json` |
+| `doctor --offline` | 跳过网络/DNS 诊断（离线模式） | `python -m gongwen doctor --offline` |
 | `repair` | 修复常见问题：安装缺失依赖/字体/同步 SKILL.md 副本 | `python -m gongwen repair` |
 
 ### ⚙️ 规则管理

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

@@ -103,6 +103,7 @@ metadata:
    ```
    - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
    - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
+   - GitHub 不可达且触发 DNS 诊断时（系统解析为保留/Fake-IP 段），`check-update --json` 会输出 `dns_diagnosis` 字段（含 `hosts_suggestions`），如实向用户转述排查建议即可
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -258,21 +259,23 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ## 用户交互指引（Agent 必须遵守）
 
+> **终端用户也可直接运行 `python -m gongwen wizard`**：交互式向导以菜单方式完成同样的 A/B/C/D 路径选择与逐步确认（详见下文「向导式交互」小节）。Agent 读到本条时，若用户表示「不熟悉命令/不想记参数」，应主动引导其使用向导，而非逐字念命令行参数。
+
 ### 第一步：确认路径（必须，严禁跳过）
 
-用通俗语言问用户走哪条路，**不允许跳过**：
+用通俗语言问用户走哪条路，**不允许跳过**。向导模式与对话模式共用同一套路径：
 
 > 这个工具支持四种处理方式：
-> - **格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
-> - **内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
-> - **生成模板**：直接生成一份空白公文模板，按国标设好版式
-> - **一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
+> - **A. 格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
+> - **B. 内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
+> - **C. 生成模板**：直接生成一份空白公文模板，按国标设好版式
+> - **D. 一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -280,6 +283,29 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ---
 
+### 向导式交互（`wizard` 命令）
+
+当用户**不熟悉命令行**、希望**逐步确认后再执行**，或 Agent 需要**把交互决策委托给工具**时，使用向导：
+
+```
+python -m gongwen wizard                        # 终端交互：菜单选 A/B/C/D → 逐项填参 → 预览确认 → 执行
+python -m gongwen wizard --answers 答案.json     # Agent 非交互：跳过提问直接执行
+python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行的命令，不真正执行
+```
+
+- **路径菜单**：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）
+- **交互流程**：选择路径 → 收集参数（公文类型支持 序号 / id / 中文名，如 `1`、`notice`、`通知`）→ A/B/D 先预览再 y/n 确认 → 执行；C 无修改风险直接执行
+- **`--answers` JSON 扁平结构**（Agent 场景，顶层带 `path`）：
+  ```json
+  {"path": "A", "input": "原文.docx", "doc_type": "notice", "output": "成品.docx", "apply": true}
+  ```
+  - 字段缺失：非交互模式直接报错并列出缺失项（不静默、不进交互菜单）
+  - 不写 `apply` 时 A/B/D **仅预览不执行**（安全默认）；`apply: true` 跳过确认直接执行
+  - 非交互执行机制：`subprocess` 调用 `sys.executable -m gongwen <子命令>`，输出流式透传，Agent 可直接解析子命令原始输出
+- **`--dry-run`**：只打印将执行的命令；A/B 会同时打印「预览」与「执行」两条命令，便于 Agent 预演与调试
+
+---
+
 ## 执行标准总则（所有路径共享）
 
 ### Agent 行为准则
@@ -295,7 +321,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -846,10 +872,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 
 ---
 
-## 附录：全部命令速查（24 个，按用途分组）
+## 附录：全部命令速查（25 个，按用途分组）
 
 > Agent 遇到用户需求时，先在此表定位对应命令；命令用法不明确时运行 `python -m gongwen <命令> --help` 查看完整参数。
 
+### 🧭 向导式交互
+
+| 命令 | 用途 | 最小用法 |
+|------|------|---------|
+| `wizard` | 交互式路径引导（A/B/C/D）+ 一键执行；Agent 用 `--answers` 非交互 / `--dry-run` 只打印命令 | `python -m gongwen wizard` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -894,15 +926,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 | `table-signs` | 从名单批量生成会议桌签 | `python -m gongwen table-signs 名单.txt -o 桌签.docx` |
 | `review` | 生成公文审稿流转单（五/三角色） | `python -m gongwen review report -o 审稿单.docx` |
 | `handoff` | 跨会话交接（长任务收尾必写） | `python -m gongwen handoff --write` |
-| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
-| `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态；GitHub 不可达时 DNS 诊断） | `python -m gongwen check-update` |
+| `font` | 公文标准字体管理（安装/检查/列出；下载失败时自动安全 DNS 直连兜底） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复
 
 | 命令 | 用途 | 最小用法 |
 |------|------|---------|
-| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格等 | `python -m gongwen doctor` |
+| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格/网络 DNS 等 | `python -m gongwen doctor` |
 | `doctor --json` | JSON 结构化输出（便于 Agent 解析） | `python -m gongwen doctor --json` |
+| `doctor --offline` | 跳过网络/DNS 诊断（离线模式） | `python -m gongwen doctor --offline` |
 | `repair` | 修复常见问题：安装缺失依赖/字体/同步 SKILL.md 副本 | `python -m gongwen repair` |
 
 ### ⚙️ 规则管理

package/CHANGELOG.md

@@ -4,6 +4,28 @@
   Licensed under the MIT License. See the LICENSE file for details.
 -->
 
+## v2.8.0 (2026-09-03)
+
+### Added
+- **DNS 污染诊断（安全 DNS / DoH）**：`check-update` 在 GitHub 渠道不可达时自动触发 DNS 污染诊断，对比系统解析与安全 DNS（DoH）真实 IP，输出污染判定、对比表与可直接粘贴的 hosts 条目建议
+- **`doctor` 新增「网络/DNS 诊断」检查项**：默认联网检测 GitHub/PyPI 关键域名是否疑似 DNS 污染（系统解析落在 198.18.0.0/15 等保留/Fake-IP 段时判定疑似污染），`--offline` 参数可完全跳过网络查询
+- **新增 `gongwen/cli/netcheck.py` 模块**：DoH 解析（内置阿里 `dns.alidns.com` / 腾讯 `doh.pub` / `1.12.12.12` / Google 备用，多端点自动降级）+ 系统解析对比 + 污染判定 + hosts 建议生成；环境变量 `GONGWEN_DOH` 可覆盖为自定义 DoH 端点
+- **`check-update --json` 输出新增 `dns_diagnosis` 字段**：含 `polluted` / `detail` / `hosts_suggestions` 等，便于 Agent 解析
+- **自动直连兜底（DNS 污染时零操作下载）**：`font install` 下载字体、`check-update`/`helpers` 查询 PyPI 常规请求失败时，自动用 DoH 真实 IP + TLS SNI 直连重试（`netcheck.download_with_doh_fallback` / `_DoHHTTPSConnection`），证书校验仍针对真实域名，安全不降级
+
+### Notes
+- 诊断只做建议，不修改 hosts、不改变版本判定逻辑；自动直连仅作为下载/查询失败的兜底路径（YAGNI）
+- DoH 查询经第三方公共 DNS 服务（阿里/腾讯），仅诊断/兜底失败时发起少量查询；可设置 `GONGWEN_DOH` 指向私有端点
+
+## v2.7.0 (2026-09-03)
+
+### Added
+- **新增 `wizard` 向导式交互命令**：`python -m gongwen wizard` 以 A/B/C/D 路径菜单引导用户（A 格式优化 `optimize` / B 内容优化 `optimize-content` / C 生成模板 `template` / D 一键格式修复 `fix-common`），交互收集参数后一键执行
+- **双模式交互**：终端 input() 交互（公文类型支持序号 / id / 中文名智能匹配）+ `--answers` 扁平 JSON 非交互（Agent 场景，顶层带 `path`，如 `{"path":"A","input":"a.docx","apply":true}`）
+- **安全默认**：A/B/D 修改类路径先预览再 y/n 确认；非交互模式不写 `apply` 时仅预览不执行；`--dry-run` 只打印将执行的命令（A/B 同时打印预览+执行两条）
+- **执行机制**：`subprocess` 调用 `sys.executable -m gongwen <子命令>`，输出流式透传，Agent 可直接解析子命令原始输出
+- **文档同步**：SKILL.md「用户交互指引」升级为向导式三步流程并新增「向导式交互」小节（命令速查 24→25 个）；README 能力表与命令行速查补充 wizard 用法
+
 ## v2.6.1 (2026-09-02)
 
 ### Changed

package/README.md

@@ -45,11 +45,12 @@ Licensed under the MIT License. See the LICENSE file for details.
 | 🔍 审稿生成 | `review` | 按五角色审稿机制生成审稿意见 |
 | 🧩 完整审校 | `full-review` | 修订+批注联合命令（句子级差异修订 + 分类批注） |
 | 🎨 样式学习 | `style-learn` / `style-list` | 上传标准文档学习 Run/段落/页面三级样式（字体/字号/字间距/行距/缩进/页边距），生成命名模板持久化，后续用 `optimize -t 模板名` 套用 |
-| 🔄 版本自检 | `check-update` | 版本自检（PyPI pip 包权威判定 + GitHub 备用，GitCode/AtomGit 作国内镜像提示） |
-| 🩺 自我诊断 | `doctor` / `repair` | 全面诊断 22 项（Python/依赖/版本一致性/字体/DSH 文件/DSH 技能 frontmatter/代码风格），自动修复常见问题 |
+| 🔄 版本自检 | `check-update` | 版本自检（PyPI pip 包权威判定 + GitHub 备用，GitCode/AtomGit 作国内镜像提示；GitHub 不可达时自动做 DNS 污染诊断 + hosts 建议） |
+| 🩺 自我诊断 | `doctor` / `repair` | 全面诊断 23 项（Python/依赖/版本一致性/字体/DSH 文件/DSH 技能 frontmatter/代码风格/网络 DNS），自动修复常见问题；`--offline` 跳过网络检查 |
 | 🕵️ 文档审计 | `audit` | 检查删除线/加粗/AI 声明等痕迹 |
 | 🤝 会话交接 | `handoff` | 跨会话上下文传递（`--list` / `--latest` / Agent 长任务收尾必写） |
 | ⚙️ 规则管理 | `rule-export/import/list` | YAML 规则三层定制（官方/单位/用户） |
+| 🧭 向导式交互 | `wizard` | 交互式路径引导（A/B/C/D）+ 一键执行；Agent 用 `--answers` 非交互 / `--dry-run` 只打印命令 |
 
 ## 使用示例
 
@@ -259,6 +260,24 @@ python -m gongwen optimize-content 新闻稿.docx --changes changes.json \
 --show-confirmed             已确认实体也生成批注
 ```
 
+### 🧭 向导式交互（wizard）
+
+交互式引导选择处理路径并一键执行，适合不熟悉命令行的用户；Agent 可走非交互模式：
+
+```bash
+python -m gongwen wizard                        # 终端交互：菜单选 A/B/C/D → 逐项填参 → 预览确认 → 执行
+python -m gongwen wizard --answers 答案.json     # Agent 非交互：跳过提问直接执行
+python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行的命令
+```
+
+`--answers` 扁平 JSON（顶层带 `path`）：
+
+```json
+{"path": "A", "input": "原文.docx", "doc_type": "notice", "output": "成品.docx", "apply": true}
+```
+
+路径：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）。A/B/D 默认先预览再 y/n 确认；不写 `apply` 时非交互模式仅预览不执行（安全默认）。
+
 ## 📐 GB/T 9704 标准格式
 
 | 元素 | 字体 | 字号 | 对齐 |
@@ -317,7 +336,7 @@ python -m gongwen rule-list notice
 
 Agent 加载 skill 后**必须执行版本追新自检**，确保使用最新版本：
 
-1. **远程自检**（首选）：`python -m gongwen check-update`——以 **PyPI（pip 包发布源）为权威判定渠道**并发查询比对本地（pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道）。全部渠道不可达时明确告知"版本自检跳过"。GitHub 为海外渠道（国内常超时）采用短超时快速降级；GitHub 不可达时自动提示国内代码镜像（GitCode/AtomGit，与 GitHub 同源 tag）与 GitHub520 hosts 加速方案
+1. **远程自检**（首选）：`python -m gongwen check-update`——以 **PyPI（pip 包发布源）为权威判定渠道**并发查询比对本地（pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道）。全部渠道不可达时明确告知"版本自检跳过"。GitHub 为海外渠道（国内常超时）采用短超时快速降级；GitHub 不可达时自动提示国内代码镜像（GitCode/AtomGit，与 GitHub 同源 tag）、GitHub520 hosts 加速方案，并自动做 **DNS 污染诊断**（对比系统解析与安全 DNS/DoH 真实 IP，输出可直接粘贴的 hosts 条目建议）
 2. **本地 git tag 对比**（补充）：对 skill 安装目录执行 `git -C "<skill安装目录>" describe --tags --abbrev=0`；若安装目录不在 git 管理下，应告知用户"无法执行版本对比，建议手动检查 GitHub 更新"
 3. **落后则警告**：发现本地版本落后于最新版本时，**必须在执行前警告用户**并提示更新——`check-update` 会按安装形态自动给出精准更新命令（pip 包安装：`pip install --upgrade gongwen-skill`；git/skill 目录安装：`cd <gongwen-skill目录> && git pull && git fetch --tags`），不得静默使用旧版本
 
@@ -337,7 +356,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.6.1
+python -m gongwen --version       # 检验：gongwen-skill v2.8.0
 ```
 
 ### 方式一：作为 DSH Skill 注册（基于本地文件系统）
@@ -393,7 +412,7 @@ pnpm add -w gongwen-skill
   "dependencies": {
     "@deepseek-ai/dsh-base": "...",
     "@deepseek-ai/dsh-web-app": "...",
-    "gongwen-skill": "^2.6.1"
+    "gongwen-skill": "^2.8.0"
   },
   "dsh": {
     "profile": {
@@ -574,7 +593,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.6.1（版本自检已确认最新）
+Skill 版本: v2.8.0（版本自检已确认最新）
 路径判定: B（内容优化）
 依据: 用户指定了已有文档，且要求"优化措辞"
 命令调用: 1. python -m gongwen optimize-content 会议通知.docx --changes changes.json --apply --paragraphs "5-8"
@@ -610,6 +629,23 @@ Skill 定位为**工具层**，默认不依赖 LLM（确定性工作全自包含
 
 ---
 
+## 🌐 GitHub 不可达排查（安全 DNS / DoH）
+
+国内网络访问 GitHub 常遇「无法访问 / 超时」问题，常见原因之一是 **DNS 污染**——系统 DNS 返回的不是真实 IP，而是保留/Fake-IP 段（如 198.18.0.0/15、0.0.0.0），连接自然失败或超时。
+
+**快速诊断**：运行 python -m gongwen doctor（含网络/DNS 检查项），或 python -m gongwen check-update（GitHub 渠道不可达时自动诊断）。检测到疑似污染时，会输出系统解析 vs 安全 DNS 真实 IP 对比，以及可直接粘贴的 hosts 条目建议。
+
+**原理**：安全 DNS（DoH，DNS over HTTPS）通过加密 HTTP 查询 DNS，避免中间设备篡改解析结果，可拿到域名的真实 IP。本工具内置阿里（dns.alidns.com）、腾讯（doh.pub / 1.12.12.12）等国内公共 DoH 端点，多端点自动降级；可通过环境变量 GONGWEN_DOH 覆盖为自定义端点（如自建的 DoH 服务）。
+
+**自动兜底（v2.8.0）**：`font install` 下载字体、`check-update` 查 PyPI 时若常规请求失败（疑似 DNS 污染），自动用 DoH 真实 IP + TLS SNI 直连重试——TLS 证书仍按真实域名校验，安全不降级，用户零操作。
+
+**处置建议**（按推荐度）：
+1. 若使用了代理工具（Clash/V2Ray 等）且系统解析命中 198.18.x Fake-IP，优先检查其 DNS 模式的 fake-ip-filter 是否漏掉 GitHub 域名（比改 hosts 更治本）
+2. 将诊断输出的 hosts 条目写入 C:\Windows\System32\drivers\etc\hosts（需管理员权限），git / 浏览器即可直连真实 IP
+3. 或使用国内镜像仓库克隆/更新（见下方「镜像仓库」）
+
+> 诊断 + 自动兜底：本工具不写入 hosts、不修改系统配置；但 `font install` 下载字体、`check-update` 查询 PyPI 遇到 DNS 污染导致的失败时，会**自动用安全 DNS（DoH）真实 IP + TLS SNI 直连重试**（零操作，证书校验不降级）。DoH 查询经第三方公共 DNS 服务，仅在诊断/兜底失败时发起少量查询，隐私敏感者可设置 GONGWEN_DOH 指向自有端点。
+
 ## 📄 许可证与出处
 
 MIT License · **(c) 2026 Jose AI** · https://www.linhut.cn

package/SKILL.md

@@ -103,6 +103,7 @@ metadata:
    ```
    - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
    - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
+   - GitHub 不可达且触发 DNS 诊断时（系统解析为保留/Fake-IP 段），`check-update --json` 会输出 `dns_diagnosis` 字段（含 `hosts_suggestions`），如实向用户转述排查建议即可
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -258,21 +259,23 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ## 用户交互指引（Agent 必须遵守）
 
+> **终端用户也可直接运行 `python -m gongwen wizard`**：交互式向导以菜单方式完成同样的 A/B/C/D 路径选择与逐步确认（详见下文「向导式交互」小节）。Agent 读到本条时，若用户表示「不熟悉命令/不想记参数」，应主动引导其使用向导，而非逐字念命令行参数。
+
 ### 第一步：确认路径（必须，严禁跳过）
 
-用通俗语言问用户走哪条路，**不允许跳过**：
+用通俗语言问用户走哪条路，**不允许跳过**。向导模式与对话模式共用同一套路径：
 
 > 这个工具支持四种处理方式：
-> - **格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
-> - **内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
-> - **生成模板**：直接生成一份空白公文模板，按国标设好版式
-> - **一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
+> - **A. 格式优化**：不改文字，只修排版（字体/字号/页边距/行距/缩进），按国标标准化
+> - **B. 内容优化**：润色文字表达，生成带标记的对比文档——保持原文档排版样式，修改处红色高亮或删除线、每段附修改说明
+> - **C. 生成模板**：直接生成一份空白公文模板，按国标设好版式
+> - **D. 一键格式修复**（fix-common）：快速规范化常见格式问题（段落类型/编号拆分/首句加粗），输出不含 AI 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -280,6 +283,29 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 
 ---
 
+### 向导式交互（`wizard` 命令）
+
+当用户**不熟悉命令行**、希望**逐步确认后再执行**，或 Agent 需要**把交互决策委托给工具**时，使用向导：
+
+```
+python -m gongwen wizard                        # 终端交互：菜单选 A/B/C/D → 逐项填参 → 预览确认 → 执行
+python -m gongwen wizard --answers 答案.json     # Agent 非交互：跳过提问直接执行
+python -m gongwen wizard --answers 答案.json --dry-run  # 只打印将执行的命令，不真正执行
+```
+
+- **路径菜单**：A 格式优化（`optimize`）｜B 内容优化（`optimize-content`）｜C 生成模板（`template`）｜D 一键格式修复（`fix-common`）
+- **交互流程**：选择路径 → 收集参数（公文类型支持 序号 / id / 中文名，如 `1`、`notice`、`通知`）→ A/B/D 先预览再 y/n 确认 → 执行；C 无修改风险直接执行
+- **`--answers` JSON 扁平结构**（Agent 场景，顶层带 `path`）：
+  ```json
+  {"path": "A", "input": "原文.docx", "doc_type": "notice", "output": "成品.docx", "apply": true}
+  ```
+  - 字段缺失：非交互模式直接报错并列出缺失项（不静默、不进交互菜单）
+  - 不写 `apply` 时 A/B/D **仅预览不执行**（安全默认）；`apply: true` 跳过确认直接执行
+  - 非交互执行机制：`subprocess` 调用 `sys.executable -m gongwen <子命令>`，输出流式透传，Agent 可直接解析子命令原始输出
+- **`--dry-run`**：只打印将执行的命令；A/B 会同时打印「预览」与「执行」两条命令，便于 Agent 预演与调试
+
+---
+
 ## 执行标准总则（所有路径共享）
 
 ### Agent 行为准则
@@ -295,7 +321,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -846,10 +872,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 
 ---
 
-## 附录：全部命令速查（24 个，按用途分组）
+## 附录：全部命令速查（25 个，按用途分组）
 
 > Agent 遇到用户需求时，先在此表定位对应命令；命令用法不明确时运行 `python -m gongwen <命令> --help` 查看完整参数。
 
+### 🧭 向导式交互
+
+| 命令 | 用途 | 最小用法 |
+|------|------|---------|
+| `wizard` | 交互式路径引导（A/B/C/D）+ 一键执行；Agent 用 `--answers` 非交互 / `--dry-run` 只打印命令 | `python -m gongwen wizard` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -894,15 +926,16 @@ python -m gongwen fix-common 文件.docx -o 成品.docx
 | `table-signs` | 从名单批量生成会议桌签 | `python -m gongwen table-signs 名单.txt -o 桌签.docx` |
 | `review` | 生成公文审稿流转单（五/三角色） | `python -m gongwen review report -o 审稿单.docx` |
 | `handoff` | 跨会话交接（长任务收尾必写） | `python -m gongwen handoff --write` |
-| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
-| `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态；GitHub 不可达时 DNS 诊断） | `python -m gongwen check-update` |
+| `font` | 公文标准字体管理（安装/检查/列出；下载失败时自动安全 DNS 直连兜底） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复
 
 | 命令 | 用途 | 最小用法 |
 |------|------|---------|
-| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格等 | `python -m gongwen doctor` |
+| `doctor` | 全面诊断：检查 Python 版本/依赖/版本一致性/字体/DSH 文件/代码风格/网络 DNS 等 | `python -m gongwen doctor` |
 | `doctor --json` | JSON 结构化输出（便于 Agent 解析） | `python -m gongwen doctor --json` |
+| `doctor --offline` | 跳过网络/DNS 诊断（离线模式） | `python -m gongwen doctor --offline` |
 | `repair` | 修复常见问题：安装缺失依赖/字体/同步 SKILL.md 副本 | `python -m gongwen repair` |
 
 ### ⚙️ 规则管理

package/dsh/index.js

@@ -1,4 +1,4 @@
-// 公文全流程处理工具 - DSH plugin bridge (gongwen-skill, v2.6.1+)
+// 公文全流程处理工具 - DSH plugin bridge (gongwen-skill, v2.8.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.

package/engine/core/document/_generator_helpers.py

@@ -529,8 +529,9 @@ def _apply_run_format(run, run_model: Run):
         run.font.italic = fmt.italic
     if fmt.underline is not None:
         run.font.underline = fmt.underline
-    if fmt.strikethrough is True:
-        run.font.strike = True
+    if fmt.strikethrough is not None:
+        # True 设置删除线 / False 显式清除已有删除线（避免 strikethrough=False 时旧删除线残留）
+        run.font.strike = fmt.strikethrough
 
     # === 颜色 ===
     if fmt.color:

package/engine/core/document/markdown_converter.py

@@ -30,8 +30,8 @@ _MD_UL_RE = re.compile(r'^[-*+]\s+')
 # markdown 有序列表前缀：1. 2. 3. 或 1、2、3、
 _MD_OL_RE = re.compile(r'^\d+[.、]\s*')
 
-# markdown 表格行
-_MD_TABLE_RE = re.compile(r'^\|.+\|.+\|$')
+# markdown 表格行（支持单列：| a |；贪婪匹配到行尾，多列 | a | b | 亦能识别）
+_MD_TABLE_RE = re.compile(r'^\|.+\|$')
 
 # markdown 表格分隔行：|----|----|
 _MD_TABLE_SEP_RE = re.compile(r'^\|[\s\-:|]+\|$')
@@ -263,6 +263,8 @@ def convert_markdown(model: DocumentModel) -> int:
         ol_match = _MD_OL_RE.match(text)
         if ol_match and not para.is_heading:
             is_list = True
+            text = _MD_OL_RE.sub('', text)
+            list_indent_pt = 32  # 有序列表同样 2 字符缩进（与无序列表一致）
 
         # --- 应用格式修改到 run ---
 

package/engine/core/document/ooxml_workflow.py

@@ -79,7 +79,7 @@ class OOXMLWorkflow:
         return self
 
     def __exit__(self, exc_type, exc_val, exc_tb) -> None:
-        # S5 修复：异常时保留临时目录便于调试；正常结束才清理
-        if self.unpack_dir is not None and exc_type is None:
+        # 修复：无论正常结束或异常均清理临时目录，避免每次异常残留 gongwen_ooxml_* 目录泄漏磁盘
+        if self.unpack_dir is not None:
             shutil.rmtree(self.unpack_dir, ignore_errors=True)
             self.unpack_dir = None

package/engine/core/rules/checker.py

@@ -893,7 +893,7 @@ def _check_header_field(model, rule_id: str, severity: str, name: str,
                     suggested_fix="仅保留一个主送机关",
                     reason="请示一般只写一个主送机关（发现多个主送机关段）",
                 ))
-            elif re.search(r'[、，,s]{2,}', first.strip().rstrip('：:')) and len(first.strip().rstrip('：:')) > 5:
+            elif re.search(r'[、，,]{2,}', first.strip().rstrip('：:')) and len(first.strip().rstrip('：:')) > 5:
                 issues.append(CheckIssue(
                     rule_id=rule_id, check_type="content", severity=severity,
                     name=name, location=f"paragraph:{recips[0].index}",

package/engine/inject.py

@@ -379,7 +379,7 @@ def inject_footer(output_path: str, footer_config: dict) -> None:
 #  页码注入：Word PAGE 域动态页码
 # ---------------------------------------------------------------------------
 
-def _add_page_run(para_elem, text: str, font_name: str, size_pt: int) -> None:
+def _add_page_run(para_elem, text: str, font_name: str, size_pt: float) -> None:
     """添加一个普通文本 run 到段落元素。"""
     from docx.oxml import OxmlElement
     from docx.oxml.ns import qn
@@ -402,7 +402,7 @@ def _add_page_run(para_elem, text: str, font_name: str, size_pt: int) -> None:
     para_elem.append(r)
 
 
-def _build_page_number_xml(fmt: str, font_name: str, size_pt: int) -> list:
+def _build_page_number_xml(fmt: str, font_name: str, size_pt: float) -> list:
     """解析页码格式字符串，返回 (类型, 内容, 字体, 字号) 元素列表。"""
     import re
     elements = []
@@ -621,6 +621,10 @@ def inject_page_number(output_path: str, page_number_config: dict) -> None:
         from docx.oxml import OxmlElement
         from docx.oxml.ns import qn
         from docx.shared import Pt
+        from engine.core.document.font_utils import (
+            PAGE_NUMBER_FONT,
+            PAGE_NUMBER_SIZE_PT,
+        )
 
         enabled = page_number_config.get('enabled')
         if enabled is None:
@@ -629,8 +633,8 @@ def inject_page_number(output_path: str, page_number_config: dict) -> None:
             return
 
         fmt = page_number_config.get('format', '- {PAGE} -')
-        font_name = page_number_config.get('font', '宋体')
-        size_pt = page_number_config.get('size', 14)
+        font_name = page_number_config.get('font', PAGE_NUMBER_FONT)
+        size_pt = page_number_config.get('size', PAGE_NUMBER_SIZE_PT)
         align = page_number_config.get('alignment') or page_number_config.get('position', 'center')
         if align == 'right-left':
             align = 'right'
@@ -671,9 +675,9 @@ def inject_page_number(output_path: str, page_number_config: dict) -> None:
             if is_odd_even:
                 ind = OxmlElement('w:ind')
                 if align == 'right':
-                    ind.set(qn('w:right'), str(int(14 * 20)))
+                    ind.set(qn('w:right'), str(int(PAGE_NUMBER_SIZE_PT * 20)))
                 else:
-                    ind.set(qn('w:left'), str(int(14 * 20)))
+                    ind.set(qn('w:left'), str(int(PAGE_NUMBER_SIZE_PT * 20)))
                 pPr.append(ind)
             try:
                 bm = section.bottom_margin

package/gongwen/__init__.py

@@ -7,7 +7,7 @@
 #
 # 公文全流程处理工具 - gongwen-skill Python package
 
-__version__ = "2.6.1"
+__version__ = "2.8.0"
 
 # Re-export everything from the legacy module for backward compatibility
 # This allows: from gongwen import main, cmd_check, etc.