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
羽毛球分组比赛记分
小程序二维码

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

小夜