第12章 代码查看器
第12章 代码查看器
Code 选项卡允许你浏览项目、进行手动编辑,并将特定代码作为上下文分享给下一条 prompt。点击预览工具栏中的 Code 按钮即可开始使用。
浏览文件
在文件树中选择一个文件,即可查看其内容,支持语法高亮和行号显示。工作区变化可用时,查看器会自动更新。
图片文件会以预览形式打开。在同一个工作区会话中切换 Code 和其他选项卡时,已选文件和编辑器状态会被保留。
使用文件标题右侧的复制文件内容或下载文件按钮,可以复制或下载当前打开的文件。对于文本文件,两者都使用编辑器当前内容,包括未保存的编辑。图片和其他二进制文件可以下载。
管理文件和文件夹
在文件树中右键点击文件或文件夹,可以选择新建文件、新建文件夹、重命名或删除。也可以直接使用文件树上方的新建文件和新建文件夹按钮。
新建项目会创建在所选文件夹内,或与所选文件同级。如果没有选中任何项,标题按钮会在项目根目录下创建新项目。在树中直接输入名称,然后按 Enter 或点击其他位置确认。按 Escape 取消。
重命名也使用内联名称字段。删除需要确认;删除文件夹会同时移除其中的内容。
文件操作会立即更新工作区。使用保存来持久化更改,或使用丢弃来撤销待处理的工作区更改。空文件夹在包含文件之前不会被持久化。
编辑代码
在文件树中选择一个现有文本文件或你创建的文件,然后在编辑器中开始输入。手动编辑需要对聊天有编辑权限,支持最大 1 MB 的 UTF-8 文本文件。图片和其他二进制文件保持只读。
编辑会在输入暂停一小段时间后自动同步到工作区。这更新了工作区文件,但没有提交它们。使用未保存更改栏来:
保存:提交并持久化跟踪的工作区文件的待处理更改,包括通过文件树创建、重命名或删除的文件。你也可以在编辑器聚焦时按 macOS 上的 ⌘S 或 Windows 和 Linux 上的 Ctrl+S。
丢弃:将所有跟踪的工作区文件恢复到最新提交版本,移除通过编辑器创建的文件,并清除待处理的编辑器草稿。无关的未跟踪文件保持不变。
编辑器支持撤销和重做。当 agent 正在工作时,手动编辑会暂停。
发送 prompt 时会尝试同步待处理的编辑,以便 agent 可以从你的工作区文件继续。编辑器同步失败不会阻止你发送 prompt。
搜索代码
选择文件树上方的搜索图标,可显示或隐藏搜索框。搜索同时匹配文件名和文件内容。
选择一个结果以打开文件。内容匹配会带你到匹配的行。你也可以在搜索框聚焦时使用方向键选择结果。
添加代码注释
使用注释为 v0 提供更改的精确上下文:
选择编辑器中的代码。 选择添加到聊天以打开注释字段。 输入可选注释,然后选择注释字段中的 + 将代码和注释添加到你的 prompt。 在聊天输入中添加其他说明,然后发送 prompt。
添加注释不会自动发送消息。prompt 包括文件路径、选中的行、捕获的代码和你的注释。即使文件后续更改,这也保留了你所指的代码。
你可以使用铅笔图标编辑已保存的注释,或在发送前从 prompt 的注释列表中移除它。在该列表中选择代码注释会在 Code 选项卡中打开其文件。
在只读代码视图中,点击行号或在边距中拖动以选择行,然后使用 + 添加上下文。
添加注释需要对聊天有编辑权限。未完成的选中或注释会在你切换文件或显示的修订版本变化时清除;已添加到 prompt 的注释会保留。
审查更改
打开消息的 Diff 选项卡以审查该版本所做的更改。Diff 选项卡是只读的。在 diff 的一侧重点击或拖动物理行号,然后使用 + 将注释作为下一条 prompt 的上下文添加。
工作区加载
如果工作区需要重新连接,Code 选项卡会显示其连接状态。在后台刷新期间,之前加载的内容可能仍然可见。如果加载失败,使用重试再试一次。
上一章 下一章 安全审查