rosercode
923d6db5c0
对照 ledgerly 自文档上次更新以来的全部改动，补充新功能文档、修正品牌与版本残留，并新增下载与安装页；配图已重新截取并上传 OSS，本地截图目录不纳入版本管理。 变更内容： - 新增「智能查数」「账单关系」两个使用文档页，并登记侧边栏与总览 - 设置页扩充为八个面板（账号安全、数据库实时进度、外观、导航等）并改为即时保存 - 收支记录补充关系列、批量操作、AI 搜索浮窗、可配置分页与「账单详情」弹窗 - 统计面板补充饼图/渠道图下钻与筛选双向联动；规则管理补充批量删除 - AI 能力补充智能查数与关系命名；新增下载与安装页 - 开发文档同步：AI 13 类调用、数据模型 24 张表、API、前端偏好、构建部署 - 统一「汇账 Ledgerly」品牌与「设置/日志」菜单文案，版本号对齐 0.1 - 截图脚本新增账单详情等场景并更新登记 说明： - download.md 的 OSS 下载链接保持待发布产物回填，暂不调整 - 已通过 npm run docs:build 与 npm run typecheck:scripts
218 lines
12 KiB
Markdown
218 lines
12 KiB
Markdown
# 收支记录
|
||
|
||
「收支记录」页面用于查看和管理每一笔收入与支出。
|
||
|
||
|
||
|
||
## 顶部操作
|
||
|
||
| 按钮 | 功能 |
|
||
|---|---|
|
||
| 排序 | 交易时间（新→旧 / 旧→新）、金额（高→低 / 低→高） |
|
||
| 查看统计 | 携带当前筛选条件跳转到[统计面板](/guide/dashboard) |
|
||
| 一键设置 | 对当前表格展示的记录批量设置分类、计入统计与标签 |
|
||
| 批量操作 / 退出批量 | 进入多选模式，可批量删除或为选中的多条记录[建立账单关系](/guide/relations) |
|
||
| 导入账单 | 打开账单导入弹窗 |
|
||
| 渠道管理 | 进入[交易渠道管理](/guide/channels)页，维护自定义渠道 |
|
||
| 导出 Excel | 按当前筛选条件导出 |
|
||
| 刷新 | 按当前筛选条件与页码重新加载列表 |
|
||
| 智能记账 | 用一句话描述收支，AI 解析后预填表单（需启用 AI） |
|
||
| 新增记录 | 手动新增一笔记录 |
|
||
|
||
> 默认为普通模式，表格不显示勾选列；点「批量操作」后才进入多选模式，勾选记录后可「批量删除」，或勾选至少两条后「建立关系」。
|
||
|
||
## 账单导入
|
||
|
||
「收支记录」页支持把支付宝、微信、美团、淘宝、京东、招商银行、交通银行的账单文件解析并导入为收支记录。
|
||
|
||
|
||
|
||
### 入口
|
||
|
||
| 入口 | 形式 | 说明 |
|
||
|---|---|---|
|
||
| 收支记录页「**导入账单**」按钮 | 弹窗 | 桌面端常用 |
|
||
| 通知邮件中的链接 `/bill-import` | 独立页 | **仅由通知邮件直达**，面向手机；独立页面（非弹窗），元素精简、系统内无其他入口 |
|
||
|
||
> `/bill-import` 是「定时通知」邮件里附带的直达上传页，方便在手机上直接上传账单，不会从系统内其他页面跳转进入。
|
||
|
||
### 支持的账单类型与格式
|
||
|
||
| 账单类型 | 支持格式 |
|
||
|---|---|
|
||
| 支付宝 | `.csv`、`.zip` |
|
||
| 微信 | `.xlsx`、`.zip` |
|
||
| 美团 | `.csv`、`.zip` |
|
||
| 淘宝 | `.xlsx` |
|
||
| 京东 | `.csv`、`.zip` |
|
||
| 招商银行 | `.csv`、`.pdf`、`.zip` |
|
||
| 交通银行 | `.xls`、`.zip` |
|
||
|
||
各平台账单的导出方法见[账单类型与获取](/guide/bills/overview)。
|
||
|
||
### 导入流程
|
||
|
||
导入采用「解析预览 → 确认导入」两步，先解析不落库，确认后才写入。
|
||
|
||
**第一步：选择类型与文件**
|
||
|
||
1. 选择账单类型（默认记住上次选择）。
|
||
2. 点击或拖拽上传账单文件。
|
||
3. 点击「解析」。
|
||
|
||
切换账单类型会清空已选文件；页面会提示该类型支持的格式与在对应 App 中的导出路径。若上传的是**加密压缩包**，解析时会弹出密码输入框，输入后重新解析。
|
||
|
||
**第二步：解析预览**
|
||
|
||
|
||
|
||
- **默认归类**：可为本次导入设置默认的支出分类、收入分类与默认标签。
|
||
- **筛选**：关键字、类型（收入/支出/不计入）、状态（可导入/已存在/不可导入）、金额区间。
|
||
- **逐行勾选**：默认勾选解析器建议的行；只有「可导入」的行可勾选。
|
||
- **计入统计**：可对勾选行批量「设为计入 / 设为不计入」，建议按来源设置（见下）。
|
||
- **预览列**：交易时间、类型、计入统计、金额、交易对方、商品名称、状态、**匹配规则与建议**。
|
||
|
||
::: tip 按来源设置计入统计
|
||
- **微信、支付宝**来源默认**计入**；**其他**来源（银行、美团、淘宝、京东等）默认**不计入**——它们往往最终走微信/支付宝支付。
|
||
- **例外**：工资、奖金等明确收入应计入。
|
||
:::
|
||
|
||
::: tip 去重
|
||
系统按「用户 + 交易号」去重。已存在于系统中的交易会标记为「已存在」，默认不勾选，避免重复导入。
|
||
:::
|
||
|
||
**第三步：导入结果**
|
||
|
||
显示成功、跳过、失败的数量与明细消息。完成后可在下方表格中查看。
|
||
|
||
### 常见问题
|
||
|
||
- **解析失败**：确认账单类型与文件格式是否匹配；银行账单请使用系统支持的导出格式。
|
||
- **需要解压密码**：部分账单压缩包在导出时设置了密码，需在解析时输入。
|
||
- **部分行不可导入**：可能是金额/时间字段无法解析，或该交易号已存在。
|
||
- **重复导入**：同一账单重复导入时，已存在的交易会被跳过。
|
||
|
||
## 筛选与 AI 智能查询
|
||
|
||
**常用筛选**：类型、分类（含「未分类」）、日期范围、备注关键字、交易渠道。交易渠道下拉包含内置渠道与账号下的[自定义渠道](/guide/channels)。
|
||
|
||
**更多筛选**：标签（含「无标签」）、计入统计、金额区间。
|
||
|
||
启用 AI 后，顶部会出现「**AI 搜索**」入口，点击打开一个**可拖拽、可缩放的浮窗**（非模态，打开后仍可继续操作主界面）。在浮窗中用自然语言查询，例如：
|
||
|
||
- 「上个月餐饮」
|
||
- 「超过500的支出」
|
||
- 「待报销的支出」
|
||
- 「微信支付」
|
||
|
||
浮窗输入框支持多行，按 `Ctrl + Enter`（Mac 为 `⌘ + Enter`）提交；解析结果会直接应用为筛选条件并立即查询。浮窗的位置与大小会被记住，输入时还能快速选择历史提问。筛选条件与每页条数、排序方式会自动记忆，下次进入自动还原。
|
||
|
||
|
||
|
||
## 表格与行操作
|
||
|
||
表格展示：交易时间、类型、分类、金额、交易渠道、备注、标签、计入统计开关、关系与操作。
|
||
|
||
- **备注隐藏**：可将敏感备注持久隐藏为 `******`，需要时临时「查看」或「取消隐藏」。默认这些记录会从列表与 Excel 导出中排除，可在[设置 → 外观设置](/guide/settings#外观设置)中开启「显示已隐藏备注的记录」。
|
||
- **计入统计**：行内开关可直接切换；关闭后该记录不纳入月度统计（适合借款、转账等），行内会以删除线标示（样式可在外观设置中调整）。
|
||
- **关系**：展示该记录所属[账单关系](/guide/relations)组的数量，点击可查看与管理。
|
||
- **行操作**：编辑、详情、删除。
|
||
|
||
### 账单详情
|
||
|
||
点击行内「**详情**」打开「账单详情」弹窗，集中展示单条账单的以下信息：
|
||
|
||
- **基本信息**：类型、金额、分类、交易渠道、交易时间、是否计入统计、备注与创建时间。
|
||
- **标签**：该记录的全部标签。
|
||
- **账单关系**：所属的[账单关系](/guide/relations)组，可在弹窗内直接新建。
|
||
- **来源图片**：图片记账生成的记录会展示其来源截图，默认加载缩略图，可按需点「加载原图」查看原图。
|
||
- **原始数据**：账单导入或图片记账时保留的原始字段（以 JSON 展示），用于核对金额、交易状态、对方账号、交易类型等明细。
|
||
|
||
|
||
|
||
> - **账单导入**记录保留原始账单行字段；**图片记账**记录保留模型从截图提取的原始字段；**手动新增**的记录没有来源图片与原始数据。
|
||
> - 原始数据是排查导入异常、核对账单的重要依据。
|
||
|
||
分页的每页条数**候选与默认值在[设置 → 外观设置](/guide/settings#外观设置)中统一配置**（默认候选 10 / 20 / 50 / 100，默认 20）；各表格会分别记住上次选择的每页条数。
|
||
|
||
## 一键设置（批量设置）
|
||
|
||
对**当前表格展示的记录**批量操作：
|
||
|
||
|
||
|
||
- 设置支出分类 / 收入分类。
|
||
- 设置是否计入统计。
|
||
- 添加标签 / 移除标签。
|
||
- 启用 AI 时，可选择建议范围（分类与标签 / 仅分类 / 仅标签）并点击「AI 智能建议」，由 AI 生成建议后进入 AI 建议弹窗。
|
||
|
||
## AI 建议弹窗
|
||
|
||
展示每条记录的建议分类、建议标签与理由，默认全选，可逐条取消。若建议中包含系统中不存在的分类或标签，会以「新建」标记，确认后自动创建。应用后分类会被覆盖、标签会被追加。
|
||
|
||
## AI 智能记账
|
||
|
||
「智能记账」弹窗提供**文字记账**与**图片记账**两种方式。
|
||
|
||
|
||
|
||
- **文字记账**：用一句话描述一笔收支，例如「昨天中午吃饭 35 支付宝」，AI 会解析为类型、金额、分类、交易渠道、时间、备注、标签等字段，并预填到新增记录表单，确认后保存。
|
||
- **图片记账**：上传一至多张账单或支付截图（也可 `Ctrl+V` 粘贴），AI 实时识别其中的每一笔交易，生成可编辑的记录列表，勾选后批量导入。
|
||
|
||
再次打开弹窗会记住上次使用的记账方式。图片记账的用法与限制详见 [AI 能力 → 图片记账](/guide/ai#图片记账)。
|
||
|
||
## 手动添加记录
|
||
|
||
1. 在收支记录页右上角点击「**新增记录**」。
|
||
2. 在弹窗中填写表单：
|
||
|
||
| 字段 | 说明 |
|
||
|---|---|
|
||
| 类型 | 支出 / 收入 |
|
||
| 分类 | 新增时必填 |
|
||
| 金额 | 大于 0 |
|
||
| 交易渠道 | 可选，含内置渠道与[自定义渠道](/guide/channels)；启用 AI 时可一键推荐或新建 |
|
||
| 交易时间 | 默认当前时间 |
|
||
| 备注 | 可选 |
|
||
| 标签 | 可选，可多选 |
|
||
| 计入统计 | 默认开启；关闭后不纳入统计 |
|
||
|
||
3. 点击「确定」保存。
|
||
|
||
|
||
|
||
## 编辑记录
|
||
|
||
在记录行点击「编辑」即可修改记录，弹窗字段与新增一致；编辑时允许不设置分类。
|
||
|
||
|
||
|
||
### 编辑时的 AI 辅助
|
||
|
||
启用 AI 后，编辑弹窗中的**分类**、**标签**与**交易渠道**旁会出现 AI 辅助按钮（与新增记录一致）：
|
||
|
||
| 按钮 | 作用 |
|
||
|---|---|
|
||
| 分类 · **AI 推荐** | 根据当前类型、金额、交易渠道、备注，从已有分类中推荐并填入 |
|
||
| 分类 · **AI 新建** | 根据当前账单信息生成新分类；确认「保存并选用」后创建并选中，若已存在同名同类型分类则直接选中 |
|
||
| 标签 · **AI 推荐** | 推荐已有标签并追加（自动去重） |
|
||
| 标签 · **AI 新建** | 生成新标签（含建议颜色），确认后创建并选中；同名标签直接选中 |
|
||
| 渠道 · **AI 推荐** | 根据当前类型、金额、渠道、备注，从已有渠道中推荐并填入 |
|
||
| 渠道 · **AI 新建** | 生成新渠道名称；确认「保存并选用」后创建并选中，同名渠道直接选中 |
|
||
|
||
|
||
|
||
> 「AI 新建」需先填写备注或金额，便于模型理解；生成结果会显示确认条，点击「保存并选用」才真正创建。
|
||
|
||
编辑完成后点击「确定」保存。其他 AI 能力（批量建议、智能记账、智能查询）见 [AI 能力](/guide/ai)。
|
||
|
||
::: tip 计入统计
|
||
「计入统计」用于区分真实消费与资金流转，建议**按账单来源**设置，避免多来源重复统计：
|
||
|
||
- **微信、支付宝**来源：默认**计入**（除非有特殊情况）。
|
||
- **其他**来源（银行、美团、淘宝、京东等）：默认**不计入**——这些渠道的扣款往往最终走微信/支付宝，重复计入会导致统计翻倍。
|
||
- **例外**：工资、奖金等明确收入应计入。
|
||
|
||
此外，借款、信用卡还款、账户间转账等资金流转也建议关闭该开关，避免统计失真。
|
||
:::
|