guoguo（guoguo 开发）

裹裹寄件下单

通过 MCP 连接裹裹寄件服务（GUOGUO_SEND_SERVICE），为用户创建寄件订单。

前置检查：自动配置 MCP

每次触发此 skill 时，必须先执行此步骤。

检查当前可用的 MCP tool 列表中是否存在 guoguo_send_server 相关的 tool（如 mcp_guoguo_send_server_GUOGUO_SEND_ORDER_CREATE）。

• 如果已存在 → 跳过，直接进入下单流程
• 如果不存在 → 执行自动配置脚本（使用 skill 加载时提供的 Base directory 路径）：

bash <Base directory>/setup-mcp.sh

脚本会自动检测 Qoder MCP 配置文件位置（兼容 macOS/Linux），若 guoguo_send_server 未配置则自动添加。配置完成后提示用户刷新 MCP 连接或重启 Qoder 以生效。

下单流程

Step 1: 收集下单信息

向用户收集以下全部必要信息（可一次性询问，也可分步收集）：

Step 2: 构造请求参数

调用 MCP tool 时需传入两个参数：request 和 accessOption。

request 参数模板：

{
    "externalUserId": "<下单账号>",
    "externalUserMobile": "<下单账号>",
    "itemId": 3000000040,
    "itemVersion": 4,
    "senderInfo": {
        "name": "<寄件人姓名>",
        "mobile": "<寄件人电话>",
        "fullAddressDetail": "<寄件人完整地址>"
    },
    "receiverInfo": {
        "name": "<收件人姓名>",
        "mobile": "<收件人电话>",
        "fullAddressDetail": "<收件人完整地址>"
    },
    "timeType": 2,
    "appointGotStartTime": "<期望揽收开始时间，毫秒时间戳>",
    "appointGotEndTime": "<appointGotStartTime + 7200000>",
    "outOrderInfoList": [],
    "designatedDeliveryUserId": null,
    "extensionMap": null,
    "userRemark": null,
    "externalUserType": 5
}

关键计算规则：

• appointGotStartTime：用户提供的揽收开始时间，转为毫秒时间戳
• appointGotEndTime：= appointGotStartTime + 7200000（即加 2 小时），此间隔由 itemId 决定，当前 3000000040 固定加 2 小时
• appointGotStartTime 必须大于当前时间，否则提示用户重新选择

固定值映射表：

accessOption 参数（固定值）：

{
    "accessCode": "示例",
    "accessMethod": null
}

Step 3: 调用 MCP Tool 下单

调用 guoguo_send_server MCP 服务中的寄件下单 tool，传入上述 request 和 accessOption 两个参数。

Step 4: 处理响应

下单成功（result.success 为 "true"）：

向用户展示以下信息：

• 寄件单号：result.data.orderId
• 取件码：result.data.gotCode
• 账号ID：result.data.cnAccountId

成功响应示例：

{
  "result": {
    "data": {
      "externalUserId": "2074370454",
      "orderId": "21240720002375404",
      "cnAccountId": "2074370454",
      "gotCode": "5617"
    },
    "success": "true"
  }
}

下单失败：

响应中会包含失败原因，提取并明确告知用户失败原因，方便排查。

注意事项

• 所有地址必须是完整地址（省/自治区+市/地区+区/县+详细地址）
• externalUserId 和 externalUserMobile 填写相同的用户手机号/账号
• 时间戳单位为毫秒
• 当前仅支持 itemId=3000000040（两小时服务），后续如有新商品可扩展固定值映射表