用途:为 Agent 接入知乎开放平台的四项能力——知乎搜索、全网搜索、知乎直答、热榜,并在多来源之间按额度与问题特征自动选择。
主要能力与额度:zhihu_search 为知乎站内搜索,global_search 为全网搜索(含知乎内容),二者共享每日免费额度 1000 次;zhida 为知乎直答,适合复杂分析性问题,使用独立额度;hot_list 为知乎实时热榜,不计入限制;query_zhihu_quota 用于查询今日剩余次数。
使用方式:首次使用前须配置 Access Secret,先前往 https://developer.zhihu.com/profile 获取,再调用 set_zhihu_api_key 工具并传入 accessSecret 参数,工具会自动验证有效性,密钥持久保存在插件数据目录,后续无需重复配置。API 调用携带 Bearer Token 和秒级 Unix 时间戳,由插件自动处理。额度每日按北京时间自动重置。
选择逻辑:普通搜索请求优先用 zhihu_search;需要最新或全网信息用 global_search;当上述共享额度用尽时自动转用 zhida。对于复杂问题,如长度超过 80 字、含多个问号或分句、或含为什么、如何、原理、机制、分析、比较、区别、优缺点、影响、关系、论证、解释、趋势等分析类关键词,则直接使用 zhida。hot_list 仅在用户主动要求查看热榜时调用,不应主动推送或定时抓取。用户询问剩余额度时使用 query_zhihu_quota。
限制:所有搜索工具均依赖 Access Secret,未配置时会返回明确提示,不应以空密钥调用;zhida 不计入免费额度,但可能有独立计费规则;hot_list 不得自行触发。资料未提供具体价格、平台支持范围等信息。