Arduino UNO Q 板载 Nanobot 自动化编程指南之四

笔者在TOOLS.md说明各种工具的使用约束、参数、最佳实践（网络搜索、编程命令、MCP 服务器等）

复制代码

 网络搜索

  ┌────────────┬───────────────────────────────────────────┐
  │    工具    │                   说明                    │
  ├────────────┼───────────────────────────────────────────┤
  │ web_search │ 百度千帆搜索（首选），返回标题、URL、摘要 │
  ├────────────┼───────────────────────────────────────────┤
  │ web_fetch  │ 网页抓取，HTML 转 Markdown                │
  └────────────┴───────────────────────────────────────────┘

  UNO Q 自主编程

  - 编程流程：创建目录 → 编写文件 → 启动应用 → 检查状态
  - 核心原则：硬件控制用 MCU 侧、Bridge 通信、Qwiic I2C 用 Wire1

  知识库

  ┌────────────┬────────────────────┐
  │   知识库   │        内容        │
  ├────────────┼────────────────────┤
  │ 树莓派杂志 │ The MagPi 官方杂志 │
  ├────────────┼────────────────────┤
  │ 孙膑兵法   │ 中国古代兵书       │
  └────────────┴────────────────────┘

  常用命令

  arduino-app-cli app start /home/arduino/ArduinoApps/
  arduino-app-cli app stop /home/arduino/ArduinoApps/
  arduino-app-cli app list

  其他工具

  - exec：命令执行（超时 300 秒，阻止危险命令）
  - cron：定时提醒（一次性/周期任务）
  - 邮件服务：SMTP smtp.qq.com:465

  ---
  简单说：TOOLS.md = 工具使用手册，回答"我如何做事"

笔者在USER.md存储用户的个人信息、技术偏好、兴趣领域、硬件环境等，用于个性化交互

复制代码

 USER.md 内容概要

  基本信息

  - Name: Flash
  - Timezone: UTC+8
  - Language: 中文
  - Email: ********@qq.com

  核心动机

  - nanobot 自主编程：让 nanobot 能自主启动程序，实现 UNO Q 自主编程能力

  背景与角色

  - 🎓 开发者：嵌入式系统爱好者，Arduino 开发
  - 🤖 UNO Q 用户：App Lab 应用开发
  - 🧠 AI 探索者：人工智能、机器人技术
  - 📜 古文字爱好者：甲骨文、中国古画

  技术偏好

  - ✅ 简洁直接，高效沟通
  - ✅ 看到什么说什么，不要编造
  - 💻 熟悉 Arduino 编程
  - 🐧 了解 Linux 基础
  - 🐍 Python 开发

 简单说：USER.md = 用户档案，回答"我为谁服务"

笔者在HEARTBEAT.md记录系统健康状态（进程、连接、磁盘、内存）及定时任务状态

复制代码

最近检查记录

  ┌──────────────────┬─────────┬────────────────────────┐
  │     检查时间     │  状态   │          备注          │
  ├──────────────────┼─────────┼────────────────────────┤
  │ 2026-03-08 20:25 │ ✅ 优化 │ Workspace 目录清理优化 │
  ├──────────────────┼─────────┼────────────────────────┤
  │ 2026-03-08 19:55 │ ✅ 正常 │ 自动检查               │
  ├──────────────────┼─────────┼────────────────────────┤
  │ ...              │ ...     │ ...                    │
  └──────────────────┴─────────┴────────────────────────┘

  检查项目

  1. nanobot gateway 进程 - PID、内存、CPU、运行时长
  2. 飞书 WebSocket 连接 - 端口 18790
  3. 磁盘空间 - 使用率、可用空间
  4. 内存使用 - 已用/总量、使用率

  定时任务状态

  ┌────────────────────────┬─────────┐
  │          任务          │  状态   │
  ├────────────────────────┼─────────┤
  │ 每 6 小时同步时间      │ ✅ 正常 │
  ├────────────────────────┼─────────┤
  │ 早间汇报（7:00/8:00）  │ ✅ 正常 │
  ├────────────────────────┼─────────┤
  │ 心跳检查（每 30 分钟） │ ✅ 正常 │
  ├────────────────────────┼─────────┤
  │ 午间汇报（12:00）      │ ✅ 正常 │
  ├────────────────────────┼─────────┤
  │ 晚间汇报（18:00）      │ ✅ 正常 │
  └────────────────────────┴─────────┘

  配置

  - 心跳间隔：1800 秒（30 分钟）
  - Cron 表达式：*/30 * * * *
  - 时区：Asia/Shanghai

  修复记录

  - 2026-03-08 08:45：心跳检查任务未配置，已添加 cron 任务

  ---
  简单说：HEARTBEAT.md = 系统健康监控日志，回答"我是否正常运行"