22 Feb, 2026
1 commit
-
一、命名与引用统一 ----------------- - 全文将 [SEARCH_REF:ref_id] 统一为 [SEARCH_RESULTS_REF:ref_id]。 - README_prompts.md: 文档中两处 SEARCH_REF 改为 SEARCH_RESULTS_REF。 - app/agents/shopping_agent.py: 系统提示与注释中的 SEARCH_REF、make_search_products_tool 改为 SEARCH_RESULTS_REF、search_products。 - app/search_registry.py: 注释与 docstring 中的 SEARCH_REF 改为 SEARCH_RESULTS_REF。 - app.py: SEARCH_REF_PATTERN 重命名为 SEARCH_RESULTS_REF_PATTERN，正则与注释同步。 - app/tools/search_tools.py: 工具返回与注释中的 SEARCH_REF 改为 SEARCH_RESULTS_REF。 二、search_registry：ref_id 改为会话内自增 ----------------------------------------- - 移除 new_ref_id()（原 uuid 短码）；ref_id 改为按 session 自增：sr_1, sr_2, ... - SearchResultRegistry 新增 _session_counter 与 next_ref_id(session_id)。 - register 逻辑不变；clear_session 时同时清除 _session_counter。 三、search_tools：搜索逻辑统一、去除重复 --------------------------------------- - 新增 _call_search_api(query, size)：仅调用搜索 API，返回 (raw_results, total_hits) 或 None。 - 新增 _raw_to_product_items(raw_results, labels=None)：将 API 原始结果转为 list[ProductItem]；有 labels 时按 Relevant/Partially Relevant 过滤并打标，否则全部打 Partially Relevant。 - 新增 search_products_impl(query, limit, *, assess_quality=True, session_id=None, registry=None)：唯一搜索实现；返回 (ref_id_or_none, products, assessed_count)。assess_quality 且提供 session_id/registry 时执行 LLM 评估并写入 registry，否则仅调 API 并返回产品列表。 - make_search_products_tool 内 search_products 改为调用 search_products_impl(..., assess_quality=True, session_id, registry)，根据返回值拼工具说明文案；使用 registry.next_ref_id(session_id)。 - 新增 search_products_api_only(query, limit=12)：薄封装，调用 search_products_impl(..., assess_quality=False)，返回 list[ProductItem]，供前端「找相似」侧栏使用（仅 API，不做 LLM 评估）。 四、app.py：前端性能与交互优化 ----------------------------- 1) 图片缓存 - 模块级 _IMAGE_CACHE (OrderedDict)，最多 100 条；key 为 image_url 或 "local:{path}"。 - _load_product_image：先查缓存，命中则 move_to_end 并返回；未命中则请求/读本地后写入缓存并做 LRU 淘汰。 2) 减少全量 rerun（fragment） - render_referenced_products_in_input、render_bottom_actions_bar 加 @st.fragment，删除引用 / 点 Ask·Compare 时只重跑对应片段。 - 侧栏内容用 @st.fragment 的 _sidebar_fragment() 包裹，在 with st.sidebar 内调用，Clear Chat 时只重跑侧栏。 3) 「找相似」：先 loading，再仅调搜索 API - 点击 Similar products 时只设置 side_panel.payload = { query, loading: True } 并 rerun，侧栏先显示「加载中…」。 - main() 中若 side_panel.mode=="similar" 且 payload.loading，则调用 search_products_api_only(payload["query"], 12)，将结果写入 payload.products、loading=False，再 rerun。 - render_side_drawer：payload.loading 显示加载中；payload.products 存在则用该列表渲染卡片；否则保留基于 ref_id + registry 的兼容逻辑。 - 删除 _run_similar_search（原完整 search tool + LLM 评估），改为上述流程。 4) 长对话渲染 - 仅渲染最近 50 条消息（MAX_MESSAGES=50），msg_index 用 start_idx + i 保持 widget key 稳定；超过 50 条时顶部显示「仅显示最近 50 条，共 N 条消息」。 Co-authored-by: Cursor <cursoragent@cursor.com>
21 Feb, 2026
2 commits
20 Feb, 2026
1 commit
18 Feb, 2026
1 commit
-
2. add web sch tools