SuperAPI AI 工具集

bargainbadger-price-update

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

用途:把一次 minimoths 爬取会话(一次会话覆盖某商品词在各商店的抓取)转换为商品笔记中带日期的价格小节,更新后的笔记即为交付物。即使请求以“哪个价格最好”提问,任务也只是记录价格,而非挑选最优。商品是参数,同一流程适用于会话所搜索的任何商品。

使用方式:先阅读库中的规范。先读枢纽笔记 /Users/mtm/Documents/Obsidian Vault/bargainbadger.md,再读其 Contents 部分链接的每篇笔记,并跟进二级链接;wikilink 通过库路径加链接文本加 .md 后缀解析。Contents 列表刻意未在此复述,因为笔记会增删改名,应以当天枢纽所列内容为准。本文件是工作流而非参考,不陈述数据、数据库或 schema 的事实;缺失事实应补入库而非本文件。

触发条件:仅在要求把价格写入商品笔记时运行,例如“我刚搜索了 shallots,能否更新 shallots 的 markdown 文件,按今天新增价格小节”“给 leeks 笔记加一个价格小节”“现在 cultured butter 的最优价格是多少”。不触发:为开发 schema 而采样数据库、添加变更日志条目、以及任何不以写入商品笔记的表格为终点的请求。

流程:读规范;确认会话实际搜索内容;解析商品笔记且绝不顺带创建;拉取会话行并收窄到该商品,报告抓取、保留、丢弃的行数;分批把 schema 字段抽取到库外的临时文件;所有派生价格用代码计算,不得手算;按“小节布局”渲染表格,插入到最新已有小节之上,旧小节不动,无则新建;提交笔记并删除临时文件。除第 7 步布局外,各步规则均来自规范,包括表格列、内容与行序。规范未覆盖时,沿用笔记中最近的价格小节格式,并作为规范缺口报告,而非默默采用。

小节布局:价格小节为表格加一个子节。表格紧接带日期标题之下,中间无内容;### notes 承载该小节全部散文,开头写运行 id、商店数、范围、抓取/保留/丢弃行数,再写主要发现,然后写表格构建方式(收窄、保留与转出的变体、列词汇归一化、逐行处理、未产生行的列表及原因)。不要进一步细分该子节。当商品需多张表时,各表用 ### 标题命名依据,如 ### priced by weight 与 ### priced by volume,### notes 置于最后。旧小节的其他子节名不得沿用。

非目标:决定 schema 问题、更新笔记 front matter 中的商店布尔字段、推荐购买商品或商店、运行爬取(由用户在调用前完成)。

排除单杯胶囊:Keurig、K-Cup、Nespresso 等单杯胶囊永不出现在价格小节,在收窄步骤丢弃且不标价;若爬取同时返回袋装与胶囊,只对袋装制表,并在 ### notes 记录因长期偏好排除胶囊、给出数量,并点名仅售胶囊而完全退出表格的商店。

Schema 变更:权威约定在库笔记 bargainbadger change log.md 的引言中,枢纽笔记链接到它,变更前先读。每次 schema 变更都要有带日期条目,点名触发商品,内联引用抓取到的列表文本并解释其中迫使变更之处,并给出 productUrl;证据与变更同一次编辑写入。绝不包含数据库行 id 或抓取时间戳,因为数据库会定期清空,只有引用文本与 productUrl 会留存。