feat：完成重构和测试

app/schemas/actions/add.py

@@ -19,5 +19,6 @@ class AddAction(ActionModel):
     )
     sample_data: bool = Field(
         default=False,
-        description="由后端按物料设置，不用填写；true 表示组件使用物料示例数据，不是真实业务数据",
+        description="true 表示组件显示的不是真实业务数据（物料示例数据，或自己编写的数据）。不写时按物料设置；"
+        "只有展示的数据全部来自大屏上已有的组件时写 false，例如更换类型时迁移了原组件的数据",
     )

app/schemas/conversation.py

@@ -14,7 +14,7 @@ class Turn(BaseModel):
     message_id: str
     prompt: str  # 用户原始输入
     outcome: Literal["completed", "waiting_for_input", "failed", "cancelled"]
-    summary: str  # 助手侧摘要，只描述后端生成了什么，不代表前端已执行
+    summary: str  # 助手一侧的完整回复（回答、追问或失败说明），不截断；不代表前端已执行
     created_at: datetime
 
 

app/schemas/input_context.py

@@ -10,5 +10,5 @@ class InputContext(DesignRequest):
     """当前复用请求协议，后续可添加解析结果而不改变前端传参"""
 
     clarification_history: list[JsonObject] = Field(default_factory=list)
-    # 同一会话此前各轮的用户输入与助手摘要，由服务端按 conversation_id 写入，按时间从早到晚排列
+    # 同一会话此前各轮的用户输入与助手回复，由服务端按 conversation_id 读取并按 token 预算裁剪，按时间从早到晚排列
     history: list[JsonObject] = Field(default_factory=list)