> 内容来源：Onevium 官方文档
> 文章: 组织项目与会话
> 原文: https://onevium.com/zh/docs/projects-and-sessions
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.22
> 功能状态: 已发布

---

# 组织项目与会话

选择正确的工作目录，组织相关任务，并在继续工作前核对项目的当前状态。

## 项目与会话分别保存什么

**项目**对应本机的工作目录，**会话**保存一个任务的消息和工具活动。一个项目可以有多个会话，但新会话不会自动复制目录、创建 Git 分支或建立 worktree。

## 新建项目或打开已有目录

在左侧 **项目** 标题旁点击带加号的文件夹按钮（**添加项目**），打开“新建项目”对话框。

| 需求     | 操作                                                    |
| ------ | ----------------------------------------------------- |
| 创建空项目  | 在“创建新项目”中输入名称，例如 `onevium-tutorial`，核对下方完整路径，点击“创建项目” |
| 使用现有项目 | 点击“打开已有文件夹”，在目录选择器中选中项目根目录并确认                         |

新建目录默认位于当前用户主目录下的 `Onevium` 文件夹；对话框会显示实际路径。它创建的是文件夹，不会自动下载代码、安装依赖或初始化 Git。已有代码请选择包含 README、包管理或构建配置的根目录，不要误选它的上级目录。

## 在指定项目创建会话

1. 点击项目名展开会话列表。
2. 将鼠标移到目标项目行，点击出现的铅笔按钮（**新会话 / New Conversation**）。左侧顶部的“新会话”也可使用，但先核对当前目录。
3. 在新会话中确认项目路径、服务商、模型和权限，再发送任务。

```text
调查本项目如何处理成员邀请。
先报告当前工作目录和 Git 分支（若不是 Git 项目就说明）。
找到界面入口、服务端处理和相关测试，引用文件路径。
不要修改文件、安装依赖或启动服务。
没有找到的部分明确列出，不要猜测。
```

点击项目名主要是展开或收起列表；进入项目中的会话，或从项目行新建会话，才能明确工作对象。同一目标的追问留在原会话，另一个独立目标再建新会话。

## 并排查看两个会话

从侧栏拖动另一条会话到当前聊天区域，待左侧或右侧的分屏落点出现后放开。进入分屏后，先点击准备操作的列，再输入消息；检查该列标题和项目，避免发错任务。

拖动列间分隔线调整宽度。列标题的关闭按钮只关闭该列；标题旁的 `…` 菜单提供重命名、关闭及关闭其他列等操作。会话仍可从侧栏重新打开。

分屏不提供文件隔离。两列若指向同一目录，会看到同一份文件；需要并行修改时，先使用明确的独立检出，或让任务处理互不重叠的文件。

## 继续历史任务

直接点击侧栏会话即可继续；项目多时，用“项目”标题旁的搜索按钮查找项目和会话。会话右键菜单中的 **复制路径** 可以核对实际目录，**在终端中打开** 打开的是 Onevium 内置终端。

继续前先读最后一条结果，再要求核对已经可能变化的事实：

```text
继续这个任务。先列出已完成内容和下一步。
重新核对当前分支、工作区改动和相关服务状态。
不要把上一次的日志当作现在仍然有效的结果。
```

## 归档与恢复

普通会话行在悬停时会出现垃圾桶按钮。移除后，可在 **设置 → 归档会话 / Archived sessions** 找到记录并点击 **恢复**。已置顶项可先取消置顶，再使用移除入口。

恢复会话不是回退代码，也不会自动恢复已经退出的进程。归档页中的永久删除是另一种操作；仍要保留的记录使用恢复，不要永久删除。

## 常见问题

| 现象            | 先检查                         |
| ------------- | --------------------------- |
| 新会话读到另一项目     | 核对项目行、会话路径；不要只看显示名称         |
| 分屏后消息发错列      | 点击目标列，再核对列标题和输入框；列内状态属于各自会话 |
| 同一文件被两个任务修改   | 查看实际 diff，保留已有改动，再调整任务分工    |
| 会话不在侧栏        | 检查搜索/筛选条件、项目是否收起，以及归档会话     |
| 历史说服务正常，现在打不开 | 重新检查进程和预览地址；历史不是当前健康状态      |

## 下一步

用[文件、终端与 Review](https://onevium.com/zh/docs/files-terminal-review)核对工作；交接长任务见[记忆与回顾](https://onevium.com/zh/docs/memory-and-recap)，持续推进见 [Goal](https://onevium.com/zh/docs/goal-mode)。