Console 交互

将开发板通过 USB 连到电脑，使用 idf.py monitor、minicom 或在线烧录工具自带的 Console，进入 edge_agent 的交互提示符（默认 app> ）。

会话与问答

不同 session 使用不同的会话历史文件（见 Memory）。长期记忆数据仍在共享的 memory/ 目录中管理。

session demo
session

使用 ask 可以与 LLM 发起多轮对话。添加 --once 可以发起不使用会话历史的单轮对话。

ask 帮我列一下你可以做什么
ask --once 这是一次性问题，不要带历史

cap list

第二个参数必须是合法 JSON 字符串（注意引号转义）。

cap call get_current_time '{}'
cap call list_dir '{"keyword":"scripts"}'

一个 Capability 可能提供大量 Tools，这些 Tools 会被组织成一个或多个 Group。

cap groups

ls 递归列出 DATA 和 SYSTEM 根目录中的文件，可选参数用于按路径关键字过滤。

ls
ls scripts

skill 列出当前 Skill 目录；添加 --reload 会先重新扫描目录。

skill
skill --reload

router --reload
router --rules
router --last

数据流与自动化更多命令、详细用法见此文档

hwmap 显示已注册资源及其使用者；hwmap query <key> 查询单项。EXCLUSIVE 最多允许一个凭证，SHARED 允许多个凭证；USERS 为当前使用数，CLAIM 为使用凭证编号。已注册但空闲的资源显示 (free)，未注册的 key 返回错误。

hwmap
hwmap query gpio:1
hwmap query bus:i2c0
hwmap query device:display_lcd

启动时注册资源目录，Board Manager 实际初始化驱动时才申请占用，驱动销毁成功后释放。Flash、PSRAM、控制台等系统资源不在注册表保护范围内。共享入口只允许复用现有硬件对象，不保证任意并发操作都安全。

根据编译配置，edge_agent 还可注册 lua、scheduler、router、skill、hwmap 和 wifi。在 Console 中输入 help 可浏览所有命令。

运行时改 Wi‑Fi、LLM 等，用 Web 往往更顺手：

Web 配置局域网浏览器修改设置与文件

配置说明 NVS 键与生效方式