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

dev/ai.md

@@ -89,11 +89,12 @@
 
 ## 规则生成
 
-`AiRuleServiceImpl` 由用户勾选的**已打标签记录**反推分类/标签规则：
+`AiRuleServiceImpl` 由用户勾选的记录反推分类/标签规则，有两个入口：规则管理页（依据**已打标签记录**）与收支记录页批量操作（依据**任意勾选账单**）：
 
-- 仅加载属于当前用户且被勾选的记录（单次 ≤ 500 条），附带其标签名称与分类名；提示词字段为 `type / remark / channel / category / tags`（不含金额与 `rawData`），并对相同组合去重。
+- 仅加载属于当前用户且被勾选的记录（单次 ≤ 500 条），附带其标签名称与分类名；提示词字段为 `type / remark / channel / category / tags`（不含金额与 `rawData`），并对相同「类型 + 备注 + 渠道 + 标签」组合去重。
 - 解析并校验模型输出（分类 ID 归属与类型、标签归属、名称长度、颜色格式等）。
 - **去重**：按「类型 + 归一化关键词 + 分类 + 排序标签集合」计算签名；与已有规则或本次建议内部重复的条目标记 `duplicate=true`（前端默认不勾选且禁止导入），`apply` 时后端再次校验并跳过。
+- **应用到交易**：`POST /api/ai/rule/apply-transactions`（`applyToTransactions`）按传入规则对指定交易做**本地匹配**（不调用大模型、不外发数据），命中时覆盖分类、追加标签，必要时新建分类/标签；用于收支记录页勾选「同时应用到账单」的场景。
 
 ## 统计搜索
 

dev/api.md

@@ -79,6 +79,7 @@
 | DELETE | `/api/rule/batch` | 批量删除规则（body `{ ids }`，返回实际删除数） |
 | POST | `/api/ai/rule/suggest` | 依据所选已打标签记录生成规则建议（含 `duplicate` 标记） |
 | POST | `/api/ai/rule/apply` | 批量创建规则（自动去重、按需新建分类/标签） |
+| POST | `/api/ai/rule/apply-transactions` | 按传入规则对指定交易做本地匹配并应用（命中则覆盖分类、追加标签，必要时新建；纯本地匹配，不外发数据） |
 | POST | `/api/ai/statistics` | 自然语言解析为统计面板参数 |
 | GET / PUT | `/api/setting/excluded-display-style` | 查询 / 更新「不计入统计」记录展示样式 |
 | GET / PUT | `/api/setting/show-hidden-data` | 查询 / 更新是否显示已隐藏备注的记录 |

dev/build-deploy.md

@@ -122,7 +122,9 @@ jar 内置的前端为生产构建，访问时与后端同源，无需额外的
 ### 安全配置
 
 - **JWT 签名密钥**：默认使用内置密钥签发 Token（有效期 24 小时）；生产环境可通过环境变量 `JWT_SECRET` 覆盖，未配置时回退内置默认值，避免个人自托管场景重启后登录态失效。
-- **CORS 放行来源**：仅放行本机与局域网来源——`localhost`、`127.0.0.1`、`[::1]`、`192.168.*`、`10.*`、`172.*`（任意端口），并允许携带凭证；生产环境前后端同源，无需额外的跨域配置。
+- **CORS 放行来源**：放开全部来源（`allowedOriginPatterns("*")` 并允许携带凭证）。因 `allowCredentials(true)` 不允许 `allowedOrigins("*")`，需使用 origin pattern 通配；接口认证基于 JWT（`Authorization` 头存于 `localStorage`，跨站脚本无法自动携带），风险可控。
+- **反向代理转发头**：`application.yml` 配置 `server.forward-headers-strategy: framework`，信任 `X-Forwarded-Proto`/`Host`；经 nginx/frp 反代时使 HTTPS 同源请求被正确识别为同源，避免被误判为跨域（否则带 `Origin` 的请求会返回 `403 Invalid CORS request`）。
+- **运行环境编码**：容器或直接运行 jar 的 JVM 需为 UTF-8 locale（`LANG`/`LC_ALL=C.UTF-8`）；否则 `sun.jnu.encoding` 退化为 ASCII，含中文的文件名（如邮箱账单附件名）落盘会抛 `InvalidPathException`。
 
 ### 发布流程
 

dev/rule-engine.md

@@ -38,10 +38,11 @@
 
 ## AI 生成规则
 
-`AiRuleServiceImpl` 依据用户勾选的**已打标签记录**生成规则建议：
+`AiRuleServiceImpl` 提供两个入口：规则管理页（生成 + 创建）与收支记录页批量操作（生成 + 可选应用到账单）。
 
-- 输入字段为记录的类型、备注、交易渠道、已有分类与标签（不含金额与原始账单数据）。
-- 输出规则经 `RuleService.create` 落库，必要时新建分类/标签，规则默认启用。
+- 生成建议（`suggest`，`POST /api/ai/rule/suggest`）：依据用户勾选的记录生成规则建议；规则管理页限定**已打标签记录**，收支记录页为**任意勾选账单**。输入字段为记录的类型、备注、交易渠道、已有分类与标签（不含金额与原始账单数据），并按「类型 + 备注 + 渠道 + 标签」组合去重。
+- 创建规则（`apply`，`POST /api/ai/rule/apply`）：输出规则经 `RuleService.create` 落库，必要时新建分类/标签，规则默认启用。
+- 应用到交易（`applyToTransactions`，`POST /api/ai/rule/apply-transactions`）：**纯本地匹配、不调用大模型**，按规则的类型/关键词/金额条件匹配指定交易，命中则聚合分类与标签，委托 `AiSuggestionService.apply` 落库（覆盖分类、追加标签，必要时新建）。
 - **去重**：以「类型 + 归一化关键词 + 分类 + 排序标签集合」为签名；与已有规则或同批已创建规则重复时跳过（`apply` 返回实际创建数），建议阶段则标记 `duplicate` 供前端禁止勾选。
 
 ## 校验