You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储工具指南TOS 命令行工具工具命令（Utilities）
复制全文
下载 pdf
我的收藏
TOS 命令行工具
工具命令（Utilities）
复制全文
下载 pdf
我的收藏
工具命令（Utilities）
工具命令提供能力探测、通用 API 调用、配置管理、Shell 补全、本地服务、Skill 管理与自检诊断等辅助能力。本章节介绍如何使用工具命令组。​
命令概览​
​
命令​
说明​
示例链接​
capabilities​
查看工具的命令能力列表，支持按层级、分组或关键词过滤输出。​
capabilities​
config​
用于初始化或管理工具配置，支持多 profile 场景。​
config​
api ​
用于直接透传请求至 TOS 服务端 API，适合调试或执行工具未封装的操作。​
api（原始 API 透传）​
completion​
用于为当前 Shell 生成命令补全脚本。​
completion​
doctor​
用于诊断工具配置、凭证、网络连通性等运行环境问题。​
doctor​
serve（MCP）​
用于启动 MCP 服务，支持 stdio 与 SSE 两种传输模式。​
serve（MCP）​
skill​
用于列举或导出工具的 Skill 定义文件，供 AI-Agent 集成使用。​
skill​
​
工具命令​
capabilities​
通过 capabilities 命令查看工具的命令能力列表，支持按层级、分组或关键词过滤输出。​
  • 支持通过 --view 参数指定输出视图，可选值为： groups（默认）、text、compact、full。​
  • 支持通过 --group、--search、--layer 参数过滤输出内容。​
代码示例如下：​
​
ve-tos-cli capabilities --view groups​
ve-tos-cli capabilities --view compact --output json​
ve-tos-cli capabilities --view full --search lifecycle --output json​
ve-tos-cli capabilities --group low_level​
​
config​
通过 config 命令初始化或管理工具配置，支持多 profile 场景。​
  • 配置文件默认路径为 ~/.tos/config.toml，可通过 --config-path 或环境变量 TOS_CONFIG_PATH 覆盖；TOS 专属配置写入 profile.ve-tos 配置文件。​
  • 支持调整的字段如下：​
  • checkpoint_dir、batch_report_dir、batch_report_format、progress_enabled、max_retry_count、requesttimeout、connecttimeout、maxconnections。​
代码示例如下：​
​
ve-tos-cli config init --profile staging​
ve-tos-cli config show --output json​
ve-tos-cli config set region cn-beijing​
ve-tos-cli config set endpoint https://tos-cn-beijing.volces.com​
ve-tos-cli config set control_endpoint https://tos-control-cn-beijing.volces.com # 控制面 endpoint​
ve-tos-cli config set account_id 2100000001​
ve-tos-cli config set max_retry_count 3​
ve-tos-cli config set staging.control_endpoint https://tos-control-cn-shanghai.volces.com​
​
api（原始 API 透传）​
通过 api 命令直接透传请求至 TOS 服务端 API，适合调试或执行工具未封装的操作。​
  • --request 参数支持内联 JSON 或 file://path 文件引用，可配置字段如下：​
  • method、endpoint_rule（或 endpoint_kind）、bucket、key、path、query、headers、body。​
  • 非幂等操作须附加 --force 方可执行。​
代码示例如下：​
​
ve-tos-cli api object list --describe​
ve-tos-cli api bucket lifecycle --dry-run --request '{"method":"GET","endpoint_rule":"bucket","bucket":"mybucket","query":{"lifecycle":""}}'​
ve-tos-cli api object delete --force --request '{"method":"DELETE","endpoint_rule":"object","bucket":"mybucket","key":"old.txt"}'​
​
completion​
通过 completion 命令为当前 Shell 生成命令补全脚本。​
代码示例如下：​
​
ve-tos-cli completion bash --output json | jq -r '.data.script' > ~/.ve-tos-completion.bash​
echo 'source ~/.ve-tos-completion.bash' >> ~/.bashrc​
ve-tos-cli completion zsh --output json | jq -r '.data.script' > ~/.zfunc/_ve-tos​
ve-tos-cli completion fish --output json | jq -r '.data.script' > ~/.config/fish/completions/ve-tos.fish​
ve-tos-cli completion powershell --output json | jq -r '.data.script' >> $PROFILE​
​
doctor​
通过 doctor 命令诊断工具配置、凭证、网络连通性等运行环境问题。​
  • 支持的检查项：auth、config、registry、permissions、region、network、version、mcp、principles、completion。​
  • 可通过 --live-network 和 --network-timeout-ms 控制实网探测行为。​
代码示例如下：​
​
ve-tos-cli doctor --output json​
ve-tos-cli doctor --check auth​
ve-tos-cli doctor --check permissions --bucket mybucket​
ve-tos-cli doctor --check principles​
​
serve（MCP）​
通过 serve 命令启动 MCP 服务，支持 stdio 与 SSE 两种传输模式。​
代码示例如下：​
​
ve-tos-cli serve --mcp --dry-run --output json​
ve-tos-cli serve --mcp​
ve-tos-cli serve --mcp --transport sse --port 9090​
​
skill​
通过 skill 命令列举或导出工具的 Skill 定义文件，供 AI-Agent 集成使用。​
  • 导出结果写入 dir/SKILL.md 及 dir/{domain}/{skill_name}/SKILL.md 文件。​
  • 目标路径已存在时，拒绝覆盖。​
代码示例如下：​
​
ve-tos-cli skill list --output json​
ve-tos-cli skill export --dry-run --dir ./ve-tos-skills --output json​
ve-tos-cli skill export --name "ve-tos bucket create" --dir ./ve-tos-skills​
ve-tos-cli skill export --language zh --dir ./ve-tos-skills-zh​
​
最近更新时间：2026.07.06 18:58:31
这个页面对您有帮助吗？
有用
有用
无用
无用