# v0.52 逐笔流水分类与审阅

入口：我的资产 → 原始交易流水 → 选择文件 → 逐笔流水分类与审阅。

## 本版本

保留每一条原始记录，按“用户、时间、账户、操作、币种、变更”生成稳定事件编号和来源哈希。支持中文及英文币安账户流水表头；原始用户ID仅用于个人范围内来源身份摘要，不在规范化结果中明文输出。文件未注明时区时保留原文时间，不根据文件名推断时区。

自动分类使用固定版本 `binance-statement-0.52.0`，属于按标签推断，并非交易所认证。识别交易收到、交易付出、手续费、充值、提现、内部转账、理财申购、理财赎回及利息/奖励。`Transfer`、冻结、退款、未知标签及数量方向冲突保留为待核对。理财申购和赎回单列本金流动，不当作投资收益。奖励仅展示币种数量，不按当前价格倒推历史收益。

支持按来源身份、子账户、分类、待分类/已确认/疑似重复筛选；每页50条，分类数量汇总始终覆盖该文件全部记录。按来源、子账户、币种、分类单独汇总；页面最多显示200项汇总，完整结果随JSON导出。

## 交易与转账候选

交易收付腿在同一来源、子账户和原文时间下分组。只有恰好一条交易收到、一条交易付出、至多一条手续费、收付币种不同、买入/卖出/兑换标签属于相同业务且没有相似重复行时，标记为配对候选。同秒多笔、缺少另一侧、孤立手续费、多条手续费或重复行保留为多义/不完整关系，不任意分摊手续费。

内部转账按同一来源、原文时间、币种及精确数量绝对值分组。只有标签指向相同划转路径、实际子账户符合路径、不同子账户间恰好一正一负、等量且没有重复时，标记为转账候选。跨用户、不同数量或缺少另一侧不强行匹配。

所有配对均为候选，缺少成交ID或划转ID时不会认证为完整交易，也不据此计算成本、收益或历史净值。分类修订只确认该条分类，不代表确认配对关系。

## 人工审阅

点击“核对分类”，选择分类，填写核对依据后确认保存。分类与数量方向必须相容：例如充值须为正、提现和手续费须为负。不能用分类操作修改数量、币种、时间或文件原件；无效字段需核对原件后重新上传。

每次修订记录来源哈希、修订前版本、前序哈希、分类、说明、确认用户与时间，并写入个人审计。相同请求编号重试不会新增修订；并发修改通过版本检查阻止覆盖。可选择“恢复自动分类”，仍保留历史。

分类与原始净变动、余额基准及持仓快照分别保存。人工分类不会改动 v0.51 已确认的持仓，也不会把原文件数量增减当作余额。余额基准数量对账仍直接使用原始变更字段。

## 重复与重叠

文件内相同规范化来源、时间、子账户、操作、币种、数量和备注摘要标记为疑似重复，全部保留，不能据此认定真实重复成交。每条最多展示20个相似记录编号，并保留完整相似数量计数。

选择另一份已保存的原件，可检查两文件的重叠候选。每页最多100组，包含两侧全部匹配记录号及数量，支持分页与本页JSON下载。不会自动删除、跨文件累计或合并余额。跨来源身份不互相匹配。

## 导出与接口

分类JSON导出包括文件元数据、SHA-256、全部规范化事件、候选分组、完整分类汇总及修订历史，使用规范化JSON哈希校验；不含交易所凭证。单次完整导出最多8 MiB，超限明确拒绝，不截断。

以下接口仅当前登录个人身份可用，禁止团队选择头、所有者覆盖参数及工作区API Key。写操作检查同源，全部操作受个人权限及速率限制。

| 接口 | 请求要点 | 用途 |
| --- | --- | --- |
| `POST /api/console/wealth/ledger` | id、offset，可选category/account/identity/state | 分页分类与候选关系 |
| `POST /api/console/wealth/ledger/review` | 独立UUID id、importId、recordNumber、revision、sourceHash、category或null、note | 确认分类或恢复自动分类 |
| `POST /api/console/wealth/ledger/history` | id、recordNumber | 该记录修订历史 |
| `POST /api/console/wealth/ledger/export` | id | 完整文件分类及审阅JSON |
| `POST /api/console/wealth/ledger/compare` | id、otherId、offset | 两文件重叠候选 |

原有原始文件列表及只读MCP工具新增 `latestLedgerClassification`，只提供分类计数和候选统计，不返回逐笔内容或执行写入。

## 恢复与兼容

65张业务表、32个迁移、45个独立恢复文件。新模型：`personal-ledger-events-v1`、`personal-ledger-review-v1`。

恢复工具验证个人归属、原件元数据关联、来源与内容哈希、数量方向、修订前序链和请求摘要。原始CSV需重传，审阅标记为 `requires_reconfirm`，重新确认前不采用旧人工分类。新确认须使用新UUID和当前修订版本；旧记录保留。原件真实性与交易配对仍需另行核验。

当前兼容清单 `release-v052.json`；旧v0.51的44个恢复文件冻结于 `/integration/v051/`。新增结构后不能直接回退到v0.51程序。

## 参考资料与规则边界

- [Binance Spot账户成交接口](https://developers.binance.com/docs/binance-spot-api-docs/rest-api/account-endpoints)：成交接口提供成交ID、订单ID、成交数量与手续费币种等；本版本没有调用该接口补造CSV缺失字段。
- [Binance Simple Earn Flexible说明](https://www.binance.com/en/support/faq/detail/3bd1a6eba20a445da1e94bf6cfa52e80)：区分申购、赎回和奖励，申购涉及账户间资产转移。
- [Binance Simple Earn申购历史](https://developers.binance.com/docs/simple_earn/flexible-locked/history/Get-Flexible-Subscription-Record)：提供申购编号、产品和来源账户等独立记录。

资料核对日期：2026-10-17。CSV操作标签的映射为本产品版本化推断规则；以上资料不等于对每个CSV标签或候选配对的官方认证。