RELEASE NOTES
版本说明
Tai-IoT 工具包各版本的内容、实测记录与适用环境。每项能力均注明对应的工具、型号与版本。
0.2.1 试用版
发布日期：2026 年 10 月 31 日 · 验证环境 Linux · 附 Windows 与 VS Code 使用说明
改进开发板示例中 ESP-IDF 工具的安装与检查。开发板工程、工具服务、主机示例与获取方式与 0.2.0 相同；三块板用本版本重新交叉编译，固件 SHA-256 与 0.2.0 的记录相同。
- 安装 ESP-IDF 工具：新增
prepare_vscode.py --install-esp-idf-tools，用工具包自己的 Python 安装 ESP-IDF 的编译器、CMake、Ninja 与 Python 环境，使 ESP-IDF 的 Python 环境与工具包使用同一 Python 版本。 - 指定安装目录：在
tools.json的tools_path中写明目录，即可把 ESP-IDF 工具装到其他磁盘，无需设置系统环境变量。 - 检查与报错：
--check显示 ESP-IDF 工具与 Python 环境是否齐全，缺少时给出安装命令；编译遇到同类问题时写明原因与安装命令。
0.2.0 试用版
发布日期：2026 年 10 月 31 日 · 验证环境 Linux · 附 Windows 与 VS Code 使用说明
新增开发板示例：同一个温度采集任务在三块开发板上的工程，基于厂家官方 SDK 与该板的官方例程，交叉编译出真实固件。试用包改为在线申请，同意试用条款后下载链接自动发到申请人邮箱。
| 组成 | 内容 | 说明 |
|---|---|---|
| 开发板示例工程 | ESP32-S3-DevKitC-1（N16R8）、NUCLEO-H723ZG、AT-START-F413 | 读取芯片内部温度，按采样周期逐行输出，超过阈值时标记报警。厂家 SDK 不随包提供，由用户按包内说明安装锁定版本。 |
| 开发板工具服务 | 7 个工具 | 读取开发板与工程信息、修改采样参数、交叉编译、烧录、读回串口并核对、查看 Git 差异；烧录与读回只对启动时指定串口的那一块开发板工作。清单见工程工具。 |
| VS Code 接入 | prepare_vscode.py | 从示例创建工程并生成工作区配置，可在 VS Code 的 AI 对话中使用自己的模型服务。 |
| 使用说明 | Linux；Windows 与 VS Code | dev-boards/README.md 与英文版；WINDOWS_VSCODE.md 从全新的 Windows 与 VS Code 开始逐步说明。 |
| 主机示例 | 示例工程与 6 个工具 | 工具向客户端说明哪些操作只读、哪些会修改工程或运行程序；客户端显示的服务版本与试用包一致。 |
| 获取方式 | 在线申请 | 同意试用条款后，下载链接与 SHA256 校验值自动发到邮箱，14 天内有效。 |
交叉编译实测记录
2026 年 10 月 31 日在 Linux（Debian 13、Python 3.13）上，脚本通过工具服务对三块板各完成一次：读取工程，把采样周期从 1000 毫秒改为 500 毫秒、报警阈值从 60℃ 改为 28℃，交叉编译并查看 Git 差异。编译器实际收到的参数均为 SAMPLE_PERIOD_MS=500U、ALARM_THRESHOLD_DECI_C=280；同一源码重复编译，固件 SHA-256 相同。
| 开发板 | SDK 与编译器 | 固件 |
|---|---|---|
| ESP32-S3-DevKitC-1 | ESP-IDF v6.1；xtensa-esp-elf-gcc 15.2.0（esp-15.2.0_20251204） | 156,448 字节，应用分区剩余 85% |
| NUCLEO-H723ZG | STM32CubeH7 v1.13.0；Arm GNU Toolchain 15.2.Rel1（gcc 15.2.1） | 13,892 字节，占 Flash 1.32%、RAM 1.68% |
| AT-START-F413 | AT32F413 固件库 v2.1.7；Arm GNU Toolchain 15.2.Rel1（gcc 15.2.1） | 8,516 字节，占 Flash 3.25%、RAM 6.25% |
以上是交叉编译记录；示例读取的是芯片温度，不是环境温度。主机示例的自然语言实测记录见下文，来自 0.1.1 的工具服务。
0.1.1 试用版
发布日期：2026 年 10 月 15 日 · Linux
在 0.1.0 的基础上新增英文使用说明，并附正式试用条款。工具服务、示例工程、环境诊断、自动演示与客户端配置均与 0.1.0 相同，下方的实测记录同样适用于本版本。
- 英文使用说明：新增
README.en.md，与中文说明逐段对应，命令完全相同。 - 试用条款：发送试用包前请申请人通过邮件确认；试用期 90 天，供申请人及其所在单位参与评估的员工使用。
0.1.0 试用版
发布日期：2026 年 10 月 15 日 · Linux
首个试用版提供本地 MCP 工具服务与一个温度采集 C 示例工程，让工程师在自己的电脑上，用 AI 客户端完成一次完整的工程任务：读取、修改、实际编译、模拟测试与差异审阅。
| 组成 | 内容 | 说明 |
|---|---|---|
| MCP 工具服务 | 6 个工具、1 个资源、1 个任务模板 | 本地 stdio 运行，工具清单见 工程工具。 |
| 示例工程 | 温度采集 C 程序 | 本机 C 编译，7 项检查覆盖采样周期、时钟回绕与报警边界，使用模拟时钟与合成温度数据。 |
| 环境诊断 | doctor.py | 检查 Python、MCP SDK、Git、编译器与示例工程。 |
| 自动演示 | run_demo.py | 无需 AI 账号，自动完成修改、编译、测试与差异查看。 |
| 客户端配置 | prepare_client.py | 生成 Codex CLI（TOML）与 Claude Code（JSON）接入配置，不改动个人设置。 |
自然语言实测
在 Codex CLI 0.162.1（gpt-6.1-sol，Linux）上，模型实际调用本地 MCP 工具，在三个独立工作区分别完成以下任务。请求记录与真实构建产物、测试输出、Git 差异及最终汇报逐项核对一致，任务期间无人工干预。
- 正常任务：采样周期改为 500 ms、报警阈值改为 28℃，实际编译，7 项检查通过，10 个样本、3 个报警。
- 错误恢复：非法周期、未构建测试与过期构建均被拒绝；重新构建后以 700 ms 运行通过。
- 编译失败：损坏的源码返回编译错误，测试被拒绝；模型如实说明原因并停止。
验证环境
| 项目 | 版本 | 说明 |
|---|---|---|
| 操作系统 | Linux | 普通本机进程。 |
| Python | 3.13.5 | 最低要求 Python 3.11。 |
| MCP SDK | 2.3.0 | 按锁定依赖安装。 |
| Git | 2.47.3 | 本地仓库操作。 |
| C 编译器 | cc 14.2.0 | 本机 C 构建。 |
系统要求
- 主机示例：Linux，Python 3.11 或更高（含 venv）
- Git 与 C 编译器（cc、gcc 或 clang）
- 开发板示例：所用开发板的厂家 SDK 与编译器，版本与安装步骤见包内说明，约需 10 GB 磁盘空间
- 可访问 Python 软件源，可使用企业镜像
- AI 客户端与模型服务使用你自己的账号；没有 AI 账号也可运行自动演示
使用其他操作系统时，请邮件联系 web@tai-iot.com。
芯片与 PLC 支持包
支持包按项目交付，依据目标型号、开发工具与版本完成适配。每个支持包随附适配记录，写明：
- MCU：芯片或板卡、SDK、编译器、下载器、操作系统与测试条件。
- PLC：CPU、固件、工程软件、设备包、库与支持的工程操作。PLC 接入通过原厂工程软件提供的官方接口进行，使用客户自有的正版软件授权，按项目逐一评估。
- 操作范围：读取、修改、编译、仿真、烧录或下载、真机验证分别记录。
- 接口区分：工程编程接口与运行数据接口分别适配和授权。
可在线提交芯片适配申请，也可通过 web@tai-iot.com 或 400-009-9300 咨询。
企业方案
面向企业研发团队，可结合现有工程与工具体系咨询以下方案：
| 方向 | 内容 |
|---|---|
| 自有仓库接入 | 远程认证、独立分支、提交与合并请求，按仓库平台对接。 |
| 工程环境恢复 | 工具版本恢复、依赖准备、离线安装与跨电脑复现。 |
| 权限与任务管理 | 任务范围、操作授权、执行记录与失败处理。 |
| 企业模型接入 | 指定模型服务与客户端，明确数据发送范围与部署条件。 |