用途：通过 b2c CLI 检索和监控 Salesforce B2C Commerce 实例上的日志文件，logs get 命令面向智能体设计，非交互式并支持结构化 JSON 输出。若未全局安装 b2c，可用 npx @salesforce/b2c-cli 代替。
配置与认证：CLI 自动从 SFCC_* 环境变量（含项目 .env）、项目本地或共享 dw.json 及配置插件发现实例和凭据，package.json 只提供非敏感默认值。--server、--client-id、--client-secret、--username、--password 等参数通常无需传递，仅用于覆盖自动检测的结果。可用 b2c setup inspect 查看已解析配置及每个值的来源，加 --json 便于脚本使用，密钥默认隐藏。
主要能力：logs get 支持 --count 限制条数、--since 按时间（如 5m、1h、2d 或 ISO 8601）过滤、--level 按级别（ERROR、FATAL 等）过滤、--search 按文本搜索，并可组合使用，--json 输出结构化结果。logs list 列出日志文件，logs tail 供人工实时跟踪（非智能体用途）。JSON 输出包含 count 和 entries，每条含 file、level、timestamp、message、raw 字段。
日志类型与自定义日志：内置前缀有 error、customerror、warn、debug、info、jobs、api、deprecation、quota。通过自定义 logger 类别写入的日志会生成 custom-<prefix>-... 文件，集成与作业代码常使用此类日志。--filter 对日志类别做前缀匹配而非精确匹配，类别按第二个短横线前内容提取，因此自定义 logger 名仅视为单词字符。可用 --filter custom- 扫描全部自定义日志，或指定完整前缀读取单个文件。内置检索不覆盖自定义日志，排查集成或作业时需显式发现。
子目录与下载：Logs 下的 internal/ 等子目录默认不列出，传入含 / 的路径式 --filter 可递归匹配。下载完整日志可结合 b2c-cli:b2c-webdav。
限制：tail 面向人工交互，不适合智能体；自定义日志文件名与类别匹配规则较特殊，需按上述方式过滤；配置与凭据优先由环境变量和 dw.json 决定，覆盖参数一般不必传。详见 b2c logs --help。