核心用法
xianyu-auto-fulfillment 是一套基于 agent-browser 网页自动化技术的闲鱼虚拟商品自动发货系统。其核心架构采用"检测层+发货层"分离设计：框架内置付款检测逻辑（识别系统付款卡片"我已付款，等待你发货"），用户通过实现 fulfill_order() 钩子函数自定义任意发货逻辑。
典型工作流程：
1. 框架持续监控闲鱼聊天页面（https://www.goofish.com/im）
2. 检测到系统付款卡片后，提取订单上下文（买家昵称、商品标题、金额等）
3. 调用用户自定义的发货钩子完成发货（发送秘钥、链接、图片、调用API等）
4. 记录日志并支持接入外部通知（Telegram、企业微信等）
框架提供7种开箱即用的发货模板：固定秘钥、秘钥池、网盘链接、图片/二维码、API调用、本地文件、混合发货。
显著优点
- 架构清晰：检测与发货职责分离，降低维护复杂度
- 高度可扩展：支持任意发货方式，不强制特定技术栈（可用Bash/Python/Node.js等实现钩子）
- 开箱即用：7种完整模板覆盖主流虚拟商品场景
- 上下文完备：自动提取订单信息，支持精细化发货逻辑
- 监控友好：结构化日志、通知接口便于运维
潜在缺点与局限性
- 平台依赖风险：基于闲鱼网页版DOM结构，平台改版可能导致检测失效
- 浏览器自动化局限：
agent-browser依赖Chrome环境，资源占用较高，难以容器化大规模部署 - 合规灰色地带：自动发货可能违反闲鱼平台服务条款，存在账号受限风险
- 并发处理能力弱：单进程轮询架构，高并发场景需自行扩展
- 无内置事务保障：秘钥池扣减与消息发送非原子操作，极端情况可能重复发货或秘钥丢失
适合人群
- 闲鱼虚拟商品卖家（软件授权、教程资源、会员兑换码等）
- 需要轻量级自动化、日均订单量适中的个人卖家
- 具备基础脚本编写能力的技术用户
- 不适合：高并发电商业务、合规要求严格的企业级场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 账号封禁 | 自动化操作可能触发平台风控 | 控制操作频率、使用备用账号、避免异常行为模式 |
| 秘钥泄露 | 秘钥池文件本地存储，权限管理不当可能泄露 | 限制文件权限、使用加密存储、定期审计 |
| 重复发货 | 网络异常或页面延迟可能导致同一订单多次发货 | 实现订单状态去重、添加发货限流机制 |
| 依赖失效 | `agent-browser` 或闲鱼页面改版 | 保持框架更新、预留人工干预通道 |
| 法律合规 | 部分虚拟商品（破解软件、盗版资源）存在法律风险 | 确保商品来源合法、遵守平台规则 |