linkfox-eureka-claim-translated

Eureka 专利权利要求翻译

本技能将指导你如何从 Eureka 专利数据平台查询已翻译的专利权利要求，帮助用户检索一项或多项专利的中文、英文或日文权利要求文本。

核心概念

专利权利要求界定了专利授予的法律保护范围。此工具从 Eureka 平台检索专利权利要求的译文，支持三种语言：中文（cn）、英文（en）和日文（jp）。你可以通过专利内部 ID 或公开号（公告号）查询专利。

专利族替代：如果某项专利没有可用的权利要求，此工具可以选择使用相关专利族成员的权利要求进行替代。此功能由 replaceByRelated 参数控制。

参数指南

参数	类型	必填	说明
patentId	string	patentId 或 patentNumber 至少填写一项	专利内部 ID。多个 ID 用逗号分隔。每次请求最多查询 100 项专利。
patentNumber	string	patentId 或 patentNumber 至少填写一项	公开号（公告号）。多个号码用逗号分隔。每次请求最多查询 100 项专利。
replaceByRelated	integer	否	无可用权利要求时，是否使用专利族成员的权利要求进行替代。1 = 是，0 = 否。默认值为 0。
lang	string	否	目标翻译语言。en = 英文（默认），cn = 中文，jp = 日文。

关键规则

1. 至少需要一个标识符：必须提供 patentId 或 patentNumber（也可以同时提供）。如果两者都提供，则优先使用 patentId。
2. 批量查询：多个专利的值可以用逗号分隔后一次性查询，每次请求最多 100 项。
3. 默认语言为英文：用户未指定语言时，使用 en。
4. 专利族回退：仅当用户明确要求在原专利缺少权利要求时使用专利族成员的权利要求进行替代，才将 replaceByRelated 设为 1。

响应字段

字段	说明
total	返回的专利记录数量
data	专利对象数组（见下文）
data[].patentId	专利内部 ID
data[].pn	公开号（公告号）
data[].claims	专利权利要求译文
data[].pnRelated	用作替代的专利族成员的公开号（仅在使用专利族替代时存在）
costToken	此请求消耗的 Token 数量

使用示例

1. 通过公开号获取单项专利的英文权利要求

Show me the English claims for patent CN112345678A.

参数：patentNumber = "CN112345678A"，lang = "en"

2. 获取多项专利的中文权利要求

Get the Chinese translation of claims for US20210012345A1 and EP3456789B1.

参数：patentNumber = "US20210012345A1,EP3456789B1"，lang = "cn"

3. 获取日文权利要求，并启用专利族成员回退

Get Japanese claims for JP2021123456A. If unavailable, try a family patent.

参数：patentNumber = "JP2021123456A"，lang = "jp"，replaceByRelated = 1

4. 通过专利 ID 查询

Get claims for patent ID 84a1b2c3 in English.

参数：patentId = "84a1b2c3"，lang = "en"

5. 启用回退的批量查询

Translate claims for these patents: CN112345678A, US20200012345A1, EP3456789B1. Use family patents if needed.

参数：patentNumber = "CN112345678A,US20200012345A1,EP3456789B1"，lang = "en"，replaceByRelated = 1

显示规则

1. 清晰呈现权利要求：以适当格式显示翻译后的权利要求文本。如果返回多个专利，请以各专利的公开编号作为标题，分别列出其权利要求。
2. 同族替代通知：响应中包含 pnRelated 时，请明确告知用户权利要求来自相关同族专利，并显示替代专利的公开编号。
3. 语言通知：注明返回的权利要求所使用的语言，让用户了解当前查看的是哪种语言的翻译。
4. 大量结果：返回多个专利时，汇总数量并展示几条有代表性的记录，同时提醒用户结果总数。
5. 错误处理：查询失败时，根据错误响应说明原因，并建议检查专利 ID 或公开编号。

调用方式

• API 端点：POST /tool-eureka/claimDataTranslated（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/eureka_claim_translated.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-claim-translated-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 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 并根据它的引导来处理。如未安装请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。
• 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取 API Key，或去 https://os.linkfox.com/ 补充积分。

重要限制

• 至少需要一个标识符：必须提供 patentId 或 patentNumber，否则查询会失败。
• 批次上限：每个请求最多查询 100 项专利。
• 语言支持：仅支持中文（cn）、英语（en）和日语（jp）。
• 同族替代：只有在 replaceByRelated 设置为 1 且原始权利要求不可用时，才会返回替代权利要求。
• 不分析权利要求：本工具仅返回未经分析的翻译文本；不会分析或比较权利要求。

用户表达与场景快速参考

适用 -- 与专利权利要求文本及翻译相关的查询：

用户表达	场景
"Show me the claims for patent XX"	单项专利权利要求查询
"Translate claims to Chinese/Japanese"	权利要求翻译
"What does patent XX claim?"	权利要求内容获取
"Get claims for these patents: XX, YY"	批量专利权利要求查询
"Claims unavailable, try family patent"	同族专利替代
"Patent rights scope of XX"	权利要求文本获取

不适用 -- 需求超出专利权利要求翻译范围：

• 专利搜索或发现（通过关键词查找专利）
• 专利引用或法律状态分析
• 专利摘要或说明书获取
• 专利组合分析或统计

边界情况：

• 如果用户只询问“专利文本”而未说明是否指权利要求，请确认其需要权利要求、摘要还是说明书。
• 如果用户提供的专利超过 100 项，请拆分为多个批次。

积分消耗规则

按动态规则计费：消耗积分 = 81 × max(返回条数, 1)。

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

反馈：

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

1. 本技能所述的功能或用途与实际行为不符
2. 本技能的结果不符合用户意图
3. 用户表达了对本技能的不满或赞赏
4. 你认为任何内容可以改进

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

---

如需获取更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。