Widget 数据结构（Zod Schema）编写说明

import { z } from "zod";
const WidgetState = z.strictObject({
  title: z.string().describe("卡片标题"),
  message: z.string().describe("展示给用户的提示信息"),
});
export default WidgetState;

{
  "title": "处理结果",
  "message": "您的请求已处理完成"
}

<Card size="sm">
  <Col gap={2}>
    <Title value={title} />
    <Text value={message} />
  </Col>
</Card>

import { z } from "zod";
const OrderItem = z.strictObject({
  id: z.string().describe("商品项标识，同一订单内不重复"),
  name: z.string().describe("商品名称"),
  quantity: z.number().int().min(1).describe("购买数量"),
  price: z.number().min(0).describe("商品单价，单位：元"),
});
const WidgetState = z.strictObject({
  orderNo: z.string().describe("订单编号"),
  status: z.enum(["pending", "completed"]).describe("pending：处理中；completed：已完成"),
  paid: z.boolean().describe("是否已支付"),
  customer: z.strictObject({
    name: z.string().describe("客户姓名"),
  }),
  items: z.array(OrderItem).min(1).describe("订单商品列表"),
  remark: z.string().optional().describe("订单备注，可不提供"),
});
export default WidgetState;

{
  "orderNo": "ORDER-1001",
  "status": "pending",
  "paid": true,
  "customer": {
    "name": "小王"
  },
  "items": [
    {
      "id": "item-1",
      "name": "笔记本",
      "quantity": 2,
      "price": 19.9
    },
    {
      "id": "item-2",
      "name": "签字笔",
      "quantity": 1,
      "price": 5
    }
  ],
  "remark": "请妥善包装"
}

<Card size="md">
  <Col gap={2}>
    <Title value={`订单 ${orderNo}`} />
    <Text value={`客户：${customer.name}`} />
    <Text value={status === "completed" ? "状态：已完成" : "状态：处理中"} />
    <Text value={paid ? "支付：已支付" : "支付：未支付"} />
    {items.map((item) => (
      <Text
        key={item.id}
        value={`${item.name} × ${item.quantity}，单价 ${item.price} 元`}
      />
    ))}
    <Text value={remark ? remark : "无备注"} />
  </Col>
</Card>