dsh-plugin-pscad-expert-vyma 1.0.10 → 1.0.11

package/README.md

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

package/index.js

@@ -29,7 +29,8 @@ export const Config = Schema.object({
     .description('Python 解释器路径；默认自动探测（PATH→py 启动器→常见安装位置），无需手动配置'),
   toolsCli: Schema.string().default('./tools/cli.py'),
   defaultFolder: Schema.string().default(''),
-  timeoutMs: Schema.number().default(120000),
+  timeoutMs: Schema.number().default(300000)
+    .description('单次工具调用总超时（毫秒）；PSCAD 冷启动等待上限 180s，需留余量'),
 })
 
 // ---------------- Python 解释器自动探测（免 profile YAML 配置） ----------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-pscad-expert-vyma",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "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.10
+version: 1.0.11
 description: PSCAD 自动化建模与仿真控制专家插件
 
 # ---- 系统提示词（加载到 Agent 上下文最前置位置）----

package/tools/main.py

@@ -68,7 +68,7 @@ from typing import Any, Dict, List, Optional, Tuple
 CONFIG_FILE_NAME: str = '.pscad_config.json'   # 工作区本地配置文件
 PSCAD_PORT: int = int(os.environ.get("PSCAD_PORT", "54329"))
 DEFAULT_FOLDER: str = os.environ.get("PSCAD_WORK_DIR", "")  # 无硬编码；空则回退当前工作目录
-LAUNCH_WAIT_S: int = 60
+LAUNCH_WAIT_S: int = 180  # PSCAD 冷启动（拉起→自动化端口就绪）实测可能 >60s，放宽到 180s
 CONNECT_TIMEOUT_S: int = 20
 
 # 配置缺失时的标准 Agent 返回（裸字典，供大模型识别并触发对话式引导）
@@ -228,15 +228,31 @@ def init_pscad_environment(exe_path: str, pylib_path: str = '') -> Dict[str, Any
     """
     try:
         if not pylib_path:
-            discovered = _discover_pylib(exe_path)
-            if discovered:
-                pylib_path = discovered
+            # ① site-packages 已有 pip 版 mhi-pscad（Python 3.12+ 机器常见）：
+            #    直接使用（空 pylib 表示不记录路径，运行时优先直导），无需发现
+            ok_sp, _ = _trial_import_mhi('')
+            if ok_sp:
+                pylib_path = ''
             else:
+                discovered = _discover_pylib(exe_path)
+                if discovered:
+                    pylib_path = discovered
+                else:
+                    return {'error': 'ConfigMissing',
+                            'instruction': ('未能在 PSCAD 安装目录自动发现 mhi.pscad，'
+                                            'site-packages 也无可用版本。请确认 PSCAD 5.x '
+                                            '安装完整（应有 bin/win64/mhi.zip），或 '
+                                            'pip install mhi-pscad 后重试，或手动提供 '
+                                            'mhi.pscad 库路径后再调用 init_pscad_environment。')}
+        # 保存前试导入验证：防止自动发现/指定路径在当前 Python 下不可导入
+        # （如 mhi.zip 2.2.1 依赖 Python 3.12 已移除的 distutils）时，把原本
+        # 可用的配置覆盖成坏配置。导入失败一律不保存，返回引导。
+        if pylib_path:
+            ok_imp, imp_msg = _trial_import_mhi(pylib_path)
+            if not ok_imp:
                 return {'error': 'ConfigMissing',
-                        'instruction': ('未能在 PSCAD 安装目录自动发现 mhi.pscad。'
-                                        '请确认 PSCAD 5.x 安装完整（应有 '
-                                        'bin/win64/mhi.zip），或手动提供 mhi.pscad '
-                                        '库路径后再调用 init_pscad_environment。')}
+                        'instruction': ('mhi.pscad 无法在当前 Python 下导入，配置未保存：%s'
+                                        % imp_msg)}
         r = save_config(exe_path, pylib_path)
         if r['status'] == 'success':
             r['data']['message'] = ('PSCAD 环境配置已保存。后续连接将自动使用该配置，'
@@ -246,6 +262,20 @@ def init_pscad_environment(exe_path: str, pylib_path: str = '') -> Dict[str, Any
         return _err(exc)
 
 
+def _trial_import_mhi(pylib: str) -> Tuple[bool, str]:
+    """试导入验证：确认 pylib（目录或 zip；空串=仅 site-packages 直导）可导入 mhi.pscad。
+
+    不抛异常；失败返回带指引的消息（Python ≥3.12 的 distutils 问题等）。
+    """
+    try:
+        if pylib and pylib not in sys.path:
+            sys.path.insert(0, pylib)
+        import mhi.pscad  # noqa: F401
+        return True, ''
+    except Exception as exc:
+        return False, _mhi_import_error(exc, pylib or '<site-packages>')
+
+
 def _cfg_exe() -> Optional[str]:
     """解析 PSCAD 可执行文件路径：本地配置优先，环境变量降级回退。"""
     cfg = load_config()
@@ -548,6 +578,12 @@ def connect_and_load_project(project_name: str,
             try:
                 _pscad.create_case(project_name, folder=folder)
                 prj = _pscad.project(project_name)
+                # mhi 2.9.7 的 create_case 可能只在 PSCAD 会话内存建工程、不落盘
+                # （与 2.2.1 语义差异）；显式 save() 保证 folder 下生成 .pscx
+                try:
+                    prj.save()
+                except Exception:
+                    pass
             except Exception as exc:
                 return _err('create_case 失败: %s' % exc)