基本使用

本指南将帮助您快速上手 AIME Chat 的基本功能。

初始化导向

界面概览

AIME Chat 的界面主要分为以下几个部分：

1. 侧边栏 - 会话管理、Agent 切换
2. 聊天区域 - 对话内容展示
3. 输入区域 - 消息输入和工具选择
4. 设置面板 - 模型和服务商配置

开始对话

1. 选择模型

在开始对话前，您需要先配置 AI 服务商并选择模型：

1. 点击设置图标进入设置页面
2. 选择 AI 服务商 选项卡
3. 启用您想使用的服务商并填写 API Key
4. 返回聊天页面，在模型选择器中选择模型

2. 发送消息

在输入框中输入您的问题或指令，按 Enter 或点击发送按钮即可发送消息。

快捷键

• Enter - 发送消息
• Shift + Enter - 换行
• Ctrl/Cmd + N - 新建会话

3. 使用工具

AIME Chat 支持多种工具调用。点击输入框旁的工具按钮可以查看和启用可用工具：

• 代码执行 - 通过 CodeExecution 运行 Python 代码
• 文件操作 - 读取、写入、搜索文件
• 网络请求 - 抓取网页、搜索信息
• 图像处理 - 图像分析、背景移除

会话管理

创建新会话

点击侧边栏的 新建会话 按钮或使用快捷键 Ctrl/Cmd + N。

管理历史会话

• 点击会话可切换到该会话
• 右键会话可进行重命名、删除等操作
• 会话会自动保存，关闭应用后不会丢失

回放消息

消息回放用于回顾已保存的对话过程，包括文本、思考、工具和文件片段。

1. 打开已有会话，等待当前回复结束
2. 点击输入区域上方工具栏中的 回放消息 图标
3. 选择每 0.5、1、3 或 5 秒 播放一个消息片段，开始回放
4. 在回放控制栏暂停或恢复播放、加快或减慢速度，或拖动进度条跳转
5. 播放完成后可从头回放；点击 退出回放 返回正常聊天

进度按消息片段计数，一条消息可能包含多个片段。回放会加载可用的压缩历史，与当前消息按 ID 去重合并；有历史内容时，控制栏会显示 包含压缩历史。

回放只展示已保存的内容，不会重新请求模型或执行工具，也不按原始响应耗时播放。没有可回放消息或当前回复尚未结束时，入口不可用。切换会话、清空消息或开始新回复时，会退出回放。

查看压缩历史与回复耗时

• 会话有压缩历史时，可点击消息区域顶部的 显示压缩历史 查看早期内容；该操作只补充界面展示，不把历史消息重新加入当前对话状态
• 助手消息下方会在时间信息可用时显示 耗时，按前一条用户消息到助手最后一个片段的时间差计算，以毫秒、秒或分秒展示
• 时间信息缺失、无效或时间顺序异常时，不显示耗时；该数值并非单独的模型推理计时

导出项目聊天

项目聊天支持按线程导出完整历史：

1. 进入一个项目并打开任意聊天线程
2. 点击页面右上角的 更多操作，选择 导出消息
3. 勾选要导出的项目聊天线程
4. 选择格式并指定保存位置

格式	适合场景
Markdown (.md)	阅读、归档与分享
原始 JSON (.json)	保留 Mastra 原始消息和展开后的工具消息体
Excel (.xlsx)	在线程表和消息表中筛选、统计或复核
Unsloth JSONL (.jsonl)	准备训练数据，并保留工具调用与工具输出

导出对话框默认选中项目中的全部线程，也可以只导出当前线程或自定义组合。

详细说明见 项目与文件工作区。

选择 Agent

AIME Chat 内置多种 Agent，针对不同场景优化：

Agent	描述	适用场景
默认 Agent	通用对话助手	日常对话、问答
代码 Agent	专注代码开发	编程、调试、代码审查

切换 Agent：

1. 在聊天页面点击 Agent 选择器
2. 选择适合您需求的 Agent

项目文件工作区

项目聊天侧边的文件树可以直接打开工作区文件：

• 文本和代码文件使用带语法高亮的编辑器，支持 Ctrl/Cmd + S 保存
• Markdown 可在富文本编辑与源码编辑之间切换
• 图片、音频、视频和 PDF 可直接预览
• GLB、glTF、FBX、OBJ、STL 可交互式预览，并切换线框或放大查看；具体操作见 项目与文件工作区
• 超过编辑上限的大型文本文件会以只读方式打开，避免误保存截断内容
• 关闭有未保存修改的文件前，应用会提示确认

外观设置

进入 设置 → 外观 后可以配置：

• 主题模式：浅色、深色或跟随系统
• 主题色：使用内置预设或自定义颜色
• 侧边栏背景与聊天背景：两者可分别选择图片、调整透明度和模糊度

背景图片支持 JPG、PNG 和 WebP，单张最大 10 MB。导入后图片会复制到应用的用户资料目录；恢复默认外观会清除主题色与两张背景图，但保留当前主题模式。

浏览器实例

AgentBrowser 会按需在聊天预览中打开内置 Electron Chromium，支持同一聊天多个标签页。首次需要登录网站时，在对应页面手动登录即可，后续聊天共享该登录状态。

进入 设置 → 实例管理 可以：

• 查看 Chromium 版本、标签页和聊天数量
• 打开固定的 instances/default_browser 数据目录
• 关闭所有浏览器标签页并取消操作，保留登录数据

共享数据与旧目录迁移说明见 浏览器实例。

Bash 的 Python 运行器

在 Agent 的 Bash 工具配置中，可以选择：

• 独立运行器（推荐）：使用 AIME Chat 管理的 Python 环境，依赖与系统环境相互隔离
• 系统运行器：使用登录 Shell 中可用的系统 Python 与既有环境配置

如果独立运行器尚未安装，请先在 设置 → 运行库 中安装 UV / Python。

语言设置

支持中文和英文界面：

1. 进入设置页面
2. 选择 通用 选项卡
3. 在语言选项中选择您偏好的语言

下一步

• 了解如何 配置 AI 服务商
• 探索 知识库功能
• 学习 工具系统 的高级用法