用途 volcengine-tosutil 是面向火山引擎对象存储 TOS 的 tosutil 命令行工具的封装型技能，目标是把“要对 TOS 做什么操作”的需求转换为默认只预览的 tosutil 命令，并在执行时输出结构化 JSON 结果、可复现证据和可诊断建议。它自身不直接调用 TOS HTTP API，而是以本地 CLI 封装层方式工作。
主要能力 输入为目标命令（如 ls/cp/rm/du/setmeta）加最少必要参数（tos:// 地址、本地路径、递归开关），可选公共参数（endpoint/region/credentials/conf）。输出为统一 JSON 协议（ok/code/message/data/ts），包含脱敏后的 preview.shell 命令、执行摘要，失败时给出 advice.code 与 next_actions。
默认行为强调安全：默认只生成命令预览，需显式 --run 才执行；破坏性命令（如 rm）默认不执行，必须显式 --yes（legacy 模式下 --assume-yes）才真正运行；输出默认脱敏，不回显 AK/SK/Token。
适用场景 包括：使用 tosutil 初始化或更新 TOS 配置；创建桶、列举桶/对象、查询对象属性；上传、下载、复制、批量删除对象；计算对象容量、设置对象元数据；分析 Http status [403]、连通性失败、命令参数错误等问题；为 share、set-acl、mount、probe、netdig 等高级命令生成执行方案。
使用方式 需先按操作系统与芯片架构下载 tosutil 并设置执行权限。安装命令如下： Linux：wget https://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/linux/amd64/tosutil，随后 chmod a+x tosutil，sudo mv tosutil /usr/local/bin。 macOS Intel：下载 darwin/amd64/tosutil，步骤同上；macOS Apple Silicon：下载 darwin/arm64/tosutil，步骤同上。 Windows：wget https://m645b3e1bb36e-mrap.mrap.accesspoint.tos-global.volces.com/windows/tosutil -O tosutil.exe。 官方提供 sha256 校验文件，建议下载后做完整性校验。macOS 可能拦截未验证开发者应用，需在系统安全设置中放行。若二进制未加入 PATH，可用绝对路径调用，并通过 --tosutil-binary <absolute-path> 显式指定。 技能脚本调用示例：预览不执行 python3 scripts/main.py ls --cloud-url tos://bucketname；执行 python3 scripts/main.py ls --cloud-url tos://bucketname --preflight --run；高风险删除 python3 scripts/main.py rm --cloud-url tos://bucketname/prefix/ --recursive --run --yes。 安装后校验：依次执行 tosutil version、tosutil config、tosutil ls，确认二进制可执行、配置文件路径及凭证与网络连通性。
标准流程 识别场景（配置、桶操作、对象传输、删除、元数据、容量统计、故障诊断）→ 预检查（version/config/ls，检查 Endpoint 是否为 TOS 协议域名、Region 是否一致、凭证权限）→ 参数归一化 → 生成命令（按本地到 TOS、TOS 到本地、TOS 到 TOS 自动判断上传/下载/复制，目录或前缀用 -r，大文件按阈值分片）→ 输出校验（successfully、Bucket number is:、Succeed count is:、Task id is: 为成功信号；Http status [403] 为权限问题；A connection attempt failed 为网络问题）。
常见命令示例 tosutil config -i <ak> -k <sk> -e <endpoint> -re <region>（永久密钥；STS 加 -t <token>；匿名访问用 -i= -k= -t=）。 tosutil ls、tosutil mb tos://bucketname、tosutil cp /local/file.txt tos://bucketname/file.txt、tosutil rm tos://bucketname/file.txt、tosutil du tos://bucketname、tosutil setmeta tos://bucketname/object.png -meta aaa:bbb#ccc:ddd。
限制与注意事项 config 写入本机配置文件（默认用户目录下 .tosutilconfig），-conf 只能指向已有配置文件，不自动创建。初始化应使用 TOS 协议域名而非 S3 协议域名。rm 默认二次确认，非交互删除用 -f 而非 -y，删除应限定受限前缀。du 在百万级对象下可能耗时较长，建议按目录拆分计算。本技能优先覆盖 config、ls、mb、cp、rm、du、setmeta、stat、help、version；share、set-acl、mount、probe、netdig、curl 等高级命令采用扩展适配模式，参数未确认前需通过 tosutil help <command> 校验，不臆造参数。具体版本、收费或更多平台支持情况暂未提供。