/debug-log

name: debug-log
description: 查看 Prismer Evolution 插件的调试日志，诊断 hook 运行状态
user-invocable: true

查看 Prismer 插件的结构化调试日志。每条日志包含时间戳、级别、hook 名称和上下文。

查看最近日志

CACHE="${CLAUDE_PLUGIN_DATA:-$(dirname "$0")/../../.cache}"
LOG="$CACHE/prismer-debug.log"
if [ -f "$LOG" ]; then
  echo "=== Prismer Debug Log (last 30 entries) ==="
  tail -30 "$LOG" | while IFS= read -r line; do
    # 格式化 JSON 为可读输出
    echo "$line" | node -e "
      const line = require('fs').readFileSync(0,'utf8').trim();
      try {
        const j = JSON.parse(line);
        const lvl = {debug:'D',info:'I',warn:'W',error:'E'}[j.lvl]||'?';
        const {ts,lvl:_,hook,msg,...ctx} = j;
        const extra = Object.keys(ctx).length ? ' ' + JSON.stringify(ctx) : '';
        console.log(\`[\${ts.slice(11,19)}] \${lvl} [\${hook}] \${msg}\${extra}\`);
      } catch { console.log(line); }
    " 2>/dev/null || echo "$line"
  done
else
  echo "No log file found at: $LOG"
  echo "Logs are created after the first hook runs."
  echo "Set PRISMER_LOG_LEVEL=debug for verbose output."
fi

日志级别

通过环境变量 `PRISMER_LOG_LEVEL` 控制：

• `debug` — 所有操作（dev mode 默认）
• `info` — 关键操作（生产默认）
• `warn` — 仅告警和错误
• `error` — 仅错误

常见问题诊断

| 日志关键词 | 含义 | 解决 | |-----------|------|------| | `sync-pull-failed timeout:true` | 进化网络同步超时 | 检查网络连接或 API 状态 | | `sync-pull-failed error:...` | API 返回错误 | 检查 API Key 是否有效 | | `memory-pull-failed` | 记忆加载失败 | 检查 API Key 权限 | | `evolution-query timeout:true` | 进化查询超时（stuck detection） | 正常降级，不影响工作 | | `cache-save-failed` | Web 缓存保存失败 | 非关键，自动跳过 |