gongwen-skill 2.6.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,13 @@
   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

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` | 版本自检（PyPI + 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 + GitHub 双判定渠道）
+# 版本自检（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`——以 **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 +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.6.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.6.0"
+    "gongwen-skill": "^2.6.1"
   },
   "dsh": {
     "profile": {
@@ -574,7 +574,7 @@ pip install -r requirements.txt
 用户：帮我优化这份会议通知的第二章节措辞
 
 Agent：📋 合规自检报告
-Skill 版本: v2.6.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.6.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.6.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.6.0"
+__version__ = "2.6.1"
 # 版本号应与 gongwen/__init__.py 保持一致，每次发版同步更新
 """
 中文公文全流程处理工具 —— 基于 GB/T 9704《党政机关公文格式》国家标准。
@@ -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 作国内镜像）
+# 官方镜像仓库（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
 
@@ -58,11 +59,11 @@ def _latest_tag_from_remote(remote_url: str, timeout: int = 15) -> tuple[bool, s
 
 
 # 判定渠道（版本从哪来）：
-#   - PyPI   ：发布源（pip 用户首选，国内有镜像）
-#   - GitHub ：代码仓库权威源（git 用户，CI 触发源）
+#   - PyPI   ：发布源（pip 包核心分发渠道，权威判定——pip install -U 即从 PyPI 拉取）
+#   - GitHub ：代码仓库备用源（PyPI 不可达时回退；git 用户、CI 触发源）
 # GitCode/AtomGit 与 GitHub 是同一份 tag 的镜像（发布时同步 push），
-# 参与版本判定零增量，不列为判定渠道；仅在 GitHub 不可达时作为
-# 国内拉取/加速代理提示（参考 EasyTier「单权威源 + 加速代理」设计）。
+# 不列为判定渠道；仅在 GitHub 不可达时作为国内拉取/加速代理提示。
+# 设计参考 EasyTier「单权威源 + 加速代理」：权威 = PyPI（pip 包），镜像只做加速提示。
 _JUDGMENT_CHANNELS = ("PyPI", "GitHub")
 
 # 渠道分级超时（秒）：GitHub 为海外渠道，国内常超时，用短超时快速降级；
@@ -77,6 +78,31 @@ _CHANNEL_TIMEOUTS = {
 _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]:
     """查询单个渠道，返回 (渠道名, 是否成功, 版本或错误信息)。
 
@@ -90,13 +116,14 @@ def _fetch_channel(name: str, url: str | None, timeout: int) -> tuple[str, bool,
 
 
 def cmd_check_update(args):
-    """版本自检：以 PyPI + GitHub 双判定渠道取最高版本比对本地。
+    """版本自检：以 PyPI（pip 包发布源）为权威判定，GitHub 作备用渠道。
 
-    判定渠道：PyPI（发布源，pip 用户首选）+ GitHub（代码仓库权威源，CI 触发源）。
+    权威判定：PyPI（pip 包核心分发渠道，pip install -U 即从此拉取）。
+    备用判定：GitHub（PyPI 不可达时回退 tag 查询；git 用户、CI 触发源）。
     GitCode/AtomGit 与 GitHub 同步同 tag，不参与版本判定（零增量），
     仅在 GitHub 不可达时作为国内拉取镜像提示（JSON 输出于 mirrors 字段）。
-    全部判定渠道不可达时明确告知并返回退出码 2。
-    支持 --json 输出结构化结果，便于 Agent 解析。
+    全部渠道不可达时明确告知并返回退出码 2。
+    支持 --json 输出结构化结果，便于 Agent 解析（含 authoritative_channel 字段）。
     """
     import json as _json
     t0 = time.time()
@@ -105,13 +132,13 @@ def cmd_check_update(args):
     local_ver = __version__
 
     if not use_json:
-        print(f"🔍 版本自检（PyPI + GitHub 判定，本地 v{local_ver}）")
+        print(f"🔍 版本自检（pip 包权威：PyPI 判定 + GitHub 备用，本地 v{local_ver}）")
         print(f"{'─' * 50}")
 
     results: dict[str, str] = {}
     ok_count = 0
 
-    # 判定渠道并发查询：PyPI（发布源）+ GitHub（代码权威源）。
+    # 判定渠道并发查询：PyPI（权威，pip 包发布源）+ GitHub（备用，tag 查询）。
     # 两渠道并发，总耗时 = 最坏单渠道超时（GitHub 短超时快速降级）。
     from concurrent.futures import ThreadPoolExecutor
     channels = [
@@ -157,12 +184,19 @@ def cmd_check_update(args):
                 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 = bool(results.get("GitHub"))
 
@@ -179,6 +213,8 @@ def cmd_check_update(args):
                 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),
         }
@@ -187,19 +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):
         if ok_count >= 2:
-            print(f"✅ 已是最新版本：v{local_ver}（PyPI 与 GitHub 一致）")
+            if pypi_ok:
+                print(f"✅ 已是最新版本：v{local_ver}（PyPI pip 包权威确认，GitHub 备用一致）")
+            else:
+                print(f"✅ 已是最新版本：v{local_ver}（GitHub 备用渠道确认，兼容此版本）")
         else:
-            print(f"✅ 已是最新版本：v{local_ver}（单渠道确认）")
+            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.6.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.6.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.6.0"
+version = "2.6.1"
 description = "公文全流程处理工具 - GB/T 9704 格式检查/修复/内容优化/模板生成/版式注入"
 readme = "README.md"
 license = {text = "MIT"}