dsh-plugin-pscad-expert-vyma 1.0.5 → 1.0.7

package/README.md

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

package/index.js

@@ -79,7 +79,9 @@ function runPy(tool, args, config, signal) {
 }
 
 // ---------------- 工具渲染（纯函数：不做 I/O） ----------------
-function renderJson(value) {
+// 注意：DSH 框架以 render(args, value) 双参调用渲染器；若只声明单参 value，
+// 实际收到的是 args，导致"成功结果恒显示参数/{}"。必须双参并取第二个参数。
+function renderJson(_args, value) {
   if (value && typeof value === 'object' && value.error === 'ConfigMissing') {
     // 配置缺失：引导 Agent 立即停止当前任务并询问用户路径
     return [{ type: 'text', text: `【配置缺失】${value.instruction}` }]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-pscad-expert-vyma",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "PSCAD 自动化建模与仿真控制专家插件（DSH Agent 工具库 + 基准模板 + 领域知识）",
   "type": "module",
   "main": "index.js",
@@ -30,7 +30,10 @@
     "plugin.yaml",
     "README.md",
     "index.js",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "!tools/__pycache__/",
+    "!**/*.pyc",
+    "!**/*.pyo"
   ],
   "engines": {
     "python": ">=3.7"

package/plugin.yaml

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

package/tools/cli.py

@@ -27,9 +27,33 @@ from typing import Any, Dict, List
 # 将本文件所在目录加入 sys.path，以便 import main（tools/main.py）
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
+# 统一 stdout 为 UTF-8：Node 桥接按 UTF-8 解码，避免 GBK 中文乱码（Python 3.7+）
+try:
+    sys.stdout.reconfigure(encoding='utf-8')
+    sys.stderr.reconfigure(encoding='utf-8')
+except Exception:
+    pass
+
 import main as pat  # noqa: E402
 
+def _run_simulation_configure(time_duration: float = 0.5,
+                              time_step: float = 10.0,
+                              sample_step: float = 50.0,
+                              timeout_loops: int = 60) -> Dict[str, Any]:
+    """组合工具：先配置仿真参数（configure_simulation），再编译运行并监控。
+
+    对应桥接层 pscad_run_simulation 的复合语义（配置 + 运行一步到位）。
+    """
+    cfg = pat.configure_simulation(time_duration=time_duration,
+                                   time_step=time_step,
+                                   sample_step=sample_step)
+    if cfg.get('status') != 'success':
+        return cfg
+    return pat.run_simulation_and_monitor(timeout_loops=timeout_loops)
+
+
 # 白名单：仅暴露经过审核的工具函数（防止任意 Python 代码执行）
+# 同时收录桥接层 index.js 注册的 pscad_* 工具名（别名），消除名字脱节。
 TOOL_WHITELIST: Dict[str, Any] = {
     'init_pscad_environment': pat.init_pscad_environment,
     'connect_and_load_project': pat.connect_and_load_project,
@@ -50,6 +74,15 @@ TOOL_WHITELIST: Dict[str, Any] = {
     'close_connection': pat.close_connection,
     'build_droop_chain': pat.build_droop_chain,
     'self_check': pat.self_check,
+    # ---- 桥接层别名（index.js 注册的 pscad_* 工具名）----
+    'pscad_init_environment': pat.init_pscad_environment,
+    'pscad_connect_load_project': pat.connect_and_load_project,
+    'pscad_add_component': pat.add_and_configure_component,
+    'pscad_connect_ports': pat.connect_ports_safely,
+    'pscad_connect_signal': pat.connect_signal_by_name,
+    'pscad_run_simulation': _run_simulation_configure,
+    'pscad_read_output': pat.read_output,
+    'pscad_self_check': pat.self_check,
 }
 
 

package/tools/main.py

@@ -109,44 +109,73 @@ _NAME_HINT: Dict[str, str] = {
 }
 
 # ---------------------------------------------------------------------------
-# 本地配置持久化（工作区 .pscad_config.json）
+# 本地配置持久化（用户级优先：PSCAD 路径是机器属性，跨工作区共享）
+# 查找顺序：PSCAD_CONFIG_DIR 环境变量 → 用户级(DSH_HOME/主目录) → 工作区级(兼容旧版)
 # ---------------------------------------------------------------------------
 _config_cache: Optional[Dict[str, Any]] = None
 
 
-def _config_path() -> str:
-    """配置文件绝对路径（默认当前工作目录；可被环境变量 PSCAD_CONFIG 覆盖）。"""
-    base = os.environ.get('PSCAD_CONFIG_DIR') or os.getcwd()
+def _user_config_path() -> str:
+    """用户级配置路径：优先 DSH_HOME，其次用户主目录。"""
+    dsh_home = os.environ.get('DSH_HOME')
+    base = dsh_home if dsh_home else os.path.expanduser('~')
     return os.path.join(base, CONFIG_FILE_NAME)
 
 
+def _config_path() -> str:
+    """配置写入路径（保存时使用）：显式 PSCAD_CONFIG_DIR 优先，否则用户级。"""
+    env_dir = os.environ.get('PSCAD_CONFIG_DIR')
+    if env_dir:
+        return os.path.join(env_dir, CONFIG_FILE_NAME)
+    return _user_config_path()
+
+
 def load_config() -> Dict[str, Any]:
-    """加载工作区本地配置 ``.pscad_config.json``。
+    """加载 PSCAD 路径配置（多级查找，**跨工作区共享**）。
+
+    查找顺序：
+      1. 环境变量 ``PSCAD_CONFIG_DIR`` 指定目录下的 ``.pscad_config.json``；
+      2. 用户级：``$DSH_HOME/.pscad_config.json``（无 DSH_HOME 时用用户主目录）——
+         一次配置，所有工作区/所有会话共享，**不依赖任何插件仓库目录**；
+      3. 工作区级：当前目录 ``.pscad_config.json``（兼容旧版本遗留配置）。
 
     配置键：``pscad_exe_path``（PSCAD 可执行文件）、``mhi_pylib_path``
     （mhi.pscad 库目录）、``pscad_port``（自动化端口，可选）、``saved_at``。
 
     Returns:
-        配置字典；文件不存在或损坏时返回 ``{}``（**绝不抛异常**）。
+        配置字典；均不存在或损坏时返回 ``{}``（**绝不抛异常**）。
         结果会缓存，供懒加载与连接逻辑读取。
     """
     global _config_cache
     if _config_cache is not None:
         return _config_cache
-    try:
-        path = _config_path()
-        if os.path.isfile(path):
-            with open(path, encoding='utf-8') as fh:
-                _config_cache = json.load(fh)
-        else:
-            _config_cache = {}
-    except Exception:
-        _config_cache = {}
+    candidates: List[str] = []
+    env_dir = os.environ.get('PSCAD_CONFIG_DIR')
+    if env_dir:
+        candidates.append(os.path.join(env_dir, CONFIG_FILE_NAME))
+    candidates.append(_user_config_path())
+    candidates.append(os.path.join(os.getcwd(), CONFIG_FILE_NAME))
+    cfg: Dict[str, Any] = {}
+    for path in candidates:
+        try:
+            if os.path.isfile(path):
+                with open(path, encoding='utf-8') as fh:
+                    data = json.load(fh)
+                if isinstance(data, dict) and data:
+                    cfg = data
+                    break
+        except Exception:
+            continue
+    _config_cache = cfg
     return _config_cache
 
 
 def save_config(exe_path: str, pylib_path: str) -> Dict[str, Any]:
-    """将 PSCAD 路径配置持久化到工作区 ``.pscad_config.json``。
+    """将 PSCAD 路径配置持久化到**用户级** ``.pscad_config.json``（跨工作区共享）。
+
+    写入位置：``PSCAD_CONFIG_DIR`` 环境变量（若设置）→ 否则 ``$DSH_HOME``（无则用户
+    主目录）。**不写入当前工作区**——保证在其他任意工作区、其他电脑（无插件仓库）
+    都能通过 load_config 读到同一份配置。
 
     Args:
         exe_path: PSCAD 可执行文件绝对路径（如 '<PSCAD_INSTALL_DIR>/bin/win64/Pscad.exe'）。