dsh-plugin-pscad-expert-vyma 1.0.14 → 1.0.15

package/README.md

@@ -1,6 +1,6 @@
 # pscad-dsh-plugin — PSCAD 自动化建模与仿真控制专家插件
 
-> **版本**：1.0.14 ｜ **注册名**：`pscad-automation-expert`
+> **版本**：1.0.15 ｜ **注册名**：`pscad-automation-expert`
 > **来源**：PSCAD 知识资产固化项目（四阶段：技能文档 → 模板索引 → 工具库 → 插件打包）
 > 所有知识、工具、模板均来自真实仿真验证（L13~L19 认证轮 + R4 科研轮），**无伪造数据**。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-pscad-expert-vyma",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "PSCAD 自动化建模与仿真控制专家插件（DSH Agent 工具库 + 基准模板 + 领域知识）",
   "type": "module",
   "main": "index.js",

package/plugin.yaml

@@ -3,7 +3,7 @@
 # 由知识资产固化项目自动生成（2026-08-25）· 部署至 Git 仓库
 # ============================================================
 name: pscad-automation-expert
-version: 1.0.14
+version: 1.0.15
 description: PSCAD 自动化建模与仿真控制专家插件
 
 # ---- 系统提示词（加载到 Agent 上下文最前置位置）----

package/scripts/self_heal_pscad_plugin.ps1

@@ -53,9 +53,9 @@ if (-not (Test-Path -LiteralPath $pkgJson)) {
 Copy-Item -LiteralPath $pkgJson -Destination "$pkgJson.bak-$(Get-Date -Format yyyyMMdd-HHmmss)" -Force
 $text = [System.IO.File]::ReadAllText($pkgJson, [System.Text.Encoding]::UTF8)
 
-# 4a) 依赖版本号：无论当前写的是什么，统一替换为最新版
-$new = $text -replace '("dsh-plugin-pscad-expert-vyma"\s*:\s*")[^"]*(")', ('${1}' + $latest + '${2}')
-if ($new -notmatch ('"' + $pkg + '"\s*:\s*"' + [regex]::Escape($latest) + '"')) {
+# 4a) 依赖版本号：无论当前写的是什么，统一替换为 ^最新（^ 范围让后续 dsh plugin up 可解析新版本）
+$new = $text -replace '("dsh-plugin-pscad-expert-vyma"\s*:\s*")[^"]*(")', ('${1}^' + $latest + '${2}')
+if ($new -notmatch ('"' + $pkg + '"\s*:\s*"\^?' + [regex]::Escape($latest) + '"')) {
     Write-Host "  !! 未在 dependencies 找到插件条目，无法自动改版本，请先把上方输出发回。" -ForegroundColor Red
     exit 1
 }

package/tools/main.py

@@ -55,6 +55,7 @@ from __future__ import annotations
 import json
 import os
 import re
+import socket
 import sys
 import time
 import math
@@ -668,6 +669,21 @@ def connect_and_load_project(project_name: str,
         return _err(exc)
 
 
+def _port_ready(port: int, timeout_s: float = 1.0) -> bool:
+    """毫秒~秒级 TCP 端口探测：PSCAD 自动化端口是否已监听。
+
+    背景（P5 实测）：mhi-pscad 2.9.7 的 connect(timeout=5) 在 PSCAD 未运行时会
+    内部重试阻塞 ~16s，不尊重超时参数；轮询循环若直接调 connect，单次迭代
+    ≈18s，180s 名义上限实际只能尝试约 10 次。改用 socket 探测后单次迭代 ≈2s，
+    且 connect 只在端口就绪后才调用。
+    """
+    try:
+        with socket.create_connection(('127.0.0.1', port), timeout=timeout_s):
+            return True
+    except Exception:
+        return False
+
+
 def _ensure_connected() -> Tuple[bool, str]:
     """确保存在活的 mhi 连接（幂等；懒加载 mhi）。"""
     global _pscad
@@ -680,6 +696,9 @@ def _ensure_connected() -> Tuple[bool, str]:
                 return True, ''
         except Exception:
             _pscad = None
+    # 端口未监听时直接快速失败（避免 mhi connect 阻塞 ~16s）
+    if not _port_ready(PSCAD_PORT, 0.5):
+        return False, 'PSCAD 自动化端口 %d 未就绪（PSCAD 未运行？）' % PSCAD_PORT
     try:
         _pscad = mhi.pscad.connect(port=PSCAD_PORT, timeout=CONNECT_TIMEOUT_S)
         return True, ''
@@ -760,7 +779,13 @@ def _ensure_project() -> Optional[Dict[str, Any]]:
 
 
 def _launch_pscad() -> Tuple[bool, str]:
-    """拉起 PSCAD 进程并等待自动化端口就绪（崩溃恢复标准路径；懒加载 exe 路径）。"""
+    """拉起 PSCAD 进程并等待自动化端口就绪（崩溃恢复标准路径；懒加载 exe 路径）。
+
+    轮询用 socket 端口探测（毫秒级）而非直接 mhi.pscad.connect：P5 实测
+    mhi 2.9.7 的 connect(timeout=5) 在 PSCAD 未起时阻塞 ~16s（不尊重超时），
+    直接调用会让 180s 名义上限实际只能尝试约 10 次；socket 探测使单次迭代
+    ≈2s，端口就绪后才调用 connect 建立自动化连接。
+    """
     global _pscad
     exe = _cfg_exe()
     if not exe:
@@ -770,12 +795,14 @@ def _launch_pscad() -> Tuple[bool, str]:
                           '/port:%d' % PSCAD_PORT, '/splash:false'])
         deadline = time.time() + LAUNCH_WAIT_S
         while time.time() < deadline:
+            if _port_ready(PSCAD_PORT, 1.0):
+                try:
+                    _pscad = mhi.pscad.connect(port=PSCAD_PORT,
+                                               timeout=CONNECT_TIMEOUT_S)
+                    return True, ''
+                except Exception:
+                    continue
             time.sleep(2)
-            try:
-                _pscad = mhi.pscad.connect(port=PSCAD_PORT, timeout=5)
-                return True, ''
-            except Exception:
-                continue
         return False, 'PSCAD 启动后 %ds 内端口未就绪' % LAUNCH_WAIT_S
     except Exception as exc:
         return False, str(exc)