Repository navigation
v1.2.0
新增本地安全策略
新增 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