commerce://catalog/categories     # 商品分类
commerce://store/info             # 店铺信息
file:///path/to/config.json       # 本地文件
https://api.example.com/data      # 远程数据

{
  "uriTemplate": "commerce://products/{sku}",
  "name": "商品详情",
  "description": "按SKU获取指定商品的详细信息",
  "mimeType": "application/json"
}

commerce://products/{sku}              # 单个商品
commerce://orders/{orderId}/items      # 订单明细
commerce://categories/{categoryId}     # 分类详情
commerce://inventory/{sku}/{warehouse} # 指定仓库的库存

{
  "method": "resources/read",
  "params": {
    "uri": "commerce://products/SHOE-001"
  }
}

{
  "uri": "commerce://catalog/categories",
  "name": "商品分类",
  "description": "完整的商品分类层级结构",
  "mimeType": "application/json",
  "annotations": {
    "audience": ["user", "assistant"],
    "priority": 0.8,
    "lastModified": "2026-04-10T08:00:00Z"
  }
}

// Client → Server: 订阅资源
{
  "method": "resources/subscribe",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

// Server → Client: 资源内容变化通知
{
  "method": "notifications/resources/updated",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

{
  "method": "resources/unsubscribe",
  "params": { "uri": "commerce://inventory/SHOE-001" }
}

{ "method": "notifications/resources/list_changed" }

// 静态资源
server.resource(
  "commerce://catalog/categories",
  "商品分类",
  "application/json",
  async () => {
    const categories = await db.categories.getAll();
    return JSON.stringify(categories, null, 2);
  }
);

// 动态资源（URI模板）
server.resource(
  "commerce://products/{sku}",
  "商品详情",
  "application/json",
  async (uri) => {
    const sku = uri.pathname.split("/").pop();
    const product = await db.products.findBySku(sku);
    if (!product) throw new Error(`商品 ${sku} 不存在`);
    return JSON.stringify(product, null, 2);
  }
);

{
  "name": "product_comparison",
  "description": "对比两个商品的优劣",
  "arguments": [
    { "name": "product1", "description": "第一个商品SKU", "required": true },
    { "name": "product2", "description": "第二个商品SKU", "required": true },
    { "name": "focus", "description": "关注维度（价格/性能/评价）", "required": false }
  ]
}

// Client → Server
{
  "method": "prompts/get",
  "params": {
    "name": "product_comparison",
    "arguments": {
      "product1": "SHOE-001",
      "product2": "SHOE-002",
      "focus": "性价比"
    }
  }
}

// Server → Client
{
  "result": {
    "messages": [
      {
        "role": "user",
        "content": {
          "type": "text",
          "text": "请从性价比角度对比以下商品：\n\n商品1: Nike Air Max (SHOE-001) - 899元\n商品2: Adidas Ultra Boost (SHOE-002) - 1299元\n\n分析各自优劣并给出购买建议。"
        }
      }
    ]
  }
}

// 商品对比
server.prompt(
  "product_comparison",
  "对比两个商品的优劣",
  [
    { name: "product1", description: "第一个商品SKU", required: true },
    { name: "product2", description: "第二个商品SKU", required: true }
  ],
  async ({ product1, product2 }) => {
    const p1 = await db.products.findBySku(product1);
    const p2 = await db.products.findBySku(product2);
    return {
      messages: [{
        role: "user",
        content: {
          type: "text",
          text: `请对比以下两个商品：\n\n商品1: ${JSON.stringify(p1)}\n\n商品2: ${JSON.stringify(p2)}\n\n从价格、功能、评价三个维度分析各自优劣。`
        }
      }]
    };
  }
);

// 订单摘要
server.prompt(
  "order_summary",
  "生成用户订单的摘要报告",
  [
    { name: "userId", description: "用户ID", required: true },
    { name: "period", description: "时间范围（如 last_month）", required: false }
  ],
  async ({ userId, period = "last_month" }) => {
    const orders = await db.orders.getByUser(userId, period);
    return {
      messages: [{
        role: "user",
        content: {
          type: "text",
          text: `以下是用户最近的订单数据：\n\n${JSON.stringify(orders, null, 2)}\n\n请生成一份简洁的消费摘要，包括总消费、常购品类、消费趋势。`
        }
      }]
    };
  }
);

server.prompt(
  "customer_service",
  "启动客服助手模式",
  [],
  async () => {
    const policies = await db.policies.getAll();
    return {
      messages: [
        {
          role: "assistant",
          content: {
            type: "text",
            text: `你是一个专业的客服助手。以下是店铺政策：\n\n${JSON.stringify(policies)}\n\n请始终基于政策回答用户问题。`
          }
        }
      ]
    };
  }
);

server.prompt(
  "analyze_catalog",
  "分析商品目录结构",
  [],
  async () => {
    return {
      messages: [{
        role: "user",
        content: {
          type: "resource",
          resource: {
            uri: "commerce://catalog/categories",
            mimeType: "application/json",
            text: await db.categories.getJsonString()
          }
        }
      }]
    };
  }
);