用途：在智能体或 CI 会话中操作火山引擎日志服务（TLS，命令行工具为 volclog）时，提供以契约为先、可复用缓存的调用流程，避免猜测命令、字段与输出结构。命令示例保留上游原生 volclog 形式，运行时需改写为 ve volclog ...（要求 ve >= 1.1.11），后续参数不变。
主要能力：区分 tool（已发布的公共 API）、workflow（CLI 自有编排）与 raw（已知 method/path 时使用）三种调用面；通过 tool list/workflow list 发现可调用接口，通过 tool describe/workflow describe 读取权威契约（compact 为发现摘要，full 用于编写嵌套请求）；用 --input '{...}' 提交结构化 JSON；支持 --dry-run 做契约或计划校验；通过 contract_digest 判断缓存契约是否可复用。
使用方式：遵循 Discover -> Describe -> Exec -> Read Result 循环。先解析运行时选择器（活动 profile、显式 --profile、一次性 --secrets-file、context.secrets_file 或进程级环境凭据），必要时运行 volclog configure list 查看本地 profile；然后 tool list/workflow list 发现接口，tool describe/workflow describe 读契约，再 tool exec/workflow exec 执行，或按已知 method/path 使用 volclog raw。结果按 status、summary.deliveryMode、错误对象、data 业务字段的顺序读取。大结果应提供可写的 --output-dir，并以 summary.deliveryMode 判断实际交付方式。
错误处理：按 error.kind 分别应对，如 validation 回到 describe 修正形状或选择器，auth/401 检查选择器、凭据与端点或区域覆盖，403 先核对租户与 profile，usage 重新 list 而非自造别名，unsupported_feature 读 hint 后换用指定调用面，filesystem 修正 --output-dir 或权限，decode 依据 hint 去除错误过滤后重跑，server 仅在契约允许且确属瞬态时退避重试，config 运行 volclog doctor 后排查，unknown 先读 hint。ResultStatus=incomplete 时应缩小时间窗口后重跑。
限制：不得猜测命令名、tool/workflow id、JSON 字段或输出结构；不得把人工快捷命令作为智能体主流程；不得为缩短 shell 路径而把有效请求改写成旗标式快捷形式；不得用 jq/grep 重新发现 schema；--dry-run 只验证契约或计划，不证明业务查询正确；高风险重试需谨慎，结果不明时应按契约指定的 get/describe/list 动作核对，否则停止并上报；区域仅在契约或任务明确要求时覆盖，不得由端点或域名推断；不得读取、打印、导出或持久化 AK/SK 与 token。相关参考文件按需查阅：路由不清读 references/routing.md，多步流程读 references/sops.md，运行时语义与恢复策略不清读 references/best-practices.md。