前言¶
在 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: 本地目錄安裝,宿主自帶更新按鈕不適用的情況)。
安裝與啓用¶
前置條件¶
- 已安裝 EPLAN Electric P8 2025(README 示例路徑
C:\Program Files\EPLAN\Platform\2025.0.3),並在 文件 → 設置 → 工作站 → 接口 → 遠程訪問 勾選「允許通過 Remote Client 遠程訪問」。 - Python 3.12+,具備
mcp(>=1.19,<2)與pythonnet;setup.ps1會探測解釋器並寫入runtime\python-path.txt,vendor 已隨插件入庫。 - 已安裝 DeepSeek Harness(desktop profile)。
- 僅首次構建 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