该技能用于按专利标识查询专利族信息，数据来自 Nexscope 平台。调用前提是配置 NEXSCOPE_API_KEY 环境变量；凭证缺失或过期时，可通过指定帮助页面补充额度。
用途 用户提到专利族、等同专利、同族成员、INPADOC 族或想比较不同族定义时使用。技能返回指定专利在 Simple Family、INPADOC Family、Nexscope Family 三种定义下的族成员列表与族标识。
概念说明 专利族指通过优先权主张相互关联的专利文献集合。Simple Family 指共享完全相同优先权申请集合的专利，通常是不同国家的直接等同件；INPADOC Family 是欧洲专利局定义的更宽分组，链接至少共享一项优先权的专利（包括间接共享）；Nexscope Family 是 Nexscope 的专有定义，在 INPADOC 逻辑基础上增加启发式规则，以涵盖延续案、分案等相关申请。响应中每条专利记录分别带有 simpleFamilyId、inpadocFamilyId、patsnapFamilyId。
使用方式 可通过 API 端点 POST /zhihuiya/patentFamily 调用（完整参数、响应与错误码见 references/api.md），也可运行 Python 脚本：python scripts/patent_family_data.py '<JSON params>' [--inline]。
参数规则 patentId 与 patentNumber 至少提供一个；两者都提供时以 patentId 为准，忽略 patentNumber。patentId 可含最多 100 个逗号分隔的专利 ID；patentNumber 仅支持单个公开号或公告号，不能传多个逗号分隔值。批量请求最多 100 个，提交前应先确认批量范围。
输出策略 脚本默认把完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-zhihuiya-patent-family-<timestamp>.json，其中 <cwd> 为执行时工作目录，<session> 取自 SESSION_ID 环境变量；禁止写入 /tmp，目录不可写会报错。响应体不超过 8 KB 时写盘后向标准输出打印完整 JSON；超过 8 KB 时仅打印摘要（顶层字段、total/costToken 等常用计数、最大列表字段长度及前 3 个样本）。加 --inline 可强制完整输出到标准输出，但仍会写盘。建议先看摘要，再按需用 jq 或 ConvertFrom-Json 从保存文件提取字段。
响应字段 包括 total（返回记录数）、data（记录数组，含 patentId、pn、simpleFamilyId、simpleFamily、inpadocFamilyId、inpadocFamily、patsnapFamilyId、patsnapFamily）、columns（渲染列定义）、costToken（本次消耗 token 数）和 type（渲染风格提示）。
示例 按公开号查询：{"patentNumber": "US10000001B2"}；按专利 ID 查询：{"patentId": "5af83e12-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}；比较族范围：查询 US20200012345A1 后对比 simpleFamily 与 inpadocFamily 数组。
展示建议 以结构化表格呈现，按族类型分组；说明各类型族成员数量；列出成员时标注国家或地区以展示保护范围；按每条专利分别展示；遇到错误或空结果时解释可能原因（号码格式无效、数据库中未找到等）并建议修正。仅呈现事实数据，不提供专利范围、有效性或侵权的法律意见。
限制 仅支持已知专利的族查询，不能做关键词检索或全文检索；批次最多 100 个；数据来自 Nexscope 数据库，可能相对最新专利局公开有轻微延迟；族成员数组为摘要对象，获取单个成员完整著录数据可能需另行查询。该工具消耗额度，同一参数组合每会话默认只调用一次，失败或空结果后不要自动重试。