chore: 初始化文档站仓库

2026-09-21 13:38:20 +08:00
commit a4ae7ac979
58 changed files with 4622 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 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，结果更确定、可预期。