XianyuAutoAgent：闲鱼客服自动值守的意图路由与议价阶梯
智能闲鱼客服机器人系统：专为闲鱼平台打造的AI值守解决方案，实现闲鱼平台7×24小时自动化值守，支持多专家协同决策、智能议价和上下文感知对话。
ひと目でわかる
- これは何？
- 闲鱼平台上的自动回复机器人，用提示词把对话分派给价格、技术、默认三个专家。机制看得清，但认证方式、许可与维护承诺都是需要先确认的变量。
- 誰に向いている？
- 向已经在闲鱼上做小规模二手或技术服务生意、能接受 cookie 认证与 GPL-3.0 约束、并愿意自己改提示词的开发者推荐先做本地验证。不适合把客服当作合规或资金环节使用的人，也不适合期待官方长期维护的人：README 明确写着开发团队可能在任何时间停止更新或删除项目。
- 商用利用できる？
- 条件付きでできます。GPL-3.0 はコピーレフトのライセンスで、これを含むソフトウェアを配布する場合、そのソフトウェアのソースコードを同じライセンスで公開する必要があります。配布せず社内で使うだけなら、この義務は生じません。
- 今もメンテナンスされている？
- されています。最後のコミットは 98 日前です。
- 何の言語で書かれている？
- 主に Python です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月15日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
闲鱼卖家半夜收到的那条“在吗”
闲鱼上的成交往往取决于回复速度。买家发一句在吗，几小时没人应，就去看下一个卖家的同款。XianyuAutoAgent 想解决的就是这个空档：让一个 LLM 驱动的机器人替卖家守着会话窗口，7×24 小时回复。README 的定位写得很直白，专为闲鱼平台打造的 AI 值守解决方案。目标用户是个人卖家和小团队，商品描述里常带议价空间、也常被问技术细节的那类。项目用 Python 3.8+ 写成，默认调用通义千问，也可以换成别的模型地址。它不是一个通用客服系统，而是绑死在闲鱼会话上的一套脚本。
意图分类先跑一遍，再把会话交给对应专家
README 把对话引擎拆成两层。第一层是上下文感知，做法是把会话历史存下来，完整对话历史作为 LLM 上下文输入，属于轻量级对话记忆管理。第二层是专家路由，技术实现写的是 LLM prompt 加规则路由，先做基于提示工程的意图识别，再把会话动态分发给专家 Agent，支持议价、技术、客服多场景切换。落到文件上，就是 prompts 目录里的四个文本：classify_prompt.txt 负责意图分类，price_prompt.txt 是价格专家，tech_prompt.txt 是技术专家，default_prompt.txt 是默认回复。也就是说，路由逻辑本身不是硬编码的分支树，而是可以改的提示词。这个设计的代价是分类质量完全取决于你写的 classify_prompt.txt，模型换了、闲鱼买家换了说话方式，分类就会漂。
阶梯降价策略与网络搜索整合
业务功能矩阵列出的已实现项里，议价系统是阶梯降价策略，技术支持是网络搜索整合。阶梯降价意味着价格让步不是由模型即兴决定，而是按预设档位往下走，这比让 LLM 自由报价可控，但也意味着议价空间的上限由写提示词的人提前定死，遇到真的难缠的买家，机器人会卡在最后一档重复同一句话。技术专家接的是网络搜索，README 没有说明搜索走的是哪个接口、结果如何注入提示词，这一点从现有材料无法确认。规划中的项目包括情感分析增强、市场比价、RAG 知识库增强、钉钉集成和 Web 管理界面，都还没有实现。运维监控目前只有基础日志，截图里的后台 log 就是它的全部形态。
从 .env 到 python main.py
安装路径很短。git clone 仓库后 cd XianyuAutoAgent，然后 pip install -r requirements.txt。配置靠一个 .env 文件，也可以直接把 .env.example 改名。必配项四个：API_KEY 从模型平台获取，COOKIES_STR 填网页端抓到的 cookie，MODEL_BASE_URL 是模型地址，MODEL_NAME 是模型名称。可选两项：TOGGLE_KEYWORDS 是接管模式切换关键词，默认是句号，输入句号切人工接管，再输入一次切回 AI；SIMULATE_HUMAN_TYPING 控制是否模拟人工回复延迟。README 给的取 cookie 方法是网页端 F12 打开控制台，选 Network，点 Fetch/XHR，点一个请求查看 cookies。最后一步容易漏：需要创建 prompts/*_prompt.txt，或者把模板名称里的 _example 去掉，否则程序读取的是四个提示词模板里的默认内容。跑起来就是 python main.py。
cookie 认证是这套方案最脆的地方
整个系统的登录态建立在一段手工复制的 COOKIES_STR 上，没有 OAuth，没有账号密码流程。这意味着三件事。cookie 过期后机器人静默失效，而 README 没有给出失效检测或提醒机制，你只能靠日志发现它不再回复。cookie 等同于账号凭证，把它写进 .env 再放进任何同步目录或容器镜像，风险由使用者承担。README 自己也留了一段注意事项，写明本项目仅供学习与交流，并说鉴于项目的特殊性，开发团队可能在任何时间停止更新或删除项目。这不是客套话，它直接说明上游接口一旦变动，修复不一定会来。把自动议价接到真实成交环节之前，这一点必须先想清楚。
和自己写一个定时回复脚本比，差别在哪
最直接的替代方案是自己写一个监听消息、命中关键词就回固定话术的脚本，或者用 n8n 这类工作流工具把闲鱼消息接到 LLM。区别在决策层。关键词脚本没有意图识别，买家问“这个和另一款比怎么样”和“能便宜点吗”会得到同一个回复；XianyuAutoAgent 多了一层 classify_prompt.txt 做分类，再分发到不同的专家提示词，议价还带阶梯策略。代价是它同时引入了模型调用成本和不可预测性，同一句话在两次运行里可能得到不同回复。如果卖家的商品单一、问题高度重复，关键词脚本更省事也更可控。如果商品线杂、议价频繁，意图路由这一层才值得引入。README 提到项目参考了 cv-cat/XianYuApis，闲鱼接口这一层的能力来自那里。
GPL-3.0 与维护成本
许可证是 GPL-3.0。如果你只是自己跑一个实例替自己的店铺值守，这通常不构成分发，约束有限。但如果你把改过的版本打包成服务卖给别的卖家，GPL-3.0 的传染性会要求你以同样许可开放对应源码，这一点在商业化之前需要让懂许可的人确认，本文不构成法律意见。维护成本主要在提示词和 cookie 两处：模型平台换模型要改 MODEL_NAME 和 MODEL_BASE_URL，闲鱼改版要重新抓 COOKIES_STR，买家话术变化要回头调 classify_prompt.txt。仓库没有检索到正式 release，最近一次 push 是 2026 年 6 月 10 日，没有版本号可供锁定，升级只能跟随 main 分支。
編集部の結論
向已经在闲鱼上做小规模二手或技术服务生意、能接受 cookie 认证与 GPL-3.0 约束、并愿意自己改提示词的开发者推荐先做本地验证。不适合把客服当作合规或资金环节使用的人，也不适合期待官方长期维护的人：README 明确写着开发团队可能在任何时间停止更新或删除项目。动手前先确认三件事，一是 COOKIES_STR 的获取与过期后的处理方式，二是 prompts 目录下四个提示词模板的实际内容，三是在自己账号上跑 python main.py 时 TOGGLE_KEYWORDS 的句号接管是否真的能中断自动回复。
コミュニティノート