A 股交易记录分析 · 炒股盈亏统计复盘
这个技能做什么、不做什么
- 做：把用户自己的成交记录按先买先卖（FIFO）配成一笔笔平仓，算出扣完手续费、印花税、过户费的真实盈亏，然后拆开看：哪只票赚的、哪只亏的，哪个月赚的，拿几天的单子赚钱，星期几 / 哪个时段进出的单子结果如何，费用吃掉了多少，按用户自己写的策略标签分组的结果。全是用户账户里已经发生的事实。
- 只看 A 股（沪深北，含场内 ETF）。港股通、可转债、期权、新股申购、分红送转这些记录自动跳过并在报告里报条数。
- 不做：不联网，不取任何行情，不评价任何一只股票「好不好」，不预测涨跌，不给买卖建议，不推荐仓位。用户问「XX 还能拿吗 / 该不该补」时，明说这不在本技能范围内，把话题拉回「你的记录里这类操作的结果是什么」。
- 报告里出现的每一个数字，都能在用户的成交文件里找到来源。
成交文件的隐私检查
成交明细属于个人财务信息。第一次使用先跑内置样例，不需要真实账户。用户决定分析真实记录前：
- 先说明需要处理的是成交明细，并让用户确认愿意在当前对话或执行环境中使用这些记录。
- 删除或遮盖姓名、身份证号、手机号、资金账号、银行卡号、联系地址、客户编号等无关身份信息；账户名改成「账户 A」「账户 B」，文件名也不要带姓名或账号。
- 只保留核算需要的成交日期、证券代码、买卖方向、价格、数量、成交金额和费用。截图裁掉账户抬头，检查每张图没有身份信息。
- 不要求用户上传资金流水、登录凭据、银行卡或身份证图片。若用户不想分享逐笔成交，让他只看样例，或在自己信任的环境运行脚本，再自行决定是否分享汇总结果。
第一步：先让用户看到结果，再教他拿文件
用户第一次来、手上还没有文件时，不要一上来就让他去导出。按下面的顺序：
1. 先用样例跑一份完整报告给他看
python {baseDir}/scripts/ledger.py --demo --out demo.md
样例是两个示例账户（一个东方财富格式、一个同花顺格式），报告里「分账户 → 合计 → 已平仓 / 未平仓 → 按策略标签」每一节都有。展示时开头说清楚：这是样例数据，不是你的账户。然后挑一两个数字说明这份报告能回答什么问题（比如「样例里 #追涨 的 3 笔合计亏 6,534.44 元」），再问他要不要换成自己的记录。
2. 教他导出成交记录
告诉用户：要的是「历史成交」（有的券商叫「成交查询」「交割单」），不是「资金流水」或「当日委托」。查询区间尽量拉长，最好包含现在还拿着的票当初买入的那几天。
| 软件 | 一般在哪里 | 导出方法 |
|---|---|---|
| 同花顺（电脑版下单程序） | 一般在『查询→历史成交』 | 选好起止日期查询后，多数版本在列表上按 Ctrl+S 可以存成文件；也可以右键列表找「导出 / 输出」。存出来的 .xls 常常其实是文本文件，直接发来就行 |
| 东方财富（电脑版交易） | 一般在『查询→历史成交』 | 查询后找列表上方或右键菜单里的「导出 / 输出」，存成 Excel 或 CSV |
| 通达信（券商定制的电脑版交易） | 一般在『查询→历史成交』 | 查询后点「输出」，选输出到 Excel 或文本文件 |
| 券商手机 App | 一般在『交易→查询→历史成交』（有的叫「交割单」） | 手机上通常只能看不能导出：截图发过来（一屏一张，连续截完），或者去该券商的电脑版导出 |
菜单名称各家券商不完全一样，找不到时让用户在软件里搜「历史成交」或「交割单」，别替用户编菜单路径。
3. 用户贴表格文字或截图时，由你整理成 CSV 再跑
- 先按上面的隐私检查处理截图；按这一行表头整理（没有的列可以不要，前 5 个必须有：成交日期、证券代码、买卖标志、成交价格、成交数量）：
成交日期,成交时间,证券代码,证券名称,买卖标志,成交价格,成交数量,成交金额,手续费,印花税,过户费,备注
2026-08-03,09:35:12,600519,贵州茅台,买入,1420.00,20,28400.00,8.52,0.00,0.28,#低吸
- 逐行照抄，不补、不猜。 截图里看不清的数字标出来问用户，不要自己填一个。代码保留 6 位（前面的 0 别丢）。
- 抄完自检：每行「成交价格 × 成交数量」和「成交金额」应当差不多；对不上的行指给用户确认。
- 截图多张时注意别重复抄同一行（翻页常有重叠）。
- 存成 UTF-8 的 CSV 文件后照常跑下面的命令。报告不会自己知道数据是整理来的，展示时由你补一句「这份是按你的截图 / 粘贴整理的，数字以券商记录为准」。
典型用法（用户常这么问）
| 用户说 | 你做什么 |
|---|---|
| 「今年炒股到底赚没赚？手续费交了多少？」 | 跑 ledger.py，先报「已平仓」的净盈亏和费用合计，再单独报还没卖的持仓成本，两者别混在一起说 |
| 「我华泰和国君两个账户，合起来算一下」 | 两个文件一起传，--trades 华泰=… 国君=…，先各账户、再合计 |
| 「我打板和低吸哪个结果好一点？」 | 让用户在备注里给买入打 #打板 #低吸，跑出「按策略标签」一节，只报各标签的笔数、净盈亏、胜率，不评价哪种做法对 |
| 「8 月亏了不少，帮我复盘一下」 | 跑 monthly.py --month 2026-08，列出当月每一笔，再按需跑 timeslot.py 看是哪个时段进出的单子 |
| 「我只有手机 App，导不出来」 | 让用户把历史成交截图发来，按上面的表头逐行整理成 CSV 再跑 |
| 「我还没导出，先看看能出什么」 | 跑 ledger.py --demo |
使用流程
- 拿到文件：CSV、xlsx、xls 都行。东方财富、同花顺、通达信、华泰、中信、平安、国泰君安等常见列名自动识别（见
references/columns.md）。券商导出的 .xls 很多其实是网页表格或制表符文本，脚本会自动按这两种方式试着读；真读不了会提示用户「在券商软件里另存为 CSV 或 xlsx」。 - 问一句本金（可选）：有本金才能算「费用占本金」「已实现净盈亏占本金」。用户不说就跳过，别自己编。
- 跑全量账本：
python {baseDir}/scripts/ledger.py --trades <成交文件> [--capital 200000] --out report.md
输出 Markdown 报告（report.md）和同名 JSON。报告结构：
- 一、已平仓（已实现盈亏）：总账、按股票、按月、按持仓天数、费用、习惯画像。
- 二、未平仓持仓成本：还没卖的票，只列股数、买入均价、成本、已拿几天。不算浮盈浮亏（不取行情），提醒用户现价去券商软件的持仓页看。
- 三、按策略标签（有备注 / 标签列才有）。
- 四、数据说明：读法、跳过条数、找不到买入的老仓、费用是否估算。
把报告原样展示给用户，再用两三句话点出最扎眼的一个数字（不下判断，只指方向）。
- 多个账户一起看：
python {baseDir}/scripts/ledger.py --trades 华泰=华泰.csv 国君=国君.xlsx --out report.md
- 每个文件默认一个账户，账户名取文件名；写成「账户名=文件」可以自己起名。
- 报告先按账户分开列（每个账户都有已平仓 / 未平仓两节），最后一节「合计」：账户对比表 + 合并后的完整统计。
- 同一只票在不同账户里各自配对，A 账户买的不会和 B 账户卖的配在一起。
- 同一个账户分几次导出的文件（比如上半年、下半年各一份），用同一个账户名：
华泰=上半年.csv 华泰=下半年.csv，会合成一个账户，重叠的成交只算一次。如果报告提示「不同账户之间有 N 条成交完全相同」，多半就是这种情况，按提示改了重跑。 --capital在多账户时按全部账户的合计本金理解。
-
按策略标签分组（可选）：用户在券商导出文件的「备注」列（或自己加一列「标签 / 策略」）里写
#打板、#低吸、#追涨这样的标签，报告就多一节「按策略标签」。
- 标签写在买入那一行；买入没写、卖出写了的，用卖出的。
- 一笔带多个标签时，每个标签各算一次。没打标签的归到「未打标签」。
- 没有这一列就整节跳过，不提示。有列但一个#都没有时，报告会教用户怎么写。
- 用户想用标签但券商导出没有备注列：让他在 Excel / WPS 里自己加一列「备注」，逐行写上，再存成 CSV 发来。 -
月复盘：
python {baseDir}/scripts/monthly.py --trades <成交文件...> --month 2026-08
输出当月每一笔平仓的明细、当月贡献前三 / 后三、月末还没卖的持仓成本。配对用的是全量记录（月初持仓的成本来自更早的买入），只是把当月卖掉的挑出来。
- 时段复盘（按星期几 / 交易时段拆已实现盈亏）：
python {baseDir}/scripts/timeslot.py --trades <成交文件...> [--by open|close|both] [--min-n 5] [--out timeslot.md]
星期几只要有日期就能算；时段需要「成交时间」列，没有时报告会提示导出时勾上。口径同上：只说「你的记录显示周五买入的 5 笔合计 2,857.71 元」，不说「周五适合买」。
- 对比：想看「这个月比上个月怎么样」，跑两次
monthly.py再比数字，不要凭印象说「好转了」。
出错了怎么办
脚本出错时只打印一段中文说明（以「没算成：」开头），里面已经写了原因和下一步，原样转述给用户，不要自己改成别的说法：
- 找不到表头 / 缺少某几列：说明里会列出缺的列、文件里现有的列、正确的列名示例。如果只是列名不一样（比如买卖方向那一列叫「交易类别」），问清楚对应关系后在 CSV 里改列名重跑，别猜。
.xls读不了：让用户在券商软件或 Excel / WPS 里「另存为」CSV 或 xlsx。- 读出来了但没有 A 股买卖：多半导出的是资金流水 / 对账单，让用户重新导出「历史成交」。
和「交易纪律教练」怎么配合
- 账本（本技能）管「钱是怎么赚 / 亏的」：结果层面——净盈亏、胜率、盈亏比、持仓周期、费用、策略标签。
- 纪律教练管「有没有守规矩」：行为层面——追涨、亏损加仓、日亏超线、连亏不停手、仓位超限、过度交易。
顺序：先跑账本，再跑纪律。 先看钱从哪来（比如「持仓 1–3 天的 11 笔合计亏 8,882.07 元」），带着这个结论去纪律报告里找对应的行为。两个技能认同一套列名，同一份导出文件两边都能用。
报告怎么说话
- 数字先行：先给数，再给一句解释数从哪来。
- 不用形容词：不说「亏得惨」「表现很好」「值得警惕」，说「持仓 1–3 天的 11 笔，合计 -8,882.07 元，胜率 18.2%」。
- 不评价个股：表里的股票只是统计单位。可以说「300750 这 2 笔合计亏 5,877.58 元」，不能说「这只票不适合你」。
- 不评价策略：可以说「#追涨 的 3 笔合计 -6,534.44 元」，不能说「追涨策略不行，别做了」。
- 不预测：不说「持仓拉长会改善」，只说「你的记录显示 4–10 天这一档 3 笔全赚，合计 6,034.93 元」。
- 已实现和未平仓分开说：没卖的票不算盈亏，也不要替用户去估现价。
- 结尾固定一句：
以上仅为你自己交易记录的统计，不构成投资建议。（脚本已自动附上，不要删。）
口径与边界
- 一笔平仓 = 一次卖出：一次卖出可能由多笔买入配成（先买先卖），持仓天数按股数加权平均（可能是小数，分档没有空隙）。
- 费用：买入费用按股数摊到每股，卖出费用（含印花税、过户费）摊到本次卖出。文件没有费用列时按万 3 手续费、千 0.5 印花税估算，并在报告里注明。
- 找不到买入的卖出：导出区间之前就拿着的老仓，单列成「无成本记录」，报股数与卖出金额，不计入盈亏，不猜成本。
- 未平仓持仓：只列股数、买入均价、买入成本（含 / 不含买入费用）、最早买入日、截至记录最后一天已拿几天。
- 融资融券：「担保品买入 / 卖出」「融资买入」「卖券还款」按普通买卖计入，并标注条数。
- 大文件：超过 20,000 行时只取最近 12 个月并注明。
- 容错：代码被 Excel 吞掉前导零（1 → 000001）会补回；
="000001"这种写法会去壳；新的在上面的倒序文件会翻正；成交时间93512这类写法会规整成 09:35:12 再排先后。 - 加仓判定：一笔平仓若由两笔及以上买入配成，记为「分两次及以上买进」。这只是记录事实，不等于「加仓是错的」。
脚本
| 脚本 | 用途 |
|---|---|
scripts/common.py |
成交文件读取与解析（CSV / xlsx / 伪 xls、编码识别、列名别名、A 股过滤、费用估算、标签、多账户） |
scripts/ledger.py |
全量账本：已平仓 / 未平仓分节、按股票 / 月 / 持仓天数、费用、习惯画像、策略标签、多账户合计；--demo 跑样例 |
scripts/monthly.py |
单月账单：每笔平仓明细 + 当月贡献前三 / 后三 + 月末未平仓成本 |
scripts/timeslot.py |
时段复盘：按星期几、交易时段、整点小时拆已实现盈亏 |
纯 Python 3 标准库，零第三方依赖（xlsx 用自带解析；装了 openpyxl 会优先用它；真正的老式二进制 .xls 装了 xlrd 才能读，否则提示另存）。
assets/sample_trades.csv（东方财富格式，带成交时间与备注标签）和 assets/sample_trades_2.csv（同花顺格式，新的在上面、日期写成 20260804）是 --demo 用的两个示例账户。
