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

package/README.md

@@ -1,6 +1,6 @@
 # pscad-dsh-plugin — PSCAD 自动化建模与仿真控制专家插件
 
-> **版本**：1.0.10 ｜ **注册名**：`pscad-automation-expert`
+> **版本**：1.0.12 ｜ **注册名**：`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.12",
   "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.12
 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()
@@ -492,6 +522,57 @@ def _gen_name(comp_type: str) -> str:
 # ---------------------------------------------------------------------------
 # 工具集 1：连接与工程加载（懒加载 mhi）
 # ---------------------------------------------------------------------------
+def _persist_case(prj: Any, project_name: str, folder: str) -> Optional[str]:
+    """尽力把会话内新建工程落盘，返回实际 .pscx 路径；找不到返回 None。
+
+    mhi-pscad 2.9.7 的 create_case(project_name, folder=...) 与 save() 都可能
+    不按 folder 写 .pscx（工程仅在 PSCAD 会话内存）。依次尝试：
+    ① save/save_as/save_case 变体；② prj 路径属性；③ 候选目录全盘搜同名文件。
+    """
+    expected = os.path.join(folder, project_name + '.pscx')
+    try:
+        # ① 常见保存 API
+        for meth, args in (('save', ()), ('save_as', (expected,)),
+                           ('save_case', (expected,))):
+            try:
+                fn = getattr(prj, meth)
+                fn(*args)
+            except Exception:
+                continue
+            if os.path.isfile(expected):
+                return expected
+        # ② prj 自带路径属性
+        for attr in ('path', 'filename', 'file_name', 'case_path',
+                     'project_path'):
+            try:
+                p = getattr(prj, attr)
+                if callable(p):
+                    p = p()
+                if isinstance(p, str) and p.lower().endswith('.pscx') \
+                        and os.path.isfile(p):
+                    return p
+            except Exception:
+                continue
+        # ③ 候选目录搜最近生成的同名文件
+        import glob as _glob
+        bases = [folder, os.getcwd(), os.path.expanduser('~/Documents'),
+                 os.path.expanduser('~/PSCAD')]
+        best = None
+        for base in bases:
+            try:
+                hits = _glob.glob(os.path.join(base, '**',
+                                               project_name + '.pscx'),
+                                  recursive=True)
+            except Exception:
+                hits = []
+            for h in hits:
+                if best is None or os.path.getmtime(h) > os.path.getmtime(best):
+                    best = h
+        return best
+    except Exception:
+        return None
+
+
 def connect_and_load_project(project_name: str,
                              folder: Optional[str] = None,
                              create_if_missing: bool = False,
@@ -528,6 +609,7 @@ def connect_and_load_project(project_name: str,
 
         folder = folder or (DEFAULT_FOLDER or os.getcwd())
         _prj_folder = folder
+        pscx_path: Optional[str] = None  # 实际落盘的 .pscx 路径（探测后回报）
 
         prj = None
         try:
@@ -541,13 +623,23 @@ def connect_and_load_project(project_name: str,
                 try:
                     _pscad.load(pscx.replace('\\', '/'))
                     prj = _pscad.project(project_name)
+                    pscx_path = pscx
                 except Exception as exc:
                     return _err('加载 %s 失败: %s' % (pscx, exc))
 
         if prj is None and create_if_missing:
             try:
+                # 目录不存在可能导致 create_case 静默不落盘：先确保目标目录存在
+                try:
+                    os.makedirs(folder, exist_ok=True)
+                except Exception:
+                    pass
                 _pscad.create_case(project_name, folder=folder)
                 prj = _pscad.project(project_name)
+                pscx_path = _persist_case(prj, project_name, folder)
+                if pscx_path:
+                    folder = os.path.dirname(pscx_path)  # 会话状态跟随真实落盘目录
+                    _prj_folder = folder
             except Exception as exc:
                 return _err('create_case 失败: %s' % exc)
 
@@ -563,7 +655,13 @@ def connect_and_load_project(project_name: str,
         except Exception as exc:
             _main = None
             return _err('打开 Main 画布失败: %s' % exc)
-        return _ok({'project': project_name, 'canvas': 'Main'})
+        result = {'project': project_name, 'canvas': 'Main',
+                  'pscx_path': pscx_path}
+        if create_if_missing and not pscx_path:
+            result['warning'] = ('create_case 未能在磁盘找到 .pscx（mhi 2.9.7 可能仅'
+                                 '内存建工程）：工程仅存在于当前 PSCAD 会话，退出即丢；'
+                                 '建议改用已有模板 .pscx 加载，或提供可写目录。')
+        return _ok(result)
     except Exception as exc:
         return _err(exc)