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 长期地址引用。
3.6 KiB
3.6 KiB
邮箱账单
邮箱账单功能通过 IMAP 监听邮箱，当账单邮件到达时自动拉取附件，识别账单类型并进入待处理列表，由你预览后再确认导入。
页面包含三个标签页：邮箱配置、发件人规则、待处理账单。
邮箱配置
配置用于接收账单邮件的 IMAP 邮箱：
- 点击右上角「新增」，填写邮箱信息：
- 名称：便于识别的名称
- IMAP 服务器：可从内置列表选择或自定义（选择后自动填端口 993 并开启 SSL）
- 邮箱账号 / 授权码：授权码在邮箱设置中开启 IMAP 服务后生成
- 监听文件夹：默认
INBOX - 默认归类：默认支出/收入分类与标签
- 拉取范围：仅新邮件 / 最近 N 天 / 最近 N 封
- 启用：开启后持续监听
- 点击「保存」。
- 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 秒自动刷新。
行操作：
- 解析：选择账单类型与解压密码后解析，进入预览，确认后导入。
- 忽略：标记为已忽略，不再处理。
- 删除：删除该消息及本地附件。
工作流程
账单邮件到达
│
▼
IMAP 监听（IDLE 实时 / 轮询降级）
│ 提取附件并保存
▼
发件人规则匹配 → 确定账单类型、解压密码、默认归类
│
▼
进入「待处理账单」（状态：待解析）
│ 手动点「解析」→ 预览 → 确认导入
▼
写入收支记录（状态：已导入）
::: tip 先预览再导入 邮箱账单不会自动写入账本，必须经过预览确认，避免误导入。 :::