ENGINEERING TOOLS
Tai-IoT 工程工具
用中文描述任务，AI 客户端会自动选择合适的工程工具，完成读取、修改、构建、测试与审阅。你不需要记住工具名称。
工具能力
工具按工程任务分为六类。涉及修改和设备的操作，客户端可在执行前请你确认。
工程读取
了解目标型号、工程配置与源码结构，修改前先确认上下文。只读，不改动工程。
工程修改
修改配置或源码，只改工作副本，每次修改都留下可审阅的差异。
构建与测试
按项目要求编译并运行测试，返回完整输出。修改后未重新构建时不会运行测试，避免误判。
版本差异
汇总本次修改的差异，供 AI 解释、工程师审阅。不自动提交或推送。
设备操作
下载与烧录测试程序，随支持包提供。只对指定测试设备启用，执行前由工程师确认。
运行数据
查看设备运行状态与诊断信息，随支持包提供。只读，按授权范围开放。
主机示例工具
免费试用包的主机示例提供以下 6 个工具，围绕附带的温度采集 C 示例工程完成一次完整的工程任务。
| 操作 | 说明 | 类型 |
|---|---|---|
查看工程概况get_project_profile | 目标、采样参数、文件列表与可执行的操作。 | 工程读取 |
读取工程文件read_project_file | 读取示例工程的配置与 C 源码，只访问示例工程内的文件。 | 工程读取 |
修改采样参数set_sampling | 修改采样周期与报警阈值。超出允许范围时拒绝修改，配置保持不变。 | 工程修改 |
编译工程build_project | 在你的电脑上实际编译，返回完整的编译输出。 | 构建与测试 |
运行模拟测试run_simulation | 以模拟时钟和温度输入执行 7 项检查，返回 10 个样本。未编译或修改后未重新编译时不会运行。 | 构建与测试 |
查看修改差异get_git_diff | 列出本次修改的差异，不提交、不推送。 | 版本差异 |
以上工具已在 Codex CLI 0.162.1 上完成自然语言实测（0.1.1 的工具服务），模型自主选择并调用了全部 6 个工具。
开发板示例工具
开发板示例提供以下 7 个工具，在 ESP32-S3-DevKitC-1、NUCLEO-H723ZG 与 AT-START-F413 的示例工程上完成修改、交叉编译、烧录与读回。烧录与读回只对启动时指定串口的那一块开发板启用，写入前核对编译结果是最新的、文件未被改动。
| 操作 | 说明 | 类型 |
|---|---|---|
查看开发板与工程get_board_profile | 开发板、目标芯片、采样参数、厂家 SDK 是否就绪、编译状态，以及已连接的 USB 串口设备。 | 工程读取 |
读取工程文件read_project_file | 读取示例工程的配置与源码，只访问工程内的文件。 | 工程读取 |
修改采样参数set_sampling | 修改采样周期与报警阈值。超出允许范围时拒绝修改，配置保持不变。 | 工程修改 |
交叉编译固件build_firmware | 用该板锁定的厂家 SDK 与编译器编译，返回固件大小、存储占用、SHA-256，以及编译器实际收到的参数。 | 构建与测试 |
烧录固件flash_firmware | 把当前编译结果写入指定的开发板；编译过期、文件被改动或串口不是该板时拒绝。 | 设备操作 |
读回串口输出read_serial_log | 重启指定的开发板，读取串口 3 至 60 秒，核对启动参数、采样间隔、报警标记与温度范围。 | 运行数据 |
查看修改差异get_git_diff | 列出本次修改的差异，不提交、不推送。 | 版本差异 |
三块板的交叉编译已在 Linux 上通过这些工具实测，编译器实际收到的参数与修改后的配置一致。
试试这样说
在已接入的 AI 客户端里直接输入任务。
用 Tai-IoT 的工具先读取工程，把采样周期从 1000 毫秒改为 500 毫秒，报警阈值改为 28℃。实际编译，执行模拟测试，展示 Git 差异。按真实输出汇报，不提交或推送。
结果：采样周期改为 500 毫秒、阈值 28℃，7 项检查通过，10 个样本，3 个报警样本。
先尝试把采样周期设为 55 毫秒、阈值 28℃，记录工具返回结果并确认配置。再在未编译时运行模拟，说明实际返回的错误。
结果：55 毫秒被拒绝且配置不变，未编译的模拟被拒绝，AI 依据工具输出说明原因并恢复。
数据与运行位置
- 本地运行：工具在你的电脑上运行，工程代码不经过 Tai-IoT 服务器。
- 不上传：工具包不上传任何内容，也不读取你的账号或密钥。
- 操作范围：只操作指定的工程，不提交、不推送、不访问远程仓库。
- 模型数据：使用云端模型时，客户端会把工程内容和工具结果发送给你选择的模型服务；企业可按要求选择模型与发送范围。
支持的客户端
可接入支持 MCP 标准的 AI 客户端，沿用你已有的账号和模型服务。
| 客户端 | 接入方式 | 说明 |
|---|---|---|
| Codex CLI | 一条命令登记 | 已完成实测：0.162.1 / gpt-6.1-sol / Linux，覆盖正常任务、错误恢复与编译失败处理。 |
| VS Code | 开发板示例生成工作区配置 | 在 VS Code 的 AI 对话中使用你自己的模型服务，无需登录 GitHub。 |
| Claude Code | 试用包生成配置 | 试用包提供配置生成与接入步骤。 |
| Cursor、VS Code + Cline 等 | 客户端设置中登记 | 在客户端的 MCP 设置中登记即可接入。 |