Skip to content

MiaoMint/goofish-ai-reply

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

闲鱼 AI 智能客服

基于 OpenAI API 的闲鱼自动回复油猴脚本,自动检测未读消息并调用 AI 生成回复,让你的闲鱼摊位 24 小时在线。

Install

点击上方按钮,浏览器会自动弹出 Tampermonkey 安装页面(需已安装 Tampermonkey 扩展)。


功能特性

  • 自动检测未读消息 — 每 15 秒扫描一次聊天列表角标,发现未读即自动处理
  • 实时监听当前会话 — 对当前打开的聊天窗口实时监听,无角标也能即时回复
  • 完整上下文理解 — 读取最近 20 条聊天记录后再调用 AI,回复更连贯
  • 防误发保护 — 发送前二次校验当前激活会话,防止会话切换导致消息发错人
  • 串行发送队列 — 全局串行锁保证同一时刻只有一条 AI 回复在处理,杜绝消息串联
  • 自定义 System Prompt — 完全自定义 AI 角色与回复风格
  • 自定义回复后缀 — 可添加"(由机器人回复)"等标注,让买家知晓
  • 回复记录面板 — 记录所有已自动回复的用户,标注人工未读条数,一键跳转会话
  • 支持任意 OpenAI 兼容 API — 可替换为 DeepSeek、Moonshot、Claude 等兼容接口
  • 可拖拽悬浮面板 — 不遮挡页面内容,随时暂停/恢复

安装

第一步:安装油猴扩展

根据你使用的浏览器,选择对应的扩展安装:

浏览器 扩展
Chrome / Edge Tampermonkey
Firefox TampermonkeyGreasemonkey
Safari Userscripts

第二步:安装脚本

方式 A — 一键安装(推荐)

点击下方按钮,Tampermonkey 会自动弹出安装页面,确认即可:

Install

方式 B — 直接从文件安装(本地使用)

  1. 打开 Tampermonkey 扩展面板
  2. 点击「管理面板」→「实用工具」→「从文件导入」
  3. 选择本项目中的 goofish_ai_reply.user.js 文件

方式 C — 新建脚本粘贴代码

  1. 打开 Tampermonkey 扩展面板
  2. 点击右上角「+」新建脚本
  3. goofish_ai_reply.user.js 的全部内容粘贴进去,保存(Ctrl+S / Cmd+S

第三步:配置 API Key

  1. 打开 闲鱼网页版 并登录
  2. 页面右下角会出现蓝紫色悬浮面板「🤖 闲鱼 AI 智能客服」
  3. API 标签页填写:
    • API Key:你的 OpenAI API Key(sk-...
    • API Base URL:默认 https://api.openai.com/v1,使用第三方兼容接口时替换此处
    • 模型名称:默认 gpt-4o-mini,可改为 gpt-4odeepseek-chat
  4. 点击「保存设置」

使用说明

控制面板

面板分为四个标签页:

标签 说明
API 填写 API Key、Base URL、模型、回复后缀
Prompt 自定义 System Prompt,控制 AI 角色与回复风格
记录 查看所有已自动回复的买家,显示人工未读条数,点击可跳转到对应会话
日志 实时查看脚本运行日志,方便排查问题

启停控制

点击面板标题栏右侧的复选框可以随时暂停 / 恢复自动回复,不影响任何设置。

回复后缀

默认在每条 AI 回复末尾附加 (由机器人回复),可在 API 标签页修改或清空。


自定义 Prompt

Prompt 标签页可完全自定义 System Prompt。默认 Prompt 如下:

你是一位专业的闲鱼卖家客服助手。请根据买家的问题给出简洁、友好、专业的回复。
注意:
- 回复要简短自然,不超过 100 字
- 用中文回复
- 不要每次都重复相同的问候语
- 如果买家询问发货/退款/价格,请给出合理解答

可以在 Prompt 里写上你的商品信息、价格政策、发货周期等,让 AI 回答更准确。


使用第三方兼容 API

只需在 API 标签页修改 API Base URL模型名称 即可接入任意 OpenAI 兼容接口:

注意事项

  • 脚本仅在 https://www.goofish.com/im* 页面运行,需保持页面常驻
  • API Key 存储在浏览器 localStorage 中,不会上传到任何服务器
  • 建议在测试账号上先试用,确认回复质量后再用于正式账号
  • 频繁调用 API 会产生费用,建议选择低成本模型(如 gpt-4o-minideepseek-chat
  • 若买家消息中有敏感信息,请确保你使用的 API 服务商符合隐私要求

常见问题

Q: 面板没有出现怎么办?
确认脚本已启用,且当前页面 URL 包含 https://www.goofish.com/im

Q: 提示「API Key 未设置」?
在面板 API 标签页填写 Key 后点击「保存设置」。

Q: 消息没有自动回复?
查看「日志」标签页,常见原因:① API Key 错误或额度不足 ② 最后一条消息是自己发的(正常跳过)③ 消息加载超时。

Q: 怎么暂停自动回复?
点击面板右上角的复选框即可切换暂停/运行状态。

Q: 能用国内的 AI 服务吗?
可以,只要是 OpenAI 兼容接口,修改 API Base URL 和模型名称即可。


License

MIT

About

基于 OpenAI API 的闲鱼自动回复油猴脚本,自动检测未读消息并调用 AI 生成回复,让你的闲鱼摊位 24 小时在线。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors