chore: M0 项目骨架（年糕历险记）——配置/日志/主循环/数据文件/构建脚本

internal/engine/loop.go

@@ -0,0 +1,55 @@
+// Package engine 主循环：tick 固定 20Hz、render 吃满帧率、两者解耦（架构.md §3.2）。
+package engine
+
+import (
+	"context"
+	"time"
+)
+
+// Ticker 世界逻辑接口：每 tick 调用，dt 为固定 tick 间隔秒数。
+type Ticker interface {
+	Tick(dt float64)
+}
+
+// Renderer 渲染接口：每帧调用；ShouldClose 返回 true 时退出循环。
+type Renderer interface {
+	Render()
+	ShouldClose() bool
+}
+
+// NoopRenderer 无渲染占位（服务器），以约 60Hz 空转。
+type NoopRenderer struct{}
+
+// Render 空实现。
+func (NoopRenderer) Render() { time.Sleep(time.Second / 60) }
+
+// ShouldClose 永不主动关闭。
+func (NoopRenderer) ShouldClose() bool { return false }
+
+// Run 主循环：tick goroutine 固定 20Hz；主 goroutine 渲染；ctx 取消或窗口关闭时退出。
+func Run(ctx context.Context, tick Ticker, render Renderer) {
+	const tickInterval = time.Second / 20
+	stop := make(chan struct{})
+	go func() {
+		t := time.NewTicker(tickInterval)
+		defer t.Stop()
+		for {
+			select {
+			case <-ctx.Done():
+				return
+			case <-stop:
+				return
+			case <-t.C:
+				tick.Tick(tickInterval.Seconds())
+			}
+		}
+	}()
+	defer close(stop)
+
+	for {
+		if ctx.Err() != nil || render.ShouldClose() {
+			return
+		}
+		render.Render()
+	}
+}