dsh-plugin-pscad-expert-vyma 1.0.0 → 1.0.2

package/cordis.patch.yml

@@ -0,0 +1,2 @@
+id: pscad-expert-bridge
+name: PSCAD Expert Agent Loader

package/index.js

@@ -0,0 +1,24 @@
+const fs = require('fs');
+const path = require('path');
+
+exports.name = 'pscad-expert-bridge';
+
+exports.apply = function (ctx) {
+    ctx.on('ready', () => {
+        try {
+            const baseDir = ctx.baseDir || process.cwd();
+            const targetDir = path.join(baseDir, 'plugins', 'dsh-plugin-pscad-expert-vyma');
+            
+            if (!fs.existsSync(targetDir)) {
+                fs.mkdirSync(targetDir, { recursive: true });
+                fs.cpSync(__dirname, targetDir, { 
+                    recursive: true,
+                    filter: (src) => !src.includes('node_modules') && !src.includes('.git')
+                });
+                ctx.logger('pscad-bridge').info('PSCAD Agent 资产已成功跨层释放！');
+            }
+        } catch (err) {
+            ctx.logger('pscad-bridge').error('释放资产失败:', err);
+        }
+    });
+};

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "dsh-plugin-pscad-expert-vyma",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "PSCAD 自动化建模与仿真控制专家插件（DSH Agent 工具库 + 基准模板 + 领域知识）",
-  "main": "plugin.yaml",
+  "main": "index.js",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
   "keywords": [
     "dsh",
     "pscad",
@@ -17,7 +22,9 @@
     "tools/",
     "templates/",
     "plugin.yaml",
-    "README.md"
+    "README.md",
+    "index.js",
+    "cordis.patch.yml"
   ],
   "engines": {
     "python": ">=3.7"

package/plugin.yaml

@@ -3,9 +3,18 @@
 # 由知识资产固化项目自动生成（2026-08-25）· 部署至 Git 仓库
 # ============================================================
 name: pscad-automation-expert
-version: 1.0.0
+version: 1.0.2
 description: PSCAD 自动化建模与仿真控制专家插件
 
+# ---- 系统提示词（加载到 Agent 上下文最前置位置）----
+system_prompt: |
+  【环境配置最高优先级规则】当调用工具返回 ConfigMissing 错误时，你必须立刻停止当前任务，
+  主动且礼貌地在聊天界面询问用户的 PSCAD 安装路径，并引导他们完成配置。
+
+  你是 PSCAD 自动化建模与仿真控制专家。当调用任何工具返回 `ConfigMissing` 错误时，
+  你必须立刻停止调用其他工具，主动在聊天界面中询问用户 PSCAD 的安装路径，
+  并引导他们完成配置（调用 init_pscad_environment 工具保存路径）。
+
 # ---- 工具入口注册（tools/main.py 中的核心函数）----
 entry_points:
   tools:

package/tools/main.py

@@ -71,9 +71,12 @@ DEFAULT_FOLDER: str = os.environ.get("PSCAD_WORK_DIR", "")  # 无硬编码；空
 LAUNCH_WAIT_S: int = 60
 CONNECT_TIMEOUT_S: int = 20
 
-MISSING_CONFIG_MSG = (
-    '未找到 PSCAD 路径配置。请先使用 init_pscad_environment 工具进行设置。'
-)
+# 配置缺失时的标准 Agent 返回（裸字典，供大模型识别并触发对话式引导）
+CONFIG_MISSING_RESPONSE: Dict[str, str] = {
+    "error": "ConfigMissing",
+    "instruction": "本地未找到配置。请中止操作，用自然语言向用户询问其 PSCAD 的安装路径，获取后调用 init_pscad_environment 工具保存。",
+}
+MISSING_CONFIG_MSG = CONFIG_MISSING_RESPONSE['instruction']
 
 # 元件默认参数（实测合法值；调用方 params 覆盖默认值）
 COMPONENT_DEFAULTS: Dict[str, Dict[str, Any]] = {
@@ -242,6 +245,26 @@ def _err(exc: Union[Exception, str]) -> Dict[str, Any]:
     return {"status": "error", "message": str(exc)}
 
 
+def _require_config() -> Optional[Dict[str, Any]]:
+    """统一配置存在性检查（所有会连接 PSCAD 的工具函数入口调用）。
+
+    若工作区本地无 ``.pscad_config.json``（且无环境变量回退），**不抛异常、
+    不崩溃**，直接返回标准引导字典：:
+
+        {"error": "ConfigMissing",
+         "instruction": "本地未找到 PSCAD 配置。请立即中止当前操作，使用自然语言
+         向用户询问其 PSCAD 的安装路径，获取后调用 init_pscad_environment 工具进行保存。"}
+
+    大模型收到该返回后应停止调用其他工具、在聊天界面询问用户路径。
+
+    Returns:
+        配置缺失时返回 ``CONFIG_MISSING_RESPONSE``（裸字典）；配置可用返回 ``None``。
+    """
+    if _cfg_exe() and _cfg_pylib():
+        return None
+    return CONFIG_MISSING_RESPONSE
+
+
 def _import_mhi() -> Tuple[bool, str]:
     """懒加载 mhi.pscad（仅在实际需要连接 PSCAD 时调用）。
 
@@ -378,6 +401,10 @@ def connect_and_load_project(project_name: str,
     """
     global _pscad, _prj, _prj_name, _prj_folder, _main
     try:
+        # 对话式引导：配置缺失时立即返回 ConfigMissing 引导字典（不崩溃）
+        missing = _require_config()
+        if missing is not None:
+            return missing
         ok, msg = _ensure_connected()
         if not ok and auto_launch:
             launched, msg2 = _launch_pscad()
@@ -476,6 +503,10 @@ def restart_pscad() -> Dict[str, Any]:
     """
     global _pscad, _prj, _main
     try:
+        # 对话式引导：配置缺失时返回 ConfigMissing 引导字典（不崩溃）
+        missing = _require_config()
+        if missing is not None:
+            return missing
         if _pscad is not None:
             try:
                 _pscad.close_connection()