项目与文件工作区
项目把本地目录、聊天线程、Agent 上下文、文件编辑和后台任务组织在同一空间中。适合代码仓库、长期研究或需要持续维护文件的工作。
创建项目
- 进入 项目 页面并选择新建项目
- 输入项目名称
- 选择一个本地目录
- 按需选择 Code 或 Work 标签
- 创建后进入项目聊天
从 GitHub 克隆
新建项目时可以额外填写 GitHub 仓库地址。AIME Chat 会先把仓库克隆到所选目录,再创建项目。
- 支持标准 HTTPS、SSH URL 和
git@github.com:owner/repository.git格式 - 目标目录必须不存在或为空,并且父目录已经存在
- 本机必须已安装 Git,私有仓库需要预先配置可用的凭据或 SSH Key
- 克隆过程不会打开交互式凭据提示;认证失败时请先在终端验证仓库访问
文件浏览与搜索
项目聊天中的文件面板以项目目录为边界:
- 展开目录并点击文件即可在工作区打开
- 可在文件树中搜索文件名或内容
- 文件预览面板可以调整宽度,适合与聊天并排工作
- 聊天中的文件操作和 Agent 工具默认使用项目目录作为工作区
预览与编辑
| 文件类型 | 工作区行为 |
|---|---|
| 文本与代码 | 使用 CodeMirror 编辑,并根据扩展名启用语法高亮 |
| Markdown | 可在 Markdown 编辑器与源码模式之间切换 |
| 图片 | 应用内预览,并支持放大查看 |
| 音频 / 视频 | 使用系统媒体控件播放 |
| 在内嵌预览器中查看 | |
| 其他二进制文件 | 提示使用系统应用打开 |
代码高亮覆盖 JavaScript/TypeScript、JSON、HTML、CSS、Markdown、Python、SQL、YAML 和 XML 等常见格式。
保存与大文件保护
- 使用
Ctrl/Cmd + S保存当前文本文件 - 有未保存修改时会显示状态标记
- 关闭未保存文件前会要求确认
- 超过 2 MiB 的文本文件只显示截断后的只读预览,避免把不完整内容写回原文件
项目聊天线程
同一项目可以维护多个聊天线程。每个线程共享项目范围,但保留自己的消息历史;项目级任务视图还会汇总这些线程启动的后台 Bash 会话。
导出聊天历史
打开任意项目聊天后,从右上角的更多菜单选择 导出消息:
- 选择一个、多个或全部项目线程
- 选择保存格式
- 指定本地文件路径并导出
| 格式 | 内容 |
|---|---|
| Markdown | 适合阅读、归档和分享的完整对话 |
| 原始 JSON | Mastra 原始消息与展开后的模型消息 |
| Excel | 分为线程和消息工作表,便于筛选与统计 |
| Unsloth JSONL | 一行一个会话,保留工具调用、role=tool 与工具输出 |
Unsloth 导出会移除中断提示等训练噪声,但训练前仍应检查隐私、授权和数据质量。
使用建议
- 将一个稳定目录绑定到一个项目,避免在项目使用期间移动或重命名根目录
- 用多个聊天线程拆分功能开发、调研和运营任务,再通过项目范围查看后台进程
- 大型二进制资料可在工作区预览;需要结构化读取时,让 Agent 使用 Read、OCR 或代码执行工具
- 导出训练数据前先用 Markdown 或 Excel 格式抽查消息和工具结果