> 内容来源：Onevium 官方文档
> 文章: 使用文件、终端与 Review
> 原文: https://onevium.com/zh/docs/files-terminal-review
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.22
> 功能状态: 已发布

---

# 使用文件、终端与 Review

提供准确文件上下文、检查命令结果，并在工作区审阅一次小范围修改。

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

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

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

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

## 为示例准备一份文档

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

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

## 完成一次小修改

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
```

第一条查看文件状态，第二条查看未暂存的文档差异，第三条检查差异中的空白错误。它们不会替你提交代码。长期运行的预览应使用[托管服务](https://onevium.com/zh/docs/managed-services)，不要让普通终端标签承担服务管理。

## 在 Review 中逐项验收

Review 左上角可在 **Changes / 变更** 与 **All files / 全部文件** 之间切换。变更按未暂存、已暂存和未跟踪文件分类；选择文件查看对应内容。

本例应只新增约定小节，原有段落和其他文件保持原样。如果文件已被暂存，查看已暂存区域；终端对应使用 `git diff --cached -- README.md`。

Review 可以看到整个工作区已有变化，不会自动只显示本次任务的改动。先区分原有修改和新增修改。顶部的 **Commit**、**Commit and push** 是另行执行的操作，本例不需要点击。

## 常见问题

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

## 下一步

需要运行预览时，跟随[托管开发服务示例](https://onevium.com/zh/docs/managed-services)。更多操作边界见[权限与计划](https://onevium.com/zh/docs/permissions)，项目组织见[项目与会话](https://onevium.com/zh/docs/projects-and-sessions)。