klarkxy 知乎搜索插件使用指南
本插件封装了知乎开放平台的四个核心 API：知乎搜索、全网搜索、知乎直答、热榜。插件自动追踪每日免费额度（1000 次/天，共享于 zhihu_search + global_search），并根据问题特征智能选择搜索源。
第一步：配置密钥
在首次使用任何搜索工具之前，必须先配置 Access Secret：
- 引导用户前往 https://developer.zhihu.com/profile 获取 Access Secret
- 调用
set_zhihu_api_key工具，传入accessSecret参数 - 工具会自动验证密钥有效性
密钥会在插件的数据目录中持久保存，后续无需重复配置。
工具列表与选择策略
| 工具 | 用途 | 额度 | 适合场景 |
|---|---|---|---|
zhihu_search |
知乎站内搜索 | 共享每日 1000 次 | 常规知乎内容搜索 |
global_search |
全网搜索（含知乎内容） | 共享每日 1000 次 | 需要站外信息、最新资讯 |
zhida |
知乎直答（深度问答） | 独立额度 | 复杂、分析性问题 |
hot_list |
知乎实时热榜 | 不计入限制 | 仅用户主动要求时使用 |
query_zhihu_quota |
查询额度使用 | — | 查询今日剩余次数 |
智能选择逻辑
当用户提出搜索类请求时，按以下优先级判断：
- 先查额度 —— 如果今日免费额度（zhihu_search + global_search）还有剩余
- 普通问题 →
zhihu_search（知乎站内搜索） - 需要最新/全网信息 →
global_search（全网搜索）
- 普通问题 →
- 额度用尽时 → 自动转用
zhida（知乎直答），它使用独立额度 - 复杂问题 —— 无论额度是否充足，如果问题属于以下特征，直接用
zhida：- 问题长度超过 80 字
- 包含多个问号或分句
- 包含分析类关键词：为什么、如何、原理、机制、分析、比较、区别、优缺点、影响、关系、论证、解释、趋势等
- 热榜 ——
hot_list仅当用户主动要求查看热榜时才调用，不得主动推送或定时抓取热榜内容 - 额度查询 —— 当用户询问「还有多少额度」「每天能搜多少次」时，用
query_zhihu_quota
综合示例
用户问：「量子计算的原理是什么？」→ 这是复杂问题 → 调用 zhida
用户问：「最近有什么热门新闻？」→ 这是搜索需求 → 检查额度：
- 有额度 →
global_search（全网搜索） - 额度用尽 →
zhida
用户问：「知乎热榜今天有什么？」→ 用户主动要求热榜 → 调用 hot_list
用户问：「今天还能搜多少次？」→ 调用 query_zhihu_quota
注意事项
- 所有搜索工具都依赖 Access Secret，未配置时会返回明确提示
- API 调用携带 Bearer Token 和秒级 Unix 时间戳，插件自动处理
- 额度数据每日自动重置（北京时间）
zhida不计入免费额度，但可能有独立计费规则hot_list仅在用户主动要求时调用——不要在工具调用中自行触发热榜- 如果用户未提供密钥，不要尝试用空密钥调用 API，先请用户提供