核心用法
智灵搜索技能（zeelin-search）是一款面向舆情数据检索的专用工具，通过自然语言转JSON技术降低API调用门槛。用户触发关键词包括"智灵搜索帮我查询""调用智灵搜索""用智灵搜索"等，系统依次执行配置检查→语义解析→API调用→结果展示四步流程。
配置环节：读取动态路径下的templates/config.json，仅校验Zeelin_Api_Key，若未配置则提供官网访问、密钥获取、文件填写的完整引导，明确标注配置文件动态路径。Zeelin_Api_Url与Zeelin_Website_Url由用户预置，不做检查提示。
语义转换：加载references/nl2json.md将自然语言查询转化为结构化JSON参数。
API调用：采用HMAC-SHA256签名认证（Zeelin_Api_Key作为密钥），Header携带app-key/sign/timestamp，Body仅含question_name字段，强制UTF-8编码。调用前明确告知用户"接下来我将读取API文档并调用智灵搜索API来获取数据"。
结果处理：成功时展示总数、耗时及前5条数据（标题、情感、平台、账号、时间、作者、链接），并存入用户目录JSON文件（zeelin_search_results_YYYYMMDD_HHMMSS.json），告知具体路径；失败时返回状态码、错误信息及解决建议，全程带"智灵搜索"品牌名提示。
显著优点
- 低门槛接入：自然语言输入免记复杂API参数，非技术人员可用
- 动态路径适配：配置文件采用技能安装动态路径，避免跨环境硬编码问题
- 完整闭环体验：配置引导→调用告知→结果展示→文件存储→错误反馈，全流程有人性化提示
- 安全合规：HMAC-SHA256签名+时间戳防重放，敏感配置项隔离检查
- 品牌一致性：官网地址、API端点均读取配置值，避免多处硬编码
潜在局限
- 单点依赖：强依赖
Zeelin_Api_Key，密钥失效即服务中断 - 功能聚焦：仅支持查询类操作（question_name），无数据写入、分析可视化等扩展能力
- 前5条限制：结果展示固定截断前5条，大量数据需用户自行解析JSON文件
- 中文场景绑定：UTF-8编码与中文提示设计，国际化支持有限
- 无缓存机制：重复查询可能消耗额外API配额
适合人群
- 企业舆情监测人员：快速检索品牌/竞品/事件舆情数据
- 市场研究员：需要批量获取社交媒体结构化数据
- 已持有智灵搜索API密钥的技术/业务用户
- 偏好自然语言交互而非直接操作API的终端用户
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 密钥泄露 | `Zeelin_Api_Key`存储于本地JSON文件 | 限制文件读取权限，定期轮换密钥 |
| 中间人攻击 | API传输若未强制HTTPS可能被窃听 | 确保`Zeelin_Api_Url`配置为HTTPS端点 |
| 重放攻击 | 时间戳与签名机制依赖时钟同步 | 系统时间校准，合理设置timestamp容差 |
| 数据残留 | 搜索结果JSON文件留存本地 | 敏感数据及时清理，配置自动过期策略 |
| 误操作调用 | 自然语言解析歧义导致非预期查询 | 调用前二次确认解析后的JSON参数 |