CleverSee 共享搜索工具
CleverSee CNAuto是已确定的主检索提供方。独立CLI与Hermes原生web_search共用同一客户端，适合为名称发现及公开资料核对提供来源。
在项目中调用
python3 -m entity_search '瑞金医院 年门诊量' --limit 6Hermes可直接调用原生web_search(query, limit)。凭据由部署者在私有配置或进程环境中提供，本公开站不收集或展示Key，也不代访问真实搜索接口。
参数
| 参数 | 语义 |
|---|---|
| query | 1–500字符，建议简明且尽量30字符以内，不静默截断 |
| --limit | 1–10，默认6 |
| --time-range | NoLimit、OneDay、OneWeek、OneMonth、OneYear；约束页面时间 |
| --raw | 加入脱敏上游原响应 |
| --refresh | 跳过一小时缓存，可能重新产生用量 |
| --health | 无网络检查本地配置，不证明账户或额度可用 |
请求开启索引正文与相关度，关闭增强摘要；单次25秒超时、响应上限8MB，不自动重试或跨提供方回退。空结果仍是一次成功执行的检索。
返回值
顶层包含success、status、provider、engine、results、usage、cached、queried_at。每条结果含title、url、snippet、main_text、published_at、relevance和evidence_kind=search_index。
失败状态包含INVALID_INPUT、CONFIG_ERROR、AUTH_ERROR、QUOTA_EXCEEDED、FORBIDDEN、RATE_LIMITED、HTTP_ERROR、REQUEST_ERROR、INVALID_RESPONSE、RESPONSE_TOO_LARGE、CACHE_ERROR、BUSY及上游错误。不要将失败当无结果，或循环重试导致重复费用。
缓存与成本
相同query／条数／时间范围的成功结果缓存1小时，同查询锁避免并发重复请求。命中缓存时保留原queried_at并增加served_at；usage表示原响应计量，不等于缓存命中也再次扣费。
Hermes还有自己的进程内缓存和条数分桶，当前6条请求可能向插件传10条，再裁成6条。跨CLI与原生工具比较缓存时需核对条数。Hermes既有救援策略可能影响失败后的实际后端，应保留backend_error及来源，不将救援结果标成CleverSee。
已验证与尚未验证
已完成Hermes原生首次、重复请求、新进程和跨用户共享缓存验证；共享技能可发现。尚未把它接入医院API的通用名称推理／近似统计字段填充，也未执行完整Hermes模型问答验收。原文提取仍是独立步骤。