rosercode
d94d4e1ed5
同步近期 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 长期地址引用。
97 lines
4.7 KiB
Markdown
97 lines
4.7 KiB
Markdown
# 规则管理
|
|
|
|
规则用于**自动归类**：命中条件后自动应用指定的分类与标签，减少手动整理。
|
|
|
|
|
|
|
|
## 创建规则
|
|
|
|
1. 在规则管理页右上角点击「**新增规则**」。
|
|
2. 填写规则名称，并按需设置条件与结果：
|
|
|
|
| 字段 | 说明 |
|
|
|---|---|
|
|
| 类型 | 不限类型 / 支出 / 收入 |
|
|
| 关键词 | 匹配备注、交易对方、商品名称（包含即命中） |
|
|
| 金额区间 | 最小值 ~ 最大值（可只填一端） |
|
|
| 目标分类 | 命中后应用的分类 |
|
|
| 目标标签 | 命中后应用的标签（可多选） |
|
|
| 启用 / 排序 | 是否启用、优先级（越小越优先） |
|
|
|
|
3. 点击「确定」保存。
|
|
|
|
|
|
|
|
## 规则条件
|
|
|
|
一条规则可组合以下条件：
|
|
|
|
| 条件 | 说明 |
|
|
|---|---|
|
|
| 类型 | 不限类型 / 支出 / 收入 |
|
|
| 关键词 | 匹配备注、交易对方、商品名称，**包含即命中**（忽略大小写） |
|
|
| 金额区间 | 最小值 ~ 最大值（含边界，可只填一端） |
|
|
| 目标分类 | 命中后应用的分类（可不选） |
|
|
| 目标标签 | 命中后应用的标签（多选，可不选） |
|
|
| 优先级 | 排序值越小越优先 |
|
|
| 启用 | 可随时启用或停用 |
|
|
|
|
## 命中规则
|
|
|
|
- **分类**：取优先级最高（排序值最小）且与交易类型一致的命中规则。
|
|
- **标签**：取所有命中规则标签的并集。
|
|
- 规则在**账单导入的解析预览阶段**即会展示命中的规则名与建议分类/标签；确认导入时，**规则建议的分类优先于面板默认分类**，标签与默认标签合并去重。
|
|
|
|
## 搜索与分页
|
|
|
|
规则列表支持按条件检索与分页：
|
|
|
|
- **搜索**：按**规则名称或关键词**模糊匹配。
|
|
- **筛选**：**启用状态**（已启用 / 已停用）、**收支类型**（收入 / 支出）。
|
|
- **分页**：每页 10 / 20 / 50 / 100 条。
|
|
|
|
点击「搜索」按条件查询，「清空」重置全部条件。新增规则后回到第一页，便于查看新规则。
|
|
|
|
## 多选与批量删除
|
|
|
|
规则列表每行前都有勾选框，表头可**全选当前页**：
|
|
|
|
- 勾选若干规则后，点右上角「**批量删除**」并确认，即可一次性删除选中的规则。
|
|
- 未勾选任何规则时「批量删除」不可点击。
|
|
|
|
> 删除规则只影响后续导入时的自动归类，已应用的历史记录分类与标签不会被撤销。
|
|
|
|
## AI 生成规则
|
|
|
|
启用 AI 后，规则管理页右上角会出现「**AI 生成规则**」按钮，可让 AI 依据**已打标签的记录**自动归纳出「关键词 → 分类/标签」规则，无需手工逐条编写。
|
|
|
|
流程为两步：
|
|
|
|
1. **选择记录**：列出当前用户**已打标签**的记录，默认全选当前页。可按**备注关键字**搜索，并按**收支类型、标签**筛选；支持分页与每页条数切换，可「全选本页」或「清空选择」。跨页选择会保留。
|
|
|
|
|
|
|
|
2. **预览规则**：AI 依据所选记录的**类型、备注、交易渠道、已有分类与标签**归纳出规则建议，展示规则名称、关键词、目标分类与标签、理由。名称与关键词可编辑，勾选后点击「创建勾选规则」批量创建；系统会自动创建建议中不存在的新分类与标签。
|
|
|
|
|
|
|
|
> 此外，也可在[收支记录页的批量操作区](/guide/transactions#ai-生成规则从勾选账单)勾选账单后直接生成规则（不要求已打标签），并可选「同时应用到勾选账单」。
|
|
|
|
::: tip 与已有规则去重
|
|
AI 建议若与**数据库中已有规则重复**（按「类型 + 关键词 + 分类 + 标签集合」判定），会标注「**已存在**」，**默认不勾选且不可勾选**，无法导入，避免产生重复规则。
|
|
:::
|
|
|
|
## 示例
|
|
|
|
| 规则名 | 条件 | 结果 |
|
|
|---|---|---|
|
|
| 星巴克归入餐饮 | 关键词「星巴克」、类型支出 | 分类：餐饮；标签：咖啡 |
|
|
| 滴滴出行归入交通 | 关键词「滴滴」、类型支出 | 分类：交通 |
|
|
| 大额支出标记 | 金额 ≥ 500、类型支出 | 标签：大额消费 |
|
|
|
|
## 使用建议
|
|
|
|
- 先建立少量高频规则（餐饮、交通、外卖等），再逐步补充。
|
|
- 关键词尽量选择稳定、唯一的商户或商品名，避免误命中。
|
|
- 同一笔记录可能命中多条规则，分类取最优先的一条，标签会全部应用。
|