one-pipe-system/openspec/changes/add-commission-clawback-records/tasks.md

1. 类型与 API 层（commission-api）

• 1.1 CommissionStatus 补充 5（回溯）；修正 CommissionRecordQueryParams.status 过期注释并支持回溯值
• 1.2 ShopCommissionRecordItem 新增 source、original_commission_id、refund_id、refund_no、withdrawable、clawback_records、clawback_total_amount
• 1.3 新增回溯摘要与佣金记录详情类型（原佣金详情含 clawback_records，回溯详情含 original_commission）
• 1.4 CommissionService 新增 getShopCommissionRecordDetail(shopId, id, source?)

2. 列表页（commission-records-list）

• 2.1 行 key 改为 source + ':' + id（my-commission 与 agent-fund-overview 佣金明细）
• 2.2 回溯行展示「回溯」状态与「不可提现」标识
• 2.3 负数金额与可为负的 balance_after 标红渲染
• 2.4 status 筛选项新增「回溯」
• 2.5 列表新增详情入口，且请求必须携带该行 source

3. 详情展示（commission-record-detail）

• 3.1 原佣金详情展示 clawback_records 摘要与 clawback_total_amount
• 3.2 回溯详情展示来源 original_commission
• 3.3 越权/不存在统一提示「佣金明细不存在」，不作为存在性判断依据

4. 导出（commission-record-export）

• 4.1 ExportTaskScene 增加 commission_record 并补场景配置
• 4.2 新增导出佣金记录场景页、路由、菜单与中英文案
• 4.3 佣金记录列表新增导出入口，query 仅提交 shop_id / status / commission_source / order_no

5. 验证

• 5.1 运行 npm run build（含 vue-tsc --noEmit）
• 5.2 运行 npm run check:encoding
• 5.3 运行 openspec.cmd validate add-commission-clawback-records --strict