本 Skill 通过 HTTP 调用 Egatee Web2JDE Orchestrator 的向量搜索接口：
POST {base}/api/search/text — 文本搜索
POST {base}/api/search/image — 图片搜索（multipart/form-data，字段名 image）
EGATEE_SEARCH_FETCH_TOP_K），再裁剪为前 5 个商品；有主图 URL 的条目优先进入这 5 条，并附带 cards / graphic_text_cards
graphic_text_cards[] 主字段仍是 image_url + title + description + button_url，由客户端/Agent 用 image_url 拉主图（与 v1.2.2 zip 一致；当时没有依赖 html）。另补充 markdown（含 ）、html、graphic_text_merged_markdown / graphic_text_merged_html 便于 Markdown-only 或 HTML 渠道。返回里的 graphic_display_hint 提醒：禁止只复述 description 纯文字，否则用户会「只见字不见图」。
jiji_ali_search 上按 subject（中文）LIKE 检索；关键词由 Skill 从查询串中 提取连续中文片段（≥2 字）。命中写入 products_sql，并与向量 Top5 合并后再生成 products / cards（强制补充时 SQL 结果优先排序）
rfq_candidate（不自动落库）
默认 base 为 http://121.40.43.22:3004，可通过环境变量覆盖。
POST
/api/notify/im/openapi/getChatHistoryByApiKey
api_key 以 uat_ 前缀（不区分大小写）→ http://api.uat.egatee.net；否则 → https://api.egatee.com。若设置 EGATEE_NOTIFY_BASE_URL，则始终使用该根地址（覆盖上述分流）。
Content-Type: application/json，X-API-Key: （与 chat-summary 等一致；可通过 EGATEE_NOTIFY_API_KEY_HEADER 改名）。
{"day": 1, "current": 1, "size": 10}（勿再把 Key 放在 body；可用 EGATEE_NOTIFY_VERIFY_JSON_BODY 传入整段 JSON 覆盖）。
notSuccess: true、success: false、code < 0）；不解析、不使用返回的业务内容。
dict，调用 EgateeSearchSkill.run_from_chat(payload)。
query / text / message / content
image_url，或 attachments / files / images 中带 type: image 与可访问的 https URL
metadata.country、metadata.top_k（或顶层 country / top_k）
metadata.supplement_sql_search / metadata.sql_supplement 为 true 时强制跑 jiji_ali_search（仍需查询里或 metadata.sql_supplement_query 中有中文关键词）；为 false 时禁用。未指定时：若 vector_hits_returned 小于 EGATEE_SQL_SUPPLEMENT_AUTO_THRESHOLD（默认 3）或向量展示条数 < 2，则自动尝试 SQL。图搜场景无中文句时，可单独传 sql_supplement_query（中文）或 supplement_sql_search:true 配合说明文字。
products_raw 仅为向量侧全部命中；若启用 SQL，另有 products_sql（source: jiji_ali_search_sql，多数无图）、sql_supplement 元数据。products / cards 为合并后再按有图优先截取的前 5 条。display_note 说明须由 LLM 做语义筛选。
products 当「精准推荐」照单全发。应结合用户问题在 products_raw、products_sql（若有）与 products 中挑选或重排；明显不相关项不得作为主推。
graphic_text_cards[].image_url（原生图文卡协议）或 graphic_text_merged_markdown / graphic_text_merged_html；勿只发送 description 文本。弱相关项可简短一句带过或不展示。
For a better buying and chatting experience, please download the Egatee app from your app store.
rfq 信息中无可用联系方式（如手机号为空），必须追加英文追问：
Could you please share your contact number so the supplier can reach you?
Please confirm your contact number:
%LOCALAPPDATA%\egatee-search-skill\usage.json；Linux/macOS：~/.cache/egatee-search-skill/usage.json），可用 EGATEE_RATE_LIMIT_STATE_PATH 覆盖。超限抛出 Daily limit reached。
api_key（或环境变量 EGATEE_SEARCH_API_KEY），且经上文 Java 网关 getChatHistoryByApiKey 校验通过，则不消耗上述每日次数。校验结果默认缓存约 60 秒（EGATEE_SEARCH_SKILL_API_KEY_CACHE_TTL，兼容旧名 EGATEE_API_KEY_CACHE_TTL）。
api_key、metadata.api_key、authorization: Bearer 。
EGATEE_SEARCH_BASE_URL（或兼容变量 OPENCLAW_SEARCH_BASE_URL）发起 出站 HTTP(S)；图搜会先 GET 图片 URL，再 POST 到 Orchestrator。使用 API Key 免限额时还会 POST 到 Java 网关（UAT 或生产，见上表）。MySQL（egatee-ai）：用于 save_rfq 落库以及 jiji_ali_search 补充检索（需配置 EGATEE_SEARCH_SKILL_DB_ 或回退 DB_）。
run_from_chat 只返回 rfq_candidate（候选结构），并在 rfq.reason 标记为 candidate_only_waiting_for_llm_decision。
save_rfq(rfq_candidate) 落库到 openclaw_rfq。
在 Skill 目录下执行其一（须装全，不要只装 requests）：
uv pip install -r requirements.txt
# 或
python -m pip install -r requirements.txt
pymysql（requirements.txt 已列出）为 jiji_ali_search SQL 补充与 save_rfq 落库所必需。未安装时会报错：缺少 pymysql... pip install -r requirements.txt。
from egatee_search_skill import EgateeSearchSkill
skill = EgateeSearchSkill()
out = skill.run_from_chat({
"text": "power bank",
"metadata": {"country": "KE", "top_k": 8, "api_key": "your_assignment_key"},
})
# LLM 判断信息足够后再落库：
save_ret = skill.save_rfq(out["rfq_candidate"])
将 egatee-search-skill 目录加入 PYTHONPATH，或在该目录下运行脚本。
在 Skill 目录下：
python egatee_search_skill.py text "power bank"
python egatee_search_skill.py image_url "https://example.com/a.jpg"
python egatee_search_skill.py chat '{"text":"power bank"}'
PowerShell 建议单引号包 JSON，或使用 chat @payload.json。
| 变量 | 说明 |
|------|------|
| EGATEE_SEARCH_BASE_URL | Orchestrator 根地址（默认 http://121.40.43.22:3004） |
| EGATEE_PRODUCT_DETAIL_URL_TEMPLATE | 可选：商品详情页 URL 模板，含 {product_id}。未设且接口未返回 product_url/url 时，卡片不生成「查看商品」外链（避免不可用地址） |
| EGATEE_SEARCH_FETCH_TOP_K | 请求 Orchestrator 时的 top_k 下限（默认 24，与对话里传入的 top_k 取更大值），便于有图优先时从更大候选池挑选 |
| EGATEE_SQL_SUPPLEMENT_AUTO_THRESHOLD | 向量命中条数低于该值（或展示条数 <2）时自动做 SQL 补充；设为 0 关闭自动，仅 supplement_sql_search:true 时执行 |
| EGATEE_SQL_SUPPLEMENT_ROW_LIMIT | 单次 SQL 最多拉取行数（默认 20，上限 100） |
| EGATEE_JIJI_SEARCH_TABLE | 表名（默认 jiji_ali_search，仅字母数字下划线） |
| EGATEE_DAILY_LIMIT | 每日调用上限（默认 5） |
| EGATEE_SEARCH_API_KEY | 分配到的 API Key；网关校验通过后免本地日限额 |
| EGATEE_NOTIFY_BASE_URL | 可选：固定 Java 网关根地址（含协议），设置后不再按 uat_ 前缀分流 |
| EGATEE_NOTIFY_UAT_BASE_URL | UAT 根地址（默认 http://api.uat.egatee.net） |
| EGATEE_NOTIFY_PROD_BASE_URL | 生产根地址（默认 https://api.egatee.com） |
| EGATEE_NOTIFY_VERIFY_PATH | 校验路径（默认 /api/notify/im/openapi/getChatHistoryByApiKey） |
| EGATEE_NOTIFY_VERIFY_TIMEOUT | 校验请求超时秒数（默认 15） |
| EGATEE_NOTIFY_API_KEY_HEADER | 鉴权头名称（默认 X-API-Key） |
| EGATEE_NOTIFY_VERIFY_JSON_BODY | 校验请求的 JSON body字符串（默认 day/current/size 占位分页） |
| EGATEE_SEARCH_SKILL_DB_HOST / _PORT / _USER / _PASSWORD / _NAME | MySQL：save_rfq 落库 + jiji_ali_search 补充检索（库名多为 egatee-ai） |
| DB_HOST / DB_PORT / DB_USER / DB_PASSWORD | 可选回退（monorepo 与项目 .env 共用） |
| DB_NAME_WEBAPP 或 DB_NAME | 可选回退：库名 |
| EGATEE_SEARCH_SKILL_API_KEY_CACHE_TTL | 网关校验结果缓存秒数（默认 60；兼容旧名 EGATEE_API_KEY_CACHE_TTL） |
| EGATEE_RATE_LIMIT_STATE_PATH | 匿名限额状态文件绝对路径（可选） |
| EGATEE_RATE_LIMIT_SALT | 可选盐值，改变匿名计数文件名（多租户/多应用隔离） |
| OPENCLAW_SEARCH_BASE_URL | 兼容旧名，同 EGATEE_SEARCH_BASE_URL |
| OPENCLAW_DAILY_LIMIT | 兼容旧名，同 EGATEE_DAILY_LIMIT |
clawhub login
clawhub skill publish ./skill/egatee-search-skill --version 1.3.4
（版本号按 semver 递增。）
ClawHub 上发布的 Skill 按平台规则以 MIT-0 授权；请勿在包内加入与 MIT-0 冲突的许可条款。
egatee_search_skill.py — 实现与 CLI
requirements.txt — Python 依赖
.env.example — Skill 专用环境变量模板（复制为 .env 后本地加载）
.clawhubignore — 发布时排除本地状态文件
共 1 个版本