装上就能干活的 AI 小程序

适用场景

用于在抖音百应按选品条件查找商品，并逐步积累平台允许展示的商家微信与手机号，方便后续商家合作联系。

• 按商家 ID 去重、持续保存，多次采集可累计通讯录。
• 微信与手机分别记录获取状态，更新失败或本次未提供时保留最后成功值。
• 支持商品来源追溯、单商家更新、通讯录搜索与分页、CSV / JSON 分批导出。

开始使用

1. 打开小程序，等待本地数据读取、数据库写入检查和百应页面加载。
2. 在百应浏览器窗口完成账号登录或验证。小程序使用客户端共享登录态，无需在小程序内输入密码。
3. 返回小程序，点击右上角「我已登录」重新检测；已连接时按钮显示为「检测」。
4. 确认百应已连接、数据库写入检查通过后，在「选品采集」设置条件。

请只运行一个实例。若提示通讯录被占用，请停止其他实例后重新打开；异常退出后的占用标记可能需要等待过期。

选品与采集

1. 设置选品条件

• 在「商品关键词 / 商品链接」输入商品名称、关键词或商品链接；留空时查询推荐商品。
• 选择商品行业、一级类目和二级类目。子类目以所选行业实际提供的选项为准。
• 点击「同步筛选条件」读取当前可用条件。售价、佣金率、月销等常用条件直接显示，其他条件按组展开设置。
• 更多筛选可包含浏览量、带货达人数、体验分、好评率、服务权益、流量助推和特色货品等，具体以平台当前返回为准。支持自定义范围的字段可填写最低值和最高值。
• 排序可选综合排序、销量、佣金率、售价或月带货达人数；非综合排序可选择从高到低或从低到高。

切换行业或类目会清空已选的其他筛选条件。「重置」恢复默认选品与采集设置，不清空通讯录或任务记录。开始采集前会重新核验平台筛选定义。

2. 先预览商品

点击底部「搜索预览」，查看当前一页商品及平台返回总量。列表显示商品名称、商家名称、商品 ID 和价格；点击「详情」可在百应窗口打开商品详情。

搜索预览只查商品，不获取商家联系方式。

3. 设置采集安排

默认跳过所有已保存商家，包括联系方式缺失或更新失败的记录。如需补齐，可取消勾选，或前往通讯录单独更新。每连续处理 20 家商家、仍需继续采集时，会冷却 60 秒。

4. 开始或停止采集

点击底部「开始采集」。应用按平台可翻页范围搜索商品，确认商家归属后分别读取微信和手机号，并逐条保存。

底部常驻操作栏显示当前阶段、完成商家数、扫描商品数及异常提示。准备阶段和采集过程中均可点击「停止任务」；停止时需等待当前请求结束，已保存的数据保留，不会自动继续。

实际完成数量可能少于设置目标，取决于可用商品、重复商家、已保存商家和平台限制。完成商家数不表示每家都同时提供了微信和手机号。

查询与更新通讯录

进入「商家通讯录」：

1. 输入商家名称、ID、微信或手机进行搜索。
2. 按「全部状态」「本次微信有效」「本次手机有效」「待补齐 / 更新失败」或「本次均未提供」筛选。
3. 每页展示 30 家，支持上一页、下一页及输入页码跳转；新入库商家优先显示。
4. 联系方式默认遮挡，勾选「显示明文」后查看已保存值。
5. 点击「更新此商家」，通过已保存的来源商品重新检查联系方式。更新需要有效登录及可用商品来源。
6. 点击「来源与历史」，查看微信、手机最近成功时间、来源商品及更新前快照；点击「打开详情」查看来源商品。

微信和手机各自显示「待获取」「已获取」「本次未提供」或「更新失败」。历史值被保留时会明确标记，不代表本次获取成功。顶部「微信有效」「手机有效」统计的是当前状态为已获取的商家数，并非联系方式可接通或可添加的验证结果。

每家商家最多保留最近 30 个来源商品和 10 次更新前快照。

导出 CSV / JSON

1. 停止采集或单商家更新，进入「商家通讯录」。
2. 设置搜索词和联系方式状态，确定需要导出的范围。
3. 点击「导出 CSV / JSON」，选择导出批次。
4. 点击「准备文件并选择目录」，等待文件准备完成，再选择安全的本地目录。准备期间可点击「取消准备」。

每次导出当前筛选范围中的一个批次，每批最多 50,000 家，每个文件最多 250 家，同时生成 CSV 和 JSON 文件。更多数据需分别选择后续批次导出。

• CSV 包含商家 ID、名称、微信和手机的最后成功值、各自状态、检查时间、成功时间及来源商品与链接。
• JSON 包含商家记录及其来源、历史信息。
• 导出按入库先后排序，与通讯录页面的新入库优先顺序不同。
• 导出期间通讯录发生更新会中止，请停止更新后重新导出。
• 导出文件包含明文联系方式，不受界面「显示明文」开关影响，请妥善保存。

查看任务记录

「任务记录」保留最近 30 次批量采集或单商家更新，显示开始与结束时间、关键词、完成数量、扫描数量、跳过已保存数量、去重数量及停止原因。

记录区分「已完成」「已停止」和「受限 / 异常暂停」。被停止或异常中断的任务，其已保存结果仍可在通讯录中查看。

注意事项

• 登录失效、限流、验证码、联系方式展示额度、网络异常或平台拒绝等情况会停止任务，不自动重复请求联系方式。请按提示在百应窗口处理后手动重新操作。
• 商品范围和联系方式是否提供由平台决定；应用不绕过平台限制，也不保证获取平台可返回范围之外的商品。
• 关闭小程序界面后，后台任务可继续；关闭百应主浏览器窗口或退出客户端会停止运行。客户端重启后不会自动续跑。
• 通讯录不设固定累计条数上限，但实际容量受本地磁盘、设备性能及宿主约束影响，并非无限容量。
• 数据保存在当前小程序的工作区中，不进入分享的小程序发布包。仅用于平台允许的商家合作联系，请遵守账号额度和平台使用规则。