149 lines
4.9 KiB
Go
149 lines
4.9 KiB
Go
// 素材内容 schema v1 的纯校验与规范化,不负责网络抓图或数据库存储。
|
|
package platform
|
|
|
|
import (
|
|
"bytes"
|
|
"encoding/json"
|
|
"io"
|
|
"net/url"
|
|
"regexp"
|
|
)
|
|
|
|
// Paragraph 与 Section 的 ID 在同一文章内共享唯一命名空间,用于稳定引用内容块。
|
|
type Paragraph struct {
|
|
ID string `json:"id"`
|
|
Text string `json:"text"`
|
|
Description string `json:"description,omitempty"`
|
|
}
|
|
|
|
// Section 聚合标题、描述和有序段落;数量及总段落预算由 validArticle 检查。
|
|
type Section struct {
|
|
ID string `json:"id"`
|
|
Title string `json:"title"`
|
|
Description string `json:"description,omitempty"`
|
|
Paragraphs []Paragraph `json:"paragraphs"`
|
|
}
|
|
|
|
// Article 是有序章节容器,可为空文章,但必须有非 nil 的 Article 对象。
|
|
type Article struct {
|
|
Sections []Section `json:"sections"`
|
|
}
|
|
|
|
// Image 仅保存 HTTPS 引用及展示信息,尺寸零值表示未提供,不在这里读取远程资源。
|
|
type Image struct {
|
|
URL string `json:"url"`
|
|
Alt string `json:"alt,omitempty"`
|
|
Width int `json:"width,omitempty"`
|
|
Height int `json:"height,omitempty"`
|
|
}
|
|
|
|
// CardPart 是带 Kind 的互斥联合,一次只能提供对应的 text/article/image 内容。
|
|
type CardPart struct {
|
|
Kind string `json:"kind"`
|
|
Text *string `json:"text,omitempty"`
|
|
Article *Article `json:"article,omitempty"`
|
|
Image *Image `json:"image,omitempty"`
|
|
}
|
|
|
|
// Content 按素材种类使用互斥字段;board 只存 schema 标记,画布节点通过专用协议管理。
|
|
type Content struct {
|
|
SchemaVersion int `json:"schema_version"`
|
|
Text *string `json:"text,omitempty"`
|
|
Article *Article `json:"article,omitempty"`
|
|
Image *Image `json:"image,omitempty"`
|
|
Parts []CardPart `json:"parts,omitempty"`
|
|
}
|
|
|
|
var blockID = regexp.MustCompile(`^[A-Za-z0-9_-]{1,64}$`)
|
|
|
|
// validArticle 限制章节、段落和文本字节数,并用一个 seen 集合拒绝章节/段落间任何重复 ID。
|
|
func validArticle(article *Article) bool {
|
|
if article == nil || len(article.Sections) > 200 {
|
|
return false
|
|
}
|
|
seen := map[string]bool{}
|
|
total := 0
|
|
for _, section := range article.Sections {
|
|
if !blockID.MatchString(section.ID) || seen[section.ID] || len(section.Title) > 300 || len(section.Description) > 10000 {
|
|
return false
|
|
}
|
|
seen[section.ID] = true
|
|
total += len(section.Paragraphs)
|
|
if total > 2000 {
|
|
return false
|
|
}
|
|
for _, paragraph := range section.Paragraphs {
|
|
if !blockID.MatchString(paragraph.ID) || seen[paragraph.ID] || len(paragraph.Text) > 100000 || len(paragraph.Description) > 10000 {
|
|
return false
|
|
}
|
|
seen[paragraph.ID] = true
|
|
}
|
|
}
|
|
return true
|
|
}
|
|
|
|
// validImage 校验 URL、替代文本及尺寸范围;拒绝用户名密码和 fragment,不执行资源可达性检查。
|
|
func validImage(image *Image) bool {
|
|
if image == nil || len(image.URL) > 2048 || len(image.Alt) > 2000 || image.Width < 0 || image.Width > 100000 || image.Height < 0 || image.Height > 100000 {
|
|
return false
|
|
}
|
|
u, err := url.Parse(image.URL)
|
|
return err == nil && u.Scheme == "https" && u.Hostname() != "" && u.User == nil && u.Fragment == ""
|
|
}
|
|
|
|
// validPart 按判别字段检查唯一有效分支,额外的异类内容即使本身合法也会被拒绝。
|
|
func validPart(part CardPart) bool {
|
|
switch part.Kind {
|
|
case "text":
|
|
return part.Text != nil && len(*part.Text) <= 100000 && part.Article == nil && part.Image == nil
|
|
case "article":
|
|
return part.Text == nil && part.Image == nil && validArticle(part.Article)
|
|
case "image":
|
|
return part.Text == nil && part.Article == nil && validImage(part.Image)
|
|
default:
|
|
return false
|
|
}
|
|
}
|
|
|
|
// normalizeContent 严格解码单个对象,将缺省版本补为一,并重编码为统一存储形式。
|
|
func normalizeContent(kind string, raw json.RawMessage) (json.RawMessage, bool) {
|
|
if raw = bytes.TrimSpace(raw); len(raw) == 0 || raw[0] != '{' {
|
|
return nil, false
|
|
}
|
|
var content Content
|
|
d := json.NewDecoder(bytes.NewReader(raw))
|
|
d.DisallowUnknownFields()
|
|
if d.Decode(&content) != nil || d.Decode(new(any)) != io.EOF {
|
|
return nil, false
|
|
}
|
|
if content.SchemaVersion == 0 {
|
|
content.SchemaVersion = 1
|
|
}
|
|
if content.SchemaVersion != 1 {
|
|
return nil, false
|
|
}
|
|
switch kind {
|
|
case "text", "article", "image":
|
|
if len(content.Parts) > 0 || !validPart(CardPart{Kind: kind, Text: content.Text, Article: content.Article, Image: content.Image}) {
|
|
return nil, false
|
|
}
|
|
case "board":
|
|
if content.Text != nil || content.Article != nil || content.Image != nil || len(content.Parts) > 0 {
|
|
return nil, false
|
|
}
|
|
case "card":
|
|
if content.Text != nil || content.Article != nil || content.Image != nil || len(content.Parts) < 1 || len(content.Parts) > 20 {
|
|
return nil, false
|
|
}
|
|
for _, part := range content.Parts {
|
|
if !validPart(part) {
|
|
return nil, false
|
|
}
|
|
}
|
|
default:
|
|
return nil, false
|
|
}
|
|
out, err := json.Marshal(content)
|
|
return out, err == nil
|
|
}
|