夜雨聆风学习资料网

ARTICLE · 1270648

一个插件,十八般兵器:74 星的 totally-integrated-claude 把博途自动化拆成了技能地图

一个插件,十八般兵器:74 星的 totally-integrated-claude 把博途自动化拆成了技能地图

C3 用一个 MCP 服务器管所有操作,同作者的 C5 把博途自动化拆成一张技能地图——74 星,十八般兵器各管一摊。

01它解决什么问题 / 什么来头

totally-integrated-claude 是个 Claude Code 插件(同时兼容 Codex、VS Code 里的 GitHub Copilot 和 Copilot CLI),干的是博途工程自动化。注意它的形态:不是 MCP 服务器,而是一套跑在 AI 客户端里的「路由式技能框架」。

补个背景:Claude Code 这类工具的「技能(skill)」可以理解为给 AI 的岗位手册——什么任务按什么流程、调什么接口、守什么规矩,写成结构化文档,AI 干对应活时先翻手册。这个项目就是把博途自动化拆成入口、诊断、Python 路线、C# 路线、MAC 路线等十几本手册,再由一个「前台」负责分派。

那它和 MCP 服务器(本系列 C3)是什么关系?一句话:MCP 给 AI 的是「手」,skills 给 AI 的是「脑」。手负责调接口干活,脑负责知道该翻哪本手册、按什么顺序、守什么规矩。接口谁都能调,但「什么场景用什么接口、哪些坑不能踩」才是真经验——这些过去存在老师傅脑子里,现在写成结构化文档。反过来说,十几本手册同时塞给 AI,上下文瞬间撑爆,反而容易挑错本,所以必须有个前台做分诊。

02核心能力拆解

一、路由入口 tia-openness-roadmap。 总前台。你提一个工程任务,它尊重你明确指定的实现路线,判断该走 Python、C#、MAC Module Builder、诊断还是 Add-In 路径,自动加载对应领域技能;纯导出代码的审查直接走 plc-code-analysis。等于给 AI 装了个分诊台,避免它拿把螺丝刀就去拧钉子。

二、Python 路线 tia-python。 基于西门子官方的 TIA Scripting Python V1.4.3,覆盖 PLC 数据、通用 HMI 访问、设备、库、项目工作流,以及 CAx、CFC、项目文本、主拷贝、Test Suite 等场景。官方 wrapper 稳定、有 Siemens 背书,代价是能力面受官方封装范围限制。

这条路线接的是日常高频活:读写 PLC 块和变量表、HMI 画面访问导出、设备与库操作、项目工作流。README 的路由示例就很典型——「怎么读取打开着的博途项目里所有 PLC 变量表」,roadmap 会把它派给 tia-python。安装上两个细节:TIA Scripting Python 要从西门子工业在线支持下载,PyPI 上没有;装 wheel 时 CPython 标签要和解释器对上(比如 py -3.12 配 cp312)。版本兼容还留了个问号:V1.4.3 手册写支持 Openness V15.1 及以上,西门子包元数据另列 V18–V21,上手前按自己机器核实。

三、C# 路线:十一个领域技能。 重头戏,对应 V21 模块化 Openness 的各域程序集:tia-csharp-common(公共基础:进程挂接、ExclusiveAccess、事务、disposable 模式,每个 C# 任务的必载前置)打底,上面分 tia-project-general(项目与库生命周期)、tia-devices-general(硬件目录、槽位遍历)、tia-plc-operations(程序块、标签、软件单元、Safety、报警、OPC UA、工艺对象、监控强制表、在线下载)、tia-hmi-operations(HMI Classic 与 Unified)、tia-networks(拓扑)、tia-simatic-drives(Startdrive/SINAMICS)、tia-import-export(SimaticML/AML)、tia-multiuser(多用户工程)、tia-teamcenter(Teamcenter Gateway)、tia-testsuite(自动化测试)、tia-sivarc(规则表与可视化生成)。冷门如 Teamcenter、SiVArc 都有专门手册,这个覆盖面在开源圈少见。

四、MAC 与 Add-In 两条专线。 MAC 路径(tia-mac-module-builder)覆盖审计基线 MAC V21.0.5 的生命周期、生成物/自定义所有权、资源、打包与合格性边界;Add-In 路线(addin-operations)提供基于 VS Code 的 TIA Portal 插件开发工作流。

五、诊断与 API 基线。 tia-doctor 是只读 PowerShell 探针:检查精确的 V21 可执行文件、模块化 Openness 核心、Siemens.Engineering.Base.dll 和用户组成员身份,Python 检查可选。更有意思的是「Certified V21 API baselines」:托管 CI 验证提交的 installed-API 证据,不需要 runner 上装博途——技能里写的接口有没有、版本对不对,有机器把关。

03差异化亮点

广度是第一竞争力:从 PLC 块到 SINAMICS 驱动、从多用户工程到 Teamcenter、从 TestSuite 到 SiVArc,一个插件把博途自动化的边疆画了个遍。第二是「一个插件,多家客户端」:Claude Code、Codex、VS Code/Copilot、Copilot CLI 共用同一套 skills 内容,安装方式各异但内核一致。第三是自带 Siemens Docs MCP(siemens-docs):通过 uvx 启动,实时搜索 docs.tia.siemens.cloud——注意这是文档搜索服务,不是直连博途的通道,README 特意澄清了「插件捆绑的是西门子文档服务器,不是活的 TIA Portal 连接」。第四,README 直接推荐搭配同作者的 Tia Portal MCP Server(本系列 C3):一个管「知道怎么做」,一个管「动手操作」,官方 CP 实锤。

04怎么上手

安装按客户端来:Claude Code 里 /plugin marketplace add Czarnak/totally-integrated-claude;Codex 用 codex plugin marketplace add;VS Code 先把 chat.plugins.enabled 设为 true,再「Chat: Install Plugin From Source」输入仓库地址;Copilot CLI 则 copilot plugin install Czarnak/totally-integrated-claude。依赖分路线备:Python 路线要从 Siemens 官网下载 TIA Scripting Python V1.4.3(不是 PyPI 装),配 Python 3.12–3.14;C# 路线要 TIA Portal V21、模块化 Openness API 和 .NET Framework 4.8;文档 MCP 要 uv 在 PATH。装完先跑 skills\tia-doctor\probe.ps1 -RequiredMajorVersion 21 体检,再让 AI 加载 roadmap 派活。

怎么确认装到位?VS Code 里两个入口:Chat: Configure Skills 里应能看到 tia-openness-roadmap,MCP: List Servers 里应列出 siemens-docs——后者靠 uvx 启动,PATH 里没装 uv 就会静默失败,这是「插件装了、文档搜索却不好使」最常见的原因。探针还支持 -Json 输出机器可读结果,方便写进团队装机检查脚本;只玩 C# 路线就加 -SkipPython 跳过 Python 检查。想本地改技能的话不必走 marketplace,把 checkout 路径加进 chat.pluginLocations 即可直接加载。

05客观说两句

第一,也是最重要的:它本身不是 MCP 服务器,不直连博途——真正「动手」要么走 TIA Scripting Python,要么配 C3 那样的 MCP 服务器,别装完发现连不上工程就骂娘。第二,技能多是优势也是负担:加载哪本手册全靠路由质量,派错路等于让 AI 现场翻错资料。第三,C# 路线门槛高:V21、模块化 API、.NET Framework 4.8,涉及 Teamcenter 和 MAC 的更是重型环境,个人开发者基本玩不转后半部分。第四,Python 路线受西门子官方 wrapper 能力面约束,不是万能钥匙。第五,74 星、MIT、2026-10 仍在更新,但技能基线和手册结构还在快速演进,可能变。

博途自动化的疆域很宽,这个插件选择先把地图画出来——路,让每本技能手册各自去修。

核心观点:

一个前台 + 十几本岗位手册:74 星的插件不替你操控博途,它让 AI 先学会「该翻哪本手册」。

🔗 原仓库 · GitHub

Czarnak/totally-integrated-claude

https://github.com/Czarnak/totally-integrated-claude

面向博途工程自动化的 Claude Code 插件:路由式技能框架,覆盖 Python 脚本、C# Openness 与 MAC 路线

★ 74 | MIT | PowerShell | 最近更新 2026-10

推荐标签

#PLC#AI#工业自动化#开源#西门子#TIA_Portal#ClaudeCode#AI技能

相关学习资料