Zhihuiya 专利法律状态

本技能指导您如何通过 Zhihuiya（PatSnap）平台查询专利法律状态信息，帮助用户快速判断一项或多项专利当前的法律效力及历史法律事件。

调用方式

• API 端点：POST /zhihuiya/legalStatus（完整参数/响应/错误码详见 references/api.md）
• Python 脚本：python scripts/zhihuiya_legal_status.py '' [--inline]
• 成本约束：本工具将消耗积分；同一会话中、相同参数组合默认仅调用一次，脚本自带 24 小时本地缓存。失败或返回空结果时，不得自动更换关键词、翻页或修改邮编进行连续试探；如需继续检索，须先向用户说明将产生额外积分消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 /linkfox///data/linkfox-zhihuiya-legal-status-.json（其中 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录； 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp；若当前目录不可写则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印至 stdout
• 响应体 > 8 KB：落盘后 stdout 仅输出摘要（顶层字段、常见计数字段如 total/costToken、最大列表字段的长度 + 前 3 条样本）
• 添加 --inline 参数可强制将全部内容打印至 stdout（仍会同步落盘）

读取数据建议：请先查看摘要判断是否已满足需求；如需提取具体字段，优先使用 jq 或 ConvertFrom-Json 从已保存的 JSON 文件中按需抽取，避免整份 JSON 进入上下文。

解决认证和积分问题

发生以下异常情况时，请采用如下措施处理：

异常情况

• 未配置 API Key：环境变量既未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应状态码为 401 或 402
• 响应提示积分或余额不足：消息中包含“积分余额不足”、“计费不足”、“余额不足”、“quota exceeded”、“insufficient balance”、“套餐到期”、“需充值”、“请充值”等字眼，或具有类似含义的内容。

措施

• 优先调用本 skill 内置的 onboarding.md 引导用户解决问题。
• 如未找到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill，并依据其引导流程处理。若该 skill 尚未安装，请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装该 skill。如需用户授权方可下载，请主动询问用户是否授权，你不得自行放弃下载。
• 兜底措施：仅当上述两种方式经全力尝试均不可行时，才提示用户参考 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key，或前往 https://os.linkfox.com/ 补充积分。

核心概念

Zhihuiya 专利法律状态工具为每项专利返回三层法律信息：

1. 简易法律状态（Simple Legal Status） —— 专利当前法律效力的高层级概括（例如：Active、Inactive、Pending、Undetermined、PCT designated period、PCT designated expiration）。
2. 法律状态（Legal Status） —— 描述专利生命周期阶段的详细状态（例如：Published、Examining、Granted、Abandoned、Withdrawn、Rejected、Expired、Revoked、Ceased、Restoration 等）。
3. 法律事件（Legal Events） —— 已在该专利上发生的特定法律行为（例如：Transfer、License、Pledge、Opposition、Litigation、Re-examination、Customs、Preservation、Invalid-procedure、Oral-procedure、Declassification、Double application、Trust 等）。

专利标识方式：可通过专利 ID 或公开（公告）号查询专利。当两者同时提供时，以专利 ID 为准。单次请求支持提交多个值（逗号分隔，最多 100 个）。

参数说明

• 若用户提供的是公开号（例如 CN115xxxxxxA、US11xxxxxxB2、EP3xxxxxxA1），请使用 patentNumber。
• 若用户提供的是内部专利 ID，请使用 patentId。
• 当两者同时提供时，patentId 优先级更高，系统将忽略 patentNumber。

响应字段说明

使用示例

1. 检查单件专利是否仍有效

查询专利公开号 CN115000000A 的法律状态。

2. 批量查询多项专利的法律状态

查询专利 US11000000B2、EP3000000A1 和 CN115000001A 的法律状态。

3. 查询某专利涉及的法律事件

CN115000000A 是否涉及诉讼、转让或质押事件？

4. 判断专利是否已失效或被撤销

检查专利 US10000000B1 是否已失效、被撤销，或仍在有效期内。

5. 使用专利 ID 查询

查询专利 ID abc123 和 def456 的法律状态。

展示规则

1. 清晰呈现数据：以结构化表格形式展示结果，每项专利应包含公开号、简易法律状态、详细法律状态及法律事件。
2. 状态值本地化翻译：当用户语言偏好明确时，状态标签应以对应语言显示，同时括号内保留标准英文值以确保精确性。
3. 突出关键结论：若用户关注专利有效性，应在响应顶部显著标明每项专利是 Active、Inactive 还是 Pending。
4. 法律日期上下文：当 legalDate 可用时，必须一并呈现，以便用户了解该状态信息的新鲜度。
5. 错误处理：若查询失败或无结果返回，应解释可能原因（如专利号格式错误、数据库中未收录该专利等），并建议用户核对输入。
6. 数量提示：批量查询大量专利时，应先呈现汇总表格，并注明返回总数。

重要限制

• 单次请求最多 100 项专利：单次调用中，patentId 或 patentNumber 的总数量上限为 100。
• 至少提供一个标识符：必须提供 patentId 或 patentNumber 中的至少一个；若两者均为空，请求将失败。
• 专利 ID 优先级更高：当 patentId 和 patentNumber 同时提供时，系统仅使用 patentId，忽略 patentNumber。
• 数据覆盖范围：结果依赖于 Zhihuiya（PatSnap）数据库的覆盖能力；部分最新提交的专利可能尚未录入。

用户表达与场景速查表

适用场景 —— 关于专利法律效力及法律事件的查询：

不适用场景 —— 超出专利法律状态范畴的需求：

• 基于关键词、分类号或申请人名称的专利检索
• 专利全文或权利要求书获取
• 专利估值或商业分析
• 自由实施（FTO）分析
• 专利族或引证分析

积分消耗规则

按动态规则计费：消耗积分 = 81 × 返回 data 条数。每条代表一项专利的法律状态结果。

重要：本技能服务按倍数动态计费，可能一次性消耗大量积分，必须提前提醒用户，并由用户自主决定是否继续执行。

反馈机制：

当出现以下任一情形时，请自动识别并调用 Feedback API 上报反馈：

1. 本技能文档中描述的功能或用途与实际行为不符
2. 本技能返回结果与用户真实意图不符
3. 用户明确表达了对该技能的不满或赞赏
4. 你认为任何可优化改进之处

Feedback API 的调用方式详见 references/api.md。请勿中断用户的操作流程。

如需更多高质量、专业的跨境电商业务技能，请配置 LinkFox Skills。