CONNECT & GET STARTED
从已有客户端接入工程工具
在线申请免费试用包，下载链接自动发到你的邮箱。先在开发电脑上运行自动演示，再接入用户已有的 AI 客户端和模型服务。浏览器里可以查看流程；实际操作在自己的电脑上完成。
获取与试用
Tai-IoT 工业开发工具包提供免费试用，在线申请后下载链接自动发到你的邮箱。试用包在你自己的电脑上运行，接入你已有的 AI 客户端，用一句中文完成读取工程、修改参数、实际编译、测试和查看 Git 改动；其中的开发板示例用厂家官方 SDK 交叉编译出真实固件。
| 费用 | 试用包免费。AI 客户端和模型服务使用你自己的账号，模型费用由用户自理；工具包不代付模型费用。 |
|---|---|
| 试用期 | 90 天，供申请人及其所在单位参与评估的员工使用。 |
| 示例工程 | 主机示例：温度采集 C 程序，时钟和温度使用模拟输入，无需开发板。开发板示例：同一任务在 ESP32-S3-DevKitC-1、NUCLEO-H723ZG 与 AT-START-F413 上的工程，基于厂家官方 SDK 与官方例程交叉编译，附烧录与串口读回工具。工具只操作包内附带的示例工程；接入你自己的工程，请联系我们。 |
| 系统要求 | 主机示例：Linux；Python 3.11 或更高（含 venv）、Git、C 编译器，并能访问 Python 软件源（可使用企业镜像）。开发板示例：另按包内说明安装所用开发板的厂家 SDK 与编译器，约需 10 GB 磁盘空间；包内附 Linux 步骤，以及 Windows 与 VS Code 使用说明。 |
| AI 客户端 | 主机示例已在 Codex CLI 0.162.1（gpt-6.1-sol，Linux）上完成实测；Claude Code 可按说明接入。开发板示例为 VS Code 生成工作区配置，可在 VS Code 的 AI 对话中使用你自己的模型服务。没有 AI 账号也可以完成自动演示。 |
| 数据 | 工具包不上传任何内容，也不读取你的账号或密钥。使用云端模型时，客户端会把工程内容和工具结果发送给你选择的模型服务。 |
试用包包含
邮件中的两个下载链接：压缩包 taiiot-toolkit-0.2.1.zip 和同名 .sha256 校验文件。解压后的目录中有：
server.py：工具服务，由 AI 客户端在后台启动，提供 6 个工程工具example_project/：示例工程，AI 操作的对象doctor.py：检查电脑环境run_demo.py：不需要 AI 账号的自动演示prepare_client.py：生成 AI 客户端接入配置requirements.txt、requirements-lock.txt：依赖版本清单dev-boards/：开发板示例，含三块开发板的示例工程、提供 7 个工程工具的工具服务、VS Code 配置生成prepare_vscode.py、自动演示与检查，以及 Linux 使用说明README.md和 Windows 与 VS Code 使用说明WINDOWS_VSCODE.mdREADME.md中文使用说明、README.en.md英文使用说明、TERMS.md试用条款、VERSION版本信息
申请方式
在线填写申请表并勾选同意试用条款，提交后系统自动把下载链接、有效期和 SHA256 校验值发到你填写的邮箱，链接 14 天内有效，压缩包可下载 10 次。也可以发送邮件至 web@tai-iot.com（主题注明“工具包试用申请”）。建议写明：
- 公司与联系人
- 操作系统及版本，是否已准备 Python 3.11+、Git 和 C 编译器
- 计划使用的 AI 客户端与模型服务
- 希望接入的芯片或 PLC 型号、开发工具及版本（可选）
邮件申请时，我们先发送试用条款，你回复同意后再发送下载链接。试用期 90 天，供申请人及其所在单位参与评估的员工使用，请勿提供给第三方；条款全文见试用条款，并随包附带（TERMS.md）。
试用步骤
- 申请：在线填写申请表，或发送邮件。
- 接收：提交后查收邮件，把压缩包和
.sha256文件下载到同一目录，校验后解压。 - 安装：在解压目录创建虚拟环境，安装锁定依赖，运行
doctor.py检查环境。 - 自动演示：运行
run_demo.py。不调用 AI，确认工具服务、编译器和 Git 能在你的电脑上运行。 - AI 任务：新建一份示例工程，接入 Codex CLI 或 Claude Code，用中文发送任务。开发板示例按包内
dev-boards/中的说明安装 SDK，并可接入 VS Code。 - 反馈：直接回复邮件，告诉我们安装用时、卡住的步骤、AI 是否完成任务，以及希望接入的芯片或 PLC 型号、开发工具及版本。
每一步的命令见下方安装示意和包内 README.md。遇到问题可回复邮件或致电 400-009-9300。
怎样算跑通
| 自动演示 | 7 项模拟检查通过，10 个样本，3 个报警样本，并显示 Git 改动。 |
|---|---|
| AI 任务 | AI 依次调用读取、修改、编译、测试和差异工具；Git 差异显示 project.json 中采样周期 1000 → 500 毫秒、报警阈值 60.0 → 28.0℃；7 项模拟检查通过，10 个样本的时间为 0 到 4500 毫秒、间隔 500，3 个报警样本。 |
| 开发板示例 | run_demo.py --board 完成读取、修改、交叉编译与 Git 差异；编译器实际收到的参数为 SAMPLE_PERIOD_MS=500U、ALARM_THRESHOLD_DECI_C=280，并给出固件大小与存储占用。 |
| 错误情况（可选） | 要求把采样周期改成 55 毫秒，或改完参数后不编译就测试，工具会拒绝，AI 应如实说明原因。 |
主机示例使用模拟输入，开发板示例只修改和编译时也无需接板，都可以先体验完整流程。
接入方式
本地 stdio 接入
客户端在本机启动 MCP 服务，绑定工程工作区，调用读取、修改、构建、测试与差异工具。
按平台接入工程工具
支持包按平台接入 SDK、命令行或原厂 MCP / API，并注明适用型号、工具版本与允许的操作；PLC 通过原厂工程软件的官方接口接入。
使用自己的模型服务
模型账户和连接在客户端中准备，可选择客户端支持的模型服务。使用云端模型时，工程上下文会发送给所选服务；企业模型接入可按需咨询。
开发工具全部运行在你的电脑上；网页中的安装示意只生成命令，不会连接本机或读取凭证。
支持的客户端
Tai-IoT 工具服务遵循 MCP 标准，可接入支持本地 MCP 的 AI 客户端。
| 客户端 | 接入方式 | 说明 |
|---|---|---|
| Codex CLI ↗ | 本地 stdio；TOML 或 CLI 登记 | 已完成实测：0.162.1 / gpt-6.1-sol / Linux，覆盖正常任务、错误恢复与编译失败处理。实测记录 → |
| VS Code ↗ | 本地 stdio；工作区 .vscode/mcp.json | 开发板示例的 prepare_vscode.py 生成配置；在 AI 对话中通过 Custom Endpoint 使用你自己的模型服务，无需登录 GitHub。 |
| Claude Code ↗ | 本地 stdio；JSON 启动配置 | 试用包提供配置生成，按下方步骤登记即可。 |
| Cursor ↗ | 本地 MCP 配置 | 按客户端的 MCP 配置方式登记工具服务。 |
| VS Code + Cline ↗ | 本地 MCP 配置 | 按客户端的 MCP 配置方式登记工具服务。 |
官方接入文档核对：2026 年 10 月 14 日，VS Code 为 10 月 30 日。
安装与使用示意
选择一条本机接入路径
按步骤查看并复制命令，在自己电脑的终端中执行。
填写存放压缩包和 .sha256 文件的目录，请换成你自己电脑上的目录。在线申请后，下载链接会发到你的邮箱，见上方“获取与试用”。
校验并解压试用包
正在准备接入步骤。
可直接运行的自动演示
收到试用包后，把压缩包和 .sha256 文件放在同一目录，在该目录中执行。需要 Python 3.11+、Git 与本机 C 编译器；依赖按包内锁定版本安装。
sha256sum -c taiiot-toolkit-0.2.1.zip.sha256
unzip taiiot-toolkit-0.2.1.zip
cd taiiot-toolkit-0.2.1
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-lock.txt
.venv/bin/python doctor.py
.venv/bin/python run_demo.py脚本使用真实 MCP 通信和主机 C 编译器，生成独立本地 Git 工作区。时钟与传感器使用模拟输入。查看本机证据 →
诊断用于检查前置依赖。解压后不要移动目录；接入 AI 客户端前，先新建一份示例工程，客户端配置不会覆盖既有输出文件。
接入后如何确认结果
- 在客户端确认演示服务器与六个工具可用，先读取工程上下文。
- 检查本次修改的采样周期与报警阈值，而不是历史结果。
- 实际构建并运行模拟测试，核对 7 项检查、10 个样本及对应差异。
- 修改后重新构建；错误时依据工具输出停止或恢复。
- 保存客户端、模型、工具版本、人工介入和费用记录。
试用版工具围绕示例工程的采样参数设计；正式工程中的源码开发、仓库协作与硬件操作，随支持包按项目提供。
常见问题
是否需要购买 Tai-IoT 提供的模型服务？
不需要。试用包免费，使用用户自己的客户端与模型服务，模型费用由用户自理，工具包不代付。依赖按包内锁定清单从用户选择的软件源安装，各自遵循其许可。
如何获取试用包？
在线申请并同意试用条款后，下载链接会自动发到你的邮箱，14 天内有效；也可以邮件申请。试用期 90 天，供申请人及其所在单位参与评估的员工使用，请勿提供给第三方。申请方式见获取与试用。
安装示意会修改我的电脑吗？
不会。页面只在浏览器中生成步骤和命令，不启动本机进程、不读取凭证。实际安装与客户端登记由用户在自己的电脑上执行。
本地工具运行是否意味着源码不会进入云端？
本地开发工具与模型部署是两个独立选项。使用云端模型时，提交的源码、文档和工具结果可能进入该服务；企业需明确数据发送范围。
可以使用其他操作系统或客户端吗？
主机示例的安装步骤以 Linux 为准；开发板示例附 Linux 与 Windows 使用说明，并为 VS Code 生成接入配置。工具服务遵循 MCP 标准，使用其他系统或客户端时，请邮件告知你的环境，我们会协助确认接入方式。
交流工程接入
咨询时可先提供任务概要、目标芯片或 PLC、工具与固件版本、现有测试、设备条件及模型连接要求，便于确认适配范围。