用途
该技能用于计算 Shopify 店铺的真实净利润与利润率，覆盖订单级与产品级两种粒度。与基础营收报表不同，它会扣除全部成本组成，包括 COGS（来自 inventoryItem.unitCost）、运费成本、交易/支付处理手续费、已应用的折扣、退款金额以及税费/关税，从而呈现实际利润率。该技能为只读，不执行任何变更。
主要能力
- 按订单或按产品/变体聚合计算净利润与利润率。
- 收入口径使用 currentTotalPriceSet；COGS 按 Σ(行项目数量 × 变体 inventoryItem.unitCost) 计算。
- 费用项目包括运费（totalShippingPriceSet）、折扣（totalDiscountsSet）、退款（refunds.totalRefundedSet）以及估算交易手续费（默认 2.9% + $0.30，可配置）。
- 输出人类可读报表与 JSON 两种格式，并生成 CSV 文件。
- 支持筛选全退款订单是否计入、设置回看天数、最小订单数等。
前置条件与权限
需要已认证的 Shopify CLI 会话：
shopify store auth --store <domain> --scopes read_orders,read_products,read_inventory
API 权限范围：read_orders、read_products、read_inventory。为获得准确结果，产品应已填充 inventoryItem.unitCost。
参数
- store（字符串，必填）：店铺域名，例如 mystore.myshopify.com。
- days_back（整数，可选，默认 30）：订单回看窗口。
- group_by（字符串，可选，默认 order）：分组方式，可选 order、product 或 variant。
- min_orders（整数，可选，默认 1）：产品/变体模式下产品出现所需的最小订单数。
- include_refunded（布尔，可选，默认 true）：是否将完全退款的订单纳入计算。
- format（字符串，可选，默认 human）：输出格式，human 或 json。
使用方式
技能按以下流程执行：先查询订单，携带完整成本明细；对缺失 unitCost 的库存项进行补充查询；随后对每个订单计算收入、COGS、运费成本、折扣、交易手续费、退款、净利润与利润率；若按产品/变体分组，则跨订单聚合；最后可查询产品变体以补充产品标题、SKU 等上下文信息。
每个订单的计算公式：
- 收入 = currentTotalPriceSet.shopMoney.amount
- COGS = Σ(行项目数量 × 变体 inventoryItem.unitCost)
- 运费成本 = totalShippingPriceSet.shopMoney.amount（商家承担部分估算）
- 折扣 = totalDiscountsSet.shopMoney.amount
- 交易手续费 = 按总额估算 2.9% + $0.30（可配置）
- 退款 = Σ(refunds.totalRefundedSet.shopMoney.amount)
- 净利润 = 收入 - COGS - 运费 - 交易手续费 - 退款
- 利润率 % = (净利润 / 收入) × 100
技能使用的 GraphQL 查询包括：orders：query、inventoryItems：query、productVariants：query，均已针对 api_version 2025-01 校验。技能在执行过程中会输出会话跟踪信息（开始横幅、每步进度、完成报表）。
输出格式
生成 CSV 文件 profit_report_<YYYY-MM-DD>.csv，订单级列包括：order_id, order_name, date, revenue, cogs, shipping, discounts, tx_fees, refunds, net_profit, margin_pct；产品分组列包括：product_id, product_title, vendor, units_sold, revenue, cogs, net_profit, margin_pct。human 格式会输出汇总报表，包含分析订单数、总收入、总 COGS、总运费、总手续费、总退款、净利润、整体利润率以及利润率最高与最低的产品；json 格式输出结构化字段。
错误处理
- THROTTLED（API 速率超限）：等待 2 秒，最多重试 3 次。
- 缺失 unitCost（产品未设置 COGS）：标记为“unknown COGS”，纳入报表但排除出利润率计算。
- 已退款订单（完全退款）：若 include_refunded 为 true，则以 $0 净收入计入。
适用场景
适用于需要了解扣除各项成本后真实盈利情况的 Shopify 商家，用于识别利润率正负产品、发现快销但低利润的商品，并结合批量调价等操作优化定价。
限制与注意事项
- 交易手续费为估算值（默认 2.9% + $0.30，对应 Shopify Payments 美国），需根据实际支付处理商调整。
- 必须填充 inventoryItem.unitCost，否则无法计算利润率。
- 技能为只读，不执行任何变更。
- 文档未提供价格、收费或套餐信息，相关事实暂未提供。