用途:为插件与技能提供会话感知的结构化使用日志,记录单次调用成本与使用事件,用于审计轨迹、用量分析与调试;聚合预算控制需改用 quota-management。
主要能力:自动创建会话(首次操作创建、闲置 1 小时后超时,带唯一会话 ID),以 JSONL 结构化记录时间戳、session_id、service、operation、tokens、success、duration_seconds、metadata 等字段;支持查询最近操作、按天汇总用量与估算成本、获取最近错误。
使用方式:从 leyline.usage_logger 导入 UsageLogger 并指定 service 初始化;操作完成后调用 log_usage(operation=..., tokens=..., success=..., duration=..., metadata={...});用 get_recent_operations(hours=24)、get_usage_summary(days=7)、get_recent_errors(count=10) 查询。集成时在技能 frontmatter 依赖中写 dependencies: [leyline:usage-logging]。日志默认存于 ~/.claude/leyline/usage/{service}.jsonl,可用 tail 与 jq 查看、按日期 grep 查询。各命令可用 --help 验证可用性。
适用场景:需要审计轨迹、跨会话成本追踪、构建用量分析、借助操作历史调试。
限制:无日志需求的简单操作不必使用;聚合预算控制不属于本技能;其他平台支持与收费信息暂未提供。