AI IoT 项目可以在开发过程中使用 AI，也可以在运行时使用 AI，或者两者兼具。在本指南中，三个示例都是 AI 辅助的 IoT 项目：这些联网硬件应用是在 AI 编程助手的帮助下构建的，而不是声称设备能够运行 AI 模型。对于初学者来说，困难之处往往不在于创意本身，而在于将硬件库、网络服务、显示屏和部署工具连接成一个可正常工作的系统。
CodeCraft 提供了一套基于浏览器、专注于硬件的 AI 编程工作流：描述预期行为，生成第一个版本，在云端编译，将其上传到受支持的硬件，然后在设备上进行测试和优化。本指南将通过三个为 Wio Terminal 创建的真实项目来介绍这一工作流。
快速回答：一个实用的 AI IoT 项目需要实体设备、数据或网络连接、明确定义的输出，以及可重复的测试，而不仅仅是一段由 AI 生成的代码示例。
什么才算是 AI IoT 项目？
IoT 项目会将实体设备连接到另一台设备、本地服务或互联网服务，以便收集、交换、显示信息，或使用信息触发操作。AI 可以通过两种不同的方式发挥作用：
- AI 辅助开发：AI 编程助手帮助生成、解释或修改固件及配套软件。
- 应用内部的 AI：系统运行时，由模型分析传感器、图像、音频或其他数据。
下面的三个示例主要展示 AI 辅助开发。除非应用实际运行了 AI 模型，否则不应将它们描述为机器学习系统。这一区分有助于确保“AI IoT 项目”这一术语使用准确。
一个实用的项目可以简单地描述为以下链路：
输入或数据源 → 连接 → 处理 → 实体或视觉输出 → 测试条件
例如，时钟通过 Wi-Fi 请求时间数据，处理响应，将时间显示在 Wio Terminal 上，并可以通过将屏幕内容与可信的时间源进行比较来测试。
为什么使用 Wio Terminal 构建联网项目？
Wio Terminal 是一款基于微控制器的开发设备，搭载 Microchip ATSAMD51。根据官方产品页面的信息，它通过 Realtek RTL8720DN 提供 Wi-Fi 和蓝牙连接，并兼容 Arduino 和 MicroPython。其集成屏幕和实体控制按键使其适合构建需要即时本地界面的项目。
这些特性并不会自动使每个 Wio Terminal 项目都成为 IoT 项目。应用必须有意义地使用连接功能，例如获取网络数据、与计算机交换信息，或控制其他服务。
CodeCraft 将 Wio Terminal 列入其当前支持的硬件列表。其官方网站介绍了一套基于浏览器的工作流，包括 AI 代码生成、云端编译和上传支持。不过，生成的代码仍需进行审查和测试，尤其是在项目依赖 Wi-Fi 凭据、外部 API、时区或不断变化的数据格式时。
使用 CodeCraft 构建的三个 AI IoT 项目
联网时钟与天气显示
联网时钟与天气显示将 Wio Terminal 变成一个联网信息屏幕。连接 Wi-Fi 后，它会显示当前时间、日期、星期、温度和天气图标。已发布的项目说明还指出，即使网络不可用，本地时钟仍会继续显示时间。
为什么它属于 IoT 项目
该设备依赖网络连接来获取当前的外部信息，并通过实体显示屏呈现这些信息。它还展示了一个实用的 IoT 设计原则：临时网络故障不应导致所有本地功能都无法使用。
你可以学到什么
- 将嵌入式设备连接到 Wi-Fi
- 将网络数据与本地维护的状态分离
- 针对小尺寸屏幕格式化时间、日期和天气信息
- 处理连接丢失，并决定设备仍应显示哪些内容
一个明确的成功测试方法是：确认联网后在线信息能够更新，并且在短暂的网络中断期间时钟仍可正常使用。在改编该项目之前，请确认天气数据源、其使用条款，以及是否需要 API 密钥。
动漫桌面时钟
动漫桌面时钟是一款适用于 Wio Terminal 的联网壁纸时钟。其项目页面介绍了每六小时通过 NTP 自动同步北京时间的功能，也可以选择按下中心按键来触发同步。配套的 Python 脚本可以将图像转换为壁纸资源，并将其编译到固件中。
为什么它属于 IoT 项目
NTP 同步就是其中的联网功能。设备使用网络服务校准本地时间，同时将显示和用户交互保留在硬件端。
你可以学到什么
- 从 NTP 服务请求时间
- 管理定期同步和用户触发的同步
- 区分 UTC、本地时间及时区设置
- 将网络逻辑与显示资源和实体按键结合起来
已发布的版本按照北京时间配置。如果你在其他地方复用该项目，请在提示词中明确所需的时区和夏令时规则，然后核实显示结果，不要想当然地认为生成的配置一定正确。
Wio Terminal AI Token 仪表盘
Wio Terminal AI Token 仪表盘使用 Wio Terminal 作为实体使用情况显示设备。其发布说明将其介绍为一个开源 BLE 仪表盘，用于显示从本地计算机上已登录账户中获取的 Codex 和 Claude 使用数据。它还会根据项目可获取的使用数据，显示预估的每日 API 成本，并提供本地网页预览。
为什么它符合 IoT 项目的定义
该项目通过 BLE 将计算机端的数据源与独立的实体仪表盘连接起来。尽管最后一跳并未直接使用公共互联网，但它仍然是一个联网设备应用。
你可以学到什么
- 在主机软件和设备固件之间划分应用功能
- 通过 BLE 发送结构化数据
- 设计紧凑的硬件仪表盘
- 处理缺失、延迟或不可用的使用数据
请将使用量和成本信息视为运行数据，而不是保证准确的账单记录。请通过相关服务提供商的官方账户或账单页面进行确认。不要将密码、会话令牌或 API 密钥直接放入固件、屏幕截图、代码仓库或共享项目文件中。
三个项目的比较
网络时钟和天气显示项目是最全面的入门项目，因为它结合了 Wi-Fi、外部数据、显示屏和离线备用机制。动漫时钟的范围更窄，非常适合作为第一个网络练习，因为它主要依赖时间同步这一项远程服务。令牌仪表盘则更高级，因为它同时包含计算机端软件和设备端 BLE 通信。
请根据学习目标进行选择：
- 从 Anime Desktop Clock 开始，学习使用一个网络服务并实现一种清晰的输出。
- 选择 Network Clock and Weather Display，练习处理多个数据字段和故障情况。
- 选择 AI Token Dashboard，探索 BLE、结构化数据以及由两部分组成的系统。
如何使用 CodeCraft 构建 AI IoT 项目
定义一种可观察的行为
避免从“构建一个智能仪表盘”开始。请明确输入、连接方式、输出和预期行为：
“将 Wio Terminal 连接到 Wi-Fi，使用 NTP 获取当前时间，显示小时和分钟，并在同步失败时显示连接警告。”
可测试的提示词能够为 AI 助手和构建者提供更清晰的目标。
明确硬件和限制条件
在已知的情况下，请写明具体的开发板、屏幕、按键、传感器、通信方式、时区和所需库。请说明离线备用机制、刷新间隔等限制条件，或明确凭据是否必须保存在共享源文件之外。
生成最小可用版本
从一个数据源和一个输出开始。在添加动画、多个 API 或复杂界面之前，先确认开发板能够连接、编译、上传，并显示有效结果。
编译并上传
CodeCraft 当前的产品页面介绍了针对受支持硬件的云端编译和上传功能。编译成功只能证明程序可以构建，并不能证明网络、数据源或实体设备上的行为能够正常工作。
测试真实系统
至少针对以下情况记录预期行为和实际观察到的行为：
- 连接正确且数据有效
- 凭据错误或缺失
- 网络中断
- 远程数据不可用或格式错误
- 设备重启
- 长时间运行
一次改进一个故障点
测试失败时，请将实际结果描述给 CodeCraft，并请求进行有针对性的修改。请保留各个版本，以便将新版本与上一个可正常工作的构建版本进行比较。
AI IoT 项目规划清单
在宣布项目完成之前，请确认：
- 设备和所有必需模块均已准确命名。
- 网络或 BLE 连接具有明确用途。
- 外部数据源及其限制已记录。
- 公共文件中未硬编码凭据。
- 界面能够显示连接状态和错误状态。
- 网络故障时，设备能够采取合理的应对行为。
- 时区、单位和刷新间隔均已明确。
- 每项声称具备的功能都已在实体设备上完成测试。
- 项目页面区分了已演示的行为和计划中的改进。
CodeCraft 的定位
CodeCraft 可以缩短从自然语言规格到第一版固件的路径，尤其适合那些希望在测试想法之前不必配置本地工具链的构建者。当用户提供精确要求，并根据观察到的硬件行为不断迭代时，CodeCraft 的价值最为明显。
它并不会消除理解系统的必要性。构建者仍然需要检查接线、权限、凭据、API 响应、通信可靠性以及生成的代码。对于教育而言，这意味着测试和讲解应当成为活动的重要组成部分，而不是将第一次生成的输出视为最终答案。
常见问题
所有连接硬件项目都是 AI IoT 项目吗？
不是。联网设备属于 IoT 项目，但只有当 AI 协助开发过程，或在运行中的系统内执行明确功能时，它才属于 AI IoT 项目。请说明 AI 实际承担的角色。
IoT 项目需要云服务吗？
不总是如此。该令牌仪表盘展示的是计算机与设备之间的本地 BLE 连接。当相互连接的组件为了实现有用的目的而交换数据时，本地仪表盘、局域网控制以及设备间通信也可以属于 IoT 架构。
没有互联网时，Wio Terminal 还能运行吗？
这取决于具体设计。本地显示、控制和存储的状态可以继续工作，但实时天气、NTP 同步或其他远程数据将无法使用。请明确规划好网络不可用时的备用行为。
CodeCraft 能保证生成的代码立即运行吗？
没有任何代码助手能够保证代码在每种设备、网络、库和外部服务环境下都能正确运行。应将生成的代码视为第一个实现版本，必须经过编译、上传、观察和修改。
这些示例需要哪些硬件？
三个精选项目都使用 Wio Terminal。根据应用场景的不同，可能还需要 Wi-Fi 网络、支持 BLE 的计算机或计算机端软件。开始之前，请查看每个项目页面。
开始你的第一个 AI IoT 项目
一个优秀的 AI IoT 项目，并不取决于它包含多少功能。它应具备清晰的数据路径、有用的物理输出、安全的凭据处理方式，以及能够展示连接成功和连接失败时行为的测试。
探索这三个已发布的示例，选择与学习目标最匹配且规模最小的一个，并使用 CodeCraft 生成和改进第一个可运行版本。
产品和应用详情已于 2026 年 9 月 2 日根据 Seeed Studio、CodeCraft 和 SenseCraft 的当前官方页面进行核实。
评论
欢迎留言，通过审核后会显示在这里。