docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]

This commit is contained in:
2026-11-16 17:52:11 +08:00
parent 30829eeb86
commit 1090591503
123 changed files with 1279 additions and 3 deletions
+8
View File
@@ -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)