chore: 初始化文档站仓库

guide/bills/wechat.md

@@ -0,0 +1,49 @@
+# 微信支付账单
+
+微信支持导出「微信支付账单流水文件」，系统以 **xlsx** 或 **zip** 形式导入。
+
+## 如何获取
+
+1. 打开微信 App，进入 **我 → 服务 → 钱包 → 账单**。
+2. 点击右上角「常见问题」。
+3. 选择「下载账单」→ 用途选择「**用于个人对账**」。
+4. 选择交易类型（建议「全部交易」）与时间范围，输入接收邮箱，按提示输入支付密码完成验证。
+5. 账单会以**加密压缩包**形式发送到邮箱，解压密码在**微信支付公众号（服务通知）**中查看。
+
+要点：
+
+- 个人对账账单**单次最长可导出 3 个月**，更早的记录需分段多次导出。
+- 导出的账单**包含已删除的交易记录**。
+- 账单一般在几分钟内到达邮箱，最慢 24 小时内；未收到时请检查垃圾邮件。
+- 解压密码每次导出单独生成，微信登录密码、支付密码均不能用于解压。
+
+## 导入
+
+在[账单导入](/guide/transactions)页选择账单类型「微信」，上传 xlsx 或 zip 文件。
+
+- 支持格式：`.xlsx`、`.zip`
+- 系统按「交易单号」去重。
+
+## 字段映射
+
+系统以首列「交易时间」定位表头，读取以下列：
+
+| 源字段（xlsx 列） | 落库字段 | 处理说明 |
+|---|---|---|
+| 交易时间 | `transaction_time` | 兼容 Excel 日期序列号与文本时间 |
+| 交易对方 | `remark` | 与商品名称拼接为备注 |
+| 商品 | `remark` | 同上 |
+| 收/支 | `type` | 支出→EXPENSE，收入→INCOME |
+| 金额(元) | `amount` | 去千分位后解析 |
+| 交易状态 | 仅推断/预览 | 不落库 |
+| 交易单号 | `external_no` | 导入去重键 |
+| — | `channel` | 固定为 `WECHAT` |
+| — | `category_id` | 取导入面板默认分类；未选为 NULL |
+
+「/」等占位符会被视为空值。
+
+## 注意事项
+
+- 「用于个人对账」导出的 xlsx 为对账用途，字段完整，适合导入。
+- 微信账单导出通常有一定延迟（通过邮件下发），收到文件后再导入。
+- 「/」等占位符会被视为空值。