本技能有独立的免费试用额度，不与其他 Skill 共用。 未配置正式密钥时，首次运行自动领取并单独保存；额度、有效期和权限以服务端返回为准。同一 Skill 升级继续使用自己的试用缓存。已有 PATENTMAX_API_KEY 时优先使用正式密钥。
专利版本对比 · PatentMax
清楚展示旧稿与新稿改了哪些文字。先确定两个文件的身份和版本，修改范围、超范围或保护范围影响另作专门判断。
默认处理用户已有材料，不联网、不需要密钥。 仅在明确要求补取专利数据时使用下方客户端，并先确认预算。
使用问题、企业采购：访问 ip930.com，右下角「联系客服」。
运行环境（必读，所有命令都适用）
部分 WorkBuddy 等环境的命令行不完整，cat、ls、sleep、rm 等可能找不到。为保证任何电脑都能跑通：
- 脚本路径一律写绝对路径：
$DIR/scripts/patentmax_client.py（$DIR是本技能所在目录），不要写cd ... && ...（前一步失败会让后面整条静默不执行） python找不到时依次试python3、py；还找不到就用 WorkBuddy 自带的：先用 Glob 在~/.workbuddy/binaries/python/versions/下找到python.exe，用它的完整路径。下文所有python都按这条替换- 不要用
cat读文件：读结果文件用 Read 工具，或用脚本的read子命令 - 检索命令几秒就返回；命令超时设为 120 秒即可
什么时候用
| 用户说 | 怎么做 |
|---|---|
| 对比我上传的两版权利要求，列出新增、删除和替换内容 | 使用本技能 |
| 检索新文献或作查新、侵权判断 | 使用对应检索或报告能力 |
第 1 步：先问清楚（最多一轮）
- 旧版和新版UTF-8文本，及对应的版本/公开或授权身份
- 对比哪些章节；默认输入文本全部逐行对照
直接使用已提供的材料，必要问题集中补问一轮，不让用户重复提交。
第 2 步：怎么做
- 核对旧、新文件及版本身份，避免把公开本和授权本、不同申请案或OCR文本混为同一修改稿。用户提供PDF/DOCX时先提取为新文本，保留原件和提取限制。
- 运行compare_versions.py。以输入文本的行作定位单位，统一换行符，但不删除空格、不改术语、不自动修正数字或标点。输出新增、删除、替换块，完整保留旧、新原文及各自行号。
- 对照HTML检查关键变化，尤其否定词、范围、数值和依附编号。脚本只作文本差异；重复段落可能有多种对齐方式，不把相似度当技术或法律结论，不把移动自动解释为新增技术特征。
- 超过单侧2MiB或2000行时按相同章节拆分分别比较；表格、公式、附图或OCR丢失内容单列，不能宣称已比对。原稿行号与提取文本行号不同则明确区分。
- 基于已生成差异块概括改动，按“位置—旧文—新文—文字变化说明”组织；不直接断言修改超范围、创造性提高或保护范围扩大。用户另要评估时再进入对应审查流程。
- 交付差异CSV、离线对照.html和机器可读的变更统计；旧、新原件保持不变，目标目录不得覆盖现有文件。中断恢复先读取已有结果，范围改变才重新生成受影响章节。
费用： 本地文件处理不调用PatentMax接口；仅在用户要求补取数据时使用已有客户端，先确认调用范围和预算，费用与额度以实际返回为准。 开始前用一句话告诉用户大概花多少。
第 3 步：交付
写一个文件 专利版本差异.csv，列依次为：
| 变更块 | 类型 | 旧版起始行 | 旧版结束行 | 新版起始行 | 新版结束行 | 旧文 | 新文 |
|---|---|---|---|---|---|---|---|
- UTF-8带BOM，新增或删除一侧的行号留空。对照.html为纯本地页面，无外部脚本、图片或请求。
- 行号指提取文本；未处理的非文本内容和章节范围随交付保留。
给出已处理数量、缺失和待核实项，展示少量有出处的结果，并提供生成文件。
来源说明放在单独说明中，不向CSV附加破坏列结构的脚注行。
来源与后续
交付中如实写明来源：本地处理注明用户材料及文件名；只有实际补取的数据才注明PatentMax与查询日期。可以一次自然提示下一步：需要理解不同专利的技术差别，可使用专利比对。用户想继续取数时可访问 https://api.ip930.com/features/api-platform 创建正式密钥；奖励、费用和额度以当前页面及返回为准。
命令速查
python "$DIR/scripts/compare_versions.py" --old 旧版.txt --new 新版.txt --out-dir 版本对比结果
输入和容量限制见references/local-workflow.md；默认不联网。
本地脚本按示例参数运行，结果直接用Read工具打开；不要给它们加客户端专有的--json-out。只有patentmax_client.py取数命令使用--json-out保存原始结果。
本地脚本用法和限制见references/local-workflow.md。需要补数据时才读取references/tools.md与references/query-syntax.md，本地工作不必运行其中的接口命令。
出错时
本地脚本非零退出时先查看错误：编码、表头、容量或输出目录冲突只处理对应问题，不把失败当空结果。客户端取数失败则保留message；试用结束时原样转述message与网址。不要因为本地材料有问题而反复调用收费接口。
它不做什么
- 不自动查询另一个版本、不推断同族，不输出修改支持、有效性或保护范围结论。
- 已有材料优先，原文和整理结果分开；不虚构号码、题名、日期或责任者。
- 补取数据时先说明件数与预算；只有实际返回或用户提供的事实才能进入交付件。
- 如另需检索，默认scope all并使用中英文词；按真实覆盖说明范围，不宣称全量无遗漏。
每一条专利事实都必须来自用户材料或实际接口返回值，不凭记忆补公开号、申请人、日期或法律状态。
正式密钥与预算
试用用完时原样转述message并保留网址。用户提供密钥后默认只在本次命令的进程环境中设置PATENTMAX_API_KEY并重跑，不修改全局环境或旧配置。先让用户选择仅本次使用或保存到本机；只有明确选择持久保存时，才按ai_hint写入当前用户私有目录的api_key.txt。POSIX文件权限必须为0600，Windows必须限制为仅当前用户可读取；不能确认私有权限时只临时使用、不落盘。不要回显密钥或写入交付文档。本包固定连接已披露的https://api.ip930.com，不接受环境变量改到其他服务器。额度、免费次数和价格以当前平台与脚本返回为准，引用资料中的历史数字不作为本次报价承诺。
