Files
ledgerly-docs/guide/ai.md
T

5.1 KiB
Raw Blame History

AI 能力

系统集成 DeepSeek 大模型,在分类打标、查询、记账等环节提供智能辅助。所有 AI 功能需先在「系统设置 → AI 模型配置」中启用并配置 API Key。

数据与隐私

系统仅向大模型发送完成功能所需的最小字段,不会上传任何敏感数据。所有 AI 请求均由你自行配置的接口地址发起。

不会发送:

  • 账单导入的原始数据(rawData,可能含交易对方、商品名、订单号、对方账户/卡号等);
  • 金额;
  • 交易号、账户/卡号、姓名、地址、电话等可识别个人或账户的信息。

实际发送(按功能所需最小化):

  • 分类/标签建议:记录的收支类型、备注、交易渠道;
  • 智能查询 / 统计:你输入的自然语言,以及分类与标签名称;
  • 智能记账:你输入的一句话;
  • 生成分类/标签、推荐 Emoji/颜色:你输入的名称或描述;
  • 生成规则:所选记录的类型、备注、交易渠道、已有分类与标签(不含金额与原始账单数据)。

API Key 仅保存在本地数据库中,仅用于向你配置的接口地址发起请求,不会随上述数据一并外发。

配置

在「系统设置 → AI 模型配置」中:

  • 开启「启用 AI 建议」。
  • 填写 API Key。
  • 可选修改 接口地址(默认 https://api.deepseek.com)与模型(默认 deepseek-chat)。
  • 点击「测试连接」验证配置。

系统设置

功能一览

功能 入口 说明
分类/标签建议 收支记录 → 一键设置 → AI 智能建议 对当前页记录批量建议分类与标签,可一键采纳
单条建议 新增/编辑记录 → AI 推荐 推荐已有分类或标签
智能查询 收支记录 → AI 智能查询 自然语言解析为筛选条件
智能记账 收支记录 → 智能记账 一句话解析为一笔记录
生成分类 分类管理 → AI 生成 由用途描述生成分类
推荐 Emoji 分类管理 → AI 推荐 为分类推荐 Emoji 图标
推荐颜色 标签管理 → AI 推荐 为标签推荐颜色
生成规则 规则管理 → AI 生成规则 由已打标签的记录归纳分类与标签规则
统计搜索 统计面板 → AI 搜索 自然语言解析为统计筛选条件与维度

分类与标签建议

在收支记录页点「一键设置」,选择建议范围(分类与标签 / 仅分类 / 仅标签)后点「AI 智能建议」。系统会按记录的类型、备注、交易渠道等聚合后请求模型,返回建议并进入 AI 建议弹窗。

弹窗中每条记录展示建议分类、建议标签与理由,默认全选。若建议了系统中不存在的分类或标签,会以「新建」标记,确认后自动创建。应用时分类会被覆盖、标签会被追加。

智能查询

在收支记录页的 AI 查询框中输入自然语言,例如:

  • 「上个月餐饮」→ 时间范围 + 分类
  • 「超过500的支出」→ 类型 + 金额区间
  • 「待报销的支出」→ 标签 + 类型
  • 「微信支付」→ 交易渠道

解析结果会直接应用为筛选条件并立即查询。

智能记账

在「智能记账」弹窗中描述一笔收支,AI 解析出类型、金额、分类、交易渠道、时间、备注、标签等字段,并预填到新增记录表单,确认后保存。

AI 智能记账弹窗

AI 统计搜索

在统计面板顶部的 AI 搜索框中用一句自然语言描述统计意图,例如「上个月餐饮花了多少」「近半年交通支出趋势,按周看」。系统会解析为时间范围、收支类型、分类、标签、交易渠道、金额区间、备注、统计口径与趋势粒度并自动回填、刷新图表。详见统计面板。

AI 生成规则

在规则管理页点「AI 生成规则」,选择用于归纳的已打标签记录(默认全选当前页,支持搜索、筛选与分页),AI 会依据这些记录的类型、备注、交易渠道、已有分类与标签生成规则建议,预览编辑后批量创建。与已有规则重复的建议会标记「已存在」并禁止导入。详见规则管理。

用量统计

「模型使用情况」页面(系统设置 → AI 模型配置 →「使用情况」)展示 AI 调用汇总与明细。

模型使用情况

  • 调用概览:调用次数、成功、失败、总 Token。
  • Token 明细:输入 Token、输出 Token、缓存命中。
  • 最近调用记录:时间、类型、分析条数、Token、耗时、状态。

说明

  • AI 建议结果仅供参考,应用前可逐条取消勾选。
  • 关闭「启用 AI 建议」后,系统不会发起任何 AI 请求,相关入口也会隐藏。
  • 账单类型识别(邮箱账单)使用的是发件人规则而非 AI,结果更确定、可预期。