跳转到正文
Onevium文档
本页内容

使用文件、终端与 Review

在 Onevium 浏览项目文件、运行终端命令、审查代码差异,并用行批注让 AI 按具体位置修改。

找到文件、变更与终端入口#

在打开项目的会话顶部,可使用以下入口。图标不确定时,将鼠标停留在按钮上查看提示文字。

入口打开什么
文件夹图标:浏览全部文件 / Browse all filesReview 工作区的“全部文件”视图;选择文件后查看内容
绿色 +N、红色 -N:显示更改 / Show changes当前 Git 项目的变更视图;不是提交按钮
终端图标会话输入区下方的内置终端面板
输入框左侧 + 的文件上传项添加本次消息的文件附件
输入框 @ 列表的 Files / 文件分组查找并引用项目中的文件路径

非 Git 目录仍可浏览全部文件,但不会有 Git 变更计数。不要为了“看到 Review”就在不明确的目录初始化 Git。

导航与预览文件

打开文件后,可用顶部的分段路径展开上级目录、选择另一个文件或复制完整路径。例如从 src/booking.ts 切到旁边的 schema 文件,先核对新文件名和内容,再要求修改。

图片预览提供缩放和适应窗口控制。SVG 可以切换源码与预览,对照标记和实际图形;音频文件提供播放控件,先播放一小段确认是目标文件。预览媒体本身不会授权修改原文件。

为示例准备一份文档#

本例需要一个已有 Git 仓库、其中的 README.md,以及可用的 Git 命令。先在终端运行 git status --short,记下已有修改;如果 README 本身正被其他任务改动,换用一份清楚归属的文档。

文件附件与项目文件引用不是一回事:上传的副本不会自动成为原项目文件的修改目标。需要编辑项目文件时,明确写出其项目内路径。

把长日志粘贴为附件

在输入框粘贴一份测试日志。超过 10,000 个字符或 150 行的文字会变成 pasted-text-…txt 附件,不再全部铺进编辑区。确认附件出现后,补一句“总结错误并引用相关行”。发送前检查内容;转换产生的是消息附件,不是项目中的新源文件。

完成一次小修改#

  1. 用“浏览全部文件”打开 README.md,确认是目标项目的文档。
  2. 返回会话,在 @ 文件列表中选择 README.md,发送下面的说明。
  3. 等待修改结果,再点击顶部 +N/-N 打开变更。
text
只在本项目 README.md 末尾追加下面这个小节:

## 本地检查
运行项目之前,先阅读本文件中的环境准备与启动说明。

如果已有同名小节,先报告,不要重复追加。
保留所有已有修改,不改其他文件,不提交或推送。
完成后报告实际改动的路径。

这是一次明确的文件写入。出现审批时,核对将修改的路径和动作再决定是否允许。

在内置终端核对命令#

点击顶部终端图标展开面板。面板里的 + 新建终端标签;标签旁关闭按钮结束该终端,面板的收起按钮只是隐藏界面。

终端按项目复用。切回项目后可能连接到已有终端,不会自动回到初始目录或清空环境。macOS/Linux 可先执行 pwd,PowerShell 使用 Get-Location;确认位于目标仓库后运行:

bash
git status --short
git diff -- README.md
git diff --check -- README.md

第一条查看文件状态,第二条查看未暂存的文档差异,第三条检查差异中的空白错误。它们不会替你提交代码。长期运行的预览应使用托管服务,不要让普通终端标签承担服务管理。

在 Review 中逐项验收#

先确认查看的是哪种变更:

入口查看范围
会话顶部 +N/-N → 工作区变更当前仓库的未暂存、已暂存和未跟踪文件,包含其他任务留下的改动
回复中的文件变更卡片 → 审核这轮请求记录的文件快照;可从来源菜单切到当前 Git 变更或其他已记录轮次
Review 左下角 比较分支指定来源分支与目标分支的差异和合并预览

本例应只新增约定小节。已暂存的修改在“已暂存”区域核对,终端对应使用 git diff --cached -- README.md。本轮记录可能不包含命令、插件或外部编辑器的修改;验收整个项目时,还要检查当前 Git 状态。

多仓库与文件导航

项目里有多个仓库时,先用仓库选择器确认范围。所有仓库可汇总查看;提交和分支比较前,选择具体仓库。

左侧可在变更 / Changes与全部文件 / All files之间切换。底部导航分别切换上一处/下一处改动、上一个/下一个文件;“所有仓库”视图也支持逐项查看。需要并排对照时,切换统一差异与左右差异视图。

给具体代码行添加批注

  1. 在当前 Git 差异的修改后内容中,将鼠标移到目标行旁,点击 +。
  2. 写清要求并保存,例如“空值时保留原来的提示”。删除前的旧内容不能用这个入口加注。
  3. 批注会直接出现在当前输入框中。点击批注可回到对应文件与行;点击移除按钮可删除不需要的批注。
  4. 核对输入框草稿和所有批注,再发送。保存批注本身不会开始修改,处理后仍要重新检查差异。

只撤销这一轮记录的文件修改

在回复的文件变更卡片上点击撤销,先看恢复预览,再点击撤销已记录的修改。它保留对话和历史变更记录,只还原可安全恢复的文件。文件已被后续任务改动或有冲突时,先处理提示。

要连同后续对话一起退回,使用消息撤回。不要把“只撤销文件”和“撤回对话”混为同一操作。

比较 Git 分支,再决定是否合并#

  1. 在 Review 选择具体仓库,点击左下角比较分支。
  2. 选择来源分支(要合入的改动)和目标分支(接收改动的分支),点击预览。
  3. 检查待合入提交、文件差异和冲突。需要助手协助时,从更多操作选择交给 AI 处理,检查请求后点击放入会话草稿,再自行发送。
  4. 确实需要合并时,清理好未提交改动,选择本地目标分支,再点击在本地合并并确认。

预览使用本机已有的分支快照,不会自动拉取远端更新。远端目标仅供审查;本地合并可能切换当前分支并创建合并提交,不会推送。工作区变更中的 Commit 和 Commit and push 是另外的 Git 操作,本例只需检查差异。

常见问题#

现象处理方法
Review 没有变化确认文件已保存、路径正确,并检查“已暂存”与“未跟踪”区域
文件树和聊天项目不一致先核对当前会话与工作目录,再打开文件
终端输出像是旧任务检查当前目录和正在运行的命令;必要时用 + 新开标签,不要凭旧日志判断
diff 包含其他人的修改保留它们,按任务边界检查;不要全部回退
检查命令报错记录命令和错误;空白检查通过不等于项目测试通过

Markdown、文本和 CSV 的手动编辑、保存与冲突处理,以及 PDF/Office 只读预览,见文件预览与编辑。

下一步#

需要运行预览时,跟随托管开发服务示例。更多操作边界见权限与计划,项目组织见项目与会话。