tt/ttstd-infinite-canvas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(*): 画布助手 - 新增 Live2D 配置导入与模型渲染支持

Browse Source
This commit is contained in:
ddCat
2026-09-21 14:11:29 +08:00
parent 4f9e79f67f
commit 4e0b0a9256
40 changed files with 1668 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
backend/internal/handler/appearance.go
View File

@@ -11,6 +11,7 @@ import (
)
func RegisterAppearanceRoutes(r *gin.RouterGroup, svc *service.Service) {
registerLive2DRoutes(r, svc)
r.GET("/public/appearance", func(c *gin.Context) {
setting, err := svc.Appearance()
if err != nil {

72
backend/internal/handler/appearance_live2d.go Normal file
View File

@@ -0,0 +1,72 @@
package handler
import (
"net/http"
"strings"
"time"
"github.com/gin-gonic/gin"
"infinite-canvas/backend/internal/model"
"infinite-canvas/backend/internal/service"
)
func registerLive2DRoutes(r *gin.RouterGroup, svc *service.Service) {
r.POST("/admin/settings/appearance/live2d", func(c *gin.Context) {
actor, err := currentUser(c, svc)
if err != nil {
failService(c, err)
return
}
if err := svc.RequireAdmin(actor); err != nil {
failService(c, err)
return
}
policy, available := loadRuntimePolicy(c, svc)
if !available || !enforceRateLimit(c, "admin-live2d-upload:"+actor.ID, policy.Request.ResourceUploadPerMinute, time.Minute) {
return
}
c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, service.Live2DMaxBytes+(1<<20))
file, err := c.FormFile("file")
if c.Request.MultipartForm != nil {
defer c.Request.MultipartForm.RemoveAll()
}
if err != nil {
fail(c, http.StatusBadRequest, err)
return
}
result, err := svc.UploadLive2D(actor, file)
if err != nil {
failService(c, err)
return
}
ok(c, gin.H{"model": result})
})
serve := func(admin bool) gin.HandlerFunc {
return func(c *gin.Context) {
var actor *model.User
if admin {
var err error
actor, err = currentUser(c, svc)
if err != nil {
failService(c, err)
return
}
if err := svc.RequireAdmin(actor); err != nil {
failService(c, err)
return
}
}
data, mime, err := svc.Live2DAsset(actor, c.Param("id"), strings.TrimPrefix(c.Param("file"), "/"))
if err != nil {
failService(c, err)
return
}
c.Header("X-Content-Type-Options", "nosniff")
c.Header("Cache-Control", "private, no-cache")
c.Header("Content-Security-Policy", "default-src 'none'")
c.Data(http.StatusOK, mime, data)
}
}
r.GET("/public/appearance/live2d/:id/*file", serve(false))
r.GET("/admin/settings/appearance/live2d/:id/*file", serve(true))
}

15
backend/internal/handler/appearance_routes_test.go
View File

@@ -13,12 +13,15 @@ func TestAppearanceRoutesAreRegistered(t *testing.T) {
router := gin.New()
RegisterAppearanceRoutes(router.Group("/api"), &service.Service{})
wanted := map[string]bool{
"GET /api/public/appearance": false,
"GET /api/public/appearance/assets/:slot": false,
"GET /api/admin/settings/appearance": false,
"PATCH /api/admin/settings/appearance": false,
"DELETE /api/admin/settings/appearance": false,
"POST /api/admin/settings/appearance/assets/:slot": false,
"POST /api/admin/settings/appearance/live2d": false,
"GET /api/admin/settings/appearance/live2d/:id/*file": false,
"GET /api/public/appearance/live2d/:id/*file": false,
"GET /api/public/appearance": false,
"GET /api/public/appearance/assets/:slot": false,
"GET /api/admin/settings/appearance": false,
"PATCH /api/admin/settings/appearance": false,
"DELETE /api/admin/settings/appearance": false,
"POST /api/admin/settings/appearance/assets/:slot": false,
}
for _, route := range router.Routes() {
key := route.Method + " " + route.Path

62
backend/internal/handler/openapi.yaml
View File

@@ -26,6 +26,68 @@ tags:
- name: agent
- name: admin
paths:
/admin/settings/appearance/live2d:
post:
tags: [admin]
summary: 导入管理员 Live2D 模型草稿（不自动启用）
description: ZIP 最大 128 MiB，最多 256 条目；解压累计 384 MiB，单文件最大 128 MiB。只接受一个 Version 3 model3.json 及 ZIP 内 MOC3、PNG、JSON 引用。启用通过 PATCH /admin/settings/appearance 的 canvas 配置完成。
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required: [file]
properties:
file: {type: string, format: binary}
responses:
"200":
description: 成功信封 data.model 包含 resourceId 和服务端确认的 entry
content:
application/json:
schema:
type: object
properties:
code: {type: integer, enum: [0]}
msg: {type: string}
data:
type: object
properties:
model:
type: object
required: [resourceId, entry]
properties:
resourceId: {type: string}
entry: {type: string}
"400": {$ref: "#/components/responses/Error"}
"401": {$ref: "#/components/responses/Error"}
"403": {$ref: "#/components/responses/Error"}
"429": {$ref: "#/components/responses/Error"}
/admin/settings/appearance/live2d/{id}/{file}:
get:
tags: [admin]
summary: 读取模型草稿文件（管理员所有者或当前配置引用）
parameters:
- {in: path, name: id, required: true, schema: {type: string}}
- {in: path, name: file, required: true, description: ZIP 内相对路径，可包含多级目录, schema: {type: string}}
responses:
"200": {description: JSON、PNG 或 MOC3 文件，非 JSON 信封}
"400": {$ref: "#/components/responses/Error"}
"401": {$ref: "#/components/responses/Error"}
"403": {$ref: "#/components/responses/Error"}
/public/appearance/live2d/{id}/{file}:
get:
tags: [meta]
security: []
summary: 读取当前启用的 Live2D 模型文件
parameters:
- {in: path, name: id, required: true, schema: {type: string}}
- {in: path, name: file, required: true, description: ZIP 内相对路径，可包含多级目录, schema: {type: string}}
responses:
"200": {description: JSON、PNG 或 MOC3 文件，非 JSON 信封；停用后拒绝公开读取}
"400": {$ref: "#/components/responses/Error"}
"401": {$ref: "#/components/responses/Error"}
"403": {$ref: "#/components/responses/Error"}
/tools:
get:
tags: [canvas]