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 辅助截图,并放宽导航超时
This commit is contained in:
2026-09-21 22:19:55 +08:00
parent a4ae7ac979
commit d2e4a51f2b
20 changed files with 557 additions and 40 deletions
+22 -8
View File
@@ -12,6 +12,7 @@
| 一键设置 | 对当前表格展示的记录批量设置分类、计入统计与标签 |
| 批量删除 | 删除表格中勾选的记录 |
| 导入账单 | 打开账单导入弹窗 |
| 渠道管理 | 进入[交易渠道管理](/guide/channels)页,维护自定义渠道 |
| 导出 Excel | 按当前筛选条件导出 |
| 刷新 | 按当前筛选条件与页码重新加载列表 |
| 智能记账 | 用一句话描述收支,AI 解析后预填表单(需启用 AI) |
@@ -90,7 +91,7 @@
## 筛选与 AI 智能查询
**常用筛选**:类型、分类(含「未分类」)、日期范围、备注关键字、交易渠道。
**常用筛选**:类型、分类(含「未分类」)、日期范围、备注关键字、交易渠道。交易渠道下拉包含内置渠道与账号下的[自定义渠道](/guide/channels)。
**更多筛选**:标签(含「无标签」)、计入统计、金额区间。
@@ -105,19 +106,23 @@
## 表格与行操作
表格展示:交易时间、类型、分类、金额、交易渠道、备注、标签、计入统计开关与操作。
表格展示:交易时间、类型、分类、金额、交易渠道、备注、标签、来源图片、计入统计开关与操作。
- **备注隐藏**:可将敏感备注持久隐藏为 `******`,需要时临时「查看」或「取消隐藏」。
- **计入统计**:行内开关可直接切换;关闭后该记录不纳入月度统计(适合借款、转账等),行内会以删除线标示。
- **行操作**:编辑、查看「原始数据」(账单导入时的原始字段,以 JSON 展示)、删除。
- **来源图片**:图片记账生成的记录会显示「查看(N)」入口,弹窗内先加载缩略图,可按需「加载原图」查看对应截图。
- **行操作**:编辑、查看「原始数据」(账单导入或图片记账时的原始字段,以 JSON 展示)、删除。
![来源图片弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/source-images.png)
分页支持每页 10/20/50/100/200/500 条。
## 查看原始数据
账单导入时,系统会完整保留每笔交易在原始账单中的字段(以 JSON 存储)。在记录行点击「**原始数据**」即可查看,用于核对金额、交易状态、对方账号、交易类型等明细。
账单导入或图片记账时,系统会完整保留每笔交易在原始账单中的字段(以 JSON 存储)。在记录行点击「**原始数据**」即可查看,用于核对金额、交易状态、对方账号、交易类型等明细。
- 仅**账单导入**的记录有原始数据;**手动新增**的记录没有,该按钮不可用。
- **账单导入**记录保留原始账单行字段;**图片记账**记录保留模型从截图提取的原始字段。
- **手动新增**的记录没有原始数据,该按钮不可用。
- 原始数据是排查导入异常、核对账单的重要依据。
## 一键设置(批量设置)
@@ -137,10 +142,15 @@
## AI 智能记账
在「智能记账」弹窗中用自然语言描述一笔收支,例如「昨天中午吃饭 35 支付宝」,AI 会解析为类型、金额、分类、交易渠道、时间、备注、标签等字段,并预填到新增记录表单,确认后保存。
「智能记账」弹窗提供**文字记账**与**图片记账**两种方式。
![AI 智能记账弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-record.png)
- **文字记账**:用一句话描述一笔收支,例如「昨天中午吃饭 35 支付宝」,AI 会解析为类型、金额、分类、交易渠道、时间、备注、标签等字段,并预填到新增记录表单,确认后保存。
- **图片记账**:上传一至多张账单或支付截图(也可 `Ctrl+V` 粘贴),AI 实时识别其中的每一笔交易,生成可编辑的记录列表,勾选后批量导入。
再次打开弹窗会记住上次使用的记账方式。图片记账的用法与限制详见 [AI 能力 → 图片记账](/guide/ai#图片记账)。
## 手动添加记录
1. 在收支记录页右上角点击「**新增记录**」。
@@ -151,7 +161,7 @@
| 类型 | 支出 / 收入 |
| 分类 | 新增时必填 |
| 金额 | 大于 0 |
| 交易渠道 | 可选 |
| 交易渠道 | 可选,含内置渠道与[自定义渠道](/guide/channels);启用 AI 时可一键推荐或新建 |
| 交易时间 | 默认当前时间 |
| 备注 | 可选 |
| 标签 | 可选,可多选 |
@@ -169,7 +179,7 @@
### 编辑时的 AI 辅助
启用 AI 后,编辑弹窗中的**分类**与**标签**旁会出现 AI 辅助按钮(与新增记录一致):
启用 AI 后,编辑弹窗中的**分类**、**标签**与**交易渠道**旁会出现 AI 辅助按钮(与新增记录一致):
| 按钮 | 作用 |
|---|---|
@@ -177,6 +187,10 @@
| 分类 · **AI 新建** | 根据当前账单信息生成新分类;确认「保存并选用」后创建并选中,若已存在同名同类型分类则直接选中 |
| 标签 · **AI 推荐** | 推荐已有标签并追加(自动去重) |
| 标签 · **AI 新建** | 生成新标签(含建议颜色),确认后创建并选中;同名标签直接选中 |
| 渠道 · **AI 推荐** | 根据当前类型、金额、渠道、备注,从已有渠道中推荐并填入 |
| 渠道 · **AI 新建** | 生成新渠道名称;确认「保存并选用」后创建并选中,同名渠道直接选中 |
![编辑记录中的渠道 AI 辅助](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-channel-suggest.png)
> 「AI 新建」需先填写备注或金额,便于模型理解;生成结果会显示确认条,点击「保存并选用」才真正创建。