zhihu-search

name	zhihu-search
description	知乎开放平台搜索能力集成——在 Agent 需要搜索知乎内容、全网信息、直答或查看热榜时使用。包含每日额度管理与智能源选择策略。

知乎搜索插件使用指南

本插件封装了知乎开放平台的四个核心 API：知乎搜索、全网搜索、知乎直答、热榜。插件自动追踪每日免费额度（1000 次/天，共享于 zhihu_search + global_search），并根据问题特征智能选择搜索源。

第一步：配置密钥

在首次使用任何搜索工具之前，必须先配置 Access Secret：

1. 引导用户前往 https://developer.zhihu.com/profile 获取 Access Secret
2. 调用 set_zhihu_api_key 工具，传入 accessSecret 参数
3. 工具会自动验证密钥有效性

密钥会在插件的数据目录中持久保存，后续无需重复配置。

工具列表与选择策略

工具	用途	额度	适合场景
zhihu_search	知乎站内搜索	共享每日 1000 次	常规知乎内容搜索
global_search	全网搜索（含知乎内容）	共享每日 1000 次	需要站外信息、最新资讯
zhida	知乎直答（深度问答）	独立额度	复杂、分析性问题
hot_list	知乎实时热榜	不计入限制	仅用户主动要求时使用
query_zhihu_quota	查询额度使用	—	查询今日剩余次数

智能选择逻辑

当用户提出搜索类请求时，按以下优先级判断：

1. 先查额度 —— 如果今日免费额度（zhihu_search + global_search）还有剩余
   • 普通问题 → zhihu_search（知乎站内搜索）
   • 需要最新/全网信息 → global_search（全网搜索）
2. 额度用尽时 → 自动转用 zhida（知乎直答），它使用独立额度
3. 复杂问题 —— 无论额度是否充足，如果问题属于以下特征，直接用 zhida：
   • 问题长度超过 80 字
   • 包含多个问号或分句
   • 包含分析类关键词：为什么、如何、原理、机制、分析、比较、区别、优缺点、影响、关系、论证、解释、趋势等
4. 热榜 —— hot_list 仅当用户主动要求查看热榜时才调用，不得主动推送或定时抓取热榜内容
5. 额度查询 —— 当用户询问「还有多少额度」「每天能搜多少次」时，用 query_zhihu_quota

综合示例

用户问：「量子计算的原理是什么？」→ 这是复杂问题 → 调用 zhida

用户问：「最近有什么热门新闻？」→ 这是搜索需求 → 检查额度：

• 有额度 → global_search（全网搜索）
• 额度用尽 → zhida

用户问：「知乎热榜今天有什么？」→ 用户主动要求热榜 → 调用 hot_list

用户问：「今天还能搜多少次？」→ 调用 query_zhihu_quota

注意事项

• 所有搜索工具都依赖 Access Secret，未配置时会返回明确提示
• API 调用携带 Bearer Token 和秒级 Unix 时间戳，插件自动处理
• 额度数据每日自动重置（北京时间）
• zhida 不计入免费额度，但可能有独立计费规则
• hot_list 仅在用户主动要求时调用——不要在工具调用中自行触发热榜
• 如果用户未提供密钥，不要尝试用空密钥调用 API，先请用户提供