前言¶
在 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 仓库。
