自动商品搜索

自动商品搜索

用 AI 帮你在山姆找到最合心意的商品

告诉 AI 你想要什么、有什么偏好,它会自动在山姆会员商店 App 中搜索、浏览并为你推荐最匹配的商品。

↓ 下载 macOS 版 需要 macOS 10.15 (Catalina) 或更高版本

不再大海捞针

山姆会员商店商品种类繁多,但 App 的搜索和筛选功能有限。当你有具体偏好时——比如想找「无糖或低糖、配料表干净的酸奶」——往往需要逐个商品点开查看,费时费力。

「自动商品搜索」通过 AI 理解你的个性化需求,然后自动操作你的手机,在山姆 App 中搜索和浏览商品,最终为你推荐最符合要求的选项。你只需描述需求,等待结果。

三步开始

1

描述需求

输入搜索词(如「酸奶」)和你的偏好要求(如「无糖、配料干净」)。

2

AI 自动搜索

AI 自动在你的手机上操作山姆 App,搜索和浏览商品。你可以在桌面端实时观察执行过程。

3

查看推荐

搜索完成后,查看 AI 根据你的偏好筛选出的推荐商品。

核心功能

🧠

AI 智能理解偏好

用自然语言描述你的需求和偏好,AI 会理解语义并规划搜索策略。支持复杂条件组合,如「无糖、配料干净、非深加工」。

📱

自动化手机操作

AI 自动控制你的 Android 手机,在山姆 App 中执行搜索、滑动浏览、查看商品详情等操作,无需你手动干预。

💬

对话式交互

聊天风格的界面设计,像跟助手对话一样搜索商品。输入搜索词和偏好,即可开始。

👁️

执行过程可见

实时查看 AI 的视觉操控过程,了解它在做什么。也可以折叠过程面板,只关注最终推荐结果。

🚚

配送方式筛选

支持按「极速达」或「全国配」筛选商品,确保搜索结果符合你的配送需求。

使用前准备

在使用本应用前,请确保你已准备好以下条件:

💻

macOS 电脑

当前版本仅支持 macOS 10.15 (Catalina) 及以上。Windows 版本计划开发中。

📱

Android 手机

需要 Android 11 或更高版本。暂不支持 iPhone。

🔌

USB 数据线

需要支持数据传输的数据线(非纯充电线),用于连接手机和电脑。

🛒

山姆会员商店 App

手机上需已安装山姆会员商店 App,并登录你的会员账号。

安装与配置

1. 下载安装应用

  1. 下载 macOS 安装包(.dmg 文件)
  2. 双击打开 .dmg 文件
  3. 将「自动商品搜索」拖入 Applications(应用程序)文件夹
  4. 首次打开时如遇到安全提示,前往「系统设置 → 隐私与安全性」中允许打开

2. 准备 Android 手机

  1. 在手机上找到「设置 → 关于手机 → 版本号」,连续点击 7 次启用开发者模式
  2. 进入「设置 → 开发者选项」,开启「USB 调试」
  3. 部分机型需要重启手机才能生效
不同品牌手机的具体操作路径略有不同。点击查看各品牌手机详细教程(华为、小米、OPPO、vivo、三星等)。

3~5. 安装 ADB 和 ADB Keyboard(一键配置)推荐

  1. 以下步骤 3、4、5 需要安装 ADB 工具和 ADB Keyboard。我们提供了一键配置脚本,可以自动完成所有操作。
  2. 运行前请先完成:① 手机已开启 USB 调试(参见步骤 2)② 手机已通过 USB 连接电脑 ③ 手机上已点「允许 USB 调试」
  3. 打开终端(不知道怎么打开?),粘贴以下命令并按回车运行:
curl -sL https://tertius.site/AutoProductSearchGUI/downloads/setup-phone-env.sh | bash
  1. 脚本会自动下载安装 ADB、配置环境变量、安装 ADB Keyboard 到手机,并验证连接。
  2. 如果你更熟悉命令行操作,也可以按照下面的手动步骤逐步完成(做的是同一件事)。
一键脚本与下面的手动步骤 3、4、5 完成的是同样的操作。选择其中一种方式即可,无需两种都做。
▼ 手动配置方式(与上面的一键配置做的是同一件事)

3. 安装 ADB(Android 调试桥)

  1. 从 Google 下载 Android Platform Tools
  2. 解压到一个固定目录,例如 `~/platform-tools`
  3. 打开终端,将 ADB 加入环境变量:
# 添加到 ~/.zshrc(如果用 bash 则添加到 ~/.bash_profile)
export PATH=$PATH:~/platform-tools

# 使配置生效
source ~/.zshrc
  1. 验证安装:终端输入 `adb version`,应显示版本号

4. 安装 ADB Keyboard(手机上)

  1. 下载 ADB Keyboard APK备用下载)并传输到手机安装
  2. 安装后,在手机「设置 → 输入法」或「设置 → 键盘列表」中启用 ADB Keyboard
  3. 也可以通过命令行启用:
adb shell ime enable com.android.adbkeyboard/.AdbIME
ADB Keyboard 用于让 AI 在搜索框中输入中文。安装后它会作为一个可选输入法出现,不会影响你日常打字。

5. 连接手机到电脑

  1. 使用 USB 数据线将 Android 手机连接到 Mac
  2. 手机上如弹出「允许 USB 调试」,点击「允许」(建议勾选「始终允许」)
  3. 在终端运行以下命令,确认手机已连接:
adb devices
# 应显示类似:
# List of devices attached
# XXXXXXXX    device
如果显示 'unauthorized',请检查手机上是否弹出了授权确认弹窗。如果列表为空,尝试更换 USB 线或接口。

6. 配置 LLM API Key

  1. 如果你还没有 LLM API Key,请先查看我们的 API Key 获取教程,里面有详细的注册和配置步骤
  2. 打开「自动商品搜索」应用,点击右上角的设置图标
  3. 在「分析决策」标签页中,填入你选择的平台的 API 地址、模型名称和 API Key
分析决策配置示例
API 地址 https://dashscope.aliyuncs.com/compatible-mode/v1
模型 deepseek-v3.2
API Key 你的 API Key
  1. 切换到「视觉操控」标签页,填入同一平台的 API 地址、视觉模型名称和同一个 API Key
视觉操控配置示例
API 地址 https://dashscope.aliyuncs.com/compatible-mode/v1
模型 qwen3.5-plus
API Key 你的 API Key(与上面相同)
  1. 点击保存,配置完成
API Key 仅保存在你的本机,不会上传到任何服务器。不知道怎么获取 API Key?查看 详细教程

7. 开始使用

  1. 在手机上打开山姆会员商店 App(停留在首页),确保手机已通过 USB 连接电脑
  2. 在应用中输入搜索词(如「酸奶」)和你的偏好要求(如「无糖或者低糖;配料表干净」),选择配送方式(可选),然后点击发送按钮
  3. AI 会自动操作手机进行搜索和分析,完成后给出推荐排名和理由。你可以在应用界面实时观察 AI 的操作过程
💡 使用示例
搜索词 酸奶
要求/偏好 无糖或者低糖;配料表干净,不要深加工食品
配送方式 极速达
AI 会自动在山姆 App 中搜索「酸奶」,逐一浏览结果、读取配料表和营养成分,筛掉不符合的产品,最终按偏好评分排名并给出推荐理由。

常见问题

支持哪些手机?
目前支持 Android 11 及以上版本的手机。暂不支持 iPhone 和鸿蒙设备。
支持 Windows 吗?
当前仅支持 macOS。Windows 版本已在计划中。
需要付费吗?
应用本身免费下载使用。但你需要自行申请 LLM API Key,调用 API 会产生少量费用。阿里云百炼的模型有免费 Token 额度,可先免费体验;硅基流动新用户实名认证可获得 16 元代金券,正常使用频率下估计用几个月甚至更长时间都没什么问题。
推荐哪个 LLM 服务?
两个平台各有特点:阿里云百炼速度稍快、有免费 Token 额度,但注册流程略复杂;硅基流动注册更简单,新用户有代金券,但视觉模型偶尔可能不稳定。两个平台都只需注册一个,视觉操控和分析决策模型可以共用同一个平台的 API Key。详见 API Key 获取教程
我的数据安全吗?
所有搜索操作在你的手机本地执行,API Key 存储在本机配置文件中,不会上传到任何第三方服务器。应用不收集任何用户数据。
搜索一次大概要多久?
取决于搜索结果数量和大模型服务商的响应速度,通常在 5-10 分钟内完成。如果命中缓存,最快 1-2 分钟就可以完成。你可以在执行过程面板中实时查看进度。

安全提示与免责声明

本应用目前为初始预览版本,在使用前请仔细阅读以下内容。

关于 AI 操作

  • 本应用使用 AI 自动操控你的手机,在山姆会员商店 App 中搜索和浏览商品信息。AI 的操作范围仅限于搜索、浏览和记录商品信息,程序不会指示 AI 执行购买、下单或支付等操作。
  • 然而,AI 大模型的行为具有固有的不确定性。尽管在开发者的大量测试中,AI 从未出现过误操作购买或下单的情况,但我们无法 100% 排除在极端情况下(如 App 弹窗干扰、页面异常等)AI 出现意外操作的可能性。此外,作为初始预览版本,程序本身也可能存在 bug 或不稳定的情况。

建议的安全措施

  • 尽量使用一台不绑定支付方式(如银行卡、微信/支付宝支付)的备用手机来运行本程序
  • 如果使用主力手机,请确保山姆会员商店 App 以及手机上的其他购物/支付类 App 已开启支付密码验证,关闭免密支付功能
  • 在 AI 执行搜索期间,你可以在应用界面的执行过程面板中实时观察 AI 的操作,如发现异常可及时干预
  • 如需紧急中止 AI 操作,断开手机与电脑之间的 USB 连接即可

免责声明

  • 本应用免费提供,开发者出于个人兴趣开发和分享,不会故意设计任何有害功能。但由于 AI 行为的固有不确定性以及软件可能存在的缺陷,开发者无法对 AI 在操作手机过程中可能产生的任何直接或间接损失承担责任。
  • 使用本应用即表示你已阅读并理解上述安全提示,接受 AI 操作可能带来的风险,并同意自行承担使用过程中可能产生的后果。
  • API Key 仅保存在你的电脑本地,应用不收集任何用户数据,不会将你的信息上传到开发者或任何第三方服务器。