linkfox-eureka-abstract-translated

Eureka 专利摘要翻译

本技能将指导你如何从 Eureka 专利数据平台获取已翻译的专利标题和摘要，支持中文、英文和日文翻译。

核心概念

Eureka 是一个专业的专利数据平台。此工具会查询其数据库，返回一项或多项专利的已翻译标题和摘要。你可以通过专利 ID或公开（公告）号查找专利，并获取中文、英文或日文翻译。

专利标识：每项专利都可以通过 patentId（内部标识符）或 patentNumber（公开出版号／公告号，例如 US20200012345A1 或 CN112345678A）进行标识。如果同时提供两者，则优先使用专利 ID。

同族专利回退：当原专利没有可用摘要时，可以将相关同族专利的摘要作为替代，方法是将 replaceByRelated 设为 1。

参数指南

参数	类型	必填	说明
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[].title	已翻译的专利标题
data[].abstractText	已翻译的专利摘要
data[].pnRelated	替代同族专利的公开（公告）号（仅在使用同族专利替换时出现）
costToken	本次请求消耗的 Token 数

使用示例

1. 通过公开（公告）号将单项专利摘要翻译成英语

Look up patent number US20200012345A1 and give me the English abstract.

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

2. 将多项专利翻译成中文

Get the Chinese translation of abstracts for patents CN112345678A and US20200067890A1.

参数：patentNumber = "CN112345678A,US20200067890A1"，lang = "cn"

3. 通过专利 ID 查找，并启用同族专利回退

Get the Japanese abstract for patent ID 12345678. If the abstract is unavailable, use a family patent instead.

参数：patentId = "12345678"，lang = "jp"，replaceByRelated = 1

4. 按专利 ID 批量查询

Translate the titles and abstracts for these patent IDs: 111111, 222222, 333333.

参数：patentId = "111111,222222,333333"，lang = "en"

5. 翻译成中文并启用同族专利回退

查询专利CN112345678A的中文摘要，如果没有就用同族专利替代。

参数：patentNumber = "CN112345678A"，lang = "cn"，replaceByRelated = 1

显示规则

1. 清晰呈现数据：使用结构良好的表格展示结果，包含专利号、标题和摘要。
2. 注明语言：在输出标题中注明翻译语言，让用户了解结果所用的语言。
3. 同族专利提示：如果任何结果中存在 pnRelated，请明确告知用户摘要来源于同族专利，并显示替代公开号。
4. 长摘要：对于很长的摘要，显示完整文本，不要截断，以便用户查看完整内容。
5. 错误处理：查询失败或没有返回结果时，说明可能的原因（例如，专利号无效、数据库中未找到该专利），并建议如何修正。

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-eureka-abstract-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/ 补充积分。

重要限制

• 必须提供标识符：必须至少提供专利 ID 或公开号之一；此工具无法进行基于关键词的搜索。
• 支持的翻译语言：仅支持中文（cn）、英语（en）和日语（jp）。
• 不检索全文：此工具仅返回标题和摘要，不返回完整的专利权利要求或说明书。
• 同族替换为可选项：仅在通过 replaceByRelated = 1 明确请求时，才会提供替代同族专利的摘要。
• 批次上限：每次请求最多 100 件专利。

用户表达与场景速查

适用 -- 专利摘要和标题翻译查询：

用户表述	场景
"翻译这份专利摘要"	单件专利翻译
"XX 专利说了什么 / 是关于什么的"	摘要查询
"获取这项专利的中文/日文版本"	指定语言翻译
"查询专利号为 XX 的摘要"	公开号查询
"批量翻译这些专利"	批量翻译
"摘要缺失了，试试同族专利"	同族专利回退

不适用 -- 需求超出摘要翻译范围：

• 检索完整专利文本、权利要求或说明书
• 按关键词、分类或申请人搜索专利
• 查询专利法律状态、进行引文分析或编制专利态势报告
• 专利估值或侵权分析

边界情况 -- 特殊情形：

• 如果用户只要求“专利内容”，但未指定部分，默认进行摘要翻译，并告知用户可以使用相关工具查询权利要求/说明书。
• 如果用户提供的专利超过 100 件，请拆分为多个批次。

积分消耗规则

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

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

反馈：

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

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

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

---

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