用途：logs-tool 属于 @blogic-cz/agent-tools，用于读取本地日志文件以及远程（k8s pod）应用日志，适用于排查应用运行问题的场景。
主要能力：可列出可用日志文件、读取指定日志、按 tail 查看末尾若干行、用 --grep 过滤内容。--grep 在本地与远程日志中均为不区分大小写的字面量子串匹配，并非正则表达式。文件路径被限制在已配置的本地或远程日志目录内；日志目录应视为可信来源，读取期间工作负载不得用符号链接替换被检查文件或其上级目录。
使用方式：需以开发依赖形式安装 @blogic-cz/agent-tools，然后运行 bun logs-tool。本地文件无需认证；远程访问使用 k8s-tool。环境为任意字符串（如 local、test），可在 agent-tools.json5 中设置 defaultEnvironment 以省去每次传 --env。示例：bun logs-tool list --env local；bun logs-tool read --env local --file app.log；bun logs-tool read --env test --file app.log --tail 50；bun logs-tool read --env test --file app.log --grep "connection refused"。可用 bun logs-tool 命令查看完整的机器可读命令与参数树，用 --help 查看单个子命令。
输出与错误：默认输出 TOON（节省 token），建议保持默认；仅在需要机器解析结果时加 --format json。失败响应包含 hint、nextCommand、retryable 字段，出错时应检查这些字段。
限制：资料未提供具体版本要求、权限模型、日志格式支持范围及性能指标，暂未提供。