docs: 补充收支记录页 AI 生成规则、CORS/反向代理与邮箱检查进度时间戳
同步近期 ledgerly 功能与配置变更到文档站：新增收支记录页「AI 生成规则」入口的用户与开发说明、补充新接口与规则应用逻辑、修正 CORS/反向代理与运行环境编码说明，并更新邮箱检查进度时间戳描述。 变更内容： - guide/transactions.md 批量操作区新增「AI 生成规则」按钮与「AI 生成规则（从勾选账单）」小节（含「同时应用到勾选账单」），引用新截图。 - guide/ai.md、guide/rules.md、guide/pages.md 补充两处生成入口与「同时应用」说明。 - dev/api.md 新增 POST /api/ai/rule/apply-transactions；dev/rule-engine.md、dev/ai.md 补充 applyToTransactions 与两个生成入口。 - dev/build-deploy.md 将 CORS 更新为放开全部来源并信任反向代理转发头，新增运行环境 UTF-8 locale 说明。 - guide/email-bills.md 补充「立即检查」进度每行带 HH:mm:ss 时间戳。 - scripts/ts/capture-elements.ts 新增 captureAiRuleFromTransactions 截图场景（交易页 AI 生成规则弹窗）。 说明： - 新截图 elements/ai-rule-transactions.png 已上传 OSS，正文以 OSS 长期地址引用。
This commit is contained in:
+7
-2
@@ -51,7 +51,7 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
|
||||
| 生成渠道 | 新增/编辑记录 → 交易渠道 → AI 新建 | 由账单描述生成渠道名称并创建 |
|
||||
| 推荐 Emoji | 分类管理 → AI 推荐 | 为分类推荐 Emoji 图标 |
|
||||
| 推荐颜色 | 标签管理 → AI 推荐 | 为标签推荐颜色 |
|
||||
| 生成规则 | 规则管理 → AI 生成规则 | 由已打标签的记录归纳分类与标签规则 |
|
||||
| 生成规则 | 规则管理 → AI 生成规则（已打标签记录）／收支记录 → 批量操作 → AI 生成规则（勾选账单） | 由所选记录归纳分类与标签规则，可同时应用到勾选账单 |
|
||||
| 统计搜索 | 统计面板 → AI 搜索 | 自然语言解析为统计筛选条件与维度 |
|
||||
| 生成关系名称 | 收支记录 → 账单关系 → AI 生成 | 依据关联账单的类型、渠道、分类与备注生成关系名称与备注 |
|
||||
| 智能查数 | 左侧菜单 → 智能查数 | 自然语言转只读 SQL 查询并展示结果 |
|
||||
@@ -114,7 +114,12 @@ API Key 仅保存在本地数据库中，仅用于向你配置的接口地址发
|
||||
|
||||
## AI 生成规则
|
||||
|
||||
在规则管理页点「AI 生成规则」，选择用于归纳的**已打标签记录**（默认全选当前页，支持搜索、筛选与分页），AI 会依据这些记录的**类型、备注、交易渠道、已有分类与标签**生成规则建议，预览编辑后批量创建。与已有规则重复的建议会标记「已存在」并禁止导入。详见[规则管理](/guide/rules)。
|
||||
有两种生成方式：
|
||||
|
||||
- **规则管理页**：点「AI 生成规则」，选择用于归纳的**已打标签记录**（默认全选当前页，支持搜索、筛选与分页），AI 依据这些记录的**类型、备注、交易渠道、已有分类与标签**生成规则建议，预览编辑后批量创建。
|
||||
- **收支记录页**：在**批量操作**区勾选若干账单后点「AI 生成规则」，直接以**勾选的账单**为依据归纳规则（不要求已打标签）；弹窗中还可勾选「**同时应用到当前勾选的账单**」，命中时覆盖这些账单的分类并追加标签。
|
||||
|
||||
两种方式都会对与已有规则重复的建议标记「已存在」并禁止导入。详见[规则管理](/guide/rules#ai-生成规则)与[收支记录](/guide/transactions#ai-生成规则从勾选账单)。
|
||||
|
||||
## 用量统计
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@
|
||||
行操作：
|
||||
|
||||
- **测试连接**：验证 IMAP 配置。
|
||||
- **立即检查**：实时展示检查进度，完成后提示新增待处理账单数量。
|
||||
- **立即检查**：实时展示检查进度（每行带 `HH:mm:ss` 时间戳），完成后提示新增待处理账单数量。
|
||||
- **编辑 / 删除**。
|
||||
|
||||
## 发件人规则
|
||||
|
||||
+1
-1
@@ -57,7 +57,7 @@
|
||||
- **智能查数**：左侧菜单「智能查数」→ 输入自然语言 → 查看结果、生成的 SQL 与历史提问
|
||||
- **自动归类**：规则管理配置规则 → 账单导入预览时命中并给出建议
|
||||
- **邮箱账单**：邮箱配置 → 发件人规则 → 待处理账单 → 解析 → 导入到收支记录
|
||||
- **AI 辅助**：设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
|
||||
- **AI 辅助**：设置启用 AI → 统计面板「AI 搜索」、收支记录「一键设置 / 文字·图片记账 / AI 查询」、编辑记录「分类·标签·渠道 AI 推荐与新建」、分类与标签「AI 推荐」、规则管理「AI 生成规则」、收支记录批量操作「AI 生成规则」、账单关系「AI 生成」、左侧「智能查数」
|
||||
- **系统维护**：顶部菜单 → 设置 / 日志
|
||||
|
||||
## 页面关系说明
|
||||
|
||||
@@ -75,6 +75,8 @@
|
||||
|
||||
|
||||
|
||||
> 此外，也可在[收支记录页的批量操作区](/guide/transactions#ai-生成规则从勾选账单)勾选账单后直接生成规则（不要求已打标签），并可选「同时应用到勾选账单」。
|
||||
|
||||
::: tip 与已有规则去重
|
||||
AI 建议若与**数据库中已有规则重复**（按「类型 + 关键词 + 分类 + 标签集合」判定），会标注「**已存在**」，**默认不勾选且不可勾选**，无法导入，避免产生重复规则。
|
||||
:::
|
||||
|
||||
@@ -27,9 +27,20 @@
|
||||
| 一键设置 | 批量设置分类、计入统计与标签；**有勾选时作用于勾选记录，未勾选时作用于当前页全部记录**，详见[一键设置（批量设置）](#一键设置-批量设置) |
|
||||
| 批量删除 | 勾选至少一条后出现，确认后删除所选记录 |
|
||||
| 建立关系 | 勾选至少两条后出现，为所选记录[建立账单关系](/guide/relations) |
|
||||
| AI 生成规则 | 启用 AI 后出现；勾选至少一条账单，由 AI 归纳分类/标签规则，可在弹窗中勾选「同时应用到当前勾选的账单」，详见 [AI 生成规则](#ai-生成规则从勾选账单) |
|
||||
|
||||
> 翻页、刷新或退出批量模式都会清空已勾选记录。**批量删除**与**建立关系**只作用于勾选记录；**一键设置**在未勾选时才作用于当前页全部记录，且当次勾选范围以打开弹窗时的选择为准。
|
||||
|
||||
## AI 生成规则（从勾选账单）
|
||||
|
||||
启用 AI 后，批量操作区会出现「**AI 生成规则**」按钮。勾选若干账单后点击，AI 会依据这些账单的**类型、备注、交易渠道、已有分类与标签**归纳出「关键词 → 分类/标签」规则；在弹窗中预览、勾选要创建的规则后点击「创建勾选规则」批量创建，系统会自动创建建议中不存在的新分类与标签。
|
||||
|
||||
弹窗底部可勾选「**同时应用到当前勾选的 N 条账单**」——命中规则时会**覆盖这些账单的分类并追加标签**（不改动备注与金额）。生成与「同时应用」全程不发送金额、原始账单数据等敏感字段。
|
||||
|
||||
|
||||
|
||||
> 与[规则管理](/guide/rules#ai-生成规则)页的「AI 生成规则」（依据**已打标签记录**归纳）不同，此入口直接以**勾选的账单**为依据，不要求已打标签；两处都会对与已有规则重复的建议标记「已存在」并禁止导入。
|
||||
|
||||
## 账单导入
|
||||
|
||||
「收支记录」页支持把支付宝、微信、美团、淘宝、京东、招商银行、交通银行的账单文件解析并导入为收支记录。
|
||||
|
||||
Reference in New Issue
Block a user