前言¶
在 DeepSeek Harness（DSH）裏做西門子 TIA Portal（博途）相關開發時，常見做法是分別找文檔、手寫 LadDoc/SimaticML、再進博途覈對或上機調試。DSH 本身支持 skill（通過 ctx.skills 與文件系統掃描 <project>/.dsh/skills、.agents/skills、~/.dsh/skills），但沒有 dsh skill add 這類命令——技能只能「拷文件到掃描目錄」或由插件在 apply() 裏 register()。若要把查文檔、生成梯形圖、渲染預覽、雲端仿真、本機網關操作工程連成一條鏈，需要自己拼 MCP 與 SKILL.md。dsh-tiaforge 由 tia-forge 維護，在社區目錄分類爲「工作流」，把五個技能與五個 MCP 端點打成一個 bundle，裝一次即可在模型側看到完整能力。
這是什麼¶
dsh-tiaforge（npm 包名 dsh-tiaforge，當前版本 0.2.2）是 TIA Forge for DeepSeek Harness 的組合插件：五個博途相關 skill + 五個 MCP 客戶端，覆蓋「查文檔 → 生成梯形圖 → 看圖覈對 → 跑仿真 → 操作真實工程」。維護方信息見倉庫 package.json（匯智網 hubwiz.com）；GitHub 倉庫 tia-forge/dsh-tiaforge，社區目錄頁 skillhub.cn/plugins/tia-forge/dsh-tiaforge。DSH 社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
插件在 index.js 的 apply() 中讀取包內 skills/*/SKILL.md 並 ctx.skills.register()，同時通過 cordis.patch.yml 注入 MCP 配置；MCP 行均設 failOnStartupError: false，端點未就緒時插件仍可加載，對應工具不出現，不會拖垮 profile。
五個技能¶
| 名稱 | 說明 |
|---|---|
tialink-tia-portal |
AI 操作博途工程（V19/V20；未授權只讀） |
plc-cloud-sim |
雲端逐掃描仿真 + 場景 PASS/FAIL |
laddoc-cloud |
LadDoc → 博途可導入 SimaticML |
lad-render-cloud |
SimaticML → PNG，導入前預覽（計費，每次渲染扣 1 次） |
tia-portal-docs |
博途編程文檔檢索（get_docs） |
五個 MCP 端點¶
| 名稱 | 地址 | 備註 |
|---|---|---|
tialink |
http://127.0.0.1:8080/mcp |
本機 TiaLink 網關 |
tia-docs |
https://tia.hubwiz.com/ai-coding-docs/mcp |
文檔 |
plc-sim |
https://tia.hubwiz.com/sim/mcp |
仿真 |
laddoc |
https://tia.hubwiz.com/lad/mcp |
梯形圖生成 |
lad-render |
https://tia.hubwiz.com/render/mcp |
渲染（計費） |
不配 Key 或未裝 TiaLink 時，對應 MCP 在 initialize 階段可能 401，工具不可用；技能正文仍可被模型讀取，不依賴 MCP 也能當知識用。
安裝與啓用¶
Web profile（界面，推薦）¶
- 打開 DSH 左上角【插件】；
- 搜索
dsh-tiaforge； - 安裝後完全退出並重開 DSH（MCP 在啓動時建立連接）。
命令行¶
# 從 npm（預構建，推薦）
dsh plugin --profile web add dsh-tiaforge
# 從 GitHub（本倉庫的 dsh-plugin 目錄）
dsh plugin --profile web add github:tia-forge/dsh-tiaforge
裝完重啓 dsh web，並強刷瀏覽器。
Desktop profile¶
Desktop 與 Web 共用同一套插件語義，profile 目錄爲 $DSH_HOME/profiles/desktop。若用命令行安裝，須先用 Desktop 自帶 CLI（菜單 →「檢查更新…」下方「管理 dsh 命令…」），且先啓動並完全退出 Desktop 一次再執行：
dsh plugin --profile desktop add dsh-tiaforge
然後重新打開 Desktop。Desktop 無單獨「技能」頁面屬正常——技能由模型通過 skill 工具調用。
兼容性：engines.dsh 爲 >=0.2.0-rc.0 <0.2.1-rc.0 || >=0.2.1-rc.0 <0.3.0，需 Node >= 22。若安裝報 engines.dsh 不匹配，可升級 Desktop 或按 README 調整範圍。
配置 token（按需）¶
# TiaLink 本機網關
export TIALINK_TOKEN=...
export TIALINK_URL=http://192.168.1.78:8080/mcp # 網關在其它機器時
# 四個雲端服務（微信掃碼，各 100 次免費）
export TIA_DOCS_KEY=...
export TIA_SIM_KEY=...
export TIA_LAD_KEY=...
export TIA_RENDER_KEY=... # 渲染：每次扣 1 次，先扣後執行；render_version 免費
| Key | 免費額度 | 關聯技能 |
|---|---|---|
TIA_DOCS_KEY |
100 次 | tia-portal-docs |
TIA_SIM_KEY |
100 次 | plc-cloud-sim |
TIA_LAD_KEY |
100 次 | laddoc-cloud |
TIA_RENDER_KEY |
100 次 | lad-render-cloud |
典型用法與驗證¶
安裝後可用下面步驟確認 bundle 是否生效：
dsh --profile web --dump-config | grep -n tiaforge
應能看到組合後的相關配置行。啓動 Web 後，在對話中讓模型列出 TIA 相關技能，確認五個 skill 與已配 Key 的 MCP 工具可用。
工作流上可沿 README 描述的鏈條使用：先用 tia-portal-docs / 文檔 MCP 查 API 與編程說明；用 laddoc-cloud 從 LadDoc 生成 SimaticML；需要目視確認時用 lad-render-cloud（消耗渲染額度）；邏輯驗證用 plc-cloud-sim；本機已部署 TiaLink 時用 tialink-tia-portal 與本地 MCP 讀寫博途工程（未授權時爲只讀）。
適用場景與注意¶
適合在 DSH 裏做西門子 PLC / 博途相關 AI 輔助編程、文檔檢索、梯形圖生成與仿真驗證的開發者。插件以當前 dsh 進程權限運行；安裝前建議閱讀 GitHub 源碼 與許可證：插件代碼 MIT，各 SKILL.md 爲 CC BY 4.0；TiaLink 網關與四個 hubwiz 雲端服務爲商業軟件/服務，不在插件 MIT 範圍內。雲端渲染與部分 MCP 調用會產生額度消耗，生產環境請先評估 Key 與計費規則。
結尾¶
dsh-tiaforge 把 TIA Forge 的五技能五 MCP 收成一次安裝，彌補 DSH 沒有「一鍵加 skill」的空檔，適合把博途開發放進 Harness 工作流。更多信息見 社區目錄頁 與 GitHub 倉庫。
