invoice-chaser

核心用法

Invoice Chaser 是一套完整的应收账款自动化工作流，专为自由职业者和小型企业设计。用户通过 add-invoice.sh 将发票录入系统后，Skill 会基于配置的时间规则自动推进催款流程：从友好提醒（到期前3天）逐步升级至最终通知（逾期45天），并在75天后触发人工介入警报。每日通过 chase.sh 运行催款周期，自动计算账龄、匹配邮件模板、发送提醒并记录交互日志。支持 --dry-run 模式测试，避免误发邮件。

显著优点

情感劳动外包：将尴尬的催款对话交给 Agent，维护客户关系的同时确保收款效率。智能分级策略：五阶段语气递进（友好→专业→坚定→紧急→人工），既避免过早强硬损伤合作，又防止过度宽容导致拖欠。现金流可视化：内置 AR 账龄报告，按 0-30/31-60/61-90/90+ 天分组展示风险敞口，支持 CSV 导出。高度可配置：邮件模板、时间节点、升级规则、付款方式均可自定义，支持变量插值（客户名、发票号、金额等）。零外部依赖风险：数据完全本地存储（~/.config/invoice-chaser//），不依赖第三方 SaaS 服务。

潜在缺点与局限性

平台兼容性：日期计算使用 BSD/macOS 风格的 date -j 命令，Linux 用户需手动适配。功能边界：缺乏多用户协作、权限管理和审计日志，不适合中大型企业或高度监管行业。邮件送达依赖：实际发送依赖 gog Skill 和 Gmail，存在进入垃圾邮件箱的风险，无内置送达率监控。法律合规空白：未内置各国催收法规适配（如美国 FDCPA、欧盟 GDPR 通信规则），跨境使用需自行合规审查。无原生支付集成：仅支持在邮件中嵌入 Stripe/PayPal 链接，无法直接处理付款或自动对账。

适合的目标群体

• 自由职业者/独立顾问：项目制收款，客户数量 5-50 家，缺乏专职财务人员
• 小型服务型企业：设计工作室、咨询公司、开发外包团队，月发票量 10-100 张
• 现金流敏感型创业者：需要严格管控应收账款周转天数（DSO）的早期公司
• 关系导向型销售者：希望保持客户友好度，不愿亲自发送催款邮件的业务负责人

使用风险

数据丢失风险：本地 JSON 文件存储，无自动备份机制，建议定期手动备份 ~/.config/invoice-chaser//。邮件声誉风险：高频自动发送可能被 Gmail 标记为垃圾邮件，建议配置 SPF/DKIM 并控制日发送量。配置错误风险：错误的 due_date 或 timing 规则可能导致过早/过晚催款，首次使用务必用 --dry-run 验证。依赖项失效：jq 未安装或 gog Skill 配置错误会导致脚本中断，需确保环境就绪。

核心用法

Invoice Chaser 是一款专为自由职业者和小型企业设计的自动化发票催收技能。它通过脚本化的状态机实现从友好提醒到严肃通知的递进式邮件序列：Day 3 发出友好提醒 → Day 7+ 到期提醒 → Day 30 首次逾期通知 → Day 45 严厉通知 → Day 60 最终通知。用户只需通过 add-invoice.sh 添加发票，配置好 cron 定时任务后，系统会自动追踪未付款项、按阶段发送邮件并记录完整日志。当客户付款后，可通过 status.sh 标记为已付。技能还提供了账龄分析报告 (report.sh) 和数据导出功能，帮助用户掌握整体应收账款状况。

显著优点

1. 自动化追款全流程：从发票登记到最终催收，所有催款邮件按预设时间自动发送，无需人工记忆和操作。
2. 递进式语气管理：邮件语气从友善逐步过渡到严肃，在保护客户关系的同时，对严重逾期施加必要压力。
3. 数据全本地化存储：所有发票信息、发送记录和状态数据存储在 ~/.config/invoice-chaser/ 目录中，无任何外部数据传输，保障商业数据隐私。
4. 零外部依赖风险：代码不依赖任何第三方 npm/pip 包，仅使用系统工具 jq 和 Clawdbot 自带的 gog 技能，供应链攻击面极小。
5. 安全性与可配置性：支持干运行测试、暂停提醒、人工干预阈值设定和每日邮件限速，避免被标记为垃圾邮件。

潜在缺点或局限性

1. 功能不完整：安全认证报告明确指出包内缺失 chase.sh（核心催收逻辑）、status.sh（状态管理）和 report.sh（报告生成）三个关键脚本，导致技能目前无法完整运行声明的工作流。
2. 输入校验不足：add-invoice.sh 缺少对邮箱格式、金额合法性和日期格式的显式校验，可能产生数据质量问题。
3. 仅限电子邮件渠道：追款通知完全依赖 Gmail API，不支持短信、电话或平台内消息等备选渠道。
4. 无会计软件集成：虽提到可对接 QuickBooks 等，但适配器尚未实现，需用户自行开发。

适合的目标群体

• 每月处理 10-100 张发票的自由职业者和独立顾问
• 雇员工少于 10 人的小型代理机构或工作室
• 需要简单 AR 管理但无力购置专业财务软件的个人经营者
• 已在 Clawdbot 生态内使用 gog 处理邮件的用户

使用风险

• 功能可用性风险：缺失脚本可能导致 agent 为完成用户指令而自行生成危险代码
• 数据丢失风险：所有数据存储于本地 JSON 文件，无自动备份机制
• 邮件投递风险：集中发送催款邮件可能触发 Gmail 垃圾邮件过滤或发送配额限制
• 法律合规风险：不同地区的催收法规差异可能导致邮件内容不合规（如某些国家要求附注争议解决方式）
• 依赖风险：完全依赖 gog 技能的可用性，该技能故障将导致所有邮件发送中断