插件面板

AI 问答助手

插件内置 AI 文档问答助手,即面板的主体区域,可直接向 Realtek Ameba 文档知识库提问,无需离开 VS Code。了解更多可以参考 AI 聊天机器人 章节。

使用方法:

  1. 在面板主体区域的 AI 问答区输入问题,点击 Send 或按回车发送,Shift+Enter 换行;输入框为单行时,可按 ↑ / ↓ 键翻阅之前发送过的问题

  2. 点击输入框右下角的模式按钮切换回答模式(见下表)

  3. 如需附带文件,点击 Attach file 添加附件

  4. AI 助手返回答案,并在答案下方的 Sources 中列出相关文档来源,点击可在浏览器中打开

  5. 回答生成过程中,可点击 Stop generation 中止

  6. 可点击 👍 / 👎 对回答评分;点击 👎 时可选择原因(Incorrect Information / Not Relevant / Question Not Addressed)并提交反馈

  7. 点击 New chat 开启新对话,当前对话历史将被清除

回答模式:

模式

说明

⚡ Fast(默认)

快速回答

🧠 Deep

深度思考模式,回答上方会显示思考耗时(如 Thought for 12s)

选择 Deep 后,后续提问都会沿用该模式,直至切回 Fast;回答生成过程中模式按钮不可点击。

备注

  • AI 问答助手需要网络连接,离线环境下不可用

  • 回答基于 RealMCU 公开文档,仅供参考,不代表实时技术支持

命令面板与状态栏

插件提供命令面板和可自定义的底部状态栏,方便快速执行常用操作。

命令面板

  • Commands:列出常用命令,每行左侧有勾选框,勾选后对应操作按钮会出现在底部状态栏,勾选状态保存,重启插件后自动恢复;内含 Advanced 可折叠子区域(默认折叠),提供高级命令入口,高级命令无勾选框,不会出现在状态栏

  • 选择区 / 操作区:芯片、串口、示例下拉框及快捷图标按钮行

命令面板完整命令列表:

命令显示名

说明

Menuconfig

打开 SDK 配置界面,打开方式由 Menuconfig Mode 设置决定

Clean

清理工程编译产物

Build

编译工程

Flash

烧录固件

Monitor

打开串口监视器

Debug

启动调试器

Docs

打开 Ameba 官方文档

Setup Wizard ▸

打开 环境安装向导

New External Project ▸

打开新建外部工程向导

Import External Project ▸

导入已有外部工程

Set Root SDK Path ▸

为当前工程创建或更新 .vscode 配置,外部工程可借此选择 SDK 路径和目标芯片

Save Project Configuration ▸

将当前 menuconfig 配置保存为 prj.conf

Full Clean ▸

深度清理工程(含 SoC 编译缓存)

Open Ameba Terminal ▸

打开已激活 SDK 环境的 Ameba 专用终端

备注

  • 带 ▸ 标记的为 Advanced 区中的高级命令

  • SDK 环境未就绪时,除 Docs 外的主命令置灰不可点击;高级命令始终可点击

选择区

  • 芯片选择:通过下拉选择框选择要开发的 Ameba 系列芯片型号

  • 串口选择:自动扫描并更新系统中所有可用串口,通过下拉选择框选择开发板对应的串口名

  • 示例选择:

    • 仅 SDK Root 工程 支持示例选择;外部工程 不显示示例选择框

    • 通过下拉选择框选择对应的应用示例,选择 None 可清除选择

    • 选择示例后,若该示例目录下存在 README.md,将自动打开其预览

    • 点击 Build 时,已选择的示例会参与编译;默认情况下或选择 None 时编译基础项目配置

    • 若示例目录下带有 prj.conf,编译时将强制使用该配置文件(自动追加 -p 参数)

    • 示例选择按工作区保存;切换 SDK 后,若所选示例在新 SDK 中不存在,选择将自动重置为 None

底部状态栏

底部状态栏分为选择类和操作类,选择类在左、操作类在右:

../_images/vsix_status_bar_zh.png
  • 选择类(左侧):显示当前芯片型号、串口和示例,点击弹出快速选择列表;始终显示,外部工程不显示示例

  • 操作类(右侧):仅显示在命令面板中勾选的命令,为纯图标按钮,点击直接执行对应命令

  • SDK 环境未就绪时,选择类仅保留芯片项并显示 ⚠ Not Ready,操作类按钮全部隐藏

  • 命令执行中时,对应图标替换为旋转加载动画;执行失败时短暂变为红色错误图标