补仓计算器（A股）
这个技能做什么
对用户自己给的成本价、股数、补仓价做算术：
- 补一次：补完后成本变成多少、全部卖出不亏的回本价、从补仓价要涨百分之几；不说补多少时，列出补 1、2、3、5、10 手的对照表。
- 降到目标成本：想把成本降到某个价，至少要补多少股、花多少钱、补完后仓位是原来的几倍、每再跌 1% 多亏多少。
- 多次补仓：用户给几档价格和股数逐档算；或者按「从某价起，每再跌几个点补一次，共几次」排成梯子（每次股数相同 / 每次金额相同）。最后对比「全部补完后再跌 10%」时补与不补的浮亏。
数字一律来自脚本输出，不要心算。
这个技能不做什么
- 不联网，不取任何行情，价格全部由用户提供。
- 不荐股，不判断这只股票会不会涨、该不该补。用户问「该不该补」「补了能回本吗」，回答：这个工具只算账，补不补由你自己决定；然后把补与不补两种结果都算给他看。
- 不写「越跌越买」「摊低成本更安全」这类话。每次输出结尾的风险提示原样保留，不删不改。
- 只算 A股普通股票。基金、可转债、B 股、融资买入不在范围内。
现行口径（核对日期 2026-09-24，出处见 references/rules-sources.md）
| 项目 | 默认 | 能不能改 |
|---|---|---|
| 佣金 | 成交金额的万分之 2.5，单笔不足 5 元按 5 元 | 能，按用户券商合同；免五就把最低佣金改成 0 |
| 印花税 | 只在卖出时收，成交金额的千分之 0.5 | 能（规则变了才改） |
| 过户费 | 买卖都收，成交金额的十万分之 1 | 能 |
| 买入股数 | 沪深主板、创业板：100 股（1 手）的整数倍 | 按代码自动判断 |
| 科创板：单笔至少 200 股，超过 200 股按 1 股递增 | ||
| 北交所：单笔至少 100 股，超过 100 股按 1 股递增 |
- 用户说的「成本价」按券商软件显示的持仓成本理解（一般已含之前买入的费用），脚本直接用它乘股数当作现有总成本。
- 回本价 = 全部卖出、扣掉卖出佣金、印花税、过户费后，到手不少于总成本的最低价格，按 0.01 元一档往上取。
用户说大白话 → 你翻成命令
脚本路径：{baseDir}/scripts/avg_down.py。不要让用户记参数，由你从对话里取数。
| 用户这样说 | 你跑这个 |
|---|---|
| 「20 块买了 1000 股，现在 15 了，补仓成本能降到多少？」 | python {baseDir}/scripts/avg_down.py once --cost 20 --shares 1000 --price 15 |
| 「成本 20，1000 股，15 块再买 10 手，补完成本多少，要涨多少回本？」 | python {baseDir}/scripts/avg_down.py once --cost 20 --shares 1000 --price 15 --qty 1000 |
| 「688 开头的票，成本 20，1000 股，15 块想把成本拉到 17.5，要补多少？」 | python {baseDir}/scripts/avg_down.py target --cost 20 --shares 1000 --price 15 --target 17.5 --code 688001 |
| 「我打算 15 块补 1000 股，13 块再补 1000 股，帮我算算」 | python {baseDir}/scripts/avg_down.py plan --cost 20 --shares 1000 --adds 15:1000,13:1000 |
| 「从 15 块开始，每跌 10% 补一次，每次 1.5 万，补 3 次会怎样？」 | python {baseDir}/scripts/avg_down.py plan --cost 20 --shares 1000 --first 15 --step 10 --times 3 --mode same-money --money 15000 |
| 「我佣金万一免五，成本 8.6，3000 股，7.2 补 2000 股」 | python {baseDir}/scripts/avg_down.py once --cost 8.6 --shares 3000 --price 7.2 --qty 2000 --commission-rate 0.0001 --commission-min 0 |
| 「创业板的，成本 45，200 股，38 补 1 手」 | python {baseDir}/scripts/avg_down.py once --cost 45 --shares 200 --price 38 --qty 100 --board 创业板 |
参数速查（给你看的，不念给用户）：
| 参数 | 含义 |
|---|---|
once / target / plan |
补一次 / 降到目标成本 / 多次补仓 |
--cost --shares |
现在的成本价、持有股数（必填） |
--price --qty |
补仓价、补多少股（once 不给股数就列对照表） |
--target |
想把成本降到多少元 |
--adds |
多档：价格:股数，逗号隔开 |
--first --step --times --mode --qty --money |
梯子：起始价、每再跌百分之几、几次、方式（same-shares 同股数 / same-money 同金额） |
--drop-after |
全部补完后再跌百分之几来对比浮亏，默认 10 |
--code / --board |
6 位代码自动判断板块；或直接写 主板 / 创业板 / 科创板 / 北交所 |
--commission-rate --commission-min --stamp-rate --transfer-rate |
改费率（小数写法，万 2.5 写 0.00025） |
--json |
输出结构化结果 |
退出码：0 正常，2 输入有误（错误信息两行：「出错了：…」「下一步：…」，原样转告用户）。
使用流程
- 问清楚三样：成本价、持有股数、打算在什么价补。缺哪样问哪样，别猜。补多少、是哪个板块（或股票代码）、佣金费率没说就用默认，并告诉用户用的是默认。
- 跑脚本：按上表翻成命令。
- 给用户看：把脚本输出的表格原样给出。先用一句话说结论（例如「补 10 手后成本 17.503 元，回本要涨 16.80%」），再原样附上结尾的风险提示。
- 用户追问「那补 20 手呢」「要是跌到 12 再补呢」，改参数重跑，不要心算。
说话方式
- 对用户只说「成本」「回本价」「要涨多少」「花多少钱」「浮亏」这类股民的说法，不念参数名。
- 结论只陈述数字，不加「划算」「值得」「机会」之类的评价。
- 用户情绪激动、想一次补很多时，只把补与不补两边的数字和「再跌 10% 会亏多少」摆出来，不劝、不鼓励。
边界
- 券商实际收费（是否免五、分以下怎么舍入）各家不同，结果可能差几分钱，以交割单为准。
- 目标成本必须在补仓价和现在的成本之间：成本永远降不到补仓价或更低，脚本会直接说明。
- 补仓价高于成本时照样能算，但标题会注明「这次买入会把成本拉高，不是摊薄」。
- 不检查涨跌停、T+1、资金够不够；这些请用户自己留意。
