# tools

**Repository Path**: mamatabulla/tools

## Basic Information

- **Project Name**: tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-26
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 闲鱼助手 - 自动发货 (xianyu_zhushou)

一个面向闲鱼网页版（goofish.com）的 Chrome 浏览器扩展，用于虚拟商品（卡密 / 账号）的自动发货。

## ✨ 功能特性

- 🤖 **自动发货**：监听聊天列表中"我已付款，等待发货"等状态，自动打开会话并发送预设卡密
- 📦 **库存池管理**：在弹窗中维护一行一条的卡密库存，发完自动从池中移除
- 🔢 **智能数量识别**：自动解析订单中的购买数量（支持 `数量：N` / `xN` / `共N件` 等格式），按需多发
- 🛡️ **风控熔断**：检测到滑块验证码、访问频率限制等风控提示后立即暂停所有自动操作
- 🎭 **拟人化延迟**：在反应、阅读、检查、冷却等关键节点加入随机延迟，降低被识别为机器人的风险
- 🔁 **防重复发货**：通过买家昵称去重，并持久化到 `chrome.storage.local`，重启浏览器也不会重发
- ⚙️ **可自定义前后缀**：发货消息支持前缀提示语 + 卡密内容 + 后缀提示语自由拼接

## 📁 项目结构

```
xianyu_zhushou/
├── manifest.json     # MV3 扩展声明（仅注入到 *.goofish.com/im*）
├── content.js        # 核心业务逻辑：DOM 监听、识别订单、自动发货
├── popup.html        # 弹窗 UI（开关、前后缀、卡密库存编辑）
├── popup.js          # 弹窗逻辑（读写 chrome.storage.local）
└── README.md
```

## 🚀 安装与使用

1. 下载或克隆本仓库到本地
2. 打开 Chrome（或 Edge）浏览器，访问 `chrome://extensions`
3. 打开右上角的 **开发者模式**
4. 点击 **加载已解压的扩展程序**，选择本项目根目录
5. 登录闲鱼网页版（`https://www.goofish.com/im`）
6. 点击浏览器右上角插件图标，配置：
   - 勾选 **开启自动发货功能**
   - 填入发货前缀提示语（选填）
   - 一行一条粘贴卡密库存
   - 填入发货后缀提示语（选填）
   - 点击 **保存配置**

## ⚠️ 风控与免责声明

- 本插件仅作技术学习与个人使用，请勿大规模/高频使用，避免触发账号风控
- 使用过程中如遇阿里系滑块验证码，插件会**自动停止运行**，请手动通过验证后再开启
- 因闲鱼前端可能改版，DOM 选择器可能失效；如发现识别异常请提交 Issue

## 🛠️ 技术栈

- Chrome Extension Manifest V3
- 原生 JavaScript（无外部依赖）
- `chrome.storage.local` 持久化配置
- `MutationObserver` 监听聊天列表变化

## 📜 License

MIT