feat：新增物料

app/schemas/actions/add.py

@@ -16,7 +16,7 @@ class AddAction(ActionModel):
         description="新组件。id、type、layout 必填，其余只写需要覆盖物料默认配置的字段；"
         "后端按 type 找到物料，用默认配置补全：对象逐层覆盖，数组整体替换，null 明确覆盖。"
         "id 不能与当前大屏上的组件重复（包括之前提交里新增的），先 delete 的 ID 可以再用；type 用 list_components 返回的 type。"
-        '任何字段值都可以写成 {"$query": "SELECT ..."}，后端替换成上传数据的查询结果（对象数组，键是结果的列名）'
+        '任何字段值都可以写成 {"$query": "SELECT ..."}，后端替换成上传数据的查询结果：写入单个值的字段时结果要一行一列，取那个值；写入数字、文字数组的字段时结果要只有一列；其余是对象数组，键是结果的列名'
     )
     sample_data: bool = Field(
         default=False,

app/schemas/actions/update.py

@@ -23,7 +23,7 @@ class UpdateAction(BaseAction):
     )
     value: JsonValue = Field(
         description="替换该字段的值，必须符合字段定义的类型和取值；"
-        '可以写成 {"$query": "SELECT ..."}，后端替换成上传数据的查询结果（对象数组，键是结果的列名）'
+        '可以写成 {"$query": "SELECT ..."}，后端替换成上传数据的查询结果：写入单个值的字段时结果要一行一列，取那个值；写入数字、文字数组的字段时结果要只有一列；其余是对象数组，键是结果的列名'
     )
 
     @model_validator(mode="after")

app/schemas/actions/update_canvas.py

@@ -15,5 +15,6 @@ class UpdateCanvasAction(ActionModel):
     type: Literal["update_canvas"] = "update_canvas"
     properties: dict[NonBlankString, JsonValue] = Field(
         min_length=1,
-        description="要替换的 canvas 顶层字段及最终值，如 width、height、backgroundColor；未提供的字段保持不变。改变画布尺寸不会自动缩放或移动组件",
+        description="要替换的 canvas 顶层字段及最终值，如 width、height、theme（light 亮色 / dark 深色）、backgroundColor；未提供的字段保持不变。"
+        "改 theme 会让组件里跟随主题的颜色一起变；backgroundColor 写 null 表示用主题的背景色。改变画布尺寸不会自动缩放或移动组件",
     )