Files

T

rosercode d2e4a51f2b feat: 补充图片记账、交易渠道管理与前端偏好文档

- 新增「交易渠道管理」指南与「前端用户偏好」开发文档，并加入侧边栏导航
- 图片记账：补充多图上传、实时识别进度、结果勾选导入与「来源图片」回看，AI 配置新增视觉模型说明
- 数据模型补充 t_channel、t_ai_config/t_ai_image 等表与「类型+金额+时间」去重键说明，表数更新为 21 张
- API 文档补充 /api/channel、/api/transaction/batch、/api/ai/record/image(/stream)、/api/ai/image、/api/ai/channel 等接口
- 截图脚本新增渠道页、图片记账、来源图片与渠道 AI 辅助截图，并放宽导航超时

2026-09-21 22:19:55 +08:00

10 KiB

Raw Blame History

收支记录

「收支记录」页面用于查看和管理每一笔收入与支出。

顶部操作

按钮	功能
排序	交易时间（新→旧 / 旧→新）、金额（高→低 / 低→高）
一键设置	对当前表格展示的记录批量设置分类、计入统计与标签
批量删除	删除表格中勾选的记录
导入账单	打开账单导入弹窗
渠道管理	进入交易渠道管理页，维护自定义渠道
导出 Excel	按当前筛选条件导出
刷新	按当前筛选条件与页码重新加载列表
智能记账	用一句话描述收支，AI 解析后预填表单（需启用 AI）
新增记录	手动新增一笔记录

账单导入

「收支记录」页支持把支付宝、微信、美团、淘宝、京东、招商银行、交通银行的账单文件解析并导入为收支记录。

入口

入口	形式	说明
收支记录页「导入账单」按钮	弹窗	桌面端常用
通知邮件中的链接 `/bill-import`	独立页	仅由通知邮件直达，面向手机；独立页面（非弹窗），元素精简、系统内无其他入口

/bill-import 是「定时通知」邮件里附带的直达上传页，方便在手机上直接上传账单，不会从系统内其他页面跳转进入。

支持的账单类型与格式

账单类型	支持格式
支付宝	`.csv`、`.zip`
微信	`.xlsx`、`.zip`
美团	`.csv`、`.zip`
淘宝	`.xlsx`
京东	`.csv`、`.zip`
招商银行	`.csv`、`.pdf`、`.zip`
交通银行	`.xls`、`.zip`

各平台账单的导出方法见账单类型与获取。

导入流程

导入采用「解析预览 → 确认导入」两步，先解析不落库，确认后才写入。

第一步：选择类型与文件

选择账单类型（默认记住上次选择）。
点击或拖拽上传账单文件。
点击「解析」。

切换账单类型会清空已选文件；页面会提示该类型支持的格式与在对应 App 中的导出路径。若上传的是加密压缩包，解析时会弹出密码输入框，输入后重新解析。

第二步：解析预览

默认归类：可为本次导入设置默认的支出分类、收入分类与默认标签。
筛选：关键字、类型（收入/支出/不计入）、状态（可导入/已存在/不可导入）、金额区间。
逐行勾选：默认勾选解析器建议的行；只有「可导入」的行可勾选。
计入统计：可对勾选行批量「设为计入 / 设为不计入」，建议按来源设置（见下）。
预览列：交易时间、类型、计入统计、金额、交易对方、商品名称、状态、匹配规则与建议。

::: tip 按来源设置计入统计

微信、支付宝来源默认计入；其他来源（银行、美团、淘宝、京东等）默认不计入——它们往往最终走微信/支付宝支付。
例外：工资、奖金等明确收入应计入。 :::

::: tip 去重系统按「用户 + 交易号」去重。已存在于系统中的交易会标记为「已存在」，默认不勾选，避免重复导入。 :::

第三步：导入结果

显示成功、跳过、失败的数量与明细消息。完成后可在下方表格中查看。

常见问题

解析失败：确认账单类型与文件格式是否匹配；银行账单请使用系统支持的导出格式。
需要解压密码：部分账单压缩包在导出时设置了密码，需在解析时输入。
部分行不可导入：可能是金额/时间字段无法解析，或该交易号已存在。
重复导入：同一账单重复导入时，已存在的交易会被跳过。

筛选与 AI 智能查询

常用筛选：类型、分类（含「未分类」）、日期范围、备注关键字、交易渠道。交易渠道下拉包含内置渠道与账号下的自定义渠道。

更多筛选：标签（含「无标签」）、计入统计、金额区间。

启用 AI 后，顶部会出现 AI 智能查询输入框，可用自然语言查询，例如：

「上个月餐饮」
「超过500的支出」
「待报销的支出」
「微信支付」

解析结果会直接应用为筛选条件并立即查询。筛选条件与每页条数、排序方式会自动记忆，下次进入自动还原。

表格与行操作

表格展示：交易时间、类型、分类、金额、交易渠道、备注、标签、来源图片、计入统计开关与操作。

备注隐藏：可将敏感备注持久隐藏为 ******，需要时临时「查看」或「取消隐藏」。
计入统计：行内开关可直接切换；关闭后该记录不纳入月度统计（适合借款、转账等），行内会以删除线标示。
来源图片：图片记账生成的记录会显示「查看（N）」入口，弹窗内先加载缩略图，可按需「加载原图」查看对应截图。
行操作：编辑、查看「原始数据」（账单导入或图片记账时的原始字段，以 JSON 展示）、删除。

分页支持每页 10/20/50/100/200/500 条。

查看原始数据

账单导入或图片记账时，系统会完整保留每笔交易在原始账单中的字段（以 JSON 存储）。在记录行点击「原始数据」即可查看，用于核对金额、交易状态、对方账号、交易类型等明细。

账单导入记录保留原始账单行字段；图片记账记录保留模型从截图提取的原始字段。
手动新增的记录没有原始数据，该按钮不可用。
原始数据是排查导入异常、核对账单的重要依据。

一键设置（批量设置）

对当前表格展示的记录批量操作：

设置支出分类 / 收入分类。
设置是否计入统计。
添加标签 / 移除标签。
启用 AI 时，可选择建议范围（分类与标签 / 仅分类 / 仅标签）并点击「AI 智能建议」，由 AI 生成建议后进入 AI 建议弹窗。

AI 建议弹窗

展示每条记录的建议分类、建议标签与理由，默认全选，可逐条取消。若建议中包含系统中不存在的分类或标签，会以「新建」标记，确认后自动创建。应用后分类会被覆盖、标签会被追加。

AI 智能记账

「智能记账」弹窗提供文字记账与图片记账两种方式。

文字记账：用一句话描述一笔收支，例如「昨天中午吃饭 35 支付宝」，AI 会解析为类型、金额、分类、交易渠道、时间、备注、标签等字段，并预填到新增记录表单，确认后保存。
图片记账：上传一至多张账单或支付截图（也可 Ctrl+V 粘贴），AI 实时识别其中的每一笔交易，生成可编辑的记录列表，勾选后批量导入。

再次打开弹窗会记住上次使用的记账方式。图片记账的用法与限制详见 AI 能力 → 图片记账。

手动添加记录

在收支记录页右上角点击「新增记录」。

在弹窗中填写表单：

字段	说明
类型	支出 / 收入
分类	新增时必填
金额	大于 0
交易渠道	可选，含内置渠道与自定义渠道；启用 AI 时可一键推荐或新建
交易时间	默认当前时间
备注	可选
标签	可选，可多选
计入统计	默认开启；关闭后不纳入统计

点击「确定」保存。

编辑记录

在记录行点击「编辑」即可修改记录，弹窗字段与新增一致；编辑时允许不设置分类。

编辑时的 AI 辅助

启用 AI 后，编辑弹窗中的分类、标签与交易渠道旁会出现 AI 辅助按钮（与新增记录一致）：

按钮	作用
分类 · AI 推荐	根据当前类型、金额、交易渠道、备注，从已有分类中推荐并填入
分类 · AI 新建	根据当前账单信息生成新分类；确认「保存并选用」后创建并选中，若已存在同名同类型分类则直接选中
标签 · AI 推荐	推荐已有标签并追加（自动去重）
标签 · AI 新建	生成新标签（含建议颜色），确认后创建并选中；同名标签直接选中
渠道 · AI 推荐	根据当前类型、金额、渠道、备注，从已有渠道中推荐并填入
渠道 · AI 新建	生成新渠道名称；确认「保存并选用」后创建并选中，同名渠道直接选中

「AI 新建」需先填写备注或金额，便于模型理解；生成结果会显示确认条，点击「保存并选用」才真正创建。

编辑完成后点击「确定」保存。其他 AI 能力（批量建议、智能记账、智能查询）见 AI 能力。

::: tip 计入统计「计入统计」用于区分真实消费与资金流转，建议按账单来源设置，避免多来源重复统计：

微信、支付宝来源：默认计入（除非有特殊情况）。
其他来源（银行、美团、淘宝、京东等）：默认不计入——这些渠道的扣款往往最终走微信/支付宝，重复计入会导致统计翻倍。
例外：工资、奖金等明确收入应计入。

此外，借款、信用卡还款、账户间转账等资金流转也建议关闭该开关，避免统计失真。 :::

10 KiB Raw Blame History Unescape Escape