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 长期地址引用。
85 lines
3.6 KiB
Markdown
85 lines
3.6 KiB
Markdown
# 邮箱账单
|
|
|
|
邮箱账单功能通过 **IMAP** 监听邮箱，当账单邮件到达时自动拉取附件，识别账单类型并进入待处理列表，由你预览后再确认导入。
|
|
|
|
页面包含三个标签页：**邮箱配置**、**发件人规则**、**待处理账单**。
|
|
|
|
## 邮箱配置
|
|
|
|
|
|
|
|
配置用于接收账单邮件的 IMAP 邮箱：
|
|
|
|
1. 点击右上角「**新增**」，填写邮箱信息：
|
|
- **名称**：便于识别的名称
|
|
- **IMAP 服务器**：可从内置列表选择或自定义（选择后自动填端口 993 并开启 SSL）
|
|
- **邮箱账号 / 授权码**：授权码在邮箱设置中开启 IMAP 服务后生成
|
|
- **监听文件夹**：默认 `INBOX`
|
|
- **默认归类**：默认支出/收入分类与标签
|
|
- **拉取范围**：仅新邮件 / 最近 N 天 / 最近 N 封
|
|
- **启用**：开启后持续监听
|
|
2. 点击「保存」。
|
|
|
|
|
|
|
|
- **IMAP 服务器**：可从内置列表选择（QQ、腾讯企业邮、163、126、网易企业邮、阿里云、新浪、139、189、Gmail、Outlook、iCloud）或自定义，选择内置服务器会自动填端口 993 并开启 SSL。
|
|
- **邮箱账号 / 授权码**：授权码而非登录密码（在邮箱设置中开启 IMAP 服务后生成）。
|
|
- **监听文件夹**：默认 `INBOX`。
|
|
- **默认归类**：默认支出分类、收入分类与标签。
|
|
- **拉取范围**：仅新邮件（增量）/ 最近 N 天 / 最近 N 封。
|
|
- **启用**：开启后系统会持续监听该邮箱。
|
|
|
|
行操作：
|
|
|
|
- **测试连接**：验证 IMAP 配置。
|
|
- **立即检查**：实时展示检查进度（每行带 `HH:mm:ss` 时间戳），完成后提示新增待处理账单数量。
|
|
- **编辑 / 删除**。
|
|
|
|
## 发件人规则
|
|
|
|
|
|
|
|
根据邮件**发件人**识别账单类型与解析参数：
|
|
|
|
- **发件人匹配串**：每行一个，支持完整地址、`@域名` 或关键字，包含匹配且忽略大小写。
|
|
- **账单类型**：支付宝 / 微信 / 美团 / 淘宝 / 京东 / 招商银行 / 交通银行。
|
|
- **解压密码**：账单压缩包加密时填写。
|
|
- **默认归类**：默认支出分类、收入分类与标签。
|
|
- **优先级**：值越小越优先。
|
|
|
|
系统为常见账单邮箱预置了默认规则（如支付宝 `@alipay.com`、微信 `@wechatpay.com`、美团 `@meituan.com`、招行 `@message.cmbchina.com`、交行 `@bankcomm.com`）。
|
|
|
|
## 待处理账单
|
|
|
|
|
|
|
|
展示已拉取、待处理的邮件账单，可按状态筛选（待解析 / 已导入 / 已忽略），列表每 30 秒自动刷新。
|
|
|
|
行操作：
|
|
|
|
- **解析**：选择账单类型与解压密码后解析，进入预览，确认后导入。
|
|
- **忽略**：标记为已忽略，不再处理。
|
|
- **删除**：删除该消息及本地附件。
|
|
|
|
## 工作流程
|
|
|
|
```text
|
|
账单邮件到达
|
|
│
|
|
▼
|
|
IMAP 监听（IDLE 实时 / 轮询降级）
|
|
│ 提取附件并保存
|
|
▼
|
|
发件人规则匹配 → 确定账单类型、解压密码、默认归类
|
|
│
|
|
▼
|
|
进入「待处理账单」（状态：待解析）
|
|
│ 手动点「解析」→ 预览 → 确认导入
|
|
▼
|
|
写入收支记录（状态：已导入）
|
|
```
|
|
|
|
::: tip 先预览再导入
|
|
邮箱账单不会自动写入账本，必须经过预览确认，避免误导入。
|
|
:::
|