| name | bsu-amount |
| description | BSU 定软电订单金额变化测试工具。验证正签、下单、履约完成、退单各节点的费用项（1061-1068）计算是否正确。
触发词：BSU金额、bsu amount、费用项验证、检查bsu、验bsu金额、bsu费用项
|
| tags | ["测试","BSU","金额验证","费用项"] |
BSU 定软电费用项测试 Skill
背景
BSU 定软电订单（S单_sku 维度）通过合同额消息驱动，分正签、下单、履约完成、退单四个节点，每个节点写入不同的费用项（orderAmounts）。
同一子单会被多次触发，金额是增量叠加而非覆盖，最终合同总额 = 正签 + 下单增量 + 履约完成增量。
费用项定义（1061-1068）
| code | 字段名 | 含义 | 写入节点 |
|---|
| 1061 | BSU_SOFT_SIGN_AMOUNT | 正签金额，正签节点的合同额 | 正签 |
| 1062 | BSU_SOFT_PLACE_ORDER_AMOUNT | 下单金额（非下单角色），下单相对正签的增减量 | 下单 |
| 1063 | BSU_SOFT_AGREEMENT_FINISH_AMOUNT | 履约完成金额（非下单角色），履约完成相对正签+下单的增减量 | 履约完成 |
| 1064 | BSU_SOFT_AGREEMENT_FINISH_DEDUCT_SIGN_AMOUNT | 履约完成扣正签金额，调减时从正签扣的部分，调增时为 0 | 履约完成 |
| 1065 | BSU_SOFT_AGREEMENT_FINISH_DEDUCT_PLACE_ORDER_AMOUNT | 履约完成扣下单金额，调减时从下单扣的部分，调增时为 0 | 履约完成 |
| 1066 | BSU_SOFT_CONTRACT_AMOUNT | 合同总额，当前累计合同总额，全程跟随更新 | 正签/下单/履约完成/退单 |
| 1067 | BSU_SOFT_PLACE_ORDER_AMOUNT_FOR_PLACE_ORDER_ROLE | 下单金额（下单角色），下单时刻的合同总额快照，写入后不再修改 | 下单 |
| 1068 | BSU_SOFT_AGREEMENT_FINISH_AMOUNT_FOR_PLACE_ORDER_ROLE | 履约完成金额（下单角色），履约完成累计合同额 - 1067 | 履约完成 |
各节点应有的 code
| 节点 | 必须存在的 code |
|---|
| 正签 | 1061、1066 |
| 下单 | 1061、1062、1066、1067 |
| 履约完成 | 1061、1062、1063、1064、1065、1066、1067、1068 |
| 退单 | 1066 |
计算公式
changeType = 计入 / 冲销后计入
消息中 contractAmount 含义：截止当前节点的累计合同总额
正签节点：
1061 = contractAmount
1066 = contractAmount
下单节点：
1062 = contractAmount - 1061
1066 = contractAmount
1067 = contractAmount（等于1066，即正签+下单的累计）
履约完成节点：
1063 = contractAmount - 1062 - 1061
1066 = contractAmount
1067 不变（下单时的快照）
1068 = 1066 - 1067
changeType = 冲销
消息中 contractAmount 含义：本次冲销的金额本身（负数），不是累计值，所以不做减法
下单冲销：
1062 = contractAmount（直接用，不减1061）
1066 = 1061 + contractAmount
1067 = 1061 + contractAmount（等于1066）
履约完成冲销：
1063 = contractAmount（直接用，不减前两项）
1066 = 1061 + 1062 + contractAmount
1068 = 1066 - 1067
验证规则（快速断言）
规则1：1066 = 1061 + 1062 + 1063
规则2：1067 = 1061 + 1062（下单时的1066快照，履约完成节点不变）
规则3：1068 = 1066 - 1067
规则4：调增时 1064 = 0，1065 = 0
调减时 1064 + 1065 = 1063（1063为负，拆分到1064/1065上）
举例说明
所有例子基准：正签 contractAmount = 10
场景1：正签 → 下单金额增加
下单 contractAmount = 12（计入）
1061 = 10
1062 = 12 - 10 = 2
1066 = 12
1067 = 12
场景2：正签 → 下单金额减少
下单 contractAmount = 8（计入）
1061 = 10
1062 = 8 - 10 = -2
1066 = 8
1067 = 8
场景3：正签 → 下单金额增加 → 履约完成金额不变
下单 contractAmount = 12，履约完成 contractAmount = 12（计入）
1061 = 10
1062 = 2
1063 = 12 - 2 - 10 = 0
1064 = 0（调增/不变）
1065 = 0（调增/不变）
1066 = 12
1067 = 12（下单快照）
1068 = 12 - 12 = 0
场景4：正签 → 下单金额增加 → 履约完成金额增加
下单 contractAmount = 12，履约完成 contractAmount = 15（计入）
1061 = 10
1062 = 2
1063 = 15 - 2 - 10 = 3
1064 = 0（调增）
1065 = 0（调增）
1066 = 15
1067 = 12（下单快照）
1068 = 15 - 12 = 3
场景5：正签 → 下单金额增加 → 履约完成金额减少（下单够扣）
下单 contractAmount = 12，履约完成 contractAmount = 10（计入）
1061 = 10
1062 = 2
1063 = 10 - 2 - 10 = -2
sum = placeOrderAmount + 1063 = 2 + (-2) = 0 >= 0，下单够扣
1064 = 0（不扣正签）
1065 = -2（从下单扣）
1066 = 10
1067 = 12（下单快照）
1068 = 10 - 12 = -2
场景6：正签 → 下单金额增加 → 履约完成金额减少（下单不够扣，需扣正签）
下单 contractAmount = 12，履约完成 contractAmount = 6（计入）
1061 = 10
1062 = 2
1063 = 6 - 2 - 10 = -6
sum = placeOrderAmount + 1063 = 2 + (-6) = -4 < 0，下单不够扣
placeOrderAmount = 2 >= 0，走扣两个节点分支：
1064 = sum = -4（扣正签）
1065 = -2（扣下单，取 placeOrderAmount 的反）
1066 = 6
1067 = 12（下单快照）
1068 = 6 - 12 = -6
场景7：正签 → 下单金额减少 → 履约完成金额增加
下单 contractAmount = 8，履约完成 contractAmount = 12（计入）
1061 = 10
1062 = -2
1063 = 12 - (-2) - 10 = 4
1064 = 0（调增）
1065 = 0（调增）
1066 = 12
1067 = 8（下单快照）
1068 = 12 - 8 = 4
场景8：正签 → 下单金额减少 → 履约完成金额减少
下单 contractAmount = 8，履约完成 contractAmount = 5（计入）
1061 = 10
1062 = -2
1063 = 5 - (-2) - 10 = -3
sum = placeOrderAmount + 1063 = -2 + (-3) = -5 < 0，下单不够扣
placeOrderAmount = -2 < 0，走特殊分支（下单本身就是负的）：
1064 = 1063 = -3（扣正签，等于履约完成金额）
1065 = 0（下单已经是负的，不再扣）
1066 = 5
1067 = 8（下单快照）
1068 = 5 - 8 = -3
场景9：正签 → 退单
正签 contractAmount = 10，退单 contractAmount = 0
退单只更新 1066，不新增任何费用项。
存在的费用项：1061、1066
1061 = 10（正签写入，不变）
1066 = 0（退单更新）
场景10：正签 → 下单 → 退单
正签 contractAmount = 10，下单 contractAmount = 12，退单 contractAmount = 0
退单只更新 1066，不新增任何费用项。
存在的费用项：1061、1062、1066、1067
1061 = 10（正签写入，不变）
1062 = 2（下单写入，不变）
1066 = 0（退单更新）
1067 = 12（下单写入，不变）
场景11：正签 → 下单 → 履约完成 → 退单
正签 contractAmount = 10，下单 contractAmount = 12，履约完成 contractAmount = 15，退单 contractAmount = 0
退单只更新 1066，不新增任何费用项。
存在的费用项：1061、1062、1063、1064、1065、1066、1067、1068
1061 = 10（正签写入，不变）
1062 = 2（下单写入，不变）
1063 = 3（履约完成写入，不变）
1064 = 0（履约完成写入，不变）
1065 = 0（履约完成写入，不变）
1066 = 0（退单更新）
1067 = 12（下单写入，不变）
1068 = 3（履约完成写入，不变）
两套角色视角说明
非下单角色（如正签经纪人）：按节点增量拿业绩
正签拿 1061
下单拿 1062（增量，可正可负）
履约完成拿 1063（增量，可正可负）
下单角色：按累计快照拿业绩
下单拿 1067（= 正签 + 下单的累计，是下单时刻的总额快照）
履约完成拿 1068（= 当前合同总额 - 1067）
Skill 操作流程
你是一个 BSU 定软电金额测试助手。收到触发词后，严格按以下步骤执行。
步骤一：收集参数
如果用户已在触发词中提供了 order_no 和各节点金额（如"order_no=xxx，正签10，下单8，履约完成2"），直接使用，跳过此步骤。
否则，直接用文字提问，不使用 AskUserQuestion：
请提供：
- order_no（子单）
- 正签 contractAmount
- 下单 contractAmount（可选）
- 履约完成 contractAmount（可选）
- 如有冲销节点，请注明哪个节点是冲销（changeType=cancel）
步骤二：执行查询
运行以下命令（仅查询，不写库）：
cd {skill目录} && python bsu_amount.py --order_no {order_no} --sign {sign} [--place {place}] [--finish {finish}] [--place-type cancel] [--finish-type cancel] --query-only
从输出中提取 __QUERY_RESULT_JSON__ 后面的 JSON 内容。
步骤三：展示对比结果并弹出确认框
解析 JSON，用 AskUserQuestion 展示如下内容，必须等用户点击才能继续：
问题标题：以下费用项即将写入，请确认
描述内容放在「确认写入」选项的 description 里：
order_no: {order_no}
表: ke_pinus.{table}
code 字段名 现有值 期望值 操作
1061 BSU_SOFT_SIGN_AMOUNT {cur} {exp} {INSERT/UPDATE/一致}
1062 BSU_SOFT_PLACE_ORDER_AMOUNT {cur} {exp} {INSERT/UPDATE/一致}
...（只列出本场景涉及的 code）
选项：
步骤四：根据用户选择执行
用户选择「确认写入」：
cd {skill目录} && python bsu_amount.py --order_no {order_no} --sign {sign} [--place {place}] [--finish {finish}] [--place-type cancel] [--finish-type cancel] --do-write
输出完成提示：
✅ BSU 金额写入完成！
order_no：{order_no}
场景：正签={sign}，下单={place}，履约完成={finish}
费用项已按期望值写入，可重新触发消息验证计算结果 🎉
用户选择「取消」：
直接回复：已取消，未写入任何数据，流程结束。
注意事项
- 配置文件（优先级从高到低）：
skills/bsu-amount/bsu_amount.local.toml（推荐，已 gitignore）~/.zsy_tools/bsu_amount.toml（全局配置）
- 首次使用：复制
config.example.toml 为上述任意路径，填入真实的 host/user/password
- 依赖安装：
pip install PyMySQL tomli（Python 3.11+ 不需要 tomli）
- skill 目录替换为本文件所在的绝对路径
--place-type cancel / --finish-type cancel 用于冲销场景，默认不传即为计入
