用途
本技能用于从智慧芽（PatSnap）专利数据库获取翻译后的专利权利要求（claims）文本。专利权利要求界定了专利受保护的法律范围，本工具帮助用户在指定语言下查看一项或多项专利的权利要求译文。
主要能力
- 支持按内部专利 ID（patentId）或公开/公告号（patentNumber）查询专利权利要求。
- 支持三种翻译语言：英文（en，默认）、中文（cn）、日文（jp）。
- 支持同族专利替换：当某专利的权利要求不可用时，可通过 replaceByRelated 参数从关联同族专利获取权利要求，此时响应中会带有 pnRelated（替代同族专利的公开号）。
- 支持批量查询，单次请求最多 100 件专利。
数据字段
- patentId：专利内部标识符。
- pn：专利公开（公告）号。
- pnRelated：替代同族专利的公开号（仅在使用同族替换时出现）。
- claims：翻译后的专利权利要求文本。
使用方式
参数说明：
- 专利标识（至少提供其一）：patentId（内部专利 ID，当同时提供 patentId 和 patentNumber 时以 patentId 优先；多个值以逗号分隔）、patentNumber（公开或公告号，多个值以逗号分隔）。
- 可选参数：lang（目标翻译语言 en/cn/jp，默认 en）、replaceByRelated（原权利要求不可用时是否用同族专利替换：1 = 是，0 = 否，默认 0）。
调用方式：
- API 端点：POST /zhihuiya/claimDataTranslated（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/zhihuiya_claim_translated.py '<JSON 参数>' [--inline]。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-claim-data-translated-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
- 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout。
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
- 加 --inline 强制全量打印到 stdout（同样落盘）。
- 读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时应先向用户说明会产生额外消耗。
认证与算力问题：当出现未配置 API Key（环境变量未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401 或 402 状态码、或提示算力/余额不足（如“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值”等）时，按 references/onboarding.md 引导解决。
使用示例
- 按公开号获取单个专利的英文权利要求：patentNumber: "CN112345678A"，lang: "en"。
- 按公开号获取多个专利的中文权利要求：patentNumber: "US20210012345A1,EP3456789B1"，lang: "cn"。
- 获取日文权利要求并使用同族回退：patentNumber: "JP2021123456A"，lang: "jp"，replaceByRelated: 1。
- 按专利 ID 查询：patentId: "84a1b2c3-d4e5-6f78-9abc-def012345678"，lang: "en"。
展示规则
- 清晰呈现权利要求文本并合理格式化；若返回多个专利，以公开号作为标题分隔各专利的权利要求。
- 当响应中出现 pnRelated 时，明确告知用户权利要求来自关联同族专利并展示替代公开号。
- 说明返回权利要求所用语言，让用户知晓所查看的译文。
- 结果较多时，汇总数量并展示少量代表性条目，提醒用户总条数。
- 查询失败时，依据错误响应说明原因，并建议检查专利 ID 或公开号。
适用场景
适用于与专利权利要求文本及翻译相关的查询，例如：查看某专利的权利要求、将权利要求翻译为中文/日文、获取某专利的权利要求内容、批量查询多个专利的权利要求、原权利要求不可用时尝试同族专利、查看某专利的权利范围文本。
限制
- 至少需提供一个标识符（patentId 或 patentNumber），否则查询将失败。
- 单次请求最多 100 件专利。
- 仅支持中文（cn）、英文（en）、日文（jp）三种语言。
- 同族替换仅在 replaceByRelated 设为 1 且原权利要求不可用时返回替代权利要求。
- 不适用于：专利检索或发现（按关键词查找专利）、专利引证或法律状态分析、专利摘要或说明书获取、专利组合分析或统计。
算力消耗
按动态规则计费：消耗算力 = 81 × 返回 data 条数，每条对应 1 条专利权利要求翻译结果。服务按倍数动态计算，可能一次性消耗大量算力，调用前必须提醒用户，由用户决定是否继续。