使用文件、终端与 Review

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

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

非 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 打开变更。

只在本项目 README.md 末尾追加下面这个小节：

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

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

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

在内置终端核对命令#

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

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

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

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

在 Review 中逐项验收#

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

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

Review 可以看到整个工作区已有变化，不会自动只显示本次任务的改动。先区分原有修改和新增修改。展开 Review 后，可用「上一处改动／下一处改动」逐项查看，也可切到上一个或下一个文件。

给具体代码行添加批注

1. 在差异的修改后内容中，将鼠标移到目标行旁，点击出现的 +。
2. 写清该行的问题或修改要求并保存。删除前的旧内容不能用这个入口加注。
3. 点击底部的批注数量，核对跨文件批注列表；点击某条可回到对应文件与行。
4. 关闭「不用回输入框，点了就发」时，选择「放进输入框」，再补充要求并发送；开启时点击「发给 agent 修改」可直接提交。

直接发送会连同当前输入框里的草稿一起提交，发送前先检查草稿。没有可接收消息的输入框时，批注会留在输入框等待发送；保存批注本身不会让助手开始修改。助手处理后，再核对差异。

右下角的提交入口提供 Commit 和 Commit and push，它们是另行执行的 Git 操作，本例不需要点击。

常见问题#

下一步#

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