家庭财务管家

要解决什么问题

很多家庭把微信、支付宝账单堆在邮箱里：压缩包带密码、CSV/Excel 格式各有一套，退款还会把「账面支出」和「实际支出」搅在一起。手工下载、解压、对账、贴标签，重复劳动多，也很难把整条链路脚本化。

技能如何工作

本 Skill 把「家庭财务管家」套件里的 9 个子能力 封装成一个入口，对外只装统一目录；内部仍在 skills/ 下按模块拆分，便于单独调用与维护。运行时文件集中在 workspace/family-finance/。

典型编排包括：

• 配置向导（family-finance-config-wizard）：收集 QQ/163 等邮箱与 IMAP，加密存授权码，初始化工作区
• 账单获取与解压（bill-email-fetcher、bill-unzipper）：从邮箱拉压缩包，用 pyzipper 解 AES 加密 ZIP
• 清洗入库（alipay-bill-cleaner、wechat-bill-cleaner）：分别处理支付宝 CSV 与微信 Excel，可走任务链
• 时间与退款（bill-time-extractor、sqlite-refund-calculator）：提取交易时间范围，在 SQLite 里算退款后的实际支出
• 分类（transaction-classifier、custom-consumption-classifier）：V3 四层自学习分类，以及交互式自定义消费类别

敏感信息（邮箱授权码、解压密码）用 Fernet + PBKDF2 加密，密钥文件权限 600。注意：IMAP 授权码需在邮箱设置里单独生成，不是登录密码。

适用边界

• 邮箱侧文档侧重 QQ/163 拉取场景；其它邮箱需自行验证 IMAP 行为
• 账单格式以微信/支付宝官方导出为准；非标准文件可能导致清洗步骤失败
• 套件已做个人信息脱敏示例，真实环境仍建议自行备份 workspace/family-finance/ 并核对分类规则