跳转到内容
Docs

Console 交互

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

会话与问答

Section titled “会话与问答”

切换 session

Section titled “切换 session”

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

session demo
session

与 LLM 对话

Section titled “与 LLM 对话”

使用 ask 可以与 LLM 发起对话。ask_once 可以发起单轮对话，与 ask 不同的是，ask_once 不会将对话内容计入历史上下文。

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

能力 cap

Section titled “能力 cap”

列出能力

Section titled “列出能力”
cap list

调用能力

Section titled “调用能力”

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

cap call get_current_time '{}'
cap call list_dir '{"path":"/fatfs"}'

组管理

Section titled “组管理”

一个 Capability 可能提供大量 Tools。为了方便管理，这些 Tools 会被组织成一个或多个 Group，可以一次性启用/禁用/卸载整组的 Tools。

cap groups
cap enable <group_id>
cap disable <group_id>
cap unload <group_id>

技能 skill

Section titled “技能 skill”

模型侧用 activate_skill / deactivate_skill；人类在串口可用 skill 命令（由 cmd_cap_skill 注册）来管理 Skill，例如：

skill --catalog
skill --list --session default
skill --activate weather --session default
skill --deactivate weather --session default
skill --clear --session default

请保证 --session 与当前 session 命令切到的 id 一致，否则看起来会像「激活了但没进上下文」。

自动化 auto

Section titled “自动化 auto”
auto reload
auto rules
auto last
...
数据流与自动化 更多命令、详细用法见此文档

其它已注册的 cap 命令

Section titled “其它已注册的 cap 命令”

basic_demo 中通过各 Capability Group 注册了 help、cap、auto、time、web_search、mcp_client、mcp_server、llm_inspect、event_router 等命令。 在 Console 中输入 help 可浏览所有命令。

cap 命令除常规子命令（list、call、groups、enable、disable、unload）外，还支持 cap load qq（动态加载 cap_im_qq 组）。

系统配置

Section titled “系统配置”

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

Web 配置 局域网浏览器修改设置与文件
配置说明 NVS 键与生效方式