组织项目与会话
选择正确的工作目录,组织相关任务,并在继续工作前核对项目的当前状态。
工作区与会话项目与会话分别保存什么#
项目对应本机的工作目录,会话保存一个任务的消息和工具活动。一个项目可以有多个会话,但新会话不会自动复制目录、创建 Git 分支或建立 worktree。
新建项目或打开已有目录#
在左侧 项目 标题旁点击带加号的文件夹按钮(添加项目),打开“新建项目”对话框。
| 需求 | 操作 |
|---|---|
| 创建空项目 | 在“创建新项目”中输入名称,例如 onevium-tutorial,核对下方完整路径,点击“创建项目” |
| 使用现有项目 | 点击“打开已有文件夹”,在目录选择器中选中项目根目录并确认 |
新建目录默认位于当前用户主目录下的 Onevium 文件夹;对话框会显示实际路径。它创建的是文件夹,不会自动下载代码、安装依赖或初始化 Git。已有代码请选择包含 README、包管理或构建配置的根目录,不要误选它的上级目录。
在指定项目创建会话#
- 点击项目名展开会话列表。
- 将鼠标移到目标项目行,点击出现的铅笔按钮(新会话 / New Conversation)。左侧顶部的“新会话”也可使用,但先核对当前目录。
- 在新会话中确认项目路径、服务商、模型和权限,再发送任务。
调查本项目如何处理成员邀请。
先报告当前工作目录和 Git 分支(若不是 Git 项目就说明)。
找到界面入口、服务端处理和相关测试,引用文件路径。
不要修改文件、安装依赖或启动服务。
没有找到的部分明确列出,不要猜测。
点击项目名主要是展开或收起列表;进入项目中的会话,或从项目行新建会话,才能明确工作对象。同一目标的追问留在原会话,另一个独立目标再建新会话。
给会话设置容易识别的标题与标记
对本地创建的主会话,右键侧栏会话行,选择重命名…,输入例如「检查成员邀请权限」,点击保存。需要建议时点击 AI 生成,检查或修改建议文字后再保存;生成建议本身不会应用标题。命名设置可选择命名模型和规则。正在执行任务时,等任务结束再请求 AI 命名,仍可手动改名;自动命名不会静默覆盖手动保存的标题。
右键主会话,选择标记,设置表情或颜色后点击保存标记。已有可复用标签时,可在同一面板的自定义标签中选用。保存后回到侧栏核对。例如,给审查任务使用放大镜标记;标记不改变会话实际的运行或完成状态。
调整状态与渠道上下文的位置
打开设置 → 外观 → 侧边栏与会话列表。在排版预设选择状态在右侧:标记与来源图标留在左侧,运行状态放到右侧。也可逐项选择位置,并独立调整侧边栏字号,不会改变消息和代码字号。
渠道会话可在渠道会话标题中选择是否在标题前显示发送者、群或联系人名称。这些是显示选项,不会改写来源消息。返回一条熟悉的会话,检查标题与运行状态是否都清楚。
并排查看两个会话#
从侧栏拖动另一条会话到当前聊天区域,待左侧或右侧的分屏落点出现后放开。进入分屏后,先点击准备操作的列,再输入消息;检查该列标题和项目,避免发错任务。
拖动列间分隔线调整宽度。列标题的关闭按钮只关闭该列;标题旁的 … 菜单提供重命名、关闭及关闭其他列等操作。会话仍可从侧栏重新打开。
拖拽会话或调整分屏列顺序时,信息浮层会暂时避让,留出落点区域。每个会话独立记住信息卡的显示状态,调整一个会话不会把所有会话都改成相同状态。
分屏不提供文件隔离。两列若指向同一目录,会看到同一份文件;需要并行修改时,先使用明确的独立检出,或让任务处理互不重叠的文件。
查看子会话树
负责人创建真实子会话后,侧栏会把成员缩进显示在父会话下。点击父会话旁的展开按钮查看成员,点击成员行可进入它自己的对话。置顶父会话时,子会话会一起出现在置顶区。
打开成员后,可以像普通会话一样查看实时回复、处理权限或补充要求。树形关系表示任务归属,不会创建独立文件副本;不要仅因某个成员空闲,就认为整个任务完成。完整分工和报告流程见队伍协作。
继续历史任务#
直接点击侧栏会话即可继续;项目多时,用“项目”标题旁的搜索按钮查找项目和会话。会话右键菜单中的 复制路径 可以核对实际目录,在终端中打开 打开的是 Onevium 内置终端。
切换较大的会话时,Onevium 会先呈现目标上下文,再分批挂载历史内容。草稿、附件、分屏和后台回复仍归属于各自会话。继续输入前核对目标标题和输入区;特别大的单条消息仍可能需要一定渲染时间。Agent 卡片压缩了高度,但保留实际进度,不能把切走会话或卡片变短当作任务已经结束。
继续前先读最后一条结果,再要求核对已经可能变化的事实:
继续这个任务。先列出已完成内容和下一步。
重新核对当前分支、工作区改动和相关服务状态。
不要把上一次的日志当作现在仍然有效的结果。
归档与恢复#
普通会话行在悬停时会出现垃圾桶按钮。移除后,可在 设置 → 归档会话 / Archived sessions 找到记录并点击 恢复。已置顶项可先取消置顶,再使用移除入口。
恢复会话不是回退代码,也不会自动恢复已经退出的进程。归档页中的永久删除是另一种操作;仍要保留的记录使用恢复,不要永久删除。
常见问题#
| 现象 | 先检查 |
|---|---|
| 新会话读到另一项目 | 核对项目行、会话路径;不要只看显示名称 |
| 分屏后消息发错列 | 点击目标列,再核对列标题和输入框;列内状态属于各自会话 |
| 同一文件被两个任务修改 | 查看实际 diff,保留已有改动,再调整任务分工 |
| 会话不在侧栏 | 检查搜索/筛选条件、项目是否收起,以及归档会话 |
| 历史说服务正常,现在打不开 | 重新检查进程和预览地址;历史不是当前健康状态 |
下一步#
用文件、终端与 Review核对工作;交接长任务见记忆与回顾,持续推进见 Goal。