search-logs
SKILL.md
查看和搜索 mercury-server 的服务日志,帮助排查错误和了解系统运行状况。当用户的问题涉及日志查看时,直接执行查询,不需要先问用户是否需要帮忙查。
使用步骤
- 了解日志格式:先用 Read 工具读取
$PROJECT_DIR/docs/db-schema.md的「日志」章节,了解文件命名和 JSON 格式 - 定位日志目录:通过 Bash 执行
echo $LOG_DIR获取路径 - 查看或搜索日志
日志文件
| 文件 | 内容 |
|---|---|
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(模块名)、level、message、timestamp、stack(可选)字段 - 使用中文总结日志中发现的问题,不要直接输出大段原始日志