gongwen-skill 2.5.0 → 2.6.1

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
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -897,7 +894,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
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -897,7 +894,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,27 @@
   Licensed under the MIT License. See the LICENSE file for details.
 -->
 
+## 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
+- **check-update 判定渠道精简为 PyPI + GitHub 双权威源**：对齐 EasyTier 单权威源 + 加速代理设计，GitCode/AtomGit 不再参与版本判定（零增量镜像），降为 GitHub 不可达时的国内拉取镜像提示；--json 输出新增 mirrors 字段
+- **GitHub 国内访问优化**：并发查询 + 分级超时（PyPI 10s / GitHub 8s 快速降级），GitHub 不可达时提示 GitHub520 hosts 方案与国内镜像地址
+- **发布流程修复（三平台 Release 统一编号）**：ci.yml 新增 release job，tag 推送自动创建 GitHub Release（编号 = tag）；RELEASE.md 发布流程新增 GitHub Release 自动创建 + GitCode/AtomGit Release 同步（编号与 tag 统一）
+- **非必要文件不同步原则写入发布流程**：RELEASE.md 明确临时/调试文件（tmp_*、_gw_* 等）不提交、不入库、不同步三仓库
+
+### Changed
+- check-update 头部与末尾文案同步为 PyPI + GitHub 判定；--json 的 channels 字段只含 PyPI/GitHub
+- README / RELEASE.md 文档同步更新（判定渠道、镜像提示、Release 统一编号说明）
+
+### Fixed
+- 历史遗留：v2.0.0~v2.5.0 在 GitHub/GitCode 从未创建 Release 对象（仅 tag），已补建且编号与 tag 统一
 ## v2.5.0 (2026-09-01)
 
 ### Added

package/README.md

@@ -45,7 +45,7 @@ Licensed under the MIT License. See the LICENSE file for details.
 | 🔍 审稿生成 | `review` | 按五角色审稿机制生成审稿意见 |
 | 🧩 完整审校 | `full-review` | 修订+批注联合命令（句子级差异修订 + 分类批注） |
 | 🎨 样式学习 | `style-learn` / `style-list` | 上传标准文档学习 Run/段落/页面三级样式（字体/字号/字间距/行距/缩进/页边距），生成命名模板持久化，后续用 `optimize -t 模板名` 套用 |
-| 🔄 版本自检 | `check-update` | 多渠道版本自检（GitHub/GitCode/AtomGit 三仓库比对取最新） |
+| 🔄 版本自检 | `check-update` | 版本自检（PyPI pip 包权威判定 + GitHub 备用，GitCode/AtomGit 作国内镜像提示） |
 | 🩺 自我诊断 | `doctor` / `repair` | 全面诊断 22 项（Python/依赖/版本一致性/字体/DSH 文件/DSH 技能 frontmatter/代码风格），自动修复常见问题 |
 | 🕵️ 文档审计 | `audit` | 检查删除线/加粗/AI 声明等痕迹 |
 | 🤝 会话交接 | `handoff` | 跨会话上下文传递（`--list` / `--latest` / Agent 长任务收尾必写） |
@@ -150,7 +150,7 @@ python -m gongwen footer 红头公文.docx --cc "各单位" --printer "XX办公
 # 注入页码（Word PAGE 域动态页码）
 python -m gongwen pagenum 红头公文.docx --alignment right
 
-# 多渠道版本自检
+# 版本自检（PyPI pip 包权威判定 + GitHub 备用渠道）
 python -m gongwen check-update
 
 # 安装公文标准字体（方正小标宋简体/仿宋_GB2312/楷体_GB2312）
@@ -317,9 +317,9 @@ python -m gongwen rule-list notice
 
 Agent 加载 skill 后**必须执行版本追新自检**，确保使用最新版本：
 
-1. **多渠道远程自检**（首选）：`python -m gongwen check-update`——自动查询 GitHub/GitCode/AtomGit 三仓库最新 tag，取最高版本比对本地；任一渠道可达即不遗漏，全部不可达时明确告知"版本自检跳过"
+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 +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.5.0
+python -m gongwen --version       # 检验：gongwen-skill v2.6.1
 ```
 
 ### 方式一：作为 DSH Skill 注册（基于本地文件系统）
@@ -393,7 +393,7 @@ pnpm add -w gongwen-skill
   "dependencies": {
     "@deepseek-ai/dsh-base": "...",
     "@deepseek-ai/dsh-web-app": "...",
-    "gongwen-skill": "^2.5.0"
+    "gongwen-skill": "^2.6.1"
   },
   "dsh": {
     "profile": {
@@ -448,9 +448,9 @@ dsh --profile web
 | CLI 独立可执行（`python -m gongwen <命令>`） | ✅ |
 | PyPI 上架（`pip install gongwen-skill`） | ✅ |
 | 零外部运行时依赖（仅 python-docx/pydantic/pyyaml） | ✅ |
-| DSH 配置化排版参数（页边距/行距/字体/默认模板版本） | ✅ v2.5.0+ |
+| DSH 配置化排版参数（页边距/行距/字体/默认模板版本） | ✅ v2.6.0+ |
 
-### DSH 插件配置化（v2.5.0+）
+### DSH 插件配置化（v2.6.0+）
 
 DSH 插件支持通过配置文件管理排版参数，Agent 调用时自动注入，纯 CLI 用户不受影响。
 
@@ -574,7 +574,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.5.0（多渠道自检已确认最新）
+Skill 版本: v2.6.1（版本自检已确认最新）
 路径判定: 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
    ```
 
 ### 七、会话交接（长任务收尾必须遵守）
@@ -897,7 +894,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.5.0+)
+// 公文全流程处理工具 - DSH plugin bridge (gongwen-skill, v2.6.1+)
 // (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/gongwen/__init__.py

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

package/gongwen/_legacy.py

@@ -45,7 +45,7 @@ from gongwen.cli.helpers import (
     parse_config_overrides as _parse_config_overrides,
     load_rules_with_overrides as _load_rules_with_overrides,
 )
-__version__ = "2.5.0"
+__version__ = "2.6.1"
 # 版本号应与 gongwen/__init__.py 保持一致，每次发版同步更新
 """
 中文公文全流程处理工具 —— 基于 GB/T 9704《党政机关公文格式》国家标准。
@@ -857,7 +857,7 @@ _STYLE_DEVIATION_HINTS = {
 # _VALID_STYLES 已迁移到 gongwen/cli/style_helpers.py
 
 
-# 官方镜像仓库（多渠道版本自检用）
+# 官方镜像仓库（GitHub 为 check-update 判定渠道，GitCode/AtomGit 作国内镜像）
 # PyPI JSON API（无需 git，pip 用户首选渠道）
 # ---------------------------------------------------------------------------
 #  字体管理（install/list/check）
@@ -1076,8 +1076,8 @@ def main():
     p = sub.add_parser("style-list", help="列出所有通过 style-learn 学习的自定义样式模板")
     p.set_defaults(func=cmd_style_list)
 
-    # ---- 多渠道版本自检（PyPI/GitHub/GitCode/AtomGit 比对取最新） ----
-    p = sub.add_parser("check-update", help="多渠道版本自检：查询 PyPI/GitHub/GitCode/AtomGit 四渠道最新版本，取最高版本比对本地")
+    # ---- 版本自检（PyPI pip 包权威判定，GitHub 备用，GitCode/AtomGit 作国内镜像） ----
+    p = sub.add_parser("check-update", help="版本自检：PyPI（pip 包权威）判定更新，GitHub 作备用渠道（GitCode/AtomGit 作国内镜像提示）")
     p.add_argument("--json", action="store_true",
                    help="输出 JSON 格式结果（便于 Agent 解析）")
     p.set_defaults(func=cmd_check_update)

package/gongwen/cli/helpers.py

@@ -38,7 +38,7 @@ TYPE_KEYWORDS = {
     "讲话稿": "speech", "主持词": "speech", "新闻稿": "news", "简报": "news",
 }
 
-# 官方镜像仓库（多渠道版本自检用）
+# 官方镜像仓库（GitHub 为 check-update 备用判定渠道，GitCode/AtomGit 作国内镜像）
 REPO_MIRRORS = {
     "GitHub": "https://github.com/linhut/gongwen-skill.git",
     "GitCode": "https://gitcode.com/linhut/gongwen-skill.git",

package/gongwen/cli/update_cmds.py

@@ -12,6 +12,7 @@ Extracted from _legacy.py (tier-2 split).
 """
 from __future__ import annotations
 import logging
+import os
 import time
 import subprocess
 
@@ -57,12 +58,72 @@ def _latest_tag_from_remote(remote_url: str, timeout: int = 15) -> tuple[bool, s
         return False, str(e)[:120]
 
 
-def cmd_check_update(args):
-    """多渠道版本自检：查询 PyPI/GitHub/GitCode/AtomGit 四渠道最新版本，取最高版本比对本地。
+# 判定渠道（版本从哪来）：
+#   - PyPI   ：发布源（pip 包核心分发渠道，权威判定——pip install -U 即从 PyPI 拉取）
+#   - GitHub ：代码仓库备用源（PyPI 不可达时回退；git 用户、CI 触发源）
+# GitCode/AtomGit 与 GitHub 是同一份 tag 的镜像（发布时同步 push），
+# 不列为判定渠道；仅在 GitHub 不可达时作为国内拉取/加速代理提示。
+# 设计参考 EasyTier「单权威源 + 加速代理」：权威 = PyPI（pip 包），镜像只做加速提示。
+_JUDGMENT_CHANNELS = ("PyPI", "GitHub")
+
+# 渠道分级超时（秒）：GitHub 为海外渠道，国内常超时，用短超时快速降级；
+# PyPI 有国内镜像 CDN，可用较长超时。
+_CHANNEL_TIMEOUTS = {
+    "PyPI": 10,
+    "GitHub": 8,
+}
+
+# 国内代码镜像（加速代理层，非判定渠道）：GitHub 不可达时的 git 拉取替代。
+# 从 REPO_MIRRORS 派生（排除 GitHub），避免 URL 重复维护。
+_GIT_MIRRORS = {k: v for k, v in REPO_MIRRORS.items() if k != "GitHub"}
+
+
+def _detect_install_type() -> str:
+    """检测当前 gongwen 的安装形态，返回 "pip" | "git" | "unknown"。
+
+    - pip     ：gongwen 代码位于 site-packages（pip install 安装）
+    - git     ：gongwen 代码位于 git 工作树内（skill 目录 / git clone 安装）
+    - unknown ：无法判定（非标准位置）
+    用于在检测到更新时给出与安装形态匹配的精准更新命令。
+    """
+    try:
+        import gongwen
+        code_dir = os.path.dirname(os.path.abspath(gongwen.__file__))
+        if "site-packages" in code_dir or "dist-packages" in code_dir:
+            return "pip"
+        # 检查是否位于 git 工作树内
+        probe = subprocess.run(
+            ["git", "-C", code_dir, "rev-parse", "--is-inside-work-tree"],
+            capture_output=True, text=True, timeout=5, encoding="utf-8",
+        )
+        if probe.returncode == 0 and probe.stdout.strip().lower() == "true":
+            return "git"
+        return "unknown"
+    except Exception:
+        return "unknown"
+
+
+def _fetch_channel(name: str, url: str | None, timeout: int) -> tuple[str, bool, str]:
+    """查询单个渠道，返回 (渠道名, 是否成功, 版本或错误信息)。
+
+    在线程池中执行；内部已捕获异常，不会向外抛出。
+    """
+    if name == "PyPI":
+        ok, val = _latest_version_from_pypi(timeout=timeout)
+    else:
+        ok, val = _latest_tag_from_remote(url, timeout=timeout)
+    return name, ok, val
+
 
-    渠道优先级：PyPI（pip 用户首选）> GitHub > GitCode > AtomGit
-    全部不可达时明确告知并返回退出码 2。
-    支持 --json 输出结构化结果，便于 Agent 解析。
+def cmd_check_update(args):
+    """版本自检：以 PyPI（pip 包发布源）为权威判定，GitHub 作备用渠道。
+
+    权威判定：PyPI（pip 包核心分发渠道，pip install -U 即从此拉取）。
+    备用判定：GitHub（PyPI 不可达时回退 tag 查询；git 用户、CI 触发源）。
+    GitCode/AtomGit 与 GitHub 同步同 tag，不参与版本判定（零增量），
+    仅在 GitHub 不可达时作为国内拉取镜像提示（JSON 输出于 mirrors 字段）。
+    全部渠道不可达时明确告知并返回退出码 2。
+    支持 --json 输出结构化结果，便于 Agent 解析（含 authoritative_channel 字段）。
     """
     import json as _json
     t0 = time.time()
@@ -71,36 +132,40 @@ def cmd_check_update(args):
     local_ver = __version__
 
     if not use_json:
-        print(f"🔍 版本自检（多渠道，本地 v{local_ver}）")
+        print(f"🔍 版本自检（pip 包权威：PyPI 判定 + GitHub 备用，本地 v{local_ver}）")
         print(f"{'─' * 50}")
 
     results: dict[str, str] = {}
     ok_count = 0
 
-    # 渠道1：PyPI（无需 git，pip 用户首选）
-    ok, val = _latest_version_from_pypi()
-    if ok:
-        results["PyPI"] = val
-        ok_count += 1
-        if not use_json:
-            print(f"  ✅ PyPI     最新: {val}")
-    else:
-        results["PyPI"] = ""
-        if not use_json:
-            print(f"  ⚠️  PyPI     不可达: {val}")
-
-    # 渠道2-4：Git 仓库
-    for name, url in REPO_MIRRORS.items():
-        ok, val = _latest_tag_from_remote(url)
-        if ok:
-            results[name] = val
-            ok_count += 1
-            if not use_json:
-                print(f"  ✅ {name:<8} 最新: {val}")
-        else:
-            results[name] = ""
-            if not use_json:
-                print(f"  ⚠️  {name:<8} 不可达: {val}")
+    # 判定渠道并发查询：PyPI（权威，pip 包发布源）+ GitHub（备用，tag 查询）。
+    # 两渠道并发，总耗时 = 最坏单渠道超时（GitHub 短超时快速降级）。
+    from concurrent.futures import ThreadPoolExecutor
+    channels = [
+        (name, REPO_MIRRORS[name] if name in REPO_MIRRORS else None)
+        for name in _JUDGMENT_CHANNELS
+    ]
+    with ThreadPoolExecutor(max_workers=len(channels)) as pool:
+        futures = [pool.submit(_fetch_channel, name, url, _CHANNEL_TIMEOUTS[name])
+                   for name, url in channels]
+        for fut in futures:
+            name, ok, val = fut.result()
+            if ok:
+                results[name] = val
+                ok_count += 1
+                if not use_json:
+                    print(f"  ✅ {name:<8} 最新: {val}")
+            else:
+                results[name] = ""
+                if not use_json:
+                    print(f"  ⚠️  {name:<8} 不可达: {val}")
+
+    # GitHub 海外渠道不可达时，给出国内加速指引（EasyTier 式加速代理 + GitHub520 hosts）
+    if not use_json and results.get("GitHub", "") == "" and ok_count > 0:
+        print("  💡 国内访问 GitHub 常超时，可用国内代码镜像：")
+        for _name, _url in _GIT_MIRRORS.items():
+            print(f"     - {_name}: {_url}")
+        print("     或参考 GitHub520 hosts 加速方案：https://github.com/521xueweihan/GitHub520")
 
     if not use_json:
         print(f"{'─' * 50}")
@@ -111,18 +176,29 @@ def cmd_check_update(args):
             print("   ⚠️ 版本自检因无法访问远程而跳过，本地版本可能不是最新")
             print("   💡 拉取地址：")
             print("      - PyPI:  pip install --upgrade gongwen-skill")
-            for name, url in REPO_MIRRORS.items():
+            for name in _JUDGMENT_CHANNELS:
+                if name == "PyPI":
+                    continue
+                print(f"      - {name}: {REPO_MIRRORS[name]}")
+            for name, url in _GIT_MIRRORS.items():
                 print(f"      - {name}: {url}")
         return 2
 
-    # 取多渠道中的最高版本
-    valid = [v for v in results.values() if v]
-    latest = max(valid, key=_parse_version)
+    # pip 包为核心分发渠道：版本判定以 PyPI（pip 包发布源）为权威，
+    # PyPI 不可达时回退 GitHub tag（备用渠道，git 用户可见）；GitCode/AtomGit 不参与判定。
+    if results.get("PyPI"):
+        latest = results["PyPI"]
+        authoritative = "PyPI"
+    elif results.get("GitHub"):
+        latest = results["GitHub"]
+        authoritative = "GitHub"
+    else:
+        valid = [v for v in results.values() if v]
+        latest = max(valid, key=_parse_version) if valid else "v0.0.0"
+        authoritative = "未知"
 
-    # 判断安装方式（用于给出对应的更新命令）
-    # pip 安装的用户应使用 pip install --upgrade，git clone 的用户应使用 git pull
     pypi_ok = bool(results.get("PyPI"))
-    git_ok = any(results.get(name) for name in REPO_MIRRORS)
+    git_ok = bool(results.get("GitHub"))
 
     has_update = _parse_version(latest) > _parse_version(local_ver)
 
@@ -136,6 +212,9 @@ def cmd_check_update(args):
                 name: {"reachable": bool(v), "version": v.lstrip("v") if v else None}
                 for name, v in results.items()
             },
+            "mirrors": {name: url for name, url in _GIT_MIRRORS.items()},
+            "authoritative_channel": authoritative,
+            "install_type": _detect_install_type(),
             "reachable_channels": ok_count,
             "elapsed_seconds": round(time.time() - t0, 1),
         }
@@ -144,16 +223,31 @@ def cmd_check_update(args):
 
     # 人类可读输出
     if has_update:
-        print(f"📢 有更新可用：最新版 {latest}，当前 v{local_ver}")
-        print("   更新命令：")
-        if pypi_ok:
+        install_type = _detect_install_type()
+        print(f"📢 有更新可用：最新版 {latest}（权威渠道 {authoritative}），当前 v{local_ver}")
+        if install_type == "pip":
+            print("   检测到 pip 包安装，请升级 pip 包：")
             print("     pip install --upgrade gongwen-skill")
-        if git_ok:
+        elif install_type == "git":
+            print("   检测到 git/skill 目录安装，请更新代码：")
             print("     cd <gongwen-skill目录> && git pull && git fetch --tags")
+            print("   （或若以 pip 包使用，可执行：pip install --upgrade gongwen-skill）")
+        else:
+            print("   pip 包为核心分发渠道，请用 pip 升级：")
+            print("     pip install --upgrade gongwen-skill")
+            if git_ok:
+                print("   （源码安装用户备选：cd <gongwen-skill目录> && git pull && git fetch --tags）")
         print(f"⏱️  自检耗时 {time.time() - t0:.1f}s")
         return 1
     elif _parse_version(latest) == _parse_version(local_ver):
-        print(f"✅ 已是最新版本：v{local_ver}（多渠道一致）")
+        if ok_count >= 2:
+            if pypi_ok:
+                print(f"✅ 已是最新版本：v{local_ver}（PyPI pip 包权威确认，GitHub 备用一致）")
+            else:
+                print(f"✅ 已是最新版本：v{local_ver}（GitHub 备用渠道确认，兼容此版本）")
+        else:
+            src = "PyPI（pip 包权威）" if pypi_ok else "GitHub（备用）"
+            print(f"✅ 已是最新版本：v{local_ver}（单渠道确认：{src}）")
     else:
         print(f"ℹ️  本地版本 v{local_ver} 高于远程 {latest}（本地领先或渠道不同步）")
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gongwen-skill",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "公文全流程处理工具 - GB/T 9704 格式检查/修复/内容优化/模板生成/版式注入",
   "type": "module",
   "main": "dsh/index.js",

package/prompts/usage-prompts.md

@@ -201,7 +201,7 @@ python -m gongwen optimize 文件.docx -o 优化版.docx
 **Agent 响应**：
 ```
 📋 合规自检报告
-Skill 版本: v2.5.0
+Skill 版本: v2.6.1
 路径判定: B（内容优化）
 依据: 用户提供纯文本+优化要求，无已有文档
 命令调用: 将原文保存为临时文件后执行 optimize-content --apply --paragraphs "1-3"

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gongwen-skill"
-version = "2.5.0"
+version = "2.6.1"
 description = "公文全流程处理工具 - GB/T 9704 格式检查/修复/内容优化/模板生成/版式注入"
 readme = "README.md"
 license = {text = "MIT"}