闲鱼自动发货框架是一个可扩展的闲鱼虚拟商品自动化发货系统。它的核心只提供付款检测逻辑，发货流程完全交由用户自定义，遵循关注点分离、可扩展、零侵入、开箱即用的设计原则。
一、用途 框架用于在闲鱼虚拟商品交易中自动识别买家付款并触发发货动作，适合需要自动向买家发送秘钥、链接、图片、文件或调用外部接口生成发货内容的场景。
二、主要能力
- 付款检测：监控闲鱼聊天，检测系统卡片消息，要求同时满足消息类型为系统卡片、卡片内容为“我已付款，等待你发货”、存在“去发货”按钮三个条件；排除用户手打文本、无“去发货”按钮的消息以及“待付款”状态卡片。
- 发货钩子：检测到付款后调用用户定义的 fulfill_order 函数，返回值 0 表示成功、非 0 表示失败。
- 订单上下文：提供买家昵称、订单金额、下单时间、商品标题、买家头像 URL 等变量供发货逻辑使用。
- 内置模板：提供固定秘钥、秘钥池、网盘链接、图片二维码、API 发货、文件发货、混合发货共七种模板，可直接使用或作为参考。
- 自定义方式：可复制修改内置模板，也可从头编写 Bash 脚本，或使用 Python、Node.js 等其他语言实现发货逻辑后在 Bash 中调用。
- 主监控脚本：提供 monitor.sh 示例，包含加载发货钩子、检测付款、提取订单上下文、执行发货、主循环等流程，并可配置检查间隔与日志文件。
- 日志与通知：提供日志格式示例，以及 macOS、Telegram、企业微信通知的代码片段。
- 最佳实践：文档给出错误处理、重试机制、订单限流、日志增强等示例代码。
三、使用方式 基本流程包括：创建工作目录；安装 agent-browser 依赖；复制模板并编辑配置；创建秘钥池等数据文件；首次以 headed 模式打开闲鱼聊天页面并手动登录；启动 monitor.sh 监控脚本。框架依赖 agent-browser 进行页面快照、文本输入和按钮点击，相关命令示例包括 snapshot、type、click、find 等。
四、适用场景 适用于闲鱼上销售虚拟商品的卖家，包括固定秘钥或秘钥池分发、网盘链接与提取码发送、二维码或截图发送、调用外部 API 生成秘钥、发送本地文件以及组合多种发货方式等。
五、限制与注意事项 发货模板中图片与文件上传部分标注需要根据闲鱼实际界面调整，文档未提供完整可用的上传实现；通知与最佳实践为代码片段示例，需用户自行配置。故障排查部分列出无法检测付款、发货脚本未加载、Chrome 登录失效、按钮点击失败等常见问题及排查方向。文档未提供收费、价格或平台兼容性等更多信息。