docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// schema v2 的协商、点与边扩展校验;这些纯检查被快照、连接和事务命令复用。
|
||||
package platform
|
||||
|
||||
import (
|
||||
@@ -9,6 +10,7 @@ import (
|
||||
"strings"
|
||||
)
|
||||
|
||||
// canvasSchema 只读取版本字段,无法解码时返回零;不能替代 normalizeCanvas 的完整验证。
|
||||
func canvasSchema(raw json.RawMessage) int {
|
||||
var d struct {
|
||||
Version int `json:"schema_version"`
|
||||
@@ -17,6 +19,7 @@ func canvasSchema(raw json.RawMessage) int {
|
||||
return d.Version
|
||||
}
|
||||
|
||||
// acceptsCanvasV2 逐项解析 Accept 媒体类型,要求明确 version=2,且存在 q 时必须在 (0,1]。
|
||||
func acceptsCanvasV2(r *http.Request) bool {
|
||||
for _, value := range strings.Split(r.Header.Get("Accept"), ",") {
|
||||
typ, params, err := mime.ParseMediaType(strings.TrimSpace(value))
|
||||
@@ -33,11 +36,13 @@ func acceptsCanvasV2(r *http.Request) bool {
|
||||
return false
|
||||
}
|
||||
|
||||
// canvasPoint 要求完整 x/y 与有限百万坐标范围,供贝塞尔控制点和结点偏移使用。
|
||||
func canvasPoint(v any) bool {
|
||||
p, ok := v.(map[string]any)
|
||||
return ok && canvasFields(p, "x", "y") && canvasNumber(p["x"], -1e6, 1e6) && canvasNumber(p["y"], -1e6, 1e6)
|
||||
}
|
||||
|
||||
// validCanvasEdgeData 分别检查外观、动画、执行开关和贝塞尔链;省略分组合法,出现时拒绝未知键。
|
||||
func validCanvasEdgeData(v any) bool {
|
||||
d, ok := v.(map[string]any)
|
||||
if !ok || !canvasFields(d, "appearance", "animation", "path", "execution") {
|
||||
@@ -117,6 +122,7 @@ func validCanvasEdgeData(v any) bool {
|
||||
}
|
||||
}
|
||||
case "execution":
|
||||
// 执行事件是否启用与展示动画独立,协议只允许布尔 enabled。
|
||||
if !canvasFields(m, "enabled") {
|
||||
return false
|
||||
}
|
||||
@@ -126,6 +132,7 @@ func validCanvasEdgeData(v any) bool {
|
||||
}
|
||||
}
|
||||
case "path":
|
||||
// 路径仅支持 bezier-chain,最多 64 个唯一 ID 的 knot,每个 knot 有位置与进/出切线。
|
||||
if !canvasFields(m, "type", "startControl", "endControl", "knots") || m["type"] != "bezier-chain" {
|
||||
return false
|
||||
}
|
||||
@@ -157,6 +164,7 @@ func validCanvasEdgeData(v any) bool {
|
||||
if !canvasChoice(knot["mode"], "corner", "smooth", "symmetric") {
|
||||
return false
|
||||
}
|
||||
// smooth 要求非零切线反向共线;symmetric 进一步要求长度相等,使用相对误差容忍浮点噪声。
|
||||
if knot["mode"] != "corner" {
|
||||
a, b := knot["in"].(map[string]any), knot["out"].(map[string]any)
|
||||
ax, ay, bx, by := a["x"].(float64), a["y"].(float64), b["x"].(float64), b["y"].(float64)
|
||||
|
||||
Reference in New Issue
Block a user