用途：通过专利ID或公开号查询智慧芽（PatSnap）平台的专利家族信息，帮助发现简单同族（Simple Family）、INPADOC同族和PatSnap同族成员，用于了解专利的跨国布局与保护范围。
主要能力：支持按patentId或patentNumber查询，二者至少提供一个，同时提供时以patentId优先；多个值用逗号分隔，单次最多100条。返回每条专利的simpleFamilyId、inpadocFamilyId、patsnapFamilyId及对应家族成员数组，并含total、columns、costToken等字段。
使用方式：API端点为POST /zhihuiya/patentFamily；也可运行脚本：python scripts/zhihuiya_patent_family.py '<JSON 参数>' [--inline]。脚本默认将完整响应写入当前工作目录下的linkfox/<日期>/<session>/data/目录，响应体≤8KB时打印完整JSON，>8KB时仅输出摘要，加--inline可强制全量打印。建议先看摘要，再用jq或ConvertFrom-Json从保存文件按需抽取字段。
认证与计费：需配置环境变量LINKFOX_AGENT_API_KEY或LINKFOXAGENT_API_KEY；出现401/402或余额不足提示时按references/onboarding.md处理。计费按动态规则：消耗算力=81×返回data条数，可能一次性消耗大量算力，需提醒用户确认。同一会话同一参数默认只调用一次，脚本带24h本地缓存；失败或空结果不得自动换关键词或翻页试探。
适用场景：查询指定专利的同族、查找等同专利、了解专利在哪些国家/地区申请、比较简单同族与INPADOC同族范围、批量查询多个专利的同族。
限制：仅支持已知专利的同族查询，不能做关键词或全文检索；单次最多100条；数据来自智慧芽数据库，可能相对最新公开有延迟；家族成员数组为摘要对象，获取完整著录信息需另行查询；不提供法律意见、专利估值、诉讼、侵权或申请代理服务。