SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-zhihuiya-description-data-translated

linkfox-zhihuiya-description-data-translated

写作与研究

查看项目

更新于 10-15 18:03

技能介绍

用途

本技能用于通过智慧芽（PatSnap）数据服务检索翻译后的专利说明书（描述/全文）文本，面向需要查看中文、英文或日文版专利说明书的场景。

主要能力

  • 支持将专利说明书翻译为三种目标语言：中文（cn）、英文（en，默认）、日文（jp）。
  • 可通过专利 ID（patentId）或公开号（patentNumber）查询，详见下方参数说明。
  • 支持批量查询：以逗号分隔多个值，单次最多 100 件专利。
  • 当原专利说明书无法获取时，可通过 replaceByRelated 参数选择用同族专利（在另一司法辖区提交、覆盖同一发明的相关专利）的说明书替代。

参数

  • patentId（字符串，条件必填）：专利 ID。patentId 与 patentNumber 至少提供一个，若同时提供则 patentId 优先。多值以逗号分隔，最多 100 个。
  • patentNumber（字符串，条件必填）：公开（公告）号。至少与 patentId 提供其一。多值以逗号分隔，最多 100 个。
  • lang（字符串，可选）：目标翻译语言，支持 en（英文，默认）、cn（中文）、jp（日文）。
  • replaceByRelated（整数，可选）：原说明书不可用时是否用同族专利说明书替代，1 表示是，0 表示否（默认）。

关键规则

  • 至少提供一个标识符：patentId 或 patentNumber。若用户给出类似 "US10123456B2" 的公开号，使用 patentNumber；若给出数字型专利 ID，使用 patentId。
  • 优先级：两个标识符同时提供时，patentId 优先。
  • 批量查询：逗号分隔的值最多一次查询 100 件专利。
  • 默认语言：用户未指定语言时默认 en（英文）。

使用方式

  • API 端点：POST /zhihuiya/descriptionDataTranslated（完整参数、响应与错误码见 references/api.md）。
  • Python 脚本：python scripts/zhihuiya_description_translated.py '<JSON 参数>' [--inline]。

成本约束

本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果时不得自动更换关键词、翻页或改动连续试探；需要继续检索时须先向用户说明会产生额外消耗。

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

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-description-data-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 进入上下文。

认证与算力问题处理

发生以下异常时，采用 references/onboarding.md 引导解决：

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

使用示例

  1. 按公开号获取专利说明书的英文翻译：patentNumber: "US10123456B2"，lang: "en"
  2. 按专利 ID 获取专利说明书的中文翻译：patentId: "abc123def"，lang: "cn"
  3. 批量查询并使用同族专利回退：patentNumber: "US10123456B2,EP3456789A1,CN112345678A"，lang: "en"，replaceByRelated: 1
  4. 获取特定专利的日文翻译：patentNumber: "JP2021012345A"，lang: "jp"

展示规则

  • 清晰呈现译文：直接显示专利说明书文本。对于较长的说明书，展示摘要或首段，并告知用户可获取全文。
  • 标识替代来源：当响应中存在 pnRelated 时，明确告知用户该说明书来自同族专利，并显示相关公开号。
  • 批量结果：返回多件专利时，以结构化列表呈现，各专利说明书之间清晰分隔。
  • 错误处理：如实报告错误。翻译结果为空不代表该专利不存在，也不代表所有同语言请求均不受支持。如需原始说明书，使用 /zhihuiya/descriptionData，并核对返回的专利与文本语言。保持用户请求的目标语言，不得静默切换语言或替换同族专利。
  • 不得编造：绝不伪造或改写专利文本，仅显示 API 返回的内容。

适用与不适用场景

适用——专利说明书/描述翻译查询，包括单件专利翻译、指定语言翻译、批量说明书获取、专利说明书查找、日文全文翻译、说明书缺失时尝试同族专利等。

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

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

算力消耗规则

按动态规则计费：消耗算力 = 81 × 返回 data 条数，每条对应 1 条专利说明书翻译结果。

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

反馈

在以下情形时，请通过 Feedback API 自动检测并报告反馈：本技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞赏；认为有任何可改进之处。按 references/api.md 的说明调用反馈 API，不要打断用户流程。