用途
order-risk-report 用于查询近期的 Shopify 订单，并筛选出具有高或中欺诈风险分数的订单，同时展示 Shopify 所标记的具体风险指标，例如账单地址与收货地址不一致、高风险邮箱域名、高风险 IP 等。最终生成一份按优先级排序的人工欺诈评估审核队列。该技能为只读操作，不会对订单做任何修改。
前置条件
需要已认证的 Shopify CLI 会话，命令为：shopify store auth --store <domain> --scopes read_orders。所需 API 权限范围为 read_orders。
参数
- store（字符串，必填，无默认值）：商店域名，例如 mystore.myshopify.com。
- risk_level（字符串，可选，默认 high）：要纳入的最低风险等级，可选 high、medium 或 all。
- days_back（整数，可选，默认 7）：回顾订单的时间窗口。
- min_order_value（浮点数，可选，默认 0）：仅纳入高于该金额（USD）的订单。
- format（字符串，可选，默认 human）：输出格式，可选 human 或 json。
安全性
该技能为只读，不执行任何变更，可随时安全运行。风险分数由 Shopify 的欺诈分析生成，仅供参考，除非商家自行配置 Shopify 的欺诈过滤器，否则不会自动阻止订单。
工作流程
- 执行 orders 查询：输入查询条件 risk_level:<risk_level> created_at:>='<NOW - days_back days>'，first: 250，选择 riskLevel、riskFacts、totalPriceSet、customer 以及分页游标。预期输出为带有风险数据的订单，并持续分页直到 hasNextPage 为 false。
- 按风险等级排序（高风险在前），再按订单金额降序排列。
GraphQL 操作
代码内容如下：
query OrderRiskReport($query: String!, $after: String) { orders(first: 250, after: $after, query: $query) { edges { node { id name createdAt displayFinancialStatus displayFulfillmentStatus totalPriceSet { shopMoney { amount currencyCode } } riskLevel riskFacts { message sentiment } customer { id displayName defaultEmailAddress { emailAddress } numberOfOrders } shippingAddress { countryCode city } billingAddress { countryCode city } } } pageInfo { hasNextPage endCursor } } }
该查询已针对 api_version 2025-01 校验。
会话跟踪
技能要求在每一阶段输出固定内容。启动时输出带边框的标题，包含技能名、商店域名与开始时间。每完成一步后，输出形如 [N/TOTAL] <QUERY|MUTATION> <OperationName> 的进度信息，并附参数摘要与结果。完成时，human 格式输出订单风险报告摘要，包括回顾订单数、高/中/低风险计数以及高风险订单明细和输出文件名；json 格式输出包含 skill、store、period_days、orders_reviewed、high_risk_count、medium_risk_count、output_file 字段的 JSON 对象。
输出格式
生成 CSV 文件 risk_report_<YYYY-MM-DD>.csv，列包括：order_name、order_id、created_at、risk_level、total_price、currency、customer_name、customer_email、risk_indicators、financial_status、fulfillment_status。
错误处理
- THROTTLED：API 速率限制超限，等待 2 秒后重试，最多 3 次。
- No high-risk orders：无高风险订单（干净周期），以摘要形式退出，标记 0 个订单。
- riskLevel 为 null：订单过新，无法分析，将其从报告中排除并记录数量。
最佳实践
不要自动取消高风险订单，应先用 high-risk-order-tagger 将其标记为人工暂停，审核后再决定是否取消。对于重复客户（numberOfOrders > 3）出现高风险分数的情况，通常是误报，需结合判断再行动。min_order_value 有助于将审核精力集中在高价值欺诈风险上，多数商店可将 50 美元以上作为合理下限。建议每天作为早晨运维例行工作运行，尤其在高销量的促销期间，欺诈尝试会增多。
适用场景与限制
适用于需要人工审核订单欺诈风险的 Shopify 商家，尤其适合在促销高峰进行日常风险巡检。限制在于：仅支持只读，不能自动处理订单；风险分数为 Shopify 提供，仅作参考；无法确定其是否支持多店铺批量操作、具体的界面呈现方式或额外计费信息，这些内容暂未提供。