gongwen-skill 2.14.0 → 2.15.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@
   Licensed under the MIT License. See the LICENSE file for details.
 -->
 
+## v2.15.0 (2026-10-01)
+
+### Fixed
+- **npm peer 依赖在 DSH 0.2.0-rc.2 宿主上安装失败（P1，GitHub issue #2「0.2.0 rc-2装上就报错」）**：DSH 宿主升级到 0.2.0-rc.2 线后，其捆绑的 `@deepseek-ai/dsh-tools@0.2.0-rc.2` 与 `@deepseek-ai/dsh-client-ui-settings-plugins@0.2.0-rc.2` 均不满足 v2.14.0 声明的 peer 范围（`>=0.1.5-rc.3` / `>=0.1.2-rc.1`）。根因是 node-semver 的预发布逐线放行规则：范围里带预发布版本（如 `0.1.5-rc.3`）的比较器，只允许**相同 [major,minor,patch] 元组**的预发布版本参与匹配，0.2.0 线因此整体不可达 → pnpm 解析 peer 报 `ERR_PNPM_NO_MATCHING_VERSION`（与 issue #1 同根，属宿主升线后的复发性问题）
+  - `@deepseek-ai/dsh-tools` peer 改为多线锚定：`>=0.1.2-alpha.1 || >=0.1.5-alpha.1 || >=0.1.7-alpha.1 || >=0.2.0-0`（实测覆盖 0.1.2/0.1.5/0.1.7/0.2.0 全部已发布预发布线，与 npm 全部 30 个已发布版本匹配 16 个关键线）
+  - `@deepseek-ai/dsh-client-ui-settings-plugins` peer 改为：`>=0.1.2-rc.1 || >=0.1.5-rc.1 || >=0.2.0-0`
+  - **新增 `peerDependenciesMeta` 将 4 个 `@deepseek-ai/*` peer 全部标为 `optional: true`**：DSH 桌面端市场安装后这些宿主单例原就会被移除、运行时统一走宿主共享副本（issue #1 已核实的安装模型），optional 化后安装期不再因 peer 版本线漂移失败，未来宿主再升线也不受影响；运行时 import 仍解析到宿主提供的副本（版本由宿主保证）
+  - `doctor`（O2 peer 检查）版本解析升级：`_parse_version_tuple` 支持 `-alpha.N` / `-0` 预发布标记，新增 `_peer_branch_minima` 按 `||` OR 分支保守判定（安装版本 ≥ 任一分支下限即满足），避免对多线范围误报
+- **doctor O1 宿主版本检查兼容 0.2.0 线**：`_parse_version_tuple` 预发布段由仅识别 `-rc.N` 扩展为通用 `-<tag>N`（rc/alpha/裸数字），0.2.0-rc.2 正确判定 ≥ 0.1.2-rc.1，不再误报
+
+### Notes
+- 本版为 DSH 插件安装兼容性修复，CLI 功能无变化；纯 CLI 用户不受影响
+
+---
+
 ## v2.14.0 (2026-09-26)
 
 ### Added

package/dsh/index.js

@@ -1,4 +1,4 @@
-// 公文全流程处理专家 - DSH plugin bridge (gongwen-skill, v2.14.0+)
+// 公文全流程处理专家 - DSH plugin bridge (gongwen-skill, v2.15.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/gongwen/__init__.py

@@ -7,7 +7,7 @@
 #
 # 公文全流程处理专家 - gongwen-skill Python package
 
-__version__ = "2.14.0"
+__version__ = "2.15.0"
 
 # 对外展示名（单一事实来源）：面向人与模型的运行时展示文案统一引用此常量，
 # 须与 SKILL.md frontmatter description 首句、.claude-plugin/plugin.json displayName、

package/gongwen/_legacy.py

@@ -16,7 +16,7 @@ from gongwen.cli.helpers import (
     parse_config_overrides as _parse_config_overrides,
     load_rules_with_overrides as _load_rules_with_overrides,
 )
-__version__ = "2.14.0"
+__version__ = "2.15.0"
 # 版本号应与 gongwen/__init__.py 保持一致，每次发版同步更新
 """
 中文公文全流程处理专家 —— 基于 GB/T 9704《党政机关公文格式》国家标准。

package/gongwen/cli/doctor_cmds.py

@@ -717,17 +717,42 @@ def _check_display_name_consistency() -> dict:
 
 
 def _parse_version_tuple(v: str):
-    """解析 1.2.3 / 4 / 3.18.0 / 0.1.2-rc.1 → 可比较元组（rc.N 视为预发布）。
+    """解析 1.2.3 / 4 / 3.18.0 / 0.1.2-rc.1 / 0.1.2-alpha.1 / 0.1.2-0 → 可比较元组。
 
-    rc.N 预发布 < 同版本正式版（rc 取有限数，正式版取 inf）。
+    rc.N / alpha.N / 预发布 0 < 同版本正式版（预发布取末尾数字段，正式版取 inf）。
     无法解析返回 None（调用方按不满足处理，保守）。
     """
     import re as _re
-    m = _re.match(r"^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-rc\.(\d+))?$", v.strip())
+    m = _re.match(r"^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z.]+))?$", v.strip())
     if not m:
         return None
-    return (int(m.group(1)), int(m.group(2) or 0), int(m.group(3) or 0),
-            int(m.group(4)) if m.group(4) else float("inf"))
+    major, minor, patch = int(m.group(1)), int(m.group(2) or 0), int(m.group(3) or 0)
+    pre = m.group(4)
+    if pre is None:
+        return (major, minor, patch, float("inf"))
+    # 预发布取末尾数字段近似（rc.1→1、alpha.1→1、0→0、裸 rc→0），
+    # 仅用于 doctor 下限比较，不追求与 node-semver 逐线规则完全一致
+    seg = pre.split(".")[-1]
+    n = int(seg) if seg.isdigit() else 0
+    return (major, minor, patch, n)
+
+
+def _peer_branch_minima(range_str: str) -> list:
+    """把 peer 范围（可能含 `||` OR 多线）拆成各分支版本下限元组列表。
+
+    背景：DSH 宿主按 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0 等预发布线迭代，
+    peer 范围需多线锚定（npm semver 预发布逐线放行），doctor 据此做保守检查：
+    安装版本 ≥ 任一分支下限即视为满足（比 node-semver 略宽松，宁可少报）。
+    """
+    out = []
+    for branch in (range_str or "").split("||"):
+        b = branch.strip().lstrip(">=").strip()
+        if not b:
+            continue
+        t = _parse_version_tuple(b)
+        if t is not None:
+            out.append(t)
+    return out
 
 
 def _dsh_profiles() -> list:
@@ -828,7 +853,7 @@ def _check_dsh_peer_deps() -> dict:
     problems = []
     checked = 0
     for peer, minimum in peers.items():
-        min_key = _parse_version_tuple(minimum.lstrip(">=").strip())
+        branch_mins = _peer_branch_minima(minimum)
         installed = []
         for nm in nm_dirs:
             pkg = nm / peer / "package.json"
@@ -844,7 +869,9 @@ def _check_dsh_peer_deps() -> dict:
         checked += 1
         for profile, ver in installed:
             key = _parse_version_tuple(ver)
-            if key is None or key < min_key:
+            # 满足 = 不低于任一分支下限（多线 OR 保守判定）
+            ok = key is not None and any(key >= mn for mn in branch_mins)
+            if not ok:
                 problems.append(f"{peer}: {profile}={ver or '未知'}（要求 {minimum}）")
     if problems:
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gongwen-skill",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "公文全流程处理专家 - GB/T 9704 格式检查/修复/内容优化/模板生成/版式注入",
   "type": "module",
   "main": "dsh/index.js",
@@ -46,9 +46,15 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.3",
+    "@deepseek-ai/dsh-tools": ">=0.1.2-alpha.1 || >=0.1.5-alpha.1 || >=0.1.7-alpha.1 || >=0.2.0-0",
     "@deepseek-ai/schemastery": ">=3.18.0",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.2-rc.1"
+    "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.2-rc.1 || >=0.1.5-rc.1 || >=0.2.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": { "optional": true },
+    "@deepseek-ai/dsh-tools": { "optional": true },
+    "@deepseek-ai/schemastery": { "optional": true },
+    "@deepseek-ai/dsh-client-ui-settings-plugins": { "optional": true }
   },
   "scripts": {
     "prepack": "node scripts/clean-cache.js",

package/prompts/usage-prompts.md

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

package/pyproject.toml

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