第12章 代码查看器

Code viewer 在下一个提示中，你可以浏览和编辑代码、查看变更，并添加注释作为上下文。Code 标签页允许你浏览项目、手动编辑，并分享特定代码，为下一步操作提供上下文。从预览工具栏打开该标签页即可开始使用。

浏览文件 从文件树中选择一个文件，即可查看其内容，系统会显示语法高亮和行号。查看器会随着工作区变更的可用而实时更新。 图像文件以预览形式打开。在工作区会话内切换 Code 与其他标签页时，已选文件和编辑器状态会予以保留。 使用文件标题右侧的 Copy file contents 或 Download file 可复制文本或下载当前打开的文件。对于文本文件，两者均使用当前编辑器内容，包括未保存的编辑。图像和其他二进制文件可直接下载。

管理文件和文件夹 在文件树中右键点击文件或文件夹，可选择 New file、New folder、Rename 或 Delete。也可使用文件树上方的 New file 和 New folder 按钮。 新创建的项目位于所选文件夹内，或与所选文件并列。若无选中项，标题按钮会在项目根目录创建新项目。直接在文件树中输入名称，然后按 Enter 或点击其他位置以确认。按 Escape 可取消操作。 重命名同样使用内联名称字段。删除操作需要确认；删除文件夹时会同时移除其内容。 文件操作会立即更新工作区。使用 Save 可持久化这些变更，或使用 Discard 撤销待处理的工作区变更。空文件夹在包含文件之前不会被持久化。

编辑代码 在文件树中选择一个现有文本文件或你创建的文件，然后在编辑器中开始输入。手动编辑需要对话的编辑权限，支持最大 1 MB 的 UTF-8 文本文件。图像和其他二进制文件仍为只读。 编辑会在停止输入短暂后自动同步到工作区。这会更新工作区文件，但不会提交变更。使用 Unsaved Changes 栏来：

Save：提交并持久化跟踪中工作区文件的待处理变更，包括通过文件树创建、重命名或删除的文件。在编辑器获得焦点时，你也可以按 macOS 上的 ⌘S 或 Windows/Linux 上的 Ctrl+S。 Discard：将所有跟踪中的工作区文件恢复到最新提交版本，移除通过编辑器创建的文件，并清除待处理的编辑器草稿。与跟踪无关的未跟踪文件保持不变。

编辑器支持撤销和重做。当 agent 正在工作时，手动编辑会暂停。 发送提示时也会尝试同步待处理的编辑，以便 agent 可以继续基于你的工作区文件工作。编辑器同步失败不会阻止你发送提示。

搜索代码 点击文件树上方的搜索图标，可显示或隐藏搜索框。搜索会匹配文件名和文件内容。 选择结果即可打开文件。内容匹配会跳转到匹配行。在搜索框获得焦点时，你也可以使用方向键选择结果。

添加代码注释 使用注释为 v0 提供精确的变更上下文：

在编辑器中选中代码。 选择 Add to chat 打开注释输入框。 输入可选的注释，然后在注释输入框中点击 +，将代码和注释添加到你的提示中。 在聊天输入框中添加其他说明，然后发送提示。

添加注释不会自动发送消息。提示中将包含文件路径、选中的行、捕获的代码以及你的注释。即使文件后续发生变化，这也确保了所引用代码的保留。 你可以使用铅笔图标编辑已保存的注释，或在发送前从提示的注释列表中移除它。在该列表中选择一个代码注释，会在 Code 标签页中打开其文件。 在只读代码视图中，点击行号或跨过边距拖选，可选择行，然后使用 + 添加上下文。 添加注释需要对话的编辑权限。未完成的选择或注释在切换文件或显示的修订版本变更时会被清除；已添加到提示中的注释会保留。

审查变更 打开消息的 Diff 标签页，审查该版本所做的变更。Diff 标签页为只读。点击或拖选 diff 一侧的行号，然后使用 + 添加注释，作为下一个提示的上下文。

工作区加载 如果工作区需要重新连接，Code 标签页会显示其连接状态。在后台刷新期间，之前加载的内容可能仍然可见。如果加载失败，请使用 Retry 重试。 Previous Paper Next Terminal commands