Agent 调试助手

Agent Tab 是 Workbench 的 Claude Code 驱动板卡调试助手。用户用自然语言描述需求，Agent 自动解析、规划、通过 SSH 在 Pico-G1 板端执行。

功能

Agent Tab 把 Claude Code 嵌入 IDE，让你能用自然语言指挥板卡：

  • 输入"查看板卡 CPU 占用" → 自动 SSH 执行 top 并回复结果
  • 输入"写一个 Svp 人头计数脚本" → 在工作区生成代码，可直接跑
  • 输入"部署 yolov8n 并启动" → 自动串联 ch04 一键部署 + ch05 视觉 - SVP 流程
  • 支持多轮对话、新建/切换会话、随时重置上下文

适合 快速调试 / 探索性操作；复杂脚本交给 shimeta-py IDE。

在哪里使用

顶部 Tab → "Agent"

Agent Tab — 选择 Agent 下拉 + 会话历史 + 中央快捷指令 + 底部输入框

界面组成

顶部状态条

元素作用
Agent当前 Agent 模式
选择 Agent 下拉切换不同 Agent（如调试 Agent / 代码生成 Agent）
板端 IP当前连接的板卡（如 192.168.49.23）
default当前工作区
新会话新建对话
会话 下拉切换历史会话
+ 新会话快速新建
重新初始化上下文清空 Agent 当前对话上下文，重新开始

中央区域

欢迎页（首次进入）

Agent · 板卡调试
Claude Code 驱动的板卡调试与代码编写

[查看板卡当前 IP 和 CPU 占用]   [写一个 Svp 人头计数脚本到当前工作区]   [扫描板卡 I2C 总线上的设备]

3 个快捷指令按钮

快捷指令作用
查看板卡当前 IP 和 CPU 占用快速查看板端状态
写一个 Svp 人头计数脚本到当前工作区自动生成 SVP 脚本
扫描板卡 I2C 总线上的设备扫描硬件外设

点击按钮即自动执行该任务。

底部输入框

输入调试指令...（Enter 发送，Shift+Enter 换行）
  • Enter：发送
  • Shift+Enter：换行（多行输入）

工作原理

用户在 Agent 输入自然语言指令
       │
       ▼  Claude Code 解析
       │
       ▼  规划执行步骤
       │
       ▼  自动通过 SSH 在板端执行
       │       （使用 shimetad 用户连接）
       │
       ▼  收集结果
       │
       ▼  用自然语言回复用户

典型使用场景

1. 快速查询板端状态

查看板卡当前 IP 和 CPU 占用

Agent 自动 SSH 执行 ifconfig / top，回复结果。

2. 代码生成

写一个 Svp 人头计数脚本到当前工作区

Agent 在当前工作区生成 head_count.py，可用 shimeta-py IDE 直接运行。

3. 硬件调试

扫描板卡 I2C 总线上的设备

Agent 执行 i2cdetect 列出所有 I2C 设备。

4. 复杂任务

帮我把模型 yolov8n 部署到板卡，然后在视觉 Tab 启动它

Agent 自动调用 ch04 一键部署 + ch05 视觉 - SVP 流程。

与 shimeta-py IDE 的区别

项Agentshimeta-py IDE
交互方式自然语言写代码
适用快速调试 / 探索复杂脚本开发
输出自然语言回复代码执行结果
学习成本低需懂 Python

会话管理

新建会话

每次新建对话都会重置上下文。如需：

  • 点击顶部 "新会话" 或 "+ 新会话"
  • 上下文完全清空
  • 不影响其他历史会话

切换会话

点击顶部 "会话" 下拉：

  • 显示所有历史会话
  • 点击切换
  • 历史会话内容保留

重新初始化上下文

点击顶部 "重新初始化上下文"：

  • 不关闭当前会话
  • 清空 Agent 的上下文（板端状态、对话历史等）
  • 下次对话从干净状态开始

适合：板端状态变了，或 Agent 上下文混乱时。

板端上下文

Agent 需要板端上下文才能执行操作。首次使用时：

  • Agent 自动 SSH 到板端初始化
  • 收集板端状态（NPU / 内存 / 存储 / 网络）
  • 后续对话可引用

如提示 "请先连接板卡（Agent 需要板卡上下文初始化）"：

  1. 回 ch02 检查连接
  2. 连接成功后回到 Agent Tab 重新输入指令

常见问题

现象排查
Agent 提示"请先连接板卡"DEVICE TREE 检查连接
自然语言指令无响应重启 IDE；或新建会话
Agent 回复"我不知道"指令太模糊；具体化（"查看 CPU 占用" 比 "板卡怎么样" 好）
Agent 执行 SSH 失败shimetad 用户权限；切到终端 Tab 验证

下一步