0. 符号定义
f = 交易所手续费率（默认 10%）
s = 1 − f（到手比例，默认 0.9）
t = 龙币变现二次扣费开关：勾选 1，不勾选 0（默认 1）
K = P_G / P_B（金币价 ÷ 龙币价）
q = 数量
r = 目标利润率
n = 1 元可买多少金币（默认 10000）
d = 100 龙币能卖多少元（默认 0.9，即九折）
h = 1 万金币袋子的龙币挂牌价（默认 1000）
1. 三条路径
- 路径1：金币购货 → 龙币出货。用金币按 PG 买入，按 PB 卖出得到龙币。适合 K 偏低。
- 路径2：龙币购货 → 金币出货。用龙币按 PB 买入，按 PG 卖出得到金币。适合 K 偏高。
- 路径3：人民币购金币 → 金币购货 → 龙币出货 → 人民币变现。人民币买金币不承担手续费，商品卖龙币承担一次交易所手续费，龙币卖人民币是否再扣一次由开关 t 控制。适合 n 较大、材料金币价格较低时寻找闭环套利。
人民币买入金币不承担手续费；商品卖龙币承担交易所手续费；龙币卖人民币是否再扣一次手续费由开关控制。该路径适合 n 较大、材料金币价格较低时寻找闭环套利。
2. 路径1：金币购货 → 龙币出货
成本 = P_G·q（金币）
卖出收入 = s·P_B·q（龙币）
【龙币收益目标】
成本折龙币 = P_G·q·s·h / 10000
利润 = s·P_B·q − P_G·q·s·h/10000
利润率 = 利润 ÷ 成本折龙币
通用K形式：R = 10000/(K·h) − 1
【金币收益目标】
收入折金币 = s·P_B·q·10000/h
利润 = s·P_B·q·10000/h − P_G·q
利润率 = 利润 ÷ (P_G·q)
通用K形式：R = s·10000/(K·h) − 1
【人民币收益目标】
成本人民币 = P_G·q / n（人民币买金币无手续费）
收入人民币 = s^(1+t)·P_B·q·d/100
利润 = 收入人民币 − 成本人民币
通用K形式：R = s^(1+t)·d·n/(100·K) − 1
3. 路径2：龙币购货 → 金币出货
成本 = P_B·q（龙币）
卖出收入 = s·P_G·q（金币）
【龙币收益目标】
收入折龙币 = s²·P_G·q·h/10000
利润 = s²·P_G·q·h/10000 − P_B·q
通用K形式：R = s²·K·h/10000 − 1
【金币收益目标】
成本折金币 = P_B·q·10000/h
利润 = s·P_G·q − P_B·q·10000/h
通用K形式：R = s·K·h/10000 − 1
【人民币收益目标】
成本人民币 = P_B·q·d/100（龙币机会成本按变现价折算）
收入 = s·P_G·q / ((1+f)·n)（金币只能这样变现：卖方承担手续费）
R = 100·s·K/((1+f)·n·d) − 1
4. 路径3：人民币闭环
成本人民币 = P_G·q / n
收入人民币 = s^(1+t)·P_B·q·d/100
利润 = s^(1+t)·P_B·q·d/100 − P_G·q/n
利润率 = 利润 ÷ 成本人民币
通用K形式：R = s^(1+t)·d·n/(100·K) − 1
注意：路径3 与“路径1 的人民币收益目标”在公式上完全等价，
但两者视角不同（路径3 从人民币出发闭环回到人民币），界面独立展示；
在汇总时按去重处理，只计一次。
5. 盈亏平衡 K 阈值
路径1·龙币 盈利：K < 10000/h
路径1·金币 盈利：K < s·10000/h
路径1·人民币 盈利：K < s^(1+t)·d·n/100
路径2·龙币 盈利：K > 10000/(s²·h)
路径2·金币 盈利：K > 10000/(s·h)
路径2·人民币 盈利：K > (1+f)·n·d/(100·s)
路径3·人民币闭环 盈利：K < s^(1+t)·d·n/100（与路径1人民币一致）
判读要点：K 很低时优先看路径1 与路径3；K 很高时优先看路径2；中间区间可能三种目标都不赚，或只有某一个收益目标勉强为正。
6. 金币变现（只有一种口径）
金币卖出方承担 10% 手续费 → 到手 = 名义金币 × (1 − f)
折人民币：收入 = G · s / n = G / ((1+f)·n)
金币变现只有卖家付手续费这一种方式：你卖 10000 金币，买家实付 10000，实际进你账户的是 9000，再按 1 元 = n 金币折算成人民币。所以「先扣 s」和「除以 (1+f)」在 f = 10% 时只差 0.9 与 0.909，工具统一按 G/((1+f)·n) 折算，意思是：想收到 G 金币对应的全款，买方名义上要多付 (1+f) 倍。
容易搞混的是龙币变现：那一步才存在「卖出 1000 龙币、买家实收 900」的说法——交易方式是买家在交易所挂一个标的物，你按约定单价把它拍下来，成交价里已经含了手续费，所以按 900 计货款，再按 d 折成人民币。
7. 龙币变现二次扣费开关 t
原始设定：商品卖龙币时交易所扣 10%，买家拿到的是 90%；随后 900 龙币按 1 元 = 100 龙币换 9 元，九折实付 8.1 元。因此“龙币 → 人民币”这一步也存在一次 10% 的折损。
- 勾选（t = 1，默认）：商品卖龙币扣一次 s，龙币卖人民币再扣一次 s，最终收入 = s²·P_B·q·d/100。
- 不勾选（t = 0）：只认商品成交那一次手续费，最终收入 = s·P_B·q·d/100。
该开关影响：路径1·人民币、路径3·人民币的利润与利润率；对应阈值 s^(1+t)·d·n/100；以及路径2 的“成本人民币”是否应按二次折损口径理解。路径1·龙币、路径1·金币、路径2·龙币、路径2·金币 不受影响。
8. 目标利润率反推（P_G_max / P_B_min 等）
路径1·龙币 K ≤ 10000/((1+r)·h) P_G_max = P_B·10000/((1+r)·h) P_B_min = P_G·(1+r)·h/10000
路径1·金币 K ≤ s·10000/((1+r)·h) P_G_max = s·P_B·10000/((1+r)·h) P_B_min = P_G·(1+r)·h/(s·10000)
路径1·人民币 K ≤ s^(1+t)·d·n/(100(1+r)) P_G_max = s^(1+t)·P_B·d·n/(100(1+r)) P_B_min = P_G·100(1+r)/(s^(1+t)·d·n)
路径2·龙币 K ≥ 10000(1+r)/(s²·h) P_G_min = P_B·10000(1+r)/(s²·h) P_B_max = s²·P_G·h/(10000(1+r))
路径2·金币 K ≥ 10000(1+r)/(s·h) P_G_min = P_B·10000(1+r)/(s·h) P_B_max = s·P_G·h/(10000(1+r))
路径2·人民币 K ≥ (1+r)(1+f)·n·d/(100s) P_G_min = P_B·(1+r)(1+f)·n·d/(100s) P_B_max = 100s·P_G/((1+r)(1+f)·n·d)
路径3·人民币 K ≤ s^(1+t)·d·n/(100(1+r)) P_G_max = s^(1+t)·P_B·d·n/(100(1+r)) P_B_min = P_G·100(1+r)/(s^(1+t)·d·n)
路径1 / 路径3 的 PG 是买入价、PB 是卖出价，因此得到“最高买入价 PG,max”和“最低卖出价 PB,min”；路径2 相反，PB 是买入价、PG 是卖出价，因此得到“最高买入价 PB,max”和“最低卖出价 PG,min”。
9. 同货币差价公式（金币差价 / 龙币差价）
同货币差价模式与跨币种路径是两种独立策略：不涉及金币/龙币互转，不使用 K、h、n、d，只受手续费率 f 与买卖价差影响；买入不承担手续费，卖出扣 s = 1 − f。
金币差价：
成本 = P_G_in · q
卖出收入 = s · P_G_out · q
利润 = s · P_G_out · q − P_G_in · q
利润率 = 利润 ÷ (P_G_in · q) = s · KK_G − 1
其中 KK_G = P_G_out / P_G_in
龙币差价：
成本 = P_B_in · q
卖出收入 = s · P_B_out · q
利润 = s · P_B_out · q − P_B_in · q
利润率 = 利润 ÷ (P_B_in · q) = s · KK_B − 1
其中 KK_B = P_B_out / P_B_in
盈亏阈值：
盈利条件 s · KK > 1，即 KK > 1/s
等价最低卖出价 P_out > P_in / s
等价最高买入价 P_in < s · P_out
目标利润率 r 反推：
最低卖出价 P_out_min = P_in · (1 + r) / s
最高买入价 P_in_max = s · P_out / (1 + r)
目标价差比 KK_min = (1 + r) / s
目标利润额 T 反推（q 数量固定）：
已知 P_in：P_out = (T + P_in·q) / (s·q)
已知 P_out：P_in = (s·P_out·q − T) / q
阈值示例：s = 0.9 时 1/s = 1.1111，即保本价差比 111.11%，卖出价必须比买入价高至少 11.11% 才保本；卖出价 = 买入价 × 1.2 时利润率为 s×1.2−1 = 8%。
10. 同货币差价的汇总折算与去重
- 龙币目标：在“路径1·龙币”“路径2·龙币”“龙币差价利润”中取正利润最大者。
- 金币目标：在“路径1·金币”“路径2·金币”“金币差价利润”中取正利润最大者。
- 人民币目标：在“路径1·人民币”“路径2·人民币”“路径3·人民币”“金币差价折人民币”“龙币差价折人民币”中取正利润最大者；路径1 与路径3 等价，只计一次。
- 金币差价折人民币：按金币卖出唯一的折算方式，利润 / ((1+f)·n)，成本同比例折算。
- 龙币差价折人民币：利润 × d / 100，成本 × d / 100。这里的龙币利润已经是扣过交易所手续费后的净龙币，因此只乘一次 d/100，不再受“龙币二次扣费开关”影响。
- 不重复加总：汇总对每一行只取该目标币种下利润最大的那个模式。若同一商品既想跨币种又想同货币，应视为两笔独立交易分别查看，工具不会把两者叠加。
11. 金币获取成本对照（基础信息区）
用龙币换金币有两条走法，基础信息区会按当前参数直接把两个价算出来，单位统一为金币/龙币（每 1 龙币能换到多少金币，越大越划算）：
方式一 · 龙币直接买万金袋
10000 / h （金币/龙币）
折合 1 金币 = h / 10000 龙币
方式二 · 龙币卖人民币，再用人民币买金币
s^t · d · n / 100 （金币/龙币）
折合 1 金币 = 100 / (s^t · d · n) 龙币
其中 s^t 是“龙币 → 人民币”这一步的折损：t=1 扣一次 s，t=0 不扣
两种走法打平：
h* = 10000 / (s^t · d · n / 100) = 1000000 / (s^t · d · n)
h < h* → 方式一（直接买）更划算
h > h* → 方式二（绕人民币）更划算
买入这边都不收费，只有“卖”的那一步扣 s：方式一是买万金袋（买方不付手续费），方式二是卖龙币（这一步按 s^t 折损）。两者相差的百分比 = (方式二 − 方式一) / 方式一。
12. 本地缓存说明
缓存键：dn_arbitrage_tool_v2_state（当前工作状态）与 dn_arbitrage_tool_v2_my_defaults（我的默认参数），均含 version: 2 与保存时间戳。读取时对缺失字段用默认值补齐，解析失败时回退到“我的默认参数”或出厂默认并给出提示，不会白屏。