# 接入方式

async function getWeather({ location, days }) {
  // 原子接口内部实现，此处省略
  // wx.request({ url: 'https://www.example.com/get_weather' })
  // wx.cloud.callFunction({ name: 'get_weather' })
  
  return {
    isError: false,
    content: [{ type: "text", text: "已为您查询到北京未来3天天气" }],
    structuredContent: {
      location: "北京",
      forecasts: [
        { date: "2026-04-23", dayWeather: "晴", nightWeather: "晴", tempHigh: 28, tempLow: 14, wind: "北风2级" },
        { date: "2026-04-24", dayWeather: "多云", nightWeather: "阴", tempHigh: 25, tempLow: 13, wind: "东南风3级" },
        { date: "2026-04-25", dayWeather: "小雨", nightWeather: "中雨", tempHigh: 20, tempLow: 12, wind: "东风4级" }
      ]
    },
  }
}

wx.modelContext.registerAPI('placeOrder', async ({ skuId, count }) => {
  const loggedIn = await checkUserLogin()

  // 未登录：指示下一步调用 login
  if (!loggedIn) {
    return {
      isError: false,
      content: [{ type: 'text', text: '用户未登录' }],
      apiCalls: [{ name: 'login', arguments: {} }],
    }
  }

  // 已登录：正常下单
  const order = await createOrder({ skuId, count })
  return {
    isError: false,
    content: [{ type: 'text', text: `订单已创建` }],
  }
})

const getWeather = require('./apis/getWeather')

const skill = wx.modelContext.createSkill('/path/to/pkg/weatherSkill')
// name 需与定义文件中的一致
skill.registerAPI('getWeather', getWeather)

const skill = wx.modelContext.createSkill('pages/weather')
skill.registerAPI('getWeather', getWeather)
skill.use(async (ctx, next) => {
  // 1. 统一登录（仅首次）
  const token = wx.getStorageSync('token')
  if (!token) {
    const { code } = await wx.login()
    const res = await wx.request({ url: '...', data: { code } })
    wx.setStorageSync('token', res.data.token)
    // 也可以直接抛出错误，让Agent进行其他操作
    // throw new Error('登录过期，接下来自动执行xxx skill 下的 login 工具')
  }
  // 2. 上报：记录开始时间
  const start = Date.now()
  try {
    await next()  // 执行实际 handler
    // 上报成功
    reportLog({
      name: ctx.name,
      cost: Date.now() - start,
    })
  } catch (err) {
    // 3. 统一错误监听
    reportError({
      name: ctx.name,
      error: err,
      cost: Date.now() - start,
    })
    throw e
}) 

async function getWeather({ location, days }) {
  // 原子接口内部实现，此处省略
  // wx.request({ url: 'https://www.example.com/get_weather' })
  // wx.cloud.callFunction({ name: 'get_weather' })
  
  return {
    isError: false,
    content: [{ type: "text", text: "已为您查询到北京未来3天天气" }],
    structuredContent: {},
    handoff: (data) => {
      // data.result.structuredContent 模型根据用户意图过滤后数据
      return {
        query: 'poi=beijing&days=3',
        payload: {
          location: '北京',
          forecasts: [
            { date: "2026-04-23", dayWeather: "晴", nightWeather: "晴", tempHigh: 28, tempLow: 14, wind: "北风2级" },
            { date: "2026-04-24", dayWeather: "多云", nightWeather: "阴", tempHigh: 25, tempLow: 13, wind: "东南风3级" },
            { date: "2026-04-25", dayWeather: "小雨", nightWeather: "中雨", tempHigh: 20, tempLow: 12, wind: "东风4级" }
          ]
        },
      }
    },
  }
}

{
  pageId: number    // 目标页实例 ID，用于关联跳转的页面，精确投递 payload
  path: string      // 当前打开的页面的 path（不含 query）
  query: string     // 页面 query 字符串，与原子接口返回的 handoff.query 相同
  payload: unknown  // 原子接口返回的 handoff.payload
}

App({
  onLaunch() {
    wx.onAgentHandoff(({ pageId, path, query, payload }) => {
      this.globalData.agentHandoffs = this.globalData.agentHandoffs || {}
      this.globalData.agentHandoffs[pageId] = { path, query, payload }
    })
  },
})

Page({
  onLoad(query) {
    const handoffs = getApp().globalData.agentHandoffs || {}
    const handoff = handoffs[this.getPageId()]
    delete handoffs[this.getPageId()]

    // 使用原子接口返回的数据更新页面状态
    this.setData({ forecasts: handoff.payload.forecasts })

    // 使用 query 参数拉取数据
    this.loadPoiDetail(query.poi, query.days).then(forecasts => this.setData({ forecasts }))
  },
})

Component({
  lifetimes: {
    created() {
      const modelCtx = wx.modelContext.getContext(this);
      const { NotificationType } = wx.modelContext;
      modelCtx.on(NotificationType.Input, (data) => {
        // 原子接口的入参数据
      });
      modelCtx.on(NotificationType.Result, (data) => {
        // 原子接口的出参数据
      });

      const viewCtx = wx.modelContext.getViewContext(this);
      const { minHeight, maxHeight, width } = viewCtx.getDimensions();
      viewCtx.on(NotificationType.Overflow, (data) => {
        // data.contentHeight: 内容总高
        // data.overflowHeight: 溢出高度
        // data.maxHeihgt: 当前卡片容器的硬性阈值
        // 如果给原子组件的 root element 设置 maxHeight 和 overflow: hidden 则无法触发
      });
    }
  }
})

Component({
  lifetimes: {
    created() {
      const modelCtx = wx.modelContext.getContext(this)
      this._viewCtx = wx.modelContext.getViewContext(this)

      modelCtx.on('result', (data) => {
        const { orderId } = data.result.structuredContent
        this.setData({ orderId })
        // 若只传 query，路径由 mcp.json 中的 components[].relatedPage 决定
        this._viewCtx.setRelatedPage({ query: `orderId=${orderId}` })
        // 若原子组件可能与多个小程序页面关联，也可传入 path 参数
        this._viewCtx.setRelatedPage({ path: '', query: `orderId=${orderId}` })
      })
    }
  },
  methods: {
    onSpecChange(e) {
      const spec = e.detail.value
      this.setData({ selectedSpec: spec })
      // 状态变化后更新 query 参数
      this._viewCtx.setRelatedPage({
        query: `orderId=${this.data.orderId}&spec=${spec}`
      })
    }
  }
})

wx.modelContext.expireAllCards(): Promise<{ errMsg: string }>

// 过期特定组件的卡片（绝对路径）
wx.modelContext.expireAllCards({
  componentPaths: ['packageA/weatherSkill/components/weather-card/index']
})

// 只过期最近一张匹配的卡片
wx.modelContext.expireAllCards({
  componentPaths: ['packageA/weatherSkill/components/weather-card/index'],
  match: 'latest'
})

const viewCtx = wx.modelContext.getViewContext(this)
viewCtx.expirePreviousCards(): Promise<{ errMsg: string }>

// 过期特定组件的卡片（绝对路径）
viewCtx.expirePreviousCards({
  componentPaths: ['packageA/weatherSkill/components/weather-card/index']
})

// 只过期最近一张匹配的卡片
viewCtx.expirePreviousCards({
  componentPaths: ['packageA/weatherSkill/components/weather-card/index'],
  match: 'latest'
})

Component({
  lifetimes: {
    created() {
      const { NotificationType } = wx.modelContext;
      const viewCtx = wx.modelContext.getViewContext(this);

      viewCtx.on(NotificationType.Expire, (event) => {
        console.log('卡片已过期', event.expiredText)
        // 停止轮询、禁用按钮等清理逻辑
      })
    }
  }
})

Component({
  methods: {
    onOptionSelect(e) {
      const { option } = e.currentTarget.dataset

      // 将用户选择同步给模型
      const viewCtx = wx.modelContext.getViewContext(this)
      viewCtx.updateModelContext({
        content: [
          { type: 'text', text: `用户选择了${option}` }
        ]
      })
    }
  }
})

Component({
  lifetimes: {
    created() {
    }
  },
  methods: {
    showDetail() {
      const viewCtx = wx.modelContext.getViewContext(this);
      viewCtx.openDetailPage({
        url: '/packageA/pages/weather-detail?foo=bar'
      })
    }
  }
})

Page({
  onTap() {
    const ctx = wx.modelContext.getContext()
    ctx.sendFollowUpMessage({
      content: [
        {
          // 必须传
          type: 'text',
          text: '选择拿铁'
        },
        {
          // 指定下一步应该调用哪个原子接口，若不传，则由模型推理
          type: 'api/call',
          data: {
            name: 'selectGoods',
            arguments: {}
          }
        }
      ]
    })
  }
})

// 前置 wx.config()
wx.ready(function () {
    WeixinJSBridge.invoke('invokeMiniProgramAPI', {
      name: 'sendFollowUpMessage',
      arg: {
        content: [
          {
            // 必须传
            type: 'text',
            text: '选择拿铁'
          },
          {
            // 指定下一步应该调用哪个原子接口，若不传，则由模型推理
            type: 'api/call',
            data: {
              name: 'selectGoods',
              arguments: {}
            }
          }
        ]
      }
    }, function (res) {})
})

Component({
  lifetimes: {
    attached() {
      const viewCtx = wx.modelContext.getViewContext(this);
      viewCtx.preloadDetailPage({
        url: '/packageA/pages/weather-detail?foo=bar'
      })
    }
  },
})

const modelCtx = wx.modelContext.getContext()

modelCtx.reapplyApiCall({
  arguments: {
    city: '广州',
    days: 3
  }
})