dsh-tiaforge

dsh-tiaforge —— DeepSeek Harness 插件

把 TIA Forge 的五个工具技能 + 一个学习教练和五个 MCP 端点打成一个组合包（bundle）：

装一次，DSH 里就有「查文档 → 生成梯形图 → 看图核对 → 跑仿真 → 操作真实工程」这条链。

> 为什么需要它：DSH 本身支持 skill（ctx.skills + 文件系统提供方，扫 /.dsh/skills、.agents/skills、~/.dsh/skills），

> 但没有 dsh skill add 这类命令 —— skill 只能靠"把文件放到扫描目录"或"插件注册"进来。

> 这个包用后者：index.js 在 apply() 里读包内 skills/*/SKILL.md，直接 ctx.skills.register()。

> 所以你不需要拷文件、也不需要配 customSkillDirs。

装

A. 桌面端界面装（推荐，三步）

1. 点 DSH 左上角【插件】；

2. 输入 dsh-tiaforge；

3. 点安装 → 完全退出并重开 DSH（MCP 连接是在启动时建立的）。

装完模型侧就能看到 六个技能 + 五个已接入的服务，全程不用开终端、不用改配置文件。

B. 命令行（写脚本、批量装、或 dsh web 里找不到插件入口时）

# 从 npm（预构建，推荐）
dsh plugin --profile web add dsh-tiaforge

# 从 GitHub（本仓库的 dsh-plugin 目录）
dsh plugin --profile web add github:tia-forge/dsh-tiaforge

装完重启 dsh web，并强刷浏览器。

它装了什么

| 类型 | 名称 | 说明 |

|---|---|---|

| 技能 | tialink-tia-portal | AI 操作博途工程（V19 / V20 / V21；未授权只读） |

| 技能 | 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（本机网关） |

| MCP | tia-docs | https://tia.hubwiz.com/ai-coding-docs/mcp |

| MCP | plc-sim | https://tia.hubwiz.com/sim/mcp |

| MCP | laddoc | https://tia.hubwiz.com/lad/mcp |

| MCP | lad-render | https://tia.hubwiz.com/render/mcp（计费，见下） |

MCP 行全部设 failOnStartupError: false：端点没起来（没装 TiaLink、没配 Key）时插件照常加载，只是对应的工具不出现，不会拖垮 profile。

桌面端（Desktop）

Desktop 是 dsh Web 应用的 Electron 壳，插件语义完全一致（同一个共享插件管理器、同一个 profile runner），

只是 profile 目录不同：$DSH_HOME/profiles/desktop，且由 Electron 独占。

> 走 A（界面安装）不会碰到下面这两条 —— 它们只在你用命令行往 Desktop 里装时才有关。

两个硬约束（官方 apps/desktop/README.zh.md）：

1. 先用 npm 装的 dsh 管不了它 —— 必须用 Desktop 自带的 CLI：菜单 →「检查更新…」下方「管理 dsh 命令…」→ 安装，然后新终端里 dsh --version。

2. 第一次要先用 Desktop 启动一次（初始化 profile），然后完全退出应用，再执行安装命令。

# 1) 启动一次 Desktop 再完全退出
# 2) 装好 Desktop 自带 CLI 后：
dsh plugin --profile desktop add dsh-tiaforge
# 3) 重新打开 Desktop

Desktop 里没有"技能"页面——这不是缺功能：技能是模型调用的（skill 工具 + 目录注入），

本插件在 apply() 里注册，所以桌面端一样能用到，不需要任何 UI。

若安装被拒且报 engines.dsh 不匹配：Desktop 的 dsh 版本与打包版本严格一致，

升级 Desktop，或把 package.json 的 engines.dsh 放宽到覆盖你的版本。

配 token（三选一，按需）

# ① TiaLink 本机网关（默认 127.0.0.1:8080，装了 token 就填）
export TIALINK_TOKEN=...
export TIALINK_URL=http://192.168.1.78:8080/mcp   # 网关在另一台机器时

# ② 四个云端服务各自一把 Key（微信扫码，各 100 次免费）