feat：对接中心平台，完善接口鉴权

app/resources/material_fields.py

@@ -0,0 +1,50 @@
+"""从物料目录读取组件的可编辑字段，供动作生成理解字段含义，并供校验约束属性结构"""
+
+from app.resources.component import ComponentProvider
+from app.schemas.component_resource import ComponentDefinition, ComponentQuery
+from app.schemas.screen import ScreenNode
+
+# 属性面板的 key 以区域开头，只有这两个区域可以被 update 修改
+EDITABLE_SECTIONS = ("props", "style")
+
+
+def _materials(node_type: str) -> list[ComponentDefinition]:
+    # 多个物料预设可以共用同一前端 type，按 type 取全部预设
+    result = ComponentProvider().query(ComponentQuery(type=node_type))
+    return result.components if result.status == "resolved" else []
+
+
+def _split_key(key: str) -> tuple[str, list[str | int]] | None:
+    # 前端点路径中的纯数字段是数组下标，转换为与 UpdateAction.path 一致的整数
+    section, *path = key.split(".")
+    if section not in EDITABLE_SECTIONS or not path:
+        return None
+    return section, [int(part) if part.isdigit() else part for part in path]
+
+
+def editable_fields(node_type: str) -> list[dict]:
+    """返回组件属性面板中的字段：用户可见名称、区域、路径及可选值，按出现顺序去重"""
+    fields: dict[str, dict] = {}
+    for material in _materials(node_type):
+        for setter in material.setters:
+            parsed = _split_key(setter.key)
+            if parsed is None or setter.key in fields:
+                continue
+            section, path = parsed
+            field = {"label": setter.label, "section": section, "path": path}
+            if options := setter.props.get("options"):
+                field["options"] = options
+            fields[setter.key] = field
+    return list(fields.values())
+
+
+def known_prop_keys(node: ScreenNode) -> set[str] | None:
+    """props 第一层是组件与渲染器的约定，只能是节点已有或物料默认配置中的字段；
+    目录中找不到该类型时约定未知，返回 None 表示不做限制"""
+    materials = _materials(node.type)
+    if not materials:
+        return None
+    keys = set(node.props)
+    for material in materials:
+        keys.update(material.schema_.props)
+    return keys