Skip to content

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 12 Oct 13:32
· 15 commits to master since this release

新增本地安全策略

新增 ve configure safety-policy,可在发送 OpenAPI 请求前拒绝指定操作,或要求人工确认。安全策略默认关闭,启用后覆盖普通 API 调用、--force 调用和 MCP call_api。

  • 规则采用 service:action 格式,支持 * 通配符、不区分大小写,按第一条匹配规则执行;未匹配的操作默认允许。服务别名、带版本号和下划线的命令共享规则。
  • 支持 deny(本地拒绝)、confirm(执行前确认)和 allow(显式允许)。add 命令只接受 deny / confirm;allow 可通过 JSON 文件或环境变量配置。
  • 提供启用、停用、查看、添加、移除和列出规则的命令。策略独立保存于 ~/.volcengine/safety-policy.json,支持环境变量覆盖。
  • 交互式终端命中 confirm 时提示确认;Agent / MCP 客户端应先向用户说明操作并取得批准,再按原参数重试。确认参数仅跳过 confirm,不能绕过 deny。
  • 校验规则格式;策略文件损坏或环境变量格式非法时返回错误,不发送 API 请求。保存策略失败时保留原文件。

配置示例:

ve configure safety-policy enable
ve configure safety-policy add --pattern '*:Delete*' --action deny
ve configure safety-policy add --pattern '*:Update*' --action confirm
ve configure safety-policy list

安全策略是客户端防护,与火山引擎 IAM 互补;ve arkcli、ve tosutil 等代理 CLI 不在拦截范围内。详见安全策略配置。

MCP 新增文档检索工具

ve mcp 的工具由 4 个扩展为 6 个,新增两项无需云凭证的公开文档能力:

  • search_docs:搜索火山引擎公开文档,可按服务代码过滤,返回标题、URL 和文本摘要。
  • fetch_docs:获取文档正文,支持按 Unicode 字符偏移分页读取。

call_api 每次调用都会重新加载本地安全策略,并在解析云凭证和发送请求前检查规则。获批重试时可传入 yes: true,该参数不能绕过拒绝规则。详见 MCP 使用文档。

升级

ve upgrade --version 1.2.0

或通过 npm:

npm install -g @volcengine/cli@1.2.0

完整变更:v1.1.11...v1.2.0