feat(wiki): 二十四节气详情抓取百度百科并图文展示
Publish Mini Program Dev Version / publish (push) Successful in 1m12s
Build and Publish Server / build (push) Successful in 8m24s

数据源:百度百科开放接口 BaikeLemmaCardApi(无反爬,返回结构化 JSON)
与「历史上的今天」(维基)完全解耦,维基代码原样保留可随时恢复:

服务端:
- WikiEntry 增加 image(配图)和 extra(结构化字段 JSON)字段
- 新建 BaikeTermSyncLog 独立日志表(不污染维基 WikiSyncLog)
- 新建 BaikeTermSyncService 独立同步服务(24 节气,间隔 1.2s)
- 启动时缺详情自动补齐,之后按配置间隔定时增量刷新
- 管理 API:GET/POST /admin/api/wiki/term-sync*

管理后台:
- 百科条目 Tab 顶部加节气同步卡片(X/24 + 状态 + 同步按钮)
- 条目编辑器加配图 URL(含预览)和节气扩展字段编辑

小程序:
- 百科页展开详情图文展示:配图 + 简介 + 物候/习俗/养生等分块

本地验证:24/24 节气抓取成功,image/extra 全部填充,维基数据不受影响
This commit is contained in:
gouki
2026-08-13 00:31:43 +00:00
parent 0ce1a1ef97
commit fec383f257
12 changed files with 759 additions and 6 deletions
+40
View File
@@ -5,6 +5,7 @@ import (
"strconv"
"github.com/gin-gonic/gin"
"github.com/gouki/lunar-server/internal/config"
"github.com/gouki/lunar-server/internal/model"
"github.com/gouki/lunar-server/internal/service"
)
@@ -12,6 +13,9 @@ import (
// WikiSync 维基百科同步服务实例(main 中注入)
var WikiSync *service.WikiSyncService
// BaikeTermSync 节气详情同步服务实例(main 中注入,独立于维基同步)
var BaikeTermSync *service.BaikeTermSyncService
// ===== 公开接口(小程序) =====
// GetWikiEntries 百科条目列表(小程序百科页)
@@ -159,3 +163,39 @@ func AdminWikiSyncTrigger(c *gin.Context) {
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "同步任务已启动"})
}
// ===== 节气详情同步(百度百科,独立于维基) =====
// AdminTermSyncStatus 节气详情同步状态(X/24 已含详情 + 最近一次同步日志)
func AdminTermSyncStatus(c *gin.Context) {
db := config.GetDB()
var detailed int64
db.Model(&model.WikiEntry{}).Where("category = ? AND image != ''", "term").Count(&detailed)
var lastLog model.BaikeTermSyncLog
db.Order("started_at DESC").First(&lastLog)
c.JSON(http.StatusOK, gin.H{
"code": 0,
"msg": "success",
"data": gin.H{
"running": BaikeTermSync != nil && BaikeTermSync.IsRunning(),
"detailedTerms": detailed,
"totalTerms": 24,
"lastSync": lastLog,
},
})
}
// AdminTermSyncTrigger 手动触发节气详情同步(异步执行)
func AdminTermSyncTrigger(c *gin.Context) {
if BaikeTermSync == nil {
c.JSON(http.StatusServiceUnavailable, gin.H{"code": 503, "msg": "节气同步服务未初始化"})
return
}
if !BaikeTermSync.TriggerSync("admin", true) {
c.JSON(http.StatusConflict, gin.H{"code": 409, "msg": "已有节气同步任务正在执行,请稍后再试"})
return
}
c.JSON(http.StatusOK, gin.H{"code": 0, "msg": "节气同步任务已启动"})
}