linkfox-zhihuiya-description-data

智慧芽专利说明书数据

此技能指导你如何从智慧芽专利数据库查询专利说明书数据，帮助用户获取特定专利的说明书全文内容。

核心概念

专利说明书是随专利申请提交的详细技术文件，其中公开了发明的工作原理、优选实施例以及专利法要求的其他技术细节。此工具可查询智慧芽数据库，返回由其内部专利 ID 或公开公告号标识的一个或多个专利的说明书数据。

标识符优先级：同一查询同时提供专利 ID 和公开公告号时，以专利 ID 为准。

同族替代：如果无法获取某项专利的说明书，工具可以选择返回相关同族专利的说明书。

参数

参数	类型	必填	描述
patentId	string	有条件必填	内部专利 ID。必须至少提供 patentId 或 patentNumber 中的一项。多个值以逗号分隔；最多 100 个。
patentNumber	string	有条件必填	公开／公告号。必须至少提供 patentId 或 patentNumber 中的一项。多个值以逗号分隔；最多 100 个。
replaceByRelated	string	否	当目标专利的说明书不可用时，是否替换为同族专利的说明书。1 = 是，0 = 否。

响应字段

字段	类型	描述
total	integer	返回的专利记录数
data	array	专利说明书对象列表
data[].patentId	string	专利 ID
data[].pn	string	公开公告号
data[].pnRelated	string	替代同族专利的公开公告号（仅在使用同族替代时出现）
data[].description	array	说明书内容章节
columns	array	用于渲染的列定义
costToken	integer	查询消耗的 Token 数
type	string	渲染样式提示

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-description-data-<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／套餐到期／需充值／请充值”，或类似含义的内容。

如何构建查询

按公开公告号查询

用户提供专利公开公告号（例如 CN115099012A、US20230012345A1）时，通过 patentNumber 参数传入：

patentNumber: "CN115099012A"

按专利 ID 查询

用户提供智慧芽内部专利 ID 时，通过 patentId 参数传入：

patentId: "abc123def456"

批量查询

patentId 和 patentNumber 均接受以逗号分隔的值，可用于批量查询（最多 100 个）：

patentNumber: "CN115099012A,US20230012345A1,EP4123456A1"

同族替代

当数据库中没有某项专利的说明书，而用户仍需要相关内容时，启用同族替代：

patentNumber: "CN115099012A"
replaceByRelated: "1"

使用示例

1. 按公开号查询单篇专利说明书

patentNumber: "CN115099012A"

2. 一次查询多篇专利的说明书

patentNumber: "CN115099012A,US20230012345A1"

3. 启用同族替代进行查询

patentNumber: "CN115099012A"
replaceByRelated: "1"

4. 按专利 ID 查询

patentId: "some-patent-id"

显示规则

1. 忠实呈现数据：清晰展示返回的说明书内容，不得更改技术细节或添加主观解读。
2. 结构化输出：当说明书包含多个部分（背景、摘要、详细说明、权利要求等）时，使用清晰的标题呈现，便于阅读。
3. 同族替代提示：如果响应中包含 pnRelated 字段，明确告知用户说明书来源于相关同族专利，并注明替代公开号。
4. 批量结果：当返回多篇专利时，以公开号作为标题，清晰区分每篇专利的内容。
5. 错误处理：查询失败或未返回数据时，说明原因，并建议用户核实专利 ID 或公开号。
6. 大篇幅内容提示：专利说明书可能很长。先总结关键部分，并询问用户是否需要查看全文。

重要限制

• 标识符要求：必须至少提供 patentId 或 patentNumber 其中之一；该工具无法按关键词或申请人名称搜索。
• 批量上限：单次请求最多可查询 100 项专利。
• 可用性：数据库中并非所有专利都有说明书。必要时使用 replaceByRelated: "1" 尝试同族替代。
• 优先级规则：如果同时提供 patentId 和 patentNumber，则优先使用 patentId。

用户表达与场景速查

适用 —— 查询专利说明书 / 说明书内容：

用户说法	场景
“显示专利 XX 的说明书”	查询单篇专利说明书
“获取这些专利的完整说明书”	批量获取专利说明书
“我需要 CN115099012A 的详细文本”	按公开号查询
“能否改为查找同族专利的说明书”	同族替代查询
“这项专利在技术上描述了什么”	查看说明书内容

不适用 —— 需求超出专利说明书数据范围：

• 按关键词、申请人或分类搜索专利
• 专利权利要求分析或权利要求对照表生成
• 专利法律状态或审查历史
• 专利布局或统计分析
• 自由实施或侵权意见

算力消耗规则

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

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

反馈：

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

1. 此技能描述的功能或用途与实际行为不符
2. 技能的结果不符合用户意图
3. 用户表达对该技能的不满或赞扬
4. 你认为有任何可以改进之处

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

---

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