Files

T

rosercode d94d4e1ed5 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 长期地址引用。

2026-10-13 22:39:40 +08:00

4.7 KiB

Raw Blame History

规则管理

规则用于自动归类：命中条件后自动应用指定的分类与标签，减少手动整理。

创建规则

在规则管理页右上角点击「新增规则」。

填写规则名称，并按需设置条件与结果：

字段	说明
类型	不限类型 / 支出 / 收入
关键词	匹配备注、交易对方、商品名称（包含即命中）
金额区间	最小值 ~ 最大值（可只填一端）
目标分类	命中后应用的分类
目标标签	命中后应用的标签（可多选）
启用 / 排序	是否启用、优先级（越小越优先）

点击「确定」保存。

规则条件

一条规则可组合以下条件：

条件	说明
类型	不限类型 / 支出 / 收入
关键词	匹配备注、交易对方、商品名称，包含即命中（忽略大小写）
金额区间	最小值 ~ 最大值（含边界，可只填一端）
目标分类	命中后应用的分类（可不选）
目标标签	命中后应用的标签（多选，可不选）
优先级	排序值越小越优先
启用	可随时启用或停用

命中规则

分类：取优先级最高（排序值最小）且与交易类型一致的命中规则。
标签：取所有命中规则标签的并集。
规则在账单导入的解析预览阶段即会展示命中的规则名与建议分类/标签；确认导入时，规则建议的分类优先于面板默认分类，标签与默认标签合并去重。

搜索与分页

规则列表支持按条件检索与分页：

搜索：按规则名称或关键词模糊匹配。
筛选：启用状态（已启用 / 已停用）、收支类型（收入 / 支出）。
分页：每页 10 / 20 / 50 / 100 条。

点击「搜索」按条件查询，「清空」重置全部条件。新增规则后回到第一页，便于查看新规则。

多选与批量删除

规则列表每行前都有勾选框，表头可全选当前页：

勾选若干规则后，点右上角「批量删除」并确认，即可一次性删除选中的规则。
未勾选任何规则时「批量删除」不可点击。

删除规则只影响后续导入时的自动归类，已应用的历史记录分类与标签不会被撤销。

AI 生成规则

启用 AI 后，规则管理页右上角会出现「AI 生成规则」按钮，可让 AI 依据已打标签的记录自动归纳出「关键词 → 分类/标签」规则，无需手工逐条编写。

流程为两步：

选择记录：列出当前用户已打标签的记录，默认全选当前页。可按备注关键字搜索，并按收支类型、标签筛选；支持分页与每页条数切换，可「全选本页」或「清空选择」。跨页选择会保留。
预览规则：AI 依据所选记录的类型、备注、交易渠道、已有分类与标签归纳出规则建议，展示规则名称、关键词、目标分类与标签、理由。名称与关键词可编辑，勾选后点击「创建勾选规则」批量创建；系统会自动创建建议中不存在的新分类与标签。

此外，也可在收支记录页的批量操作区勾选账单后直接生成规则（不要求已打标签），并可选「同时应用到勾选账单」。

::: tip 与已有规则去重 AI 建议若与数据库中已有规则重复（按「类型 + 关键词 + 分类 + 标签集合」判定），会标注「已存在」，默认不勾选且不可勾选，无法导入，避免产生重复规则。 :::

示例

规则名	条件	结果
星巴克归入餐饮	关键词「星巴克」、类型支出	分类：餐饮；标签：咖啡
滴滴出行归入交通	关键词「滴滴」、类型支出	分类：交通
大额支出标记	金额 ≥ 500、类型支出	标签：大额消费

使用建议

先建立少量高频规则（餐饮、交通、外卖等），再逐步补充。
关键词尽量选择稳定、唯一的商户或商品名，避免误命中。
同一笔记录可能命中多条规则，分类取最优先的一条，标签会全部应用。

4.7 KiB Raw Blame History Unescape Escape