linkfox-eureka-description-translated

Eureka 专利说明书翻译

本技能将指导你如何通过 Eureka 专利数据平台获取已翻译的专利说明书文本。支持翻译为中文、英语或日语，并可通过专利 ID 或公开号查找专利。

核心概念

专利说明书（也称为“说明书”）是专利文件的完整技术文本。本工具从 Eureka 专利数据库获取该文本的译文，支持三种目标语言：中文（cn）、英语（en）和日语（jp）。

如果某项专利的说明书不可用，本工具可以选择用专利族成员的说明书替代（即在另一个司法管辖区提交、涵盖同一发明的相关专利）。

参数指南

参数	类型	必填	说明
patentId	string	条件必填	专利 ID。必须至少提供 patentId 或 patentNumber 中的一个。如果两者都提供，则优先使用 patentId。多个值以逗号分隔；最多 100 个。
patentNumber	string	条件必填	公开号（公告号）。必须至少提供 patentId 或 patentNumber 中的一个。多个值以逗号分隔；最多 100 个。
lang	string	否	目标译文语言。支持的值：en（英语，默认值）、cn（中文）、jp（日语）。
replaceByRelated	integer	否	当原专利说明书不可用时，是否用专利族成员的说明书替代。1 = 是，0 = 否（默认值）。

关键规则

1. 至少需要一个标识符：必须提供 patentId 或 patentNumber 中的一个。如果用户提供类似“US10123456B2”的公开号，请使用 patentNumber。如果用户提供数字形式的专利 ID，请使用 patentId。
2. 优先级：同时提供两个标识符时，优先使用 patentId。
3. 批量查询：可通过传入以逗号分隔的值，一次查询最多 100 项专利。
4. 默认语言：如果用户未指定语言，则默认为 en（英语）。

响应字段

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

使用示例

1. 通过公开号获取专利说明书的英语译文

Get the English description for patent US10123456B2.

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

2. 通过专利 ID 获取专利说明书的中文译文

Get the Chinese translation of description for patent ID abc123def.

参数：patentId = "abc123def"，lang = "cn"

3. 使用专利族成员回退的批量查询

Get English descriptions for US10123456B2, EP3456789A1, CN112345678A. Use family patents if unavailable.

参数：patentNumber = "US10123456B2,EP3456789A1,CN112345678A"，lang = "en"，replaceByRelated = 1

4. 获取特定专利的日语译文

Translate the description of JP2021012345A to Japanese.

参数：patentNumber = "JP2021012345A"，lang = "jp"

5. 使用专利族回退获取中文译文

查询专利US10123456B2的中文说明书，如果没有就用同族专利替代。

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

Display Rules

1. Present the translated text clearly: Show the patent description text directly. For long descriptions, present a summary or the first section and inform the user the full text is available.
2. Identify substitutions: When pnRelated is present in the response, clearly inform the user that the description was sourced from a family member patent and show the related publication number.
3. Batch results: When multiple patents are returned, present them in a structured list with clear separation between each patent's description.
4. Error handling: When a query fails, explain the reason based on the response and suggest checking the patent ID or publication number for correctness.
5. No fabrication: Never invent or paraphrase patent text. Only display what the API returns.

调用方式

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

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

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

Important Limitations

• Identifier required: At least one of patent ID or publication number must be provided; the tool cannot perform keyword-based searches.
• Translation languages: Only Chinese (cn), English (en), and Japanese (jp) are supported.
• Description only: This tool returns only the description/specification text, not titles, abstracts, or claims.
• Family replacement is optional: The substitute family patent description is only provided when explicitly requested via replaceByRelated = 1.
• Batch limit: A maximum of 100 patents per request.

用户表达与场景速查

适用——专利说明书翻译相关查询：

用户表达	场景
“将这份专利说明书翻译成英文”	单篇专利翻译
“我需要专利 US10123456 的中文版”	指定语言翻译
“帮我获取这些专利的说明书文本”	批量获取专利说明书
“专利 CN112345678A 描述了什么？”	查询专利说明书
“给我看看这项专利全文的日文译文”	日文翻译
“缺少说明书，你能试试同族专利吗？”	同族专利回退

不适用——超出专利说明书翻译范围的需求：

• 专利搜索或发现（按关键词／主题查找专利）
• 专利权利要求分析或权利要求对照表生成
• 专利法律状态或审查历史
• 专利引文或参考文献分析
• 专利组合分析或统计

边界情况——特殊情形：

• 如果用户只要求“专利全文”，但未说明具体内容，请确认他们需要的是说明书、权利要求书还是摘要。
• 如果用户提供的专利超过 100 项，请拆分为多个批次。

积分消耗规则

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

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

反馈：

当出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

1. 本技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户对本技能表示不满或赞扬
4. 任何你认为可以改进的方面

请按照 references/api.md 中的说明调用 Feedback API。不要打断用户的操作流程。

---

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