专利参考文献 · 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 步：先问清楚（最多一轮）

1. 含公开号、标题及其他著录项的CSV或已有检索结果
2. 是否有期刊、学校或报告的具体引用模板；未指定则用可读的编号目录

直接使用已提供的材料，必要问题集中补问一轮，不让用户重复提交。

第 2 步：怎么做

1. 读取已有清单，保留完整公开号和来源。已有JSON先映射为CSV，记录字段映射，不重新调用接口获取已经有的字段。申请人、发明人、责任者各自保留，不把申请人自动改成作者。
2. 公开号和标题为最低成条字段；公开日缺失则明确标注，不能拿申请日、授权日或网页访问日代替。保留文献种类码，不合并A/B版本或同族成员。
3. 运行make_bibliography.py生成编号引用表和Markdown目录。默认格式为“标题[专利]，公开号，公开日，申请人”；缺失值显式标注，不造链接、不补题名。该格式用于可追溯阅读，不宣称符合某个国标或期刊规范。
4. 用户给了模板时，在保留字段表的基础上逐项重排标点、责任者和日期位置；需要外部标准或版本要求时查当前权威材料，不凭印象指定标准年份。WIPO ST.14用于理解文献引用标识，不代替学校或期刊的格式要求。
5. 只有用户要求补字段时才先列待补件数和预算，再逐件brief --no-claims；确认号码对应，缺字段与失败分开标注，原始结果另存。标题翻译另列“译名”，不冒充原文。
6. 输出引用表、引用清单.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，不接受环境变量改到其他服务器。额度、免费次数和价格以当前平台与脚本返回为准，引用资料中的历史数字不作为本次报价承诺。