mcpField
L
linkfox-zhihuiya-description-data-translated

linkfox-zhihuiya-description-data-translated

github.com/linkfox-ai文档处理113234 次安装2 周前更新
代码仓库

关于 linkfox-zhihuiya-description-data-translated

LinkFox 技能通过专利 ID 或公开编号，从智慧芽数据库获取专利说明书译文，支持中文、英文和日文；原文说明书不可用时可选择使用同族专利文本。

主要功能

  1. 01按专利 ID 或公开编号查询
  2. 02获取三种语言的说明书译文
  3. 03单次查询最多 100 件专利
  4. 04可选使用同族专利说明书

适用场景

  1. 01阅读其他语言的专利说明书
  2. 02批量获取多件专利说明书
  3. 03原专利说明书缺失时查同族文本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-zhihuiya-description-data-translated

安装后在 Claude Code 中输入/linkfox-zhihuiya-description-data-translated确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
onboarding.py
zhihuiya_description_translated.py

详细介绍

智慧芽专利说明书（译文）

此技能指导你如何通过智慧芽数据服务获取专利说明书（规格书）译文。支持翻译为中文、英文或日文，并可按专利 ID 或公开号查询专利。

核心概念

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

当无法获取专利说明书时，此工具可以选择使用同族专利（在其他司法管辖区提交、涉及相同发明的相关专利）的说明书作为替代。

参数

参数类型必填描述
patentIdstring有条件必填专利 ID。必须提供 patentId 或 patentNumber 中至少一个。如果两者都提供，则优先使用 patentId。多个值以逗号分隔；最多 100 个。
patentNumberstring有条件必填公开号（公告号）。必须提供 patentId 或 patentNumber 中至少一个。多个值以逗号分隔；最多 100 个。
langstring否目标翻译语言。支持的值：en（英文，默认）、cn（中文）、jp（日文）。
replaceByRelatedinteger否当原说明书不可用时，是否使用同族专利的说明书作为替代。1 = 是，0 = 否（默认）。
关键规则
  1. 至少需要一个标识符：必须提供 patentId 或 patentNumber。如果用户提供类似“US10123456B2”的公开号，请使用 patentNumber。如果提供数字专利 ID，请使用 patentId。
  2. 优先级：如果同时提供两个标识符，则优先使用 patentId。
  3. 批量查询：以逗号分隔的值一次最多可查询 100 项专利。
  4. 默认语言：如果用户未指定语言，则默认使用 en（英文）。

调用方式

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

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

  • 始终将完整响应写入 <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"

展示规则

  1. 清晰呈现译文：直接展示专利说明书文本。对于较长的说明书，请提供摘要或首个部分，并告知用户可获取全文。
  2. 标明替代来源：当响应中包含 pnRelated 时，明确告知用户说明书文本来源于同族专利，并展示相关公开号。
  3. 批量结果：返回多件专利时，将说明书文本按结构化列表呈现，并清晰区分每件专利。
  4. 错误处理：报告实际错误。翻译结果为空，并不能证明专利不存在，也不能证明不支持所有相同语言的请求。对于原始说明书，请使用 /zhihuiya/descriptionData，并核实返回的专利及文本语言。保留用户请求的目标语言；不得擅自切换语言或替换为同族专利。
  5. 禁止编造：切勿编造或改写专利文本。只展示 API 返回的内容。

用户表达与场景快速参考

适用 -- 专利说明书翻译查询：

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

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

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

算力消耗规则

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

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

反馈：

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

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

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

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

评论

支持 Markdown