这个项目是干什么的？

我最近翻 GitHub，找到一个挺有意思的项目：23Star/xianyu-super-butler，名字叫“闲鱼超级管家”。

简单说，它是一个帮你管理闲鱼消息、订单和发货的自动化后台。你可以把它理解成一个“闲鱼客服 + 发货助理 + 订单面板”。

它主要适合做闲鱼副业的人，尤其是卖虚拟资料、卡券、教程、模板、素材包这类商品的人。因为这类商品最烦的不是生产，而是重复回复、重复发货、重复查订单。一天十单还好，一天几十单的时候，手就开始怀疑人生了。

它能做什么？

这个项目的核心功能主要有几个：

1.自动回复

可以设置关键词回复，比如买家问：

“在吗？”
“怎么发货？”
“能便宜点吗？”
“拍下多久发？”

系统可以自动匹配关键词并回复。它还支持默认回复、商品专属回复，以及 AI 智能议价。也就是说，买家砍价时，它可以按你设置的折扣规则自动应对，不用你每次都复制粘贴。

2.自动发货

这是我觉得最有价值的地方。

它支持卡券管理、发货规则、多规格商品、延时发货。比如你卖的是“Excel 自动记账模板”，买家拍下后，系统可以根据商品标题或规则，自动发送网盘链接、提取码、兑换码等内容。

这对于虚拟商品卖家来说很香。毕竟半夜两点有人下单，你本人可能睡得像关机了一样，但系统还可以继续干活。

订单管理

后台可以查看订单列表、订单详情、订单状态，还支持批量刷新订单。项目里还做了“立即发货”功能，可以手动补发。

比如你之前已经把资料发给买家了，但忘记在闲鱼上点发货，就可以选择“仅修改闲鱼发货状态”。
如果你既没发资料，也没改状态，就可以选择“完整发货”，让系统匹配卡券并发送。

多账号管理

它支持多个闲鱼账号，可以扫码登录、密码登录，也可以手动输入 Cookie。对于同时运营多个账号的人来说，这个功能很实用。

技术栈是什么？

后端主要是：

• Python 3.11+
• FastAPI
• SQLite
• Playwright
• WebSocket
• Asyncio

前端主要是：

• React
• TypeScript
• Vite
• Tailwind CSS
• Zustand
• Framer Motion / 图表相关组件

简单翻译一下：
后端负责连接闲鱼、处理消息、管理订单和发货；前端负责给你一个可视化后台，让你不用盯着黑乎乎的命令行操作。

举个闲鱼发货的例子

假设我在闲鱼卖一个“副业记账 Excel 模板”，售价 19.9 元。

以前的流程可能是这样：

1. 买家问：“这个怎么用？”
2. 我回复：“拍下后发网盘链接。”
3. 买家问：“能便宜吗？”
4. 我说：“最低 18。”
5. 买家下单。
6. 我打开聊天框，复制网盘链接和提取码。
7. 我再去订单里点发货。
8. 如果刚好在吃饭、睡觉、开会，买家可能还会催：“老板，发了吗？”

用这个项目之后，流程可以变成：

1. 买家问“怎么用”，系统自动回复说明。
2. 买家砍价，系统按规则自动议价。
3. 买家拍下后，系统识别订单。
4. 系统匹配“副业记账 Excel 模板”的发货规则。
5. 自动发送网盘链接、提取码。
6. 自动标记发货。

这时候你就从“人工客服”变成了“后台老板”。当然，老板也不是完全不用管，规则要先配好，异常订单也要定期看。

如何使用这个项目？

第一步：下载项目

命令：git clone https://github.com/23Star/xianyu-super-butler.git cd xianyu-super-butler

第二步：安装 Python 依赖

项目要求 Python 3.11+。

命令：pip install -r requirements.txt

还需要安装 Playwright 浏览器：

命令：playwright install chromium

Linux 服务器上可能还需要：

命令：playwright install-deps chromium

第三步：构建前端

命令：cd frontend npm install npm run build cd ..

第四步：启动服务

命令：python Start.py

启动后，浏览器打开：

http://localhost:8080

默认登录信息是：

用户名：admin 密码：admin123

首次登录后一定要改密码。这个不是建议，是保命操作。

第五步：添加闲鱼账号

进入后台后，可以添加闲鱼账号。项目支持扫码登录、密码登录、手动 Cookie 等方式。

账号添加好之后，系统才能监听消息、同步订单、执行自动回复和自动发货。

第六步：配置关键词和发货规则

比如你卖“Excel 模板”，可以这样配置：

关键词回复：

关键词：“怎么用“ ---- 回复：”拍下后自动发送网盘链接，里面有模板和使用说明“。

发货规则：

匹配商品：副业记账 Excel 模板 发货内容：网盘链接 + 提取码

如果你卖的是多规格商品，比如“基础版 / 高级版 / 旗舰版”，也可以配置不同规格对应不同发货内容。

我的使用体验总结

我看完这个项目后，感觉它最适合解决一个问题：让闲鱼副业从“手工作坊”变成“半自动小后台”。

它不是一个点一下就能发财的工具，也不是传说中的“睡后收入神器”。它真正的价值是减少重复劳动：少回一点废话，少复制几次链接，少漏几单发货。

比较适合这些人：

适合哪些人？

适合虚拟商品卖家

比如卖资料包、模板、教程、兑换码、素材、电子文档的人。因为这类商品最容易标准化，也最适合自动发货。

适合多账号运营者

如果你有多个闲鱼账号，人工切号很麻烦。这个项目的多账号管理会比较有用。

适合有一定动手能力的新手

它不是纯小白软件，需要会一点基础操作，比如安装 Python、运行命令、配置账号。如果你完全没碰过命令行，前期可能会有点懵，但照着步骤来问题不大。

不太适合纯实物卖家

如果你卖的是二手手机、家具、衣服这类强沟通、强议价、强物流的商品，它能帮你自动回复，但自动发货价值没那么大。

最后提醒

项目 README 里写了免责声明：该项目仅供学习研究使用，严禁用于商业用途。实际使用前，一定要自己确认平台规则、法律合规和账号风险。

如果只从学习和效率工具角度看，这个项目很值得研究。它把自动回复、订单管理、卡券发货、AI 议价这些功能整合到一个后台里，对于想做闲鱼自动化的人来说，是一个很好的参考项目。