gongwen-skill 2.6.0 → 2.7.0

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

@@ -93,21 +93,16 @@ metadata:
 
 1. 读取 `gongwen` 包顶部的 `__version__` 常量，获取本地版本号
 2. 告知用户：`当前加载 gongwen-skill v{__version__}`
-3. **多渠道比对远程最新 tag**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一远程——某仓库不可达/网络抖动会导致误判）：
+3. **版本自检**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一仓库——网络抖动会导致误判）：
    ```bash
-   # 首选：CLI 内置多渠道自检命令（自动查询 GitHub/GitCode/AtomGit 三仓库，取最高版本）
+   # 首选：CLI 内置自检命令（PyPI pip 包权威判定 + GitHub 备用渠道，自动比对本地版本）
    python -m gongwen check-update
 
-   # 手动回退：逐一查询三个镜像仓库，取最高版本
-   for url in \
-     https://github.com/linhut/gongwen-skill.git \
-     https://gitcode.com/linhut/gongwen-skill.git \
-     https://atomgit.com/linhut/gongwen-skill.git ; do
-     git ls-remote --tags "$url" | awk -F/ '{print $NF}' \
-       | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1
-   done
+   # 手动回退：PyPI 权威（pip 包发布源）
+   python -c "import urllib.request,json;print(json.loads(urllib.request.urlopen('https://pypi.org/pypi/gongwen-skill/json',timeout=10).read())['info']['version']))"
    ```
-   - 三个仓库取其中**最高版本**作为最新版（多渠道互相校验，任一渠道可达即不遗漏）
+   - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
+   - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -116,14 +111,16 @@ metadata:
      ```
    - 若 skill 目录不在 git 管理下，应告知用户"无法执行版本对比，建议手动检查 GitHub 更新"
    - 版本对比结果若发现本地版本落后于最新 tag，应在执行前**警告用户**
-4. 若多渠道最高版本 > 本地 `__version__`，提示用户：
+4. 若权威渠道最新版本 > 本地 `__version__`，提示用户：
    ```
-   有更新可用：最新版 {远程tag}，当前 {本地version}
+   有更新可用：最新版 {最新版}，当前 {本地version}
+   安装形态自动检测（pip 包 / git 目录），按形态给出精准更新命令：
+     pip 包安装：pip install --upgrade gongwen-skill
+     git 目录安装：cd <gongwen-skill目录> && git pull && git fetch --tags
    拉取地址：
-     GitHub：https://github.com/linhut/gongwen-skill
-     GitCode：https://gitcode.com/linhut/gongwen-skill
-     AtomGit：https://atomgit.com/linhut/gongwen-skill
-   更新命令：cd <gongwen-skill目录> && git pull && git fetch --tags
+     PyPI（权威）：https://pypi.org/project/gongwen-skill/
+     GitHub（备用）：https://github.com/linhut/gongwen-skill
+     GitCode / AtomGit（国内镜像）：https://gitcode.com/linhut/gongwen-skill / https://atomgit.com/linhut/gongwen-skill
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -261,21 +258,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 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -283,6 +282,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 行为准则
@@ -298,7 +320,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -849,10 +871,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` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -897,7 +925,7 @@ 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` | 多渠道版本自检 | `python -m gongwen check-update` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
 | `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复

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

@@ -93,21 +93,16 @@ metadata:
 
 1. 读取 `gongwen` 包顶部的 `__version__` 常量，获取本地版本号
 2. 告知用户：`当前加载 gongwen-skill v{__version__}`
-3. **多渠道比对远程最新 tag**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一远程——某仓库不可达/网络抖动会导致误判）：
+3. **版本自检**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一仓库——网络抖动会导致误判）：
    ```bash
-   # 首选：CLI 内置多渠道自检命令（自动查询 GitHub/GitCode/AtomGit 三仓库，取最高版本）
+   # 首选：CLI 内置自检命令（PyPI pip 包权威判定 + GitHub 备用渠道，自动比对本地版本）
    python -m gongwen check-update
 
-   # 手动回退：逐一查询三个镜像仓库，取最高版本
-   for url in \
-     https://github.com/linhut/gongwen-skill.git \
-     https://gitcode.com/linhut/gongwen-skill.git \
-     https://atomgit.com/linhut/gongwen-skill.git ; do
-     git ls-remote --tags "$url" | awk -F/ '{print $NF}' \
-       | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1
-   done
+   # 手动回退：PyPI 权威（pip 包发布源）
+   python -c "import urllib.request,json;print(json.loads(urllib.request.urlopen('https://pypi.org/pypi/gongwen-skill/json',timeout=10).read())['info']['version']))"
    ```
-   - 三个仓库取其中**最高版本**作为最新版（多渠道互相校验，任一渠道可达即不遗漏）
+   - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
+   - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -116,14 +111,16 @@ metadata:
      ```
    - 若 skill 目录不在 git 管理下，应告知用户"无法执行版本对比，建议手动检查 GitHub 更新"
    - 版本对比结果若发现本地版本落后于最新 tag，应在执行前**警告用户**
-4. 若多渠道最高版本 > 本地 `__version__`，提示用户：
+4. 若权威渠道最新版本 > 本地 `__version__`，提示用户：
    ```
-   有更新可用：最新版 {远程tag}，当前 {本地version}
+   有更新可用：最新版 {最新版}，当前 {本地version}
+   安装形态自动检测（pip 包 / git 目录），按形态给出精准更新命令：
+     pip 包安装：pip install --upgrade gongwen-skill
+     git 目录安装：cd <gongwen-skill目录> && git pull && git fetch --tags
    拉取地址：
-     GitHub：https://github.com/linhut/gongwen-skill
-     GitCode：https://gitcode.com/linhut/gongwen-skill
-     AtomGit：https://atomgit.com/linhut/gongwen-skill
-   更新命令：cd <gongwen-skill目录> && git pull && git fetch --tags
+     PyPI（权威）：https://pypi.org/project/gongwen-skill/
+     GitHub（备用）：https://github.com/linhut/gongwen-skill
+     GitCode / AtomGit（国内镜像）：https://gitcode.com/linhut/gongwen-skill / https://atomgit.com/linhut/gongwen-skill
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -261,21 +258,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 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -283,6 +282,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 行为准则
@@ -298,7 +320,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -849,10 +871,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` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -897,7 +925,7 @@ 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` | 多渠道版本自检 | `python -m gongwen check-update` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
 | `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复

package/CHANGELOG.md

@@ -4,6 +4,22 @@
   Licensed under the MIT License. See the LICENSE file for details.
 -->
 
+## 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
+- **check-update 改为 PyPI 权威判定 + 安装形态自动检测**：以 PyPI（pip 包发布源）为唯一权威判定渠道（pip install -U 即从 PyPI 拉取），GitHub 降为 PyPI 不可达时的备用渠道（git 用户/CI 触发源）；GitCode/AtomGit 保持国内拉取镜像提示（不参与版本判定）
+- **更新命令按安装形态精准给出**：运行时自动检测安装形态（pip 包 / git·skill 目录），pip 安装提示 `pip install --upgrade gongwen-skill`，git/skill 目录提示 `cd <gongwen-skill目录> && git pull && git fetch --tags`；--json 输出新增 authoritative_channel、install_type 字段
+- **文档同步**：SKILL.md/README/RELEASE/_legacy 的渠道描述统一为"PyPI 权威 + GitHub 备用"，SKILL.md 版本自检节新增手动回退命令
+
 ## v2.6.0 (2026-09-02)
 
 ### Added

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 + GitHub 双判定渠道，GitCode/AtomGit 作国内镜像提示） |
+| 🔄 版本自检 | `check-update` | 版本自检（PyPI pip 包权威判定 + GitHub 备用，GitCode/AtomGit 作国内镜像提示） |
 | 🩺 自我诊断 | `doctor` / `repair` | 全面诊断 22 项（Python/依赖/版本一致性/字体/DSH 文件/DSH 技能 frontmatter/代码风格），自动修复常见问题 |
 | 🕵️ 文档审计 | `audit` | 检查删除线/加粗/AI 声明等痕迹 |
 | 🤝 会话交接 | `handoff` | 跨会话上下文传递（`--list` / `--latest` / Agent 长任务收尾必写） |
 | ⚙️ 规则管理 | `rule-export/import/list` | YAML 规则三层定制（官方/单位/用户） |
+| 🧭 向导式交互 | `wizard` | 交互式路径引导（A/B/C/D）+ 一键执行；Agent 用 `--answers` 非交互 / `--dry-run` 只打印命令 |
 
 ## 使用示例
 
@@ -150,7 +151,7 @@ python -m gongwen footer 红头公文.docx --cc "各单位" --printer "XX办公
 # 注入页码（Word PAGE 域动态页码）
 python -m gongwen pagenum 红头公文.docx --alignment right
 
-# 版本自检（PyPI + GitHub 双判定渠道）
+# 版本自检（PyPI pip 包权威判定 + GitHub 备用渠道）
 python -m gongwen check-update
 
 # 安装公文标准字体（方正小标宋简体/仿宋_GB2312/楷体_GB2312）
@@ -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,9 +336,9 @@ python -m gongwen rule-list notice
 
 Agent 加载 skill 后**必须执行版本追新自检**，确保使用最新版本：
 
-1. **远程自检**（首选）：`python -m gongwen check-update`——以 **PyPI（发布源）+ GitHub（代码权威源）双判定渠道**并发查询，取最高版本比对本地；任一判定渠道可达即不遗漏，全部不可达时明确告知"版本自检跳过"。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 加速方案
 2. **本地 git tag 对比**（补充）：对 skill 安装目录执行 `git -C "<skill安装目录>" describe --tags --abbrev=0`；若安装目录不在 git 管理下，应告知用户"无法执行版本对比，建议手动检查 GitHub 更新"
-3. **落后则警告**：发现本地版本落后于最新 tag 时，**必须在执行前警告用户**并提示更新（`cd <gongwen-skill目录> && git pull && git fetch --tags`），不得静默使用旧版本
+3. **落后则警告**：发现本地版本落后于最新版本时，**必须在执行前警告用户**并提示更新——`check-update` 会按安装形态自动给出精准更新命令（pip 包安装：`pip install --upgrade gongwen-skill`；git/skill 目录安装：`cd <gongwen-skill目录> && git pull && git fetch --tags`），不得静默使用旧版本
 
 > 严禁只用本地 `git describe` 判断版本——它只读本地可达 tag，未 fetch 时会误判本地即最新。
 
@@ -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.0
+python -m gongwen --version       # 检验：gongwen-skill v2.7.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.0"
+    "gongwen-skill": "^2.7.0"
   },
   "dsh": {
     "profile": {
@@ -574,7 +593,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.6.0（版本自检已确认最新）
+Skill 版本: v2.7.0（版本自检已确认最新）
 路径判定: B（内容优化）
 依据: 用户指定了已有文档，且要求"优化措辞"
 命令调用: 1. python -m gongwen optimize-content 会议通知.docx --changes changes.json --apply --paragraphs "5-8"

package/SKILL.md

@@ -93,21 +93,16 @@ metadata:
 
 1. 读取 `gongwen` 包顶部的 `__version__` 常量，获取本地版本号
 2. 告知用户：`当前加载 gongwen-skill v{__version__}`
-3. **多渠道比对远程最新 tag**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一远程——某仓库不可达/网络抖动会导致误判）：
+3. **版本自检**（不能只用本地 `git describe`——它只读本地可达 tag，未 fetch 时会误判本地即最新；也不能只查单一仓库——网络抖动会导致误判）：
    ```bash
-   # 首选：CLI 内置多渠道自检命令（自动查询 GitHub/GitCode/AtomGit 三仓库，取最高版本）
+   # 首选：CLI 内置自检命令（PyPI pip 包权威判定 + GitHub 备用渠道，自动比对本地版本）
    python -m gongwen check-update
 
-   # 手动回退：逐一查询三个镜像仓库，取最高版本
-   for url in \
-     https://github.com/linhut/gongwen-skill.git \
-     https://gitcode.com/linhut/gongwen-skill.git \
-     https://atomgit.com/linhut/gongwen-skill.git ; do
-     git ls-remote --tags "$url" | awk -F/ '{print $NF}' \
-       | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1
-   done
+   # 手动回退：PyPI 权威（pip 包发布源）
+   python -c "import urllib.request,json;print(json.loads(urllib.request.urlopen('https://pypi.org/pypi/gongwen-skill/json',timeout=10).read())['info']['version']))"
    ```
-   - 三个仓库取其中**最高版本**作为最新版（多渠道互相校验，任一渠道可达即不遗漏）
+   - **PyPI 为权威判定渠道**（pip 包核心分发，pip install -U 即从 PyPI 拉取）；PyPI 不可达时回退 GitHub tag（备用渠道，git 用户/CI 触发源）
+   - GitCode/AtomGit 与 GitHub 同源 tag，仅在 GitHub 不可达时作国内拉取镜像提示（不参与版本判定）
    - 若全部渠道均不可用（无 git/无网络），**必须明确告知用户"版本自检因无法访问远程而跳过"**，不得静默假设本地即最新
 3.5. **本地 git tag 对比**（P6，Agent 执行版本确认时补充）：
    - 优先对 skill 安装目录执行 git tag 对比：
@@ -116,14 +111,16 @@ metadata:
      ```
    - 若 skill 目录不在 git 管理下，应告知用户"无法执行版本对比，建议手动检查 GitHub 更新"
    - 版本对比结果若发现本地版本落后于最新 tag，应在执行前**警告用户**
-4. 若多渠道最高版本 > 本地 `__version__`，提示用户：
+4. 若权威渠道最新版本 > 本地 `__version__`，提示用户：
    ```
-   有更新可用：最新版 {远程tag}，当前 {本地version}
+   有更新可用：最新版 {最新版}，当前 {本地version}
+   安装形态自动检测（pip 包 / git 目录），按形态给出精准更新命令：
+     pip 包安装：pip install --upgrade gongwen-skill
+     git 目录安装：cd <gongwen-skill目录> && git pull && git fetch --tags
    拉取地址：
-     GitHub：https://github.com/linhut/gongwen-skill
-     GitCode：https://gitcode.com/linhut/gongwen-skill
-     AtomGit：https://atomgit.com/linhut/gongwen-skill
-   更新命令：cd <gongwen-skill目录> && git pull && git fetch --tags
+     PyPI（权威）：https://pypi.org/project/gongwen-skill/
+     GitHub（备用）：https://github.com/linhut/gongwen-skill
+     GitCode / AtomGit（国内镜像）：https://gitcode.com/linhut/gongwen-skill / https://atomgit.com/linhut/gongwen-skill
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -261,21 +258,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 声明段的干净文档
 
 若用户说「帮我优化一下」，必须追问是改格式还是改内容。
 
 ### 第二步：告知输出物
 
-执行前明确说会生成什么文件、包含什么标记。
+执行前明确说会生成什么文件、包含什么标记。向导模式会在执行前展示将运行的完整命令。
 
 ### 第三步：执行后验证
 
@@ -283,6 +282,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 行为准则
@@ -298,7 +320,7 @@ python -m gongwen handoff --latest --summary # 最新交接文档（Markdown 摘
 | "按上级文件要求调整" | 用户有政策依据但未提供 | 追问具体文件名或文号，或用 web 搜索相关政策 |
 | "弄漂亮一点" | 希望格式规范 | 解释 GB/T 9704 标准是唯一合规格式 |
 
-**原则**：不确定时 **先确认路径**（A/B/C），再用 **具体示例引导用户选择**，不猜测。
+**原则**：不确定时 **先确认路径**（A/B/C/D，向导模式同），再用 **具体示例引导用户选择**，不猜测。
 
 #### 2. 充分利用 skill 知识库
 
@@ -849,10 +871,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` |
+
 ### 🏗️ 生成与模板
 
 | 命令 | 用途 | 最小用法 |
@@ -897,7 +925,7 @@ 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` | 多渠道版本自检 | `python -m gongwen check-update` |
+| `check-update` | 版本自检（PyPI pip 包权威 + GitHub 备用，自动检测安装形态） | `python -m gongwen check-update` |
 | `font` | 公文标准字体管理（安装/检查/列出） | `python -m gongwen font install` |
 
 ### 🩺 诊断与修复

package/dsh/index.js

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