> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 怎么把豆包和博途连接起来：TIA Portal 三步打通
- URL: https://www.hubwiz.com/blog/doubao-tia-portal-three-steps/
- Published: 2026-11-15T11:13:41.000Z
- Updated: 2026-11-15T11:13:53.000Z
- Description: 豆包会写 SCL 代码，但它写不进博途项目，也没法验证写得对不对。补中间那一层，再装一个插件包，三步就通。
- Author: admin
- Tags: 工业 AI, 博途, 豆包, MCP, PLC

「怎么把豆包和博途（TIA Portal）连接起来？」——没有一条现成的链接直接点。但这件事能做成，而且只要三步。

## 先说清楚：为什么现在不行

你已经试过的做法是**让它写、你粘进博途编译**。它写得像样，但两个洞一直没补上：**写不进工程，验不了对错**。

于是活儿变成这样：

- 变量表要你贴给它，它才知道地址对不对；
- 它给的块导进去报错，你回来改提示词再导；
- 编译错在哪，它不知道，得你念给它听。

省下来的打字时间，又花在来回搬。**根因不是模型不够强，是它碰不到你的工程，也拿不到工程的回话。**

## 缺的是一个"能被调用"的入口

豆包的客户端就在你本机——但**客户端本身没有碰博途的手段**。博途的工程只能通过西门子的 Openness 接口读写，而豆包不会说这套接口。所以缺的不是网络通道，是中间一层**把博途的动作翻译成"AI 能调用的工具"**的东西。

TiaLink 就是这层（[产品页与下载](https://tia.hubwiz.com/tia-link?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)）——**但它不是只把 Openness 包一层**，真正给出来的是整条链：

| 环节                                          | 靠什么                                                                                                                            | 要不要云服务         |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------- |
| 读懂老工程 → 项目知识图谱（IO 表、块清单、接口表、调用关系、变量与 UDT 表） | [TiaLink](https://tia.hubwiz.com/tia-link?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) | 不要，只读也能做       |
| 生成梯形图（LadDoc → 可导入博途的 SimaticML）            | LadDoc 云服务                                                                                                                     | **要 Key**      |
| 单元/整机仿真跑 PASS/FAIL                          | 云仿真                                                                                                                            | **要 Key**      |
| 在真机工程里编译、下载到 PLCSIM、读回核对                    | [TiaLink](https://tia.hubwiz.com/tia-link?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) | 不要（PLCSIM 在本机） |

后面两项是**另外的云服务**，各有各的入口和 Key（跟 TiaLink 是两回事，别买错）：[LadDoc](https://tia.hubwiz.com/lad/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) ／ [云仿真](https://tia.hubwiz.com/sim/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)，每把 100 次免费。（包里还带一个梯形图渲染：把 SimaticML 画成 PNG。**那是给人看的**——评审、交接、跟同事对逻辑时用，不是必经步骤，所以不在上面这条链里。）所以这套东西装好之后，**AI 不只是"能改你的工程"，而是先看懂、先生成、先验证，再动真机**。

TiaLink 装在与博途同一台机器上；豆包这边的连接器指向它就行（连接器在本地进程里跑，所以 `127.0.0.1` 或局域网 IP 都能连）。

三件事要先知道：

1. **它装在与博途同一台 Windows 上**，但那台机器不必是你的电脑——豆包可以连局域网里的它。
2. **未授权时只读**：能读工程、不能写，也不会擅自动你的工程。要写才需要授权。
3. 装完打开 `http://localhost:8080/` 能看到状态页，就算装好了。

桥通了，再看豆包那边——它还需要知道"这座桥怎么用"。这就是插件包。

## 三步

### 第一步：装插件包（6 个技能 + 5 个连接）

- **Gitee（国内，推荐）**：[tia-forge/doubao-tiaforge · 发行版](https://gitee.com/tia-forge/doubao-tiaforge/releases?ref=hubwiz.com)
- **GitHub**：[tia-forge/doubao-tiaforge · Releases](https://github.com/tia-forge/doubao-tiaforge/releases?ref=hubwiz.com)

进去挑带版本号的那个 zip（`tiaforge-doubao-plugin-*.zip`，当前 **1.0.5**，41 KB）——**别下 "Source code" 那两个**，那是仓库源码包，不能当插件包上传。

豆包左侧「**插件 · 技能 · 伙伴**」→「插件」→ 右上角 `+ 添加` → 上传插件包 → 选 zip，不用解压。

包里是两样东西：

| 类型    | 内容                                                      | 作用              |
| ----- | ------------------------------------------------------- | --------------- |
| 技能 ×6 | 博途工程直连 / 文档检索 / LadDoc 转 SimaticML / 梯形图渲染 / 云仿真 / 编程教练 | 告诉它什么时候用、按什么顺序做 |
| 连接 ×5 | TiaLink + 文档检索 + 云仿真 + LadDoc + 梯形图渲染                   | 给它真正能调的工具       |

技能和连接缺一不可：**只有技能，它知道怎么做但没有手；只有连接，它有手但不知道你的流程。**

![豆包装上插件包之后：插件页出现 Tiaforge，技能 6 个、连接 5 个](https://www.hubwiz.com/blog/content/images/2026/11/host_doubao-plugin-installed.jpg)

*装完的样子：插件页多了一个 Tiaforge，开关打开。*

![技能页：6 个技能全部就位，中文名一目了然](https://www.hubwiz.com/blog/content/images/2026/11/doubao-skills-6-1200.jpg)

*6 个技能一次装齐，默认全部开启。*

### 第二步：把包里的 TiaLink 指向你的桥（最容易漏的一步）

**包里的地址是占位值，不改永远连不上。** 我前后收到的"每次都要重新告诉它地址"，十有八九都是漏了这一步。

**顺序很重要：先改参数，再打开开关。** 反了就会一直显示"运行失败"。

1. 左侧「插件 · 技能 · 伙伴」→ 切到「**连接器**」。如果 `tialink` 的开关已经是开的，**先关掉**；
2. 点它右侧 `…` →「**编辑**」，把「**服务器 URL**」改成你自己的网关地址（见下表），点「保存」；
3. **再打开开关**（或改完直接点旁边的「重新启动」）；
4. 状态正常后，**完全退出豆包再打开**——连接是启动时建立的。

![连接器页：tialink 右侧的 … 里有「编辑」和「删除」](https://www.hubwiz.com/blog/content/images/2026/11/doubao-connector-menu.jpg)

*要改地址就点这个 `…` → 编辑，不用重装插件包。*

| 网关在哪            | 服务器 URL 填什么                |
| --------------- | -------------------------- |
| 就是这台电脑          | http://127.0.0.1:8080/mcp  |
| 另一台 Windows（常见） | http://<那台的局域网IP>:8080/mcp |

![编辑弹窗：服务器名称 / 传输类型 HTTP / 服务器 URL / 自定义 Headers](https://www.hubwiz.com/blog/content/images/2026/11/doubao-connector-dialog.jpg)

*其余三项不用动：名称 `tialink`、传输类型 HTTP、Headers 留空。*

Headers 什么时候要填？**只有你的网关开了令牌鉴权**才加一条：名称 `Authorization`，值 `Bearer <令牌>`。网关默认没开，留空即可。

> 已经显示"运行失败"也不要紧：把参数改对，点「**重新启动**」，再完全退出重开就行。参数不对时它只会停在失败状态，不会自己恢复。

### 第二步补充：云端四个连接怎么填 Key

四个云端连接各要一把 Key，**前缀就能看出是哪个服务**。Key 在各自的页面领（不是 TiaLink 产品页，那是网关本体）：

| 服务     | Key 前缀         | 领 Key 的地址                                                                                                                                                   |
| ------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 文档检索   | tia\_live\_    | [tia.hubwiz.com/ai-coding-docs](https://tia.hubwiz.com/ai-coding-docs/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) |
| 云仿真    | sim\_live\_    | [tia.hubwiz.com/sim](https://tia.hubwiz.com/sim/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)                       |
| LadDoc | lad\_live\_    | [tia.hubwiz.com/lad](https://tia.hubwiz.com/lad/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)                       |
| 梯形图渲染  | render\_live\_ | [tia.hubwiz.com/render](https://tia.hubwiz.com/render/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)                 |

每把 100 次免费；渲染按次计费（查版本不扣）。

填法（以云仿真为例）：

1. 连接器页找到 `plc-sim` → `…` →「**编辑**」；
2. 「**服务器 URL**」保持 `https://tia.hubwiz.com/sim/mcp`，不用改；
3. 「**自定义 Headers**」→「**\+ 添加**」—— - 名称填 `Authorization` \- 值填 `Bearer <你的 Key>`（`Bearer` 后面**一个空格**，Key 本身不加引号、不加前缀）
4. 点「**保存**」→ **再打开开关**（或点「重新启动」）→ 完全退出豆包重开。

![编辑自定义连接器：服务器 URL + 自定义 Headers 里填 Authorization: Bearer <Key>](https://www.hubwiz.com/blog/content/images/2026/11/doubao-apikey-header.jpg)

*Header 名称必须是 `Authorization`，值必须以 `Bearer` 开头——只填 Key 不行。*

两个常见误会：

- **"运行失败"不代表 Key 错**。先看它是不是根本没填 Key（没填一定失败），再看 Key 是不是抄漏了字符；最后才怀疑网关。
- **换 Key 也要走同一条路**：`…` → 编辑 → 改 Header 的值 → 保存 → 重新启动。改完不重启，状态还是旧的。

### 第三步：完全退出，重开，问一句话

MCP 连接是**启动时**建立的。所以：完全退出豆包（托盘也要退）→ 重开 → **新建一个工作任务**。

配好之后**不用再报地址**，直接说人话就会触发：

> 现在打开的是哪个博途工程？有几台设备？

- 报出**你屏幕上的工程名和设备型号** → 通了；
- 给你一段代码、或"建议你这样操作" → **没通**，它在凭记忆答。

如果每次都得把地址念给它才动，说明连接器没真正生效——回去重做第二步（先改参数、后开开关、再完全退出重开）。

工程名它编不出来。接着问一句「当前工程里有几个程序块」——实测 **24 秒**答出 8 个（1 OB + 1 FB + 2 FC + 4 DB），还顺手指出 4 个 DB 都是 IEC 定时器/计数器的背景块。

![豆包在装上插件包、连上本机 TiaLink 之后，24 秒读出工程里的 8 个程序块](https://www.hubwiz.com/blog/content/images/2026/11/host_doubao-block-list.jpg)

*实测：问「当前博途项目里有几个程序块？」→ 24 秒给出 8 个块的类型、块名、编号，还指出 4 个 DB 都是 IEC 定时器/计数器的背景块。*

## 三个坑

**① 回环地址只能写在"编辑"里，不能写进包。** 把 `127.0.0.1` 打进插件包，结果是连接器页面显示"5 个"、列表里只有 4 个，**没有任何报错**。写成局域网地址就正常。

**② 自定义连接器跑在本地电脑上。** 弹窗写着「仅支持在本地电脑中使用」——因为连接器本身就是本地进程。所以云端任务里找不到工具，不是你配错。

**③ 只保存不重启，等于没改。** 重开之后老会话也不会补上工具，要新建工作任务。

## 什么情况别走这条路

- **那台机器没装博途**：桥装不上，后面都没意义。
- **只想让它帮你写代码**：直接复制粘贴更快，不值得为这个装一套东西。
- **要在云端任务里用**：连接器只在本地电脑进程里跑，云端任务碰不到它。

## 装完之后，能兑现的那句话

不是"AI 能写 PLC 了"，而是这条链一次走完：

> 把这段启保停逻辑写成 FB，编译干净后下载到仿真，再把 Main 里调用了哪些块列出来给我核对。

**能验收，才叫接上。**

---

## 想直接开始装

三步里唯一要付钱的只有那层桥。**先只读也能装**——未授权时 TiaLink 只读，够你把链路验通、把话学会，再决定要不要写。

| 你要什么                                           | 去哪                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 装 TiaLink（与博途同机、微信扫码、装完 localhost:8080 看得到状态页） | **[TiaLink 产品页 / 下载](https://tia.hubwiz.com/tia-link?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)**                                                                                                                                                                                                                                                                                                                                                                        |
| 领云端 Key（文档检索 / 云仿真 / LadDoc / 渲染，各 100 次免费）    | [文档检索](https://tia.hubwiz.com/ai-coding-docs/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) ／ [云仿真](https://tia.hubwiz.com/sim/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) ／ [LadDoc](https://tia.hubwiz.com/lad/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) ／ [渲染](https://tia.hubwiz.com/render/?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps) |
| 拿插件包（6 技能 + 5 连接）                              | [Gitee 发行版](https://gitee.com/tia-forge/doubao-tiaforge/releases?ref=hubwiz.com)（国内）／ [GitHub Releases](https://github.com/tia-forge/doubao-tiaforge/releases?ref=hubwiz.com)                                                                                                                                                                                                                                                                                                                                      |
| 看不懂某一步、或报错了                                    | 把**报错原文**贴到 [Gitee Issues](https://gitee.com/tia-forge/doubao-tiaforge/issues?ref=hubwiz.com)，我按报错改包                                                                                                                                                                                                                                                                                                                                                                                                               |

**插件包**：[https://github.com/tia-forge/doubao-tiaforge](https://github.com/tia-forge/doubao-tiaforge?ref=hubwiz.com)（独立仓，含插件源码与各版本 zip）

**相关阅读**：[DeepSeek DSH 接博途：插件装完，四句对话配好并验通](https://www.hubwiz.com/blog/deepseek-harness-tiaforge-plugin/)｜[Claude Code 接博途：从空工程到跑通仿真的全链路](https://www.hubwiz.com/blog/claude-code-tia-portal-mcp/)｜[TiaLink 博途 MCP 网关](https://tia.hubwiz.com/tia-link?utm%5Fsource=blog&utm%5Fmedium=article&utm%5Fcampaign=doubao-tia-portal-three-steps)

**来源与版本**：插件包 `tiaforge-doubao-plugin` 1.0.5；网关 TiaLink 1.5.1.0，博途 V17；块数、块类型、DB 背景关系均由网关原生工具返回，不是模型记忆。