本技能有独立的免费试用额度，不与其他 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 秒即可
什么时候用
| 用户说 | 怎么做 |
|---|---|
| 把这份专利CSV整理成编号参考文献，缺字段标出来 | 使用本技能 |
| 检索新文献或作查新、侵权判断 | 使用对应检索或报告能力 |
第 1 步：先问清楚（最多一轮）
- 含公开号、标题及其他著录项的CSV或已有检索结果
- 是否有期刊、学校或报告的具体引用模板；未指定则用可读的编号目录
直接使用已提供的材料，必要问题集中补问一轮，不让用户重复提交。
第 2 步：怎么做
- 读取已有清单，保留完整公开号和来源。已有JSON先映射为CSV，记录字段映射，不重新调用接口获取已经有的字段。申请人、发明人、责任者各自保留，不把申请人自动改成作者。
- 公开号和标题为最低成条字段；公开日缺失则明确标注，不能拿申请日、授权日或网页访问日代替。保留文献种类码，不合并A/B版本或同族成员。
- 运行make_bibliography.py生成编号引用表和Markdown目录。默认格式为“标题[专利]，公开号，公开日，申请人”；缺失值显式标注，不造链接、不补题名。该格式用于可追溯阅读，不宣称符合某个国标或期刊规范。
- 用户给了模板时，在保留字段表的基础上逐项重排标点、责任者和日期位置；需要外部标准或版本要求时查当前权威材料，不凭印象指定标准年份。WIPO ST.14用于理解文献引用标识，不代替学校或期刊的格式要求。
- 只有用户要求补字段时才先列待补件数和预算，再逐件brief --no-claims；确认号码对应，缺字段与失败分开标注，原始结果另存。标题翻译另列“译名”，不冒充原文。
- 输出引用表、引用清单.md和缺失字段统计；保留原始行顺序及来源行号，重复条目列提示，不悄悄去掉用户标注或改变文内编号。
费用： 本地文件处理不调用PatentMax接口；仅在用户要求补取数据时使用已有客户端，先确认调用范围和预算，费用与额度以实际返回为准。 开始前用一句话告诉用户大概花多少。
第 3 步：交付
写一个文件 专利文献引用表.csv，列依次为：
| 序号 | 公开号 | 标题 | 公开日 | 申请人 | 责任者原文 | 引用条目 | 缺失字段 | 来源文件 | 来源行号 |
|---|---|---|---|---|---|---|---|---|---|
- UTF-8带BOM，另有引用清单.md；目录内的编号与字段表一致。
- 通用阅读格式不是GB/T或期刊合规认证；用户要求具体格式时保留模板出处与版本。
给出已处理数量、缺失和待核实项，展示少量有出处的结果，并提供生成文件。
来源说明放在单独说明中，不向CSV附加破坏列结构的脚注行。
来源与后续
交付中如实写明来源：本地处理注明用户材料及文件名；只有实际补取的数据才注明PatentMax与查询日期。可以一次自然提示下一步：需要批量阅读可继续制作专利摘要汇编。用户想继续取数时可访问 https://api.ip930.com/features/api-platform 创建正式密钥；奖励、费用和额度以当前页面及返回为准。
命令速查
python "$DIR/scripts/make_bibliography.py" --input 专利著录数据.csv --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，不接受环境变量改到其他服务器。额度、免费次数和价格以当前平台与脚本返回为准，引用资料中的历史数字不作为本次报价承诺。
