把 LadDoc 变成 TIA Portal 能导入的块
Deterministic LadDoc validation & SimaticML generation, over the Model Context Protocol.
LadDoc 是 JSON 格式的 PLC 梯形图文档，专为 AI 生成与修改梯形图设计——不是 Lua 的 LDoc，也不是 Teladoc。 LadDoc Cloud 是面向 AI 编程助手的云端 MCP 服务：Claude Code、Cursor 等助手提交 LadDoc， 服务先按 lad-ir 的 D9 规则校验，再确定性生成 SimaticML 块文件（FC / FB / OB），可直接导入 TIA Portal V19。 微信扫码即得 API Key，新用户赠送 100 次免费调用。
使用微信扫描二维码登录后自动开通 · 无需注册
严格校验
按 lad-ir 的 D9 规则逐层校验：文档形状、块接口、网络与并行分支、操作数与
FC/FB 调用；可选传入目标工程 inventory 做符号交叉检查。返回可直接定位的
code / path / message。
确定性生成
同一份 LadDoc 永远生成完全相同的 SimaticML：UId 与连线由生成器自动分配，
输出 V19 <SW.Blocks.FC|FB|OB> 文档，可直接被 TIA Portal 导入。
校验即生成门槛
生成前强制校验：只要有一条 issue 就不产出 XML，避免把无法导入的块交给 TIA。 修改后重试即可，工具会返回全部剩余问题。
MCP 标准接入
Streamable HTTP 端点 https://tia.hubwiz.com/lad/mcp，API Key 鉴权，Claude Code、
Cursor、VS Code 等客户端开箱即用。
三步开始
- 微信扫码登录 — 自动开通账户并颁发 API Key（仅存哈希，绝不泄露明文）。
- 配置 MCP 客户端 — 在 Claude Code / Cursor 中填入 MCP 地址与 API Key，见 配置指南。
- 让助手生成块 — 提交 LadDoc，先校验再生成，把返回的 XML 导入 TIA Portal。
三个 MCP 工具
| 工具 | 用途 |
|---|---|
lad_version | 免费返回本服务实现的 LAD-IR 身份（schemaVersion / bundleHash / sourceCommit） |
lad_validate | 校验一个 LadDoc 文档，返回 valid 与 issues |
lad_generate | 校验通过后生成一个 SimaticML 块 XML |
initialize / tools/list / lad_version 不计费；其余 tools/call 每次消耗 1 次额度。
按需购买额度
新用户免费 100 次；用完后微信扫码支付，到账即时，无订阅无月费。
常见问题
LadDoc 是什么？和 LDoc / Teladoc 有关系吗？
LadDoc 是 JSON 格式的 PLC 梯形图文档，专为 AI 生成与修改梯形图设计。 AI 直接产出结构化 JSON，LadDoc Cloud 校验后生成 TIA Portal V19 可导入的 SimaticML。 它和 Lua 的文档生成器 LDoc、美股的 Teladoc 都没有关系。
为什么用 JSON，而不是让 AI 直接生成 XML？
JSON 更适合 AI 生成和修改：字段清晰、可逐层校验、diff 友好，模型不容易拼错标签。 XML 由 LadDoc Cloud 在服务端确定性生成（UId 与连线自动分配），并且校验不过就不产出—— 这样把“AI 生成”和“TIA 能导入”分开，避免把格式错误的块交给博途。
LadDoc Cloud 和 TXT2LAD 有什么区别？
LadDoc Cloud 是云端 MCP：输入 LadDoc（JSON），输出 V19 SimaticML 文件， 给 AI 助手/自动化流程用；TXT2LAD 是博途 Add-In：在博途里用自然语言描述需求， 由云端生成 LAD 块并回写项目，适合工程师即时生成。前者可版本化、可批量、可接 CI。
生成结果可靠吗？
生成器是确定性的：同一份 LadDoc 永远得到相同的 XML。输出结构与 lad-ir 的 TIA V19 导出语料和 Openness XSD 对齐，UId 从 21 起按网络自动分配。
为什么生成前必须校验？
直接降低一份非法文档会产出“看起来合理但 TIA 拒绝导入”的块。服务因此把校验 作为生成的硬门槛：有任何 issue 就返回问题清单，不产出 XML。
API Key 如何保管？
服务端只保存密钥的 SHA-256 哈希，明文仅在创建时显示一次。可在控制台随时轮换或吊销。
额度如何计算？
每次被接受的 tools/call 扣 1 次（一次调用提交一个文档）；
initialize、tools/list 等握手请求不计费。余额不足时工具返回 QUOTA_EXHAUSTED。
支持哪些客户端？
任何支持 Streamable HTTP 的 MCP 客户端，包括 Claude Code、Cursor、VS Code （Copilot Chat MCP）以及 MCP Inspector。