核心用法
Fruit Pi 是一款面向农产品采购、零售及行情分析场景的价格追踪工具,核心功能围绕「水果池」展开——用户可将关注的水果(如金枕头榴莲、山竹、阿克苏苹果等)加入池中,系统定时或手动触发价格采集,最终以统一的 ¥/kg 格式呈现。
触发方式分为两类:
- 价格模式(「水果派」「果价」):执行完整收集流程,包括读取水果池、调用脚本爬取配置来源、搜索补采、格式化输出。
- 列表模式(「水果池」「看看水果池」):仅列出当前跟踪的水果清单,不执行价格采集,便于快速查看关注范围。
价格收集采用「脚本优先+搜索兜底」的双层机制:先运行 fruit-pi.py 从配置的惠农网、Talad Thai、Tridge 等来源抓取数据;若脚本返回 no_price 或价格超过48小时未更新,则自动触发 web_search,按地区策略搜索(国内用「批发价+今日」,东南亚用英文+wholesale price+国别+年月)补充采集。最终统一进行单位归化(斤→kg、磅→kg)和货币换算(外币→RMB),保留原始价格作为参考。
用户可通过自然语言管理水果池:「把榴莲加入水果池」「给荔枝加个新来源」「移除山竹」等,系统自动维护 fruit-pool.json 的结构化数据。输出采用分栏格式,标注报价来源、RMB价格、外币原价及汇率来源,底部附当季推荐(荔枝5-7月、樱桃5-7月等)和用法提示。
显著优点
1. 多源聚合与归一化:支持国内外批发平台(惠农网、一亩田、Talad Thai、Tridge、FAO等),自动换算为 ¥/kg,消除单位与货币混乱。
2. 时效性控制严格:48小时新鲜度阈值,过期数据主动搜索补采,避免展示陈旧价格误导决策。
3. 交互门槛低:自然语言指令管理水果池,无需记忆命令参数;触发词覆盖中英文及口语化表达(「水果派」「看看水果池」)。
4. 场景适配广:既满足个人用户「今天榴莲什么价」的即时查询,也支持商户批量跟踪多品种行情。
5. 透明度高:每笔价格标注来源平台、原始价格、汇率来源,便于用户交叉验证。
潜在缺点与局限性
1. 数据来源依赖公开渠道:批发价来自惠农网等 B2B 平台,实际成交价可能因采购量、品质等级、物流差异而浮动,仅供参考。
2. 汇率非实时精准:脚本内置默认汇率或调用外部API,存在更新延迟,极端波动行情下换算价可能偏离实际结汇成本。
3. 覆盖品种受限:依赖用户手动添加和脚本配置,小众水果或区域性品种可能无预置来源,需用户自行提供URL。
4. 无历史趋势分析:当前版本仅展示最新价格,缺乏价格走势图、季节性规律等深度分析功能。
5. 网络与反爬风险:部分平台可能有反爬机制,导致脚本失效,需频繁切换搜索策略或手动维护来源。
适合人群
- 水果零售商户:快速掌握批发端行情,辅助定价与进货决策。
- 社区团购/电商买手:多品种比价,追踪榴莲、樱桃等高价值单品波动。
- 餐饮采购人员:监控常用水果成本,控制食材预算。
- 农产品研究者/投资者:获取大宗商品价格数据,辅助行情分析。
常规风险
- 价格波动风险:展示价格为批发市场参考价,实际交易受品质、季节、汇率、物流多重因素影响,不宜作为合同定价唯一依据。
- 数据时效风险:48小时阈值虽能过滤明显过期数据,但日内价格波动(如早盘/晚盘差异)无法捕捉,高频交易需谨慎。
- 隐私与数据安全:水果池文件存储于本地
workspace/memory/,虽不上传,但多用户共享环境需注意隔离。 - 来源可靠性:第三方平台数据未经官方背书,存在数据录入错误或延迟可能,重大决策建议多渠道核实。