linkfox-eureka-claim-data

用途

本技能用于通过 Eureka 专利平台检索专利权利要求（Claims）数据，帮助用户快速获取一件或多件专利的完整权利要求文本以及权利要求数量。

主要能力

Eureka Claim Data 工具会针对每个被查询的专利返回完整的权利要求部分，主要包括：

• Claims 数组：该专利全部权利要求（独立权利要求与从属权利要求）的完整文本。
• Claim Count：该专利的权利要求总数。
• 关联专利回退：当启用 replaceByRelated（值为 "1"）时，如果所请求的专利没有权利要求数据，系统会尝试使用关联专利（例如申请案的授权版本）来提供权利要求数据；pnRelated 字段会指明实际使用了哪件关联专利。

专利识别方式：可通过专利 ID 或公开号进行查询。当两者同时提供时，专利 ID 优先。单次请求可提交多个值（以逗号分隔）。

参数说明

参数	是否必填	说明
patentId	条件必填	专利 ID。patentId 与 patentNumber 至少提供一个。多个值以逗号分隔。
patentNumber	条件必填	公开（公告）号。patentId 与 patentNumber 至少提供一个。多个值以逗号分隔。
replaceByRelated	可选	当被查询专利没有权利要求时，是否使用关联专利作为回退。"1" = 启用回退，"0" = 禁用（默认）。

使用建议：

• 如果用户提供的是公开号（例如 CN115000000A、US11000000B2），使用 patentNumber。
• 如果用户提供的是内部专利 ID，使用 patentId。
• 当两者同时提供时，patentId 优先。
• 当用户希望即使该公开号没有权利要求数据也要获取数据时（常见于申请阶段专利），将 replaceByRelated 设为 "1"。

返回字段

字段	说明
patentId	专利的内部 ID
pn	公开（公告）号
pnRelated	作为回退使用的关联专利公开号（仅在启用 replaceByRelated 且发生回退时出现）
claims	包含完整权利要求文本的权利要求对象数组
claimCount	权利要求总数
total	返回的记录总数
costToken	本次查询的 Token 消耗

使用方式与示例

1. 检索单件专利的权利要求： “Show me the claims for patent CN115000000A.”

2. 获取某专利的权利要求数量： “How many claims does US11000000B2 have?”

3. 批量查询多件专利的权利要求： “Get the claims for patents EP3000000A1 and CN115000001A.”

4. 对申请案使用关联专利回退： “Get the claims for application CN202210000000.0A — if claims aren't available, use the granted version.”

5. 对比多件专利的权利要求： “Show me the independent claims of US11000000B2 and US10000000B1 side by side.”

展示规则

• 清晰呈现权利要求：为每条权利要求编号，并保留层级结构（独立权利要求与从属权利要求）。
• 突出独立权利要求：当用户关注保护范围时，强调独立权利要求（通常为权利要求 1 及其他独立权利要求）。
• 权利要求数量摘要：始终在回复顶部说明权利要求总数。
• 关联专利提示：如果存在 pnRelated，需明确告知用户权利要求来源于关联专利，并说明是哪一件。
• 错误处理：如果查询失败或没有结果，说明可能原因（专利号无效、未找到专利、权利要求尚未公布），并建议替代方案（例如启用 replaceByRelated）。
• 长权利要求：对于权利要求较多的专利，可考虑先展示摘要（独立权利要求 + 总数），并提示用户可按需查看全部权利要求。

适用场景

适用于以下与专利权利要求相关的查询：

用户表述	场景
“Show me the claims for patent XX”	完整权利要求检索
“How many claims does XX have”	权利要求数量查询
“What is claim 1 of patent XX”	独立权利要求查找
“Get claims using the granted version”	回退到关联专利
“Compare the claims of XX and YY”	多专利权利要求对比
“What does patent XX protect”	保护范围（基于权利要求）

不适用于以下需求：

• 专利著录项/元数据检索（请使用 bibliography 技能）
• 专利法律状态查询
• 专利说明书全文检索
• 按关键词或分类进行专利检索
• 专利图片/附图检索
• 专利族分析

限制

• 至少需要一个标识符：必须提供 patentId 或 patentNumber 之一；两者均为空时请求会失败。
• 专利 ID 优先：当同时提供 patentId 与 patentNumber 时，系统使用 patentId 并忽略 patentNumber。
• 权利要求可用性：部分早期申请阶段的专利可能尚未公布权利要求。可使用 replaceByRelated 尝试回退到关联专利。
• 数据覆盖范围：结果取决于 Eureka 专利数据库的覆盖范围；部分非常新的申请可能尚未收录。

认证与积分

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

异常情况：

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

措施：

• 优先采用 skill 内的 onboarding.md 引导解决问题。
• 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 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/ 补充积分。

积分消耗规则：

• 按动态规则计费：消耗积分 = 81 × max(返回条数, 1)。
• 重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

反馈

在以下任一情况发生时，通过 Feedback API 自动检测并报告反馈：

• 本技能描述的功能或用途与实际行为不符
• 本技能的结果与用户意图不符
• 用户对本技能表达不满或赞扬
• 任何你认为可以改进的地方

按 references/api.md 中的说明调用反馈 API。不要打断用户流程。