feat: 添加日志文件输出功能和心跳故障排查工具

- 新增日志文件输出功能，支持配置日志文件路径和级别
- 添加心跳故障排查脚本 check-heartbeat.sh
- 支持通过环境变量 LOG_FILE 设置日志文件路径
- 日志自动创建目录，支持相对路径和绝对路径
- 优化日志初始化逻辑，支持直接写入文件
- 改进配置加载，支持日志配置项
- 完善文档，添加故障排查章节和日志功能说明
- 更新版本号至 v1.1.0

cmd/agent/main.go

@@ -5,6 +5,7 @@ import (
 	"fmt"
 	"os"
 	"os/signal"
+	"path/filepath"
 	"syscall"
 	"time"
 
@@ -14,8 +15,11 @@ import (
 	"linkmaster-node/internal/server"
 
 	"go.uber.org/zap"
+	"go.uber.org/zap/zapcore"
 )
 
+var version = "1.1.0" // 编译时通过 -ldflags "-X main.version=xxx" 设置
+
 func main() {
 	// 加载配置
 	cfg, err := config.Load()
@@ -32,7 +36,7 @@ func main() {
 	}
 	defer logger.Sync()
 
-	logger.Info("节点服务启动", zap.String("version", "1.0.0"))
+	logger.Info("节点服务启动", zap.String("version", version))
 
 	// 初始化错误恢复
 	recovery.Init()
@@ -80,9 +84,69 @@ func main() {
 }
 
 func initLogger(cfg *config.Config) (*zap.Logger, error) {
-	if cfg.Debug {
-		return zap.NewDevelopment()
+	// 确定日志级别
+	var level zapcore.Level
+	logLevel := cfg.Log.Level
+	if logLevel == "" {
+		if cfg.Debug {
+			logLevel = "debug"
+		} else {
+			logLevel = "info"
+		}
 	}
-	return zap.NewProduction()
-}
 
+	switch logLevel {
+	case "debug":
+		level = zapcore.DebugLevel
+	case "info":
+		level = zapcore.InfoLevel
+	case "warn":
+		level = zapcore.WarnLevel
+	case "error":
+		level = zapcore.ErrorLevel
+	default:
+		level = zapcore.InfoLevel
+	}
+
+	// 编码器配置
+	encoderConfig := zap.NewProductionEncoderConfig()
+	if cfg.Debug {
+		encoderConfig = zap.NewDevelopmentEncoderConfig()
+	}
+	encoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder
+	encoderConfig.EncodeLevel = zapcore.CapitalLevelEncoder
+
+	// 确定输出目标
+	var writeSyncer zapcore.WriteSyncer
+	if cfg.Log.File != "" {
+		// 确保日志目录存在
+		logDir := filepath.Dir(cfg.Log.File)
+		if logDir != "." && logDir != "" {
+			if err := os.MkdirAll(logDir, 0755); err != nil {
+				return nil, fmt.Errorf("创建日志目录失败: %w", err)
+			}
+		}
+
+		// 打开日志文件（追加模式）
+		logFile, err := os.OpenFile(cfg.Log.File, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
+		if err != nil {
+			return nil, fmt.Errorf("打开日志文件失败: %w", err)
+		}
+		writeSyncer = zapcore.AddSync(logFile)
+	} else {
+		// 输出到标准错误（兼容原有行为）
+		writeSyncer = zapcore.AddSync(os.Stderr)
+	}
+
+	// 创建核心
+	core := zapcore.NewCore(
+		zapcore.NewJSONEncoder(encoderConfig),
+		writeSyncer,
+		level,
+	)
+
+	// 创建 logger
+	logger := zap.New(core, zap.AddCaller(), zap.AddStacktrace(zapcore.ErrorLevel))
+
+	return logger, nil
+}