search-logs

SKILL.md

查看和搜索 mercury-server 的服务日志,帮助排查错误和了解系统运行状况。当用户的问题涉及日志查看时,直接执行查询,不需要先问用户是否需要帮忙查

使用步骤

  1. 了解日志格式:先用 Read 工具读取 $PROJECT_DIR/docs/db-schema.md 的「日志」章节,了解文件命名和 JSON 格式
  2. 定位日志目录:通过 Bash 执行 echo $LOG_DIR 获取路径
  3. 查看或搜索日志

日志文件

文件 内容
main.log.YYYYMMDD 全量日志(所有级别)
error.log.YYYYMMDD 仅错误级别日志

日期格式示例:20260315(2026年3月15日)

常用命令

# 查看今日错误(最近 50 条)
tail -50 "$LOG_DIR/error.log.$(date +%Y%m%d)"

# 搜索关键词(不区分大小写,取最近 30 条)
grep -i "关键词" "$LOG_DIR/main.log.$(date +%Y%m%d)" | tail -30

# 查看特定模块的日志
grep '"context":"ClaudeAgentService"' "$LOG_DIR/main.log.$(date +%Y%m%d)" | tail -20

# 列出可用的日志文件
ls -la "$LOG_DIR/"

注意事项

  • 务必用 tail/head/grep 限制输出行数,日志文件可能很大,直接 cat 会输出过多内容
  • 每行是一条独立的 JSON,包含 context(模块名)、levelmessagetimestampstack(可选)字段
  • 使用中文总结日志中发现的问题,不要直接输出大段原始日志
Installs
1
First Seen
Apr 21, 2026