DSH_Eplan:在本机操控 EPLAN P8 并离线查阅多版本文档

前言

在 DeepSeek Harness(DSH)里做 EPLAN Electric P8 相关的智能体工作,常见难点有两类:一是要让助手能连上正在运行的 P8 并执行动作,而不是只给泛泛建议;二是查 API、对话框和平台帮助时,若依赖外部托管 RAG,查询会离开本机,且往往缺少与当前安装版本精确对应的 2025 材料。社区里 Bochica 已把 EPLAN 能力接到 MCP 生态;维护者 shangyunqiang1 的 DSH_Eplan(GitHub:shangyunqiang1/DSH_Eplan)将其整理为 DSH bundle 插件:内置 eplan-mcp 驱动本机 P8,五套文档写入本地 SQLite,附带设置页与五个 agent 技能。下面按定位、能力、安装与典型核对步骤说明用法。

这是什么

DSH_Eplan(npm 包名 dsh-eplan,当前资料版本 0.2.4)是 DeepSeek Harness 的工作流类插件 bundle。简介(目录与 README 一致):面向 EPLAN Electric P8 的本地自动化 MCP、P8 2025 离线 .NET API 参考与平台用户手册,以及 2026 / 2027 / EEC Pro 的离线索引(后三者默认关闭,索引来自 Release 资源)。许可为 MIT;Node 引擎要求 ^22.19.0 || >=24.0.0,并依赖 peer @deepseek-ai/dsh-mcp-client 的指定版本区间。

相对 Bochica,资料强调两点:新增 P8 2025 版本精确的离线 API 索引(解析本机 Eplan.EplApi.*u.xml,12 个程序集、36,493 个成员)与 Plattform/2025 平台用户手册(2,691 页);并将 2026 / 2027 / EEC Pro 从云端 RAG 改为一次性爬取 www.eplan.help 写入本地 SQLite,日常检索不再联网。资料特别提醒:API 参考(eplan2025)与 用户手册(eplan2025guide)是不同 MCP,问菜单、选项、流程时应走手册服务。

核心功能

六个 MCP 服务器

MCP 服务器 工具前缀 说明(据 README)
eplan mcp__eplan__* 本地 EPLAN 自动化;上游 eplan-mcp v1.3.0,默认 discovery 模式 15 个工具,full 模式约 248 个;经 Remote Client 驱动运行中的 EPLAN
eplan2025 mcp__eplan2025__* P8 2025.0.3 .NET API 离线参考,纯本地
eplan2025guide mcp__eplan2025guide__* P8 2025 平台用户手册离线索引,纯本地
eplan2026 mcp__eplan2026__* 本地爬取的 2026 API + 平台帮助;默认 disabled: true
eplan2027 mcp__eplan2027__* 本地爬取的 2027 文档;默认 disabled: true
eecpro mcp__eecpro__* EEC Pro 2026 帮助;装好后默认启用

插件列表中会分别显示条目名称(如「EPLAN 远程连接」「P8 2025 · API 参考」等),不再是一串同名的 MCP 客户端别名。cordis.patch.yml 通过相对路径启动器与 !!js 计算 cwd,资料写明不含绝对路径,换目录解压无需改 YAML。

五个技能

skills/ 下:eplan(路由与连接/安全)、eplan-scripting(C# 与 API)、eplan-docs(文档版本与 API/手册分流)、eec-pro-development、eplan-setup(安装、验证、重建索引与爬取)。技能在新开会话或重启 DSH 后进入技能列表;主插件 index.js 还会向系统提示注入 eplan:integration,说明本机版本、工具发现与安全规则。

设置页

设置 → 插件 → dsh-eplan 提供 EPLAN Platform 目录选择(自动探测注册表、环境变量 EPLAN_PLATFORM_ROOT 等),结果写入 runtime\eplan-platform-root.txt;另有版本记录与 GitHub Release 驱动的「检查更新」(针对 link: 本地目录安装,宿主自带更新按钮不适用的情况)。

安装与启用

前置条件

  1. 已安装 EPLAN Electric P8 2025(README 示例路径 C:\Program Files\EPLAN\Platform\2025.0.3),并在 文件 → 设置 → 工作站 → 接口 → 远程访问 勾选「允许通过 Remote Client 远程访问」。
  2. Python 3.12+,具备 mcp(>=1.19,<2)与 pythonnet;setup.ps1 会探测解释器并写入 runtime\python-path.txt,vendor 已随插件入库。
  3. 已安装 DeepSeek Harness(desktop profile)。
  4. 仅首次构建 2025 平台手册或 2026/2027/EEC Pro 本地索引时需能访问 www.eplan.help;2025 API 索引来自本机 XML。

初始化与装入 DSH

先进入解压后的插件根目录,再执行官方脚本完成 Python/EPLAN 路径与 2025 API 索引构建;随后在 DSH 里从该目录安装插件。

# 进入插件根目录(示例路径请按本机修改)
Set-Location "C:\path\to\DSH_Eplan"

# 初始化:解析 Python、探测 EPLAN、构建 data\eplan2025.sqlite 等
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\setup.ps1

setup.ps1 支持 -Python、-PlatformRoot、-RebuildIndex、-SkipIndex 等可选参数。第二步在 DSH 中:插件 → 安装 → 选择上述插件根目录(README 另提到也可用 git 地址安装,具体以仓库安装章节为准)。

装好后默认挂载 4 个 MCP:eplan、eplan2025、eplan2025guide、eecpro;eplan2026 与 eplan2027 在配置中为 disabled: true,需要时在 设置 → 插件 启用,并确保 Release 中的索引已解压到 data\。

典型用法与验证

连接与自动化前,先用 MCP 自检版本、索引与(可选)工具搜索。下表来自 README 验证清单,可在 DSH 会话中逐项调用。

检查 期望
mcp__eplan__eplan_versions 报告 2025 / 2025.0.3,runtime netfx
mcp__eplan__eplan_status 未 eplan_connect 时 connected: false;连接后 api_loaded: true
mcp__eplan__eplan_tools_search({query:"pdf"}) 返回如 eplan_export_pdf_project 等工具
mcp__eplan2025__eplan2025_stats 36,493 成员,库约 35 MB
mcp__eplan2025guide__eplan2025_guide_search({query:"connection numbering"}) 返回带官方帮助页 Source URL 的手册条目

写 C# 脚本或查类型成员时,配合技能 eplan-scripting 与 eplan2025;问对话框、设置项、命令路径时用 eplan-docs 与 eplan2025guide。若 EPLAN 被弹窗阻塞,discovery 工具含 eplan_list_dialogs / eplan_click_dialog_button(README 说明)。修改 Platform 目录后需重新加载 eplan MCP(停用/启用或重启 DSH),因 PLATFORM_ROOT 仅在进程启动时读取。

适用场景与注意

适合:已在 Windows 上日常使用 P8 2025,希望在 DSH 里用同一套会话完成「连上正在运行的 EPLAN → 查版本精确文档 → 脚本/API 问题分流」的电气设计自动化与工作流辅助。

注意:

  • 插件以 当前 DSH 进程权限 运行,安装前应阅读源码、LICENSE 与 THIRD_PARTY_NOTICES.md,确认 Remote Client 与自动化范围可接受。
  • 本机主版本为 2025 时,不要默认打开 2026/2027 MCP,除非确有跨版本文档需求且索引已就绪。
  • 社区目录 SkillHub 上的 DSH_Eplan 页 与 GitHub 为独立信息源,与 DeepSeek / 幻方无官方从属关系;星标等元数据以各站点当时显示为准(资料抓取时 GitHub 3 stars)。

结尾

DSH_Eplan 把 Bochica 路线的 EPLAN MCP 与文档检索收进一个可本地部署的 DSH bundle:运行态操控走 eplan,2025 API 与平台手册走本地 SQLite,更长周期的 2026/2027/EEC Pro 可按需启用。进一步细节见仓库 README、各技能正文及 references/ 下的专题说明。

  • 目录页:https://www.skillhub.cn/plugins/shangyunqiang1/DSH_Eplan
  • GitHub:https://github.com/shangyunqiang1/DSH_Eplan
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye