[新增] 实现节点强制同步功能，允许通过 API 请求强制同步配置

openflare_agent/internal/agent/runner.go

@@ -23,6 +23,7 @@ type HeartbeatService interface {
 type SyncService interface {
 	SyncOnStartup(ctx context.Context, target *protocol.ActiveConfigMeta) error
 	SyncOnce(ctx context.Context, target *protocol.ActiveConfigMeta) error
+	ForceSyncOnce(ctx context.Context, target *protocol.ActiveConfigMeta) error
 }
 
 type Updater interface {
@@ -294,6 +295,18 @@ func (r *Runner) handleWebSocketMessage(ctx context.Context, message protocol.WS
 			slog.Error("agent ws triggered sync failed", "version", target.Version, "error", err)
 		}
 		return false, nil
+	case protocol.WSMessageTypeForceSyncConfig:
+		var target protocol.ActiveConfigMeta
+		if err := json.Unmarshal(message.Payload, &target); err != nil {
+			slog.Debug("agent ws force sync config decode failed", "error", err)
+			return false, nil
+		}
+		slog.Debug("agent ws force sync config received", "version", target.Version, "checksum", target.Checksum, "trigger_sync", true)
+		if err := r.SyncService.ForceSyncOnce(ctx, &target); err != nil {
+			r.recordSyncError(err)
+			slog.Error("agent ws triggered force sync failed", "version", target.Version, "error", err)
+		}
+		return false, nil
 	case protocol.WSMessageTypePing:
 		slog.Debug("agent ws ping received")
 		return false, conn.SendPong()

openflare_agent/internal/protocol/agent_api.go

@@ -33,11 +33,12 @@ type AgentSettings struct {
 }
 
 const (
-	WSMessageTypeStatus       = "status"
-	WSMessageTypeSettings     = "settings"
-	WSMessageTypeActiveConfig = "active_config"
-	WSMessageTypePing         = "ping"
-	WSMessageTypePong         = "pong"
+	WSMessageTypeStatus          = "status"
+	WSMessageTypeSettings        = "settings"
+	WSMessageTypeActiveConfig    = "active_config"
+	WSMessageTypeForceSyncConfig = "force_sync_config"
+	WSMessageTypePing            = "ping"
+	WSMessageTypePong            = "pong"
 )
 
 type WSMessage struct {

openflare_agent/internal/sync/service.go

@@ -137,6 +137,18 @@ func (s *Service) sync(ctx context.Context, startup bool, target *protocol.Activ
 	return s.applyIfNeeded(ctx, mode, startup, snapshot, currentChecksum, target, config)
 }
 
+func (s *Service) ForceSyncOnce(ctx context.Context, target *protocol.ActiveConfigMeta) error {
+	snapshot, err := s.stateStore.Load()
+	if err != nil {
+		return err
+	}
+	if hasBlockedTarget(snapshot) {
+		clearBlockedTarget(snapshot)
+		_ = s.stateStore.Save(snapshot)
+	}
+	return s.SyncOnce(ctx, target)
+}
+
 func (s *Service) applyIfNeeded(ctx context.Context, mode string, startup bool, snapshot *state.Snapshot, currentChecksum string, target *protocol.ActiveConfigMeta, config *protocol.ActiveConfigResponse) error {
 	if currentChecksum == config.Checksum {
 		slog.Debug("local openresty config already up to date", "mode", mode, "version", config.Version)