Files
pika/internal/handler/theme_handler.go
T
dushixiang 1af64eccd9 refactor: simplify theme system to filesystem-only with self-contained portal
主题系统从带数据库/事务/repo 层/远程下载/配置管理/主题市场的重型架构,
彻底简化为纯文件系统操作:

后端:
- 主题数据全部存放在 data/themes/ 目录,不经过数据库
- 删除主题配置功能(managed/raw/redirect schema、配置存取 API、
  ThemeConfiguration model、theme_configurations 表、repo 层)
- 删除远程下载(URL 安装、GitHub Release 更新、SSRF 防护、SHA-256)
- 删除版本范围检查(semver 解析/比较/匹配、pikaVersion 校验)
- 删除主题市场
- ThemeService 不再持有 db,合并为 theme.go + theme_util.go 两个文件
- 主题类型从 models 包移到 service 包(非数据库模型)
- 保留:ZIP 上传解压(含目录穿越防护)、目录扫描列表、启用/删除、
  覆盖安装、默认主题回退、启动恢复、入口 HTML 渲染缓存

前端 portal(官方默认主题):
- 从 47 个碎片文件精简到 15 个,按标准目录组织
- 删除 theme-sdk 包,API 客户端和类型内联回 portal,完全自包含
- 按职责拆分:types.ts / api.ts / constants.ts / lib/utils.ts /
  contexts/ColorMode.tsx / hooks/index.ts / components.tsx / pages/
- 每个页面一个文件,图表和子组件内联,fork 二开只需看一个文件
2026-08-09 22:45:43 +08:00

89 lines
2.4 KiB
Go

package handler
import (
"errors"
"net/http"
"github.com/dushixiang/pika/internal/service"
"github.com/go-orz/orz"
"github.com/labstack/echo/v5"
"go.uber.org/zap"
)
type ThemeHandler struct {
logger *zap.Logger
service *service.ThemeService
}
func NewThemeHandler(logger *zap.Logger, themeService *service.ThemeService) *ThemeHandler {
return &ThemeHandler{logger: logger, service: themeService}
}
func (h *ThemeHandler) List(c *echo.Context) error {
items, err := h.service.List(c.Request().Context())
if err != nil {
return err
}
return orz.Ok(c, items)
}
func (h *ThemeHandler) Upload(c *echo.Context) error {
fileHeader, err := c.FormFile("file")
if err != nil {
return echo.NewHTTPError(http.StatusBadRequest, "请选择主题 ZIP 文件")
}
if fileHeader.Size <= 0 || fileHeader.Size > 64<<20 {
return echo.NewHTTPError(http.StatusBadRequest, "主题 ZIP 为空或超过 64 MiB")
}
file, err := fileHeader.Open()
if err != nil {
return err
}
defer file.Close()
result, err := h.service.Install(c.Request().Context(), file)
if err != nil {
return themeHTTPError(err)
}
return orz.Ok(c, result)
}
func (h *ThemeHandler) Activate(c *echo.Context) error {
if err := h.service.Activate(c.Request().Context(), c.Param("id")); err != nil {
return themeHTTPError(err)
}
return orz.Ok(c, orz.Map{})
}
func (h *ThemeHandler) Delete(c *echo.Context) error {
if err := h.service.Delete(c.Request().Context(), c.Param("id")); err != nil {
return themeHTTPError(err)
}
return orz.Ok(c, orz.Map{})
}
func (h *ThemeHandler) Preview(c *echo.Context) error {
path, contentType, err := h.service.PreviewPath(c.Request().Context(), c.Param("id"))
if err != nil {
return themeHTTPError(err)
}
if contentType != "" {
c.Response().Header().Set("Content-Type", contentType)
}
c.Response().Header().Set("Cache-Control", "private, max-age=300")
c.Response().Header().Set("X-Content-Type-Options", "nosniff")
return serveResolvedStaticFile(c, path, false)
}
func themeHTTPError(err error) error {
switch {
case errors.Is(err, service.ErrThemeNotFound):
return echo.NewHTTPError(http.StatusNotFound, err.Error())
case errors.Is(err, service.ErrThemeExists), errors.Is(err, service.ErrThemeActive):
return echo.NewHTTPError(http.StatusConflict, err.Error())
case errors.Is(err, service.ErrDefaultTheme):
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
default:
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
}
}