Files
ledgerly-docs/guide/ai.md
T

96 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AI 能力
系统集成 **DeepSeek** 大模型,在分类打标、查询、记账等环节提供智能辅助。所有 AI 功能需先在「系统设置 → AI 模型配置」中启用并配置 API Key。
## 数据与隐私
系统仅向大模型发送完成功能所需的**最小字段**,**不会上传任何敏感数据**。所有 AI 请求均由你自行配置的接口地址发起。
**不会发送**:
- 账单导入的原始数据(`rawData`,可能含交易对方、商品名、订单号、对方账户/卡号等);
- 金额;
- 交易号、账户/卡号、姓名、地址、电话等可识别个人或账户的信息。
**实际发送**(按功能所需最小化):
- 分类/标签建议:记录的收支类型、备注、交易渠道;
- 智能查询 / 统计:你输入的自然语言,以及分类与标签名称;
- 智能记账:你输入的一句话;
- 生成分类/标签、推荐 Emoji/颜色:你输入的名称或描述;
- 生成规则:所选记录的类型、备注、交易渠道、已有分类与标签(不含金额与原始账单数据)。
API Key 仅保存在本地数据库中,仅用于向你配置的接口地址发起请求,不会随上述数据一并外发。
## 配置
在「系统设置 → AI 模型配置」中:
- 开启「启用 AI 建议」。
- 填写 **API Key**。
- 可选修改 **接口地址**(默认 `https://api.deepseek.com`)与**模型**(默认 `deepseek-chat`)。
- 点击「测试连接」验证配置。
![系统设置](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/settings.png)
## 功能一览
| 功能 | 入口 | 说明 |
|---|---|---|
| 分类/标签建议 | 收支记录 → 一键设置 → AI 智能建议 | 对当前页记录批量建议分类与标签,可一键采纳 |
| 单条建议 | 新增/编辑记录 → AI 推荐 | 推荐已有分类或标签 |
| 智能查询 | 收支记录 → AI 智能查询 | 自然语言解析为筛选条件 |
| 智能记账 | 收支记录 → 智能记账 | 一句话解析为一笔记录 |
| 生成分类 | 分类管理 → AI 生成 | 由用途描述生成分类 |
| 推荐 Emoji | 分类管理 → AI 推荐 | 为分类推荐 Emoji 图标 |
| 推荐颜色 | 标签管理 → AI 推荐 | 为标签推荐颜色 |
| 生成规则 | 规则管理 → AI 生成规则 | 由已打标签的记录归纳分类与标签规则 |
| 统计搜索 | 统计面板 → AI 搜索 | 自然语言解析为统计筛选条件与维度 |
## 分类与标签建议
在收支记录页点「一键设置」,选择建议范围(分类与标签 / 仅分类 / 仅标签)后点「AI 智能建议」。系统会按记录的类型、备注、交易渠道等聚合后请求模型,返回建议并进入 AI 建议弹窗。
弹窗中每条记录展示建议分类、建议标签与理由,默认全选。若建议了系统中不存在的分类或标签,会以「新建」标记,确认后自动创建。应用时分类会被覆盖、标签会被追加。
## 智能查询
在收支记录页的 AI 查询框中输入自然语言,例如:
- 「上个月餐饮」→ 时间范围 + 分类
- 「超过500的支出」→ 类型 + 金额区间
- 「待报销的支出」→ 标签 + 类型
- 「微信支付」→ 交易渠道
解析结果会直接应用为筛选条件并立即查询。
## 智能记账
在「智能记账」弹窗中描述一笔收支,AI 解析出类型、金额、分类、交易渠道、时间、备注、标签等字段,并预填到新增记录表单,确认后保存。
![AI 智能记账弹窗](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/elements/ai-record.png)
## AI 统计搜索
在统计面板顶部的 AI 搜索框中用一句自然语言描述统计意图,例如「上个月餐饮花了多少」「近半年交通支出趋势,按周看」。系统会解析为**时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径与趋势粒度**并自动回填、刷新图表。详见[统计面板](/guide/dashboard)。
## AI 生成规则
在规则管理页点「AI 生成规则」,选择用于归纳的**已打标签记录**(默认全选当前页,支持搜索、筛选与分页),AI 会依据这些记录的**类型、备注、交易渠道、已有分类与标签**生成规则建议,预览编辑后批量创建。与已有规则重复的建议会标记「已存在」并禁止导入。详见[规则管理](/guide/rules)。
## 用量统计
「模型使用情况」页面(系统设置 → AI 模型配置 →「使用情况」)展示 AI 调用汇总与明细。
![模型使用情况](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/ai-usage.png)
- **调用概览**:调用次数、成功、失败、总 Token。
- **Token 明细**:输入 Token、输出 Token、缓存命中。
- **最近调用记录**:时间、类型、分析条数、Token、耗时、状态。
## 说明
- AI 建议结果仅供参考,应用前可逐条取消勾选。
- 关闭「启用 AI 建议」后,系统不会发起任何 AI 请求,相关入口也会隐藏。
- 账单类型识别(邮箱账单)使用的是**发件人规则**而非 AI,结果更确定、可预期。