进阶 v0.dev 2026-11-12 04:30:30 · 15 阅读

第14章 v0 终端命令功能详解

第14章 终端命令

v0 的终端命令功能允许在项目的沙盒中运行 bash 命令,以测试交互、检查代码仓库、运行单元测试以及调用 Vercel 和 GitHub 等平台命令行工具(CLI)。你可以通过权限模式控制 v0 的自主程度,该模式默认为 Auto(自动)。

v0 在终端中的能力

v0 的 Bash 工具在与项目文件所在的同一沙盒中运行命令。每条命令都在从项目根目录启动的全新 shell 中执行,因此 v0 显式链接操作,而不是依赖 shell 状态。

常见用例

- 在浏览器中测试交互:针对实时预览启动无头浏览器会话,以验证用户流程并捕获错误。 - 审查提交历史:运行 git log、git blame 或 git diff,在编辑文件前了解先前变更。 - 编写并运行单元测试:执行项目的测试命令,读取输出并就地修复失败项。 - 使用平台 CLI:通过 Vercel CLI(vercel logs、vercel inspect)和 GitHub CLI(gh pr view、gh issue list)与部署、拉取请求(pull request)和问题(issue)交互,无需离开聊天界面。

如何请求相关操作

描述你期望的结果。例如:

- "在浏览器中测试注册流程,并报告任何失败。" - "查看该文件最近的 10 次提交,总结变更内容。" - "运行单元测试并修复任何失败项。" - "检查 Vercel 中最新的部署日志,定位错误。"

v0 会选择适当的命令,执行它们,并将输出整合到下一次响应中。

权限模式

v0 有三种权限模式,控制终端权限层如何处理命令。此设置在新的聊天中持续生效。

- Ask Permissions(询问权限):应用你的权限规则。允许的命令会运行,拒绝的命令会被阻止,标记为 ask 或未匹配到规则的命令需要确认。 - Auto Permissions(自动权限,默认):应用相同的规则。允许的命令会运行,拒绝的命令会被阻止,标记为 ask 的命令需要确认。对于未匹配的命令,v0 决定是否请求确认。 - Full Permissions(完全权限):跳过终端权限评估,不检查 allow、ask 或 deny 规则直接运行命令。

| 模式 | v0 的行为 | 适用场景 | | :--- | :--- | :--- | | Ask Permissions | 应用权限规则。允许的命令运行,拒绝的命令被阻止,标记为 ask 或未匹配规则的命令需确认。 | 敏感项目、生产数据,或希望审查未明确允许的命令时。 | | Auto Permissions (默认) | 应用相同规则。允许的命令运行,拒绝的命令被阻止,标记为 ask 的命令需确认。对于未匹配命令,v0 决定是否请求确认。 | 日常开发,希望 v0 在尊重配置规则的同时自主推进时。 | | Full Permissions | 跳过终端权限评估,不检查 allow、ask 或 deny 规则直接运行命令。 | 一次性或非敏感项目,接受无限制命令的风险时。 |

Auto Permissions(自动权限)

Auto 是默认模式,适合大多数用户。v0 无需确认即可在其内置允许列表中运行命令。该列表包括:

- 只读文件检查:ls, find, cat, head, tail, tree, wc, cd, pwd - 搜索和数据:grep, rg, jq - 本地 git:git status, git log, git diff, git show - 只读 GitHub CLI:gh pr view, gh pr list, gh pr diff, gh pr checks, gh issue view, gh repo view - 只读 Vercel CLI:vercel logs, vercel inspect, vercel list, vercel whoami, vercel activity - 输出:echo, whoami - 浏览器自动化和计时:agent-browser, sleep

未匹配的命令不会自动批准或拒绝。v0 可以根据其打算执行的操作运行该命令或明确请求你的确认。如果命令在 Auto 模式下必须有确定性结果,请添加 ask 或 deny 规则。

你可以在“设置 → Agent Permissions”下编辑此列表。请参阅“自定义规则”。

Ask Permissions(询问权限)

Ask 模式会为每个标记为 ask 或未匹配规则的命令显示确认卡片。匹配 allow 规则的命令仍无需确认即可运行,匹配 deny 规则的命令会被阻止。

当你希望有紧密的反馈循环时,例如针对真实生产数据库工作或希望在每个步骤都审计 v0 行为的仓库中工作时,使用 Ask 模式。

Full Permissions(完全权限)

Full 模式绕过终端权限评估。在执行命令前,它不检查内置、团队或用户的 allow、ask 和 deny 规则。这包括 shell 包装器(bash, sh, eval)、包执行(pnpm dlx, npx -y)、远程 git 操作(git push, gh pr create)以及破坏性命令。

仅当同时满足以下两个条件时,才使用 Full 模式:

- 你在没有生产凭据或关键数据的非敏感项目上工作。 - 你更倾向于事后审查 v0 的命令历史,而不是预先批准每个命令。

设置权限模式

1. 在编辑器工具栏中,打开模型选择器旁边的 + 菜单。 2. 选择 Auto Permissions。子菜单会显示你当前的模式。 3. 选择 Ask Permissions、Auto Permissions 或 Full Permissions。

你的选择在新聊天中持续生效,直到你更改它。

自定义规则

权限模式控制 v0 对未匹配命令的反应。规则本身(哪些命令算作允许、询问或拒绝)位于你的设置中,可以直接编辑。打开“设置 → Agent Permissions”进行管理。

用户和团队范围

权限面板有两个标签页:

- 用户(User):绑定到你账户的规则。它们应用到你工作的每个项目。 - 团队(Team):由团队所有者设置并应用到团队每个成员的规则。只有团队所有者可以编辑此标签页。

在 Ask 和 Auto 模式中,用户、团队和内置规则会被一起评估。一个范围内的规则并不总是覆盖另一个范围内的规则。最具体的匹配规则决定结果,如“规则优先级”中所述。

规则格式

每个范围持有三个 JSON 数组:

| 数组 | 行为 | | :--- | :--- | | allow | 在 Ask 或 Auto 模式下,v0 无需询问即可运行匹配的命令。 | | deny | 在 Ask 或 Auto 模式下,v0 阻止匹配的命令。 | | ask | 在 Ask 或 Auto 模式下,v0 在运行匹配的命令前与你确认。 |

模式遵循 Bash() 的形式。:* 后缀匹配任何参数。例如:

```json { "allow": ["Bash(pnpm test:*)", "Bash(pnpm lint:*)"], "ask": ["Bash(git push:*)"], "deny": ["Bash(curl:*)"] } ```

规则优先级

对于每个命令,v0 应用这些规则:

1. 它收集匹配的内置、团队和用户模式。 2. 它使用 Bash(...) 内部命令模式的长度(不包括末尾的 :*)比较它们的具体性。 3. 最具体匹配的判断获胜。因此,更具体的 allow 可以优先于更广泛的 ask 或 deny,反之亦然。 4. 如果同等具体性的获胜模式有冲突的判断,v0 请求确认。 5. 对于复合命令,v0 评估其子命令,并按此顺序使用最严格的结果:deny、ask、unmatched、allow。

当相同的精确模式在合并的设置中出现在 allow 和 ask 中时,allow 会移除相同的 ask 条目。匹配的 deny 会被保留;如果它的特异性与其他获胜判断相同,冲突将解决为 ask。

这些规则在 Full 模式下不适用,因为 Full 模式跳过权限评估。

点击“Reset to default”可丢弃你的自定义规则并恢复内置列表。

当前的删除保护

内置设置包括一个 deny 模式,针对以精确 rm -rf 令牌序列开头的命令。在 Ask 和 Auto 模式下,它参与与其他每个模式相同的具体性和平局规则。Full 模式跳过它。

此模式是保护机制,而非完整的沙盒安全边界。等效的标志形式和通过某些 shell 包装器调用的命令可能不会匹配它。其他沙盒和平台控制仍可限制进程可以访问的内容,但终端权限层不应被视为防止所有破坏性命令的保护措施。

要删除文件,请要求 v0 按名称删除它们,以便它可以使用其内置的 Delete 工具。

查看 v0 agent 的其他功能 上一节:安全审查 下一节:设计模式

评论 (0)