everythingsearch-local

EverythingSearch 本地 API（Skills）

本 Skill 指导 Agent 通过 本机已启动的 EverythingSearch HTTP 服务（默认 http://127.0.0.1:8000）完成：

• 直接搜索：GET /api/search（向量 + 关键词混合，不经过大模型）
• 自然语言搜索：POST /api/search/nl（DashScope 意图识别 → 结构化检索，可触发「精确优先」路径）
• 搜索结果智能解读：POST /api/search/interpret 或 /api/search/interpret/stream（基于当前结果列表的短总结）
• 读文本 / 下载 / 在 Finder 中揭示 等与历史一致的能力

设计细节与 Web 行为见仓库内 docs/NL_SEARCH_AND_WEB_UI.md；完整路由与配置见 docs/PROJECT_MANUAL.md 第 4.6 节。

前置条件

1. 用户已在本机运行搜索服务（例如 ./scripts/run_app.sh start）。
2. 若连接失败，提示用户先启动服务并确认 config.py 中的 HOST / PORT（多实例安装可查看 scripts/.launchd_instance 中的 APP_PORT）。
3. 非本机访问时由用户提供完整服务基址（须带 scheme，例如 http://192.168.1.10:8000）。

BASE="http://127.0.0.1:8000"   # 按 config.HOST / config.PORT 或用户给出的 URL 调整

智能能力对 DashScope API Key 的依赖

• GET /api/search：不调用生成式模型；仅需本地向量库已构建（嵌入阶段仍需要 Key 建索引）。
• POST /api/search/nl、/api/search/interpret*：服务端需在 config.py 配置 MY_API_KEY。未配置时这些接口会返回业务错误（如 MISSING_API_KEY），Agent 应退化为 GET /api/search 完成检索。
• 意图识别与解读会访问外网模型服务；默认限流见配置 RATE_LIMIT_NL_PER_MIN、RATE_LIMIT_INTERPRET_PER_MIN（常见默认各约每分钟每 IP 10 次，以 everythingsearch/infra/settings.py 为准）。

1. 直接搜索（混合检索，无大模型）

语义与关键词混合检索；结果中 preview 为围绕命中的短片段。

RESULT_JSON="$(mktemp /tmp/essearch.XXXXXX.json)"
printf '%s\n' "$RESULT_JSON"
curl -sG "$BASE/api/search" \
  --data-urlencode "q=你的关键词或短句" \
  --data-urlencode "source=all" \
  --data-urlencode "limit=30" \
  -o "$RESULT_JSON"

可选查询参数（与校验逻辑一致时）：date_field（mtime|ctime）、date_from、date_to、limit（1～200）。

• source: all | file | mweb（若实例关闭 MWeb，勿用 mweb）。
• 注意：GET /api/search 没有 exact_focus 参数；「精确优先」检索仅由下面的 NL 路径在解析出 exact_focus 后触发。

响应 JSON：results[] 含 filename, filepath, preview, relevance, tag（如「语义匹配」「精确匹配」）, mtime, source_type 等；另有 query 字段。

2. 自然语言搜索（意图 → 检索）

将用户整句自然语言交给模型解析为结构化检索参数（核心检索词 slots.q、来源、时间、match_mode 等），再执行与 Web 相同的搜索管线。

RESULT_JSON="$(mktemp /tmp/essearch-nl.XXXXXX.json)"
printf '%s\n' "$RESULT_JSON"
curl -s -X POST "$BASE/api/search/nl" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "帮我找去年关于预算的 excel",
    "sidebar_source": "all",
    "date_field": "mtime",
    "date_from": null,
    "date_to": null,
    "limit": 30
  }' \
  -o "$RESULT_JSON"