chore: 初始化文档站仓库

This commit is contained in:
2026-09-21 13:38:20 +08:00
commit a4ae7ac979
58 changed files with 4622 additions and 0 deletions
+193
View File
@@ -0,0 +1,193 @@
# 收支记录
「收支记录」页面用于查看和管理每一笔收入与支出。
![收支记录](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/transactions.png)
## 顶部操作
| 按钮 | 功能 |
|---|---|
| 排序 | 交易时间(新→旧 / 旧→新)、金额(高→低 / 低→高) |
| 一键设置 | 对当前表格展示的记录批量设置分类、计入统计与标签 |
| 批量删除 | 删除表格中勾选的记录 |
| 导入账单 | 打开账单导入弹窗 |
| 导出 Excel | 按当前筛选条件导出 |
| 刷新 | 按当前筛选条件与页码重新加载列表 |
| 智能记账 | 用一句话描述收支,AI 解析后预填表单(需启用 AI) |
| 新增记录 | 手动新增一笔记录 |
## 账单导入
「收支记录」页支持把支付宝、微信、美团、淘宝、京东、招商银行、交通银行的账单文件解析并导入为收支记录。
![导入账单弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/import-bill.png)
### 入口
| 入口 | 形式 | 说明 |
|---|---|---|
| 收支记录页「**导入账单**」按钮 | 弹窗 | 桌面端常用 |
| 通知邮件中的链接 `/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 中的导出路径。若上传的是**加密压缩包**,解析时会弹出密码输入框,输入后重新解析。
**第二步:解析预览**
![账单解析预览](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/bill-parse-preview.png)
- **默认归类**:可为本次导入设置默认的支出分类、收入分类与默认标签。
- **筛选**:关键字、类型(收入/支出/不计入)、状态(可导入/已存在/不可导入)、金额区间。
- **逐行勾选**:默认勾选解析器建议的行;只有「可导入」的行可勾选。
- **计入统计**:可对勾选行批量「设为计入 / 设为不计入」,建议按来源设置(见下)。
- **预览列**:交易时间、类型、计入统计、金额、交易对方、商品名称、状态、**匹配规则与建议**。
::: tip 按来源设置计入统计
- **微信、支付宝**来源默认**计入**;**其他**来源(银行、美团、淘宝、京东等)默认**不计入**——它们往往最终走微信/支付宝支付。
- **例外**:工资、奖金等明确收入应计入。
:::
::: tip 去重
系统按「用户 + 交易号」去重。已存在于系统中的交易会标记为「已存在」,默认不勾选,避免重复导入。
:::
**第三步:导入结果**
显示成功、跳过、失败的数量与明细消息。完成后可在下方表格中查看。
### 常见问题
- **解析失败**:确认账单类型与文件格式是否匹配;银行账单请使用系统支持的导出格式。
- **需要解压密码**:部分账单压缩包在导出时设置了密码,需在解析时输入。
- **部分行不可导入**:可能是金额/时间字段无法解析,或该交易号已存在。
- **重复导入**:同一账单重复导入时,已存在的交易会被跳过。
## 筛选与 AI 智能查询
**常用筛选**:类型、分类(含「未分类」)、日期范围、备注关键字、交易渠道。
**更多筛选**:标签(含「无标签」)、计入统计、金额区间。
启用 AI 后,顶部会出现 **AI 智能查询**输入框,可用自然语言查询,例如:
- 「上个月餐饮」
- 「超过500的支出」
- 「待报销的支出」
- 「微信支付」
解析结果会直接应用为筛选条件并立即查询。筛选条件与每页条数、排序方式会自动记忆,下次进入自动还原。
## 表格与行操作
表格展示:交易时间、类型、分类、金额、交易渠道、备注、标签、计入统计开关与操作。
- **备注隐藏**:可将敏感备注持久隐藏为 `******`,需要时临时「查看」或「取消隐藏」。
- **计入统计**:行内开关可直接切换;关闭后该记录不纳入月度统计(适合借款、转账等),行内会以删除线标示。
- **行操作**:编辑、查看「原始数据」(账单导入时的原始字段,以 JSON 展示)、删除。
分页支持每页 10/20/50/100/200/500 条。
## 查看原始数据
账单导入时,系统会完整保留每笔交易在原始账单中的字段(以 JSON 存储)。在记录行点击「**原始数据**」即可查看,用于核对金额、交易状态、对方账号、交易类型等明细。
- 仅**账单导入**的记录有原始数据;**手动新增**的记录没有,该按钮不可用。
- 原始数据是排查导入异常、核对账单的重要依据。
## 一键设置(批量设置)
对**当前表格展示的记录**批量操作:
![一键设置弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/batch-set.png)
- 设置支出分类 / 收入分类。
- 设置是否计入统计。
- 添加标签 / 移除标签。
- 启用 AI 时,可选择建议范围(分类与标签 / 仅分类 / 仅标签)并点击「AI 智能建议」,由 AI 生成建议后进入 AI 建议弹窗。
## AI 建议弹窗
展示每条记录的建议分类、建议标签与理由,默认全选,可逐条取消。若建议中包含系统中不存在的分类或标签,会以「新建」标记,确认后自动创建。应用后分类会被覆盖、标签会被追加。
## AI 智能记账
在「智能记账」弹窗中用自然语言描述一笔收支,例如「昨天中午吃饭 35 支付宝」,AI 会解析为类型、金额、分类、交易渠道、时间、备注、标签等字段,并预填到新增记录表单,确认后保存。
![AI 智能记账弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-record.png)
## 手动添加记录
1. 在收支记录页右上角点击「**新增记录**」。
2. 在弹窗中填写表单:
| 字段 | 说明 |
|---|---|
| 类型 | 支出 / 收入 |
| 分类 | 新增时必填 |
| 金额 | 大于 0 |
| 交易渠道 | 可选 |
| 交易时间 | 默认当前时间 |
| 备注 | 可选 |
| 标签 | 可选,可多选 |
| 计入统计 | 默认开启;关闭后不纳入统计 |
3. 点击「确定」保存。
![新增记录弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/add-record.png)
## 编辑记录
在记录行点击「编辑」即可修改记录,弹窗字段与新增一致;编辑时允许不设置分类。
![编辑记录弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/edit-record.png)
### 编辑时的 AI 辅助
启用 AI 后,编辑弹窗中的**分类**与**标签**旁会出现 AI 辅助按钮(与新增记录一致):
| 按钮 | 作用 |
|---|---|
| 分类 · **AI 推荐** | 根据当前类型、金额、交易渠道、备注,从已有分类中推荐并填入 |
| 分类 · **AI 新建** | 根据当前账单信息生成新分类;确认「保存并选用」后创建并选中,若已存在同名同类型分类则直接选中 |
| 标签 · **AI 推荐** | 推荐已有标签并追加(自动去重) |
| 标签 · **AI 新建** | 生成新标签(含建议颜色),确认后创建并选中;同名标签直接选中 |
> 「AI 新建」需先填写备注或金额,便于模型理解;生成结果会显示确认条,点击「保存并选用」才真正创建。
编辑完成后点击「确定」保存。其他 AI 能力(批量建议、智能记账、智能查询)见 [AI 能力](/guide/ai)。
::: tip 计入统计
「计入统计」用于区分真实消费与资金流转,建议**按账单来源**设置,避免多来源重复统计:
- **微信、支付宝**来源:默认**计入**(除非有特殊情况)。
- **其他**来源(银行、美团、淘宝、京东等):默认**不计入**——这些渠道的扣款往往最终走微信/支付宝,重复计入会导致统计翻倍。
- **例外**:工资、奖金等明确收入应计入。
此外,借款、信用卡还款、账户间转账等资金流转也建议关闭该开关,避免统计失真。
:::