receipt-subscription-cleaner

从收据或电子邮件导出中识别经常性费用和订阅，并生成包含续订日期、价格变化和取消草稿的清晰摘要。当用户想要审核支出而不发起付款或取消时使用。

# Receipt and Subscription Cleaner

## Goal
Extract and normalize receipts to detect subscriptions, renewal cycles, and potential savings opportunities.

## Best fit
- Use when the user provides email exports, receipts, or billing PDFs.
- Use when the user wants a recurring charge audit and renewal calendar.
- Use when the user wants draft cancellation emails or scripts.

## Not fit
- Avoid when the user asks to cancel, refund, or dispute charges automatically.
- Avoid when the user requests access to payment methods or bank logins.
- Avoid when receipts are not available and the user cannot export data.

## Quick orientation
- `references/overview.md` for workflow and quality bar.
- `references/auth.md` for access and token handling.
- `references/endpoints.md` for optional integrations and templates.
- `references/webhooks.md` for async event handling.
- `references/ux.md` for intake questions and output formats.
- `references/troubleshooting.md` for common issues.
- `references/safety.md` for safety and privacy guardrails.

## Required inputs
- Receipt sources (email export, PDF folder, or CSV list).
- Time window and base currency.
- Known subscriptions or vendors to prioritize.
- User preferences for reminders (frequency, timezone).

## Expected output
- Subscription table with vendor, amount, cycle, and next renewal estimate.
- Anomaly list (price changes, overlapping subscriptions).
- Draft cancellation email templates (not sent).
- Reminder schedule recommendations.

## Operational notes
- Normalize vendor names before clustering.
- Mark confidence levels for each detected subscription.
- Keep all actions read-only; produce drafts only.

## Security notes
- Do not store raw receipts outside the user workspace.
- Redact card numbers and addresses in outputs.

## Safe mode
- Analyze and summarize receipts only.
- Generate draft reminders and cancellation messages without sending.

## Sensitive ops
- Canceling subscriptions, disputing charges, or initiating payments is out of scope.

---

## 中文说明

# 收据与订阅清理工具

## 目标
提取并规范化收据，以检测订阅、续订周期和潜在的节省机会。

## 适用场景
- 当用户提供电子邮件导出、收据或账单 PDF 时使用。
- 当用户想要经常性费用审计和续订日历时使用。
- 当用户想要草稿版的取消电子邮件或话术脚本时使用。

## 不适用场景
- 当用户要求自动取消、退款或争议费用时避免使用。
- 当用户请求访问支付方式或银行登录信息时避免使用。
- 当无法获得收据且用户无法导出数据时避免使用。

## 快速导览
- `references/overview.md` 了解工作流程和质量标准。
- `references/auth.md` 了解访问权限和令牌处理。
- `references/endpoints.md` 了解可选的集成和模板。
- `references/webhooks.md` 了解异步事件处理。
- `references/ux.md` 了解信息收集问题和输出格式。
- `references/troubleshooting.md` 了解常见问题。
- `references/safety.md` 了解安全和隐私防护措施。

## 必需输入
- 收据来源（电子邮件导出、PDF 文件夹或 CSV 列表）。
- 时间窗口和基础货币。
- 需要优先处理的已知订阅或供应商。
- 用户的提醒偏好（频率、时区）。

## 预期输出
- 包含供应商、金额、周期和下次续订估算的订阅表格。
- 异常列表（价格变化、重叠订阅）。
- 草稿版的取消电子邮件模板（不发送）。
- 提醒计划建议。

## 操作说明
- 在聚类之前规范化供应商名称。
- 为每个检测到的订阅标记置信度等级。
- 保持所有操作为只读；仅生成草稿。

## 安全说明
- 不要在用户工作区之外存储原始收据。
- 在输出中遮蔽卡号和地址。

## 安全模式
- 仅分析和总结收据。
- 生成草稿版的提醒和取消消息，但不发送。

## 敏感操作
- 取消订阅、争议费用或发起付款不在工作范围内。