设置与其他
IDE 操作
Q：怎么切换主题？
右上角 ☀ 按钮 → 浅色 / 深色 / 跟随系统。
Q：怎么查看 IDE 日志？
点击底部状态栏的 > 日志 展开。日志文件位置：
%APPDATA%\ShiMetaPi Workbench\logs\Q：怎么退出 IDE？
右上角"退出"按钮。安全关闭，不会丢失本地数据。
Q：怎么安全卸载？
控制面板 → 程序 → 卸载程序 → ShiMetaPi Workbench → 卸载。
卸载不影响板端数据。
数据备份
Q：怎么备份配置？
需要备份的目录：
%APPDATA%\ShiMetaPi Workbench\包含：
- IDE 配置
- 部署日志
Q：怎么迁移到新电脑？
- 备份上述目录
- 在新电脑安装 Workbench
- 复制备份目录覆盖
- 重新登录 AIHub
Q：工作区项目文件在哪？
~/Documents/ShiMetaPi Workbench/projects/复制整个目录即可迁移项目。
性能问题
Q：IDE 启动慢？
| 可能原因 | 解决方法 |
|---|---|
| 板卡未连接（反复重连） | 先连接 |
| 工作区文件多 | 清理 |
| 杀毒软件扫描 | 添加白名单 |
Q：IDE 占用内存过大？
| 项目 | 占用 |
|---|---|
| 基础进程 | 200-400 MB |
| 摄像头预览 | +100 MB |
| 多板卡心跳 | +20 MB/台 |
如总占用 > 2 GB，考虑关闭不必要的预览窗口。
Agent
Q：怎么新建会话？
顶部 "新会话" 或 "+ 新会话"。
Q：怎么重置上下文？
点击顶部 "重新初始化上下文"。不清空历史，仅清空 Agent 当前上下文。
Q：Agent 能做什么？
Claude Code 驱动的板卡调试助手：
- 查询板端状态（IP/CPU/MEM）
- 写板端 Python 脚本
- 扫描硬件外设
- 复杂多步任务规划
详见 ch09 Agent 调试助手。
主题与界面
Q：怎么隐藏右侧面板？
右上角 ⏐ 按钮（面板切换）。
Q：怎么全局搜索？
右上角 🔍 按钮。
通知与提醒
Q：怎么查看通知？
右上角 🔔 按钮。
通知类型：
- 部署完成 / 失败
- 板端连接断开
- 模型发布等
反馈与支持
Q：在哪里反馈问题？
直接用 Agent Tab 让 Claude Code 帮你排查：
我在部署时报错 XXX，怎么解决？Claude Code 会自动 SSH 到板端排查。
Q：能联系官方客服吗？
临时支持途径：
- AIHub 平台公告：aihub.shimetapi.cn
- 软件源公告：mirrors.shimetapi.cn
安全
Q：板端 SSH 凭据会泄露吗？
- IDE 端用 Windows 凭据管理器加密
- shimetad 无密码（无凭据可泄露）
- root 凭据由用户自行管理
升级
Q：能回退到旧版本吗？
可以。卸载当前版本 → 安装旧版本。但配置可能不兼容，建议备份配置。
常见问题
| 现象 | 解决 |
|---|---|
| 主题不生效 | 重启 IDE |
| 主题切换按钮无反应 | 检查显卡驱动 |
| 自动更新不工作 | 检查网络 |
| 卸载后残留 | 手动删除 %APPDATA%\ShiMetaPi Workbench\ |