工具命令提供能力探测、通用 API 调用、配置管理、Shell 补全、本地服务、Skill 管理与自检诊断等辅助能力。本章节介绍如何使用工具命令组。 ## 命令概览 |命令 |说明 | |---|---| |[capabilities](https://docs.volcengine.com/docs/88503/2644286?lang=zh#puW5JKO2) |查看 ve\-adrive\-cli 提供的能力集合。 | |[config](https://docs.volcengine.com/docs/88503/2644286?lang=zh#wTLoDyMa) |初始化、查看和修改配置。 | |[api](https://docs.volcengine.com/docs/88503/2644286?lang=zh#Tbm457cD) |查看 ADrive API 元数据。 | |[completion](https://docs.volcengine.com/docs/88503/2644286?lang=zh#8agd0oqt) |生成 Shell 自动补全脚本。 | |[doctor](https://docs.volcengine.com/docs/88503/2644286?lang=zh#QL8BxEnT) |检查运行环境和认证状态。 | |[serve](https://docs.volcengine.com/docs/88503/2644286?lang=zh#qrWbxnoZ) |启动 MCP 服务。 | |[skill](https://docs.volcengine.com/docs/88503/2644286?lang=zh#jWnIl3OY) |列出或导出 ADrive skill 定义。 | ## 工具命令 ### capabilities capabilities 用于查看 CLI 的能力分组、命令清单和详细描述，便于快速了解当前可用能力。常用参数如下所示： |**参数** |**说明** | |---|---| |\-\-view |指定视图类型，可选值为 `groups`、`text`、`compact `和 `full`。 | |\-\-group |按能力分组过滤结果。 | |\-\-search |按关键字搜索能力项。 | |\-\-layer |按层级过滤展示结果。 | |\-\-output json |以 JSON 格式输出结果。 | 代码示例如下： ```Bash ve-adrive-cli capabilities --view groups ve-adrive-cli capabilities --view compact --output json ve-adrive-cli capabilities --view full --search cp --output json ``` ### config config 用于初始化、查看和更新本地配置。配置文件路径为 `~/.tos/config.toml`。您可以通过 `--config-path` 或 `TOS_CONFIG_PATH` 覆盖默认路径。 ADrive 专属配置写入 `[profile.adrive]`。共享 region、endpoint 和凭证字段会被忽略。代码示例如下： ```Bash ve-adrive-cli config init ve-adrive-cli config show --output json ve-adrive-cli config set region cn-beijing ve-adrive-cli config set endpoint https://ids-cn-beijing.volces.com ``` ### api（API 元数据） api 用于查看 ADrive API 元数据和 `dry-run` 规划。常用参数如下所示： |**参数** |**说明** | |---|---| | |指定 API 所属分组。 | | |指定 API 动作。 | |\-\-describe |输出 API 元数据描述。 | 代码示例如下： ```Bash ve-adrive-cli api --describe ``` ### completion completion 用于为不同 Shell 生成自动补全脚本。代码示例如下： ```Bash ve-adrive-cli completion bash --output json | jq -r '.data.script' > ~/.ve-adrive-completion.bash echo 'source ~/.ve-adrive-completion.bash' >> ~/.bashrc ve-adrive-cli completion zsh --output json | jq -r '.data.script' > ~/.zfunc/_ve-adrive ve-adrive-cli completion fish --output json | jq -r '.data.script' > ~/.config/fish/completions/ve-adrive.fish ve-adrive-cli completion powershell --output json | jq -r '.data.script' >> $PROFILE ``` ### doctor doctor 用于检查 CLI 运行环境和关键依赖状态，适合排查认证或环境异常。代码示例如下： ```Bash ve-adrive-cli doctor --output json ve-adrive-cli doctor --check auth ``` ### serve serve 用于启动 MCP 服务，可用于本地调试或服务接入。代码示例如下： ```Bash ve-adrive-cli serve --mcp --dry-run --output json ve-adrive-cli serve --mcp ve-adrive-cli serve --mcp --transport sse --port 9091 ``` ### skill skill 用于查看和导出 ADrive skill 定义。导出结果采用 ADrive skill v1 JSON 形态，写入 `dir/{domain}/{skill_name}.json`。代码示例如下： ```Bash ve-adrive-cli skill list --output json ve-adrive-cli skill export --dry-run --dir ./adrive-skills --output json ve-adrive-cli skill export --name "ve-adrive ls" --dir ./adrive-skills ```

智能网盘服务