使用文件、终端与 Review
在 Onevium 浏览项目文件、运行终端命令、审查代码差异,并用行批注让 AI 按具体位置修改。
工作区与会话找到文件、变更与终端入口#
在打开项目的会话顶部,可使用以下入口。图标不确定时,将鼠标停留在按钮上查看提示文字。
| 入口 | 打开什么 |
|---|---|
| 文件夹图标:浏览全部文件 / Browse all files | Review 工作区的“全部文件”视图;选择文件后查看内容 |
绿色 +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 附件,不再全部铺进编辑区。确认附件出现后,补一句“总结错误并引用相关行”。发送前检查内容;转换产生的是消息附件,不是项目中的新源文件。
完成一次小修改#
- 用“浏览全部文件”打开
README.md,确认是目标项目的文档。 - 返回会话,在
@文件列表中选择README.md,发送下面的说明。 - 等待修改结果,再点击顶部
+N/-N打开变更。
只在本项目 README.md 末尾追加下面这个小节:
## 本地检查
运行项目之前,先阅读本文件中的环境准备与启动说明。
如果已有同名小节,先报告,不要重复追加。
保留所有已有修改,不改其他文件,不提交或推送。
完成后报告实际改动的路径。
这是一次明确的文件写入。出现审批时,核对将修改的路径和动作再决定是否允许。
在内置终端核对命令#
点击顶部终端图标展开面板。面板里的 + 新建终端标签;标签旁关闭按钮结束该终端,面板的收起按钮只是隐藏界面。
终端按项目复用。切回项目后可能连接到已有终端,不会自动回到初始目录或清空环境。macOS/Linux 可先执行 pwd,PowerShell 使用 Get-Location;确认位于目标仓库后运行:
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之间切换。底部导航分别切换上一处/下一处改动、上一个/下一个文件;“所有仓库”视图也支持逐项查看。需要并排对照时,切换统一差异与左右差异视图。
给具体代码行添加批注
- 在当前 Git 差异的修改后内容中,将鼠标移到目标行旁,点击 +。
- 写清要求并保存,例如“空值时保留原来的提示”。删除前的旧内容不能用这个入口加注。
- 批注会直接出现在当前输入框中。点击批注可回到对应文件与行;点击移除按钮可删除不需要的批注。
- 核对输入框草稿和所有批注,再发送。保存批注本身不会开始修改,处理后仍要重新检查差异。
只撤销这一轮记录的文件修改
在回复的文件变更卡片上点击撤销,先看恢复预览,再点击撤销已记录的修改。它保留对话和历史变更记录,只还原可安全恢复的文件。文件已被后续任务改动或有冲突时,先处理提示。
要连同后续对话一起退回,使用消息撤回。不要把“只撤销文件”和“撤回对话”混为同一操作。
比较 Git 分支,再决定是否合并#
- 在 Review 选择具体仓库,点击左下角比较分支。
- 选择来源分支(要合入的改动)和目标分支(接收改动的分支),点击预览。
- 检查待合入提交、文件差异和冲突。需要助手协助时,从更多操作选择交给 AI 处理,检查请求后点击放入会话草稿,再自行发送。
- 确实需要合并时,清理好未提交改动,选择本地目标分支,再点击在本地合并并确认。
预览使用本机已有的分支快照,不会自动拉取远端更新。远端目标仅供审查;本地合并可能切换当前分支并创建合并提交,不会推送。工作区变更中的 Commit 和 Commit and push 是另外的 Git 操作,本例只需检查差异。
常见问题#
| 现象 | 处理方法 |
|---|---|
| Review 没有变化 | 确认文件已保存、路径正确,并检查“已暂存”与“未跟踪”区域 |
| 文件树和聊天项目不一致 | 先核对当前会话与工作目录,再打开文件 |
| 终端输出像是旧任务 | 检查当前目录和正在运行的命令;必要时用 + 新开标签,不要凭旧日志判断 |
| diff 包含其他人的修改 | 保留它们,按任务边界检查;不要全部回退 |
| 检查命令报错 | 记录命令和错误;空白检查通过不等于项目测试通过 |
Markdown、文本和 CSV 的手动编辑、保存与冲突处理,以及 PDF/Office 只读预览,见文件预览与编辑。