skilld
All skills
cat-xierluo avatar

/patent-download

@b7b6d0b
by 杨卫薪律师cat-xierluo/legal-skills705 stars
106

专利 PDF 批量下载工具。当用户需要下载专利全文 PDF、查询专利信息、批量导出专利文件时使用。支持多平台（Google Patents 优先），自动处理申请号和公告号格式。

Ask your Agent

Use this Skill: https://skilld.dev/gh/cat-xierluo/legal-skills/patent-download

This session only. Nothing lands on disk.

CHANGELOG.md

≈2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Changelog

本文件记录 patent-download 的用户可见变更。最新在前。

[2.7.1] - 2026-08-05 安全披露完善

文档完善

  • 新增「所需权限与安全说明」章节：披露运行时自动安装依赖（patent-download.sh 自动 pip install / playwright install chromium）、外部网络请求、环境变量凭证读取、Playwright 浏览器自动化、文件输出范围等能力边界，并提醒自动安装未固定版本存在供应链风险。对应外部安全审查（SkillSpector）的 Missing User Warnings / Context-Inappropriate Capability / Unpinned Dependencies 类问题。
  • 同步修复 frontmatter version 与 CHANGELOG 不一致（原 2.6.0，CHANGELOG 已到 2.7.0）。

[2.7.0] - 2026-07-28 友好失败提示

改进

  • 未找到专利时的差异化提示：新增 _print_not_found_hint()，根据输入是申请号还是公告号、专利类型（外观设计/发明/实用新型/未知）给出针对性建议
  • 外观设计专利专项提示：公告号 CN304964299S（Google Patents 未收录）这类场景，主动告知"Google Patents 对外观设计覆盖率较低"，并给出两条替代路径（度衍账号 / CNIPA 公告公布手动下载）
  • 发明/实用新型未收录兜底：明确告知"理论上覆盖但有特例"，列出可能原因（拼写错误、保密期、撤回）
  • 格式错误兜底：用户输入 CN12345 这种不符合 CN+数字+字母后缀 格式的号，自动提示正确格式

技术优化

  • get_info 与 download_patent 复用同一提示函数：错误文案统一管理，避免两边各写一份

决策记录

  • 详见 DECISIONS.md DEC-009：epub.cnipa 阿里云 WAF 不可绕，自动查号器暂不实现，改为友好引导

[2.6.1] - 2026-07-28 文档精简

改进

  • 移除外部 Skill 指向：删除"法条与案例检索 → 用 yuandian-law-search"等跨技能引用，避免跨技能污染
  • 删除目录结构图：SKILL.md 是操作手册而非开发文档，目录树属冗余信息

待补充

  • 外部依赖已有 requirements.txt 统一管理，首次使用前按需安装即可（见 SKILL.md 依赖章节）

[2.6.0] - 2026-07-23 发布前审查修复

改进

  • 定位拓宽：description 与标题从「中国专利下载工具」改为「专利下载工具」，反映平台本身支持通用专利（Google Patents 覆盖全球）；中国专利号格式说明作为客观事实保留
  • 隐私去具体化：实测案例中的真实公司名泛化为占位符「某信息科技公司」
  • 文档结构：EXAMPLES.md 下沉到 references/examples.md（渐进式披露，根目录只留核心文档）
  • 文档清理：删除 SKILL.md 目录图中已废弃的 pss_cookies.txt 行；删除 accounts-setup.md 中对已废弃 cookies 文件机制的引导

[2.5.0] - 2026-07-23 凭证隔离安全加固

新增

  • 防泄露自检：_creds.py 新增 check_leak()，运行 python scripts/platforms/_creds.py 时自动检查 config/.env 是否被 git 误追踪；若追踪则报警并给出可直接执行的 git rm --cached 修复命令，避免真实账号入库

改进

  • 凭证自检输出优化：自检只列出需要账号的 4 个平台（uyanip/patentstar/gpic/pss），google/epub 单独标为免登录，不再对免登录平台报"无账号"造成误导
  • .env.example 顶部加防提交警示：明确标注"切勿提交真实账号"及误操作后的修复方式、自检命令

修复

  • check_leak() 报警路径修正：原实现报警命令的 git -C 路径指向 skill 目录而非 git 仓库根，用户照做会失败；改用 git rev-parse --show-toplevel 取真实仓库根，报警命令可直接复制执行

[2.4.0] - 2026-07-23 依赖防护与发布就绪

技术优化

  • 依赖缺失优雅降级：6 个脚本的外部依赖 import 加 try/except 防护，未安装时打印清晰的中文安装提示并退出，不再抛晦涩的 ImportError
    • download.py：playwright（含 playwright install chromium 提示）
    • uyanip.py / epub.py / patentstar.py / pss.py / gpic.py：requests
  • 符合 AGENTS.md「脚本依赖防护要求」硬依赖规范

改进

  • SKILL.md 依赖章节重构：按 AGENTS.md「SKILL.md 依赖声明要求」区分"开箱即用"（信息查询、凭证自检零依赖）和"需安装依赖"（按通道列出依赖表）两档，就近给出安装说明

[2.3.0] - 2026-07-23 技术债务清理与一致性修复

改进

  • 文档/注释对齐凭证来源：修正 v2.2.0 改造后残留的"账号见 config/platforms.yaml"表述（platform-status.md、gpic/pss/uyanip 文件头、cli.py 注释），统一改为"环境变量，见 config/.env.example"，与 _creds.py 实际行为一致
  • 半成品平台显式标注：给 patentstar / patentstar_browser / gpic / pss / epub 五个未完成或已失效的平台脚本在 docstring 顶部加 ⚠️ 实验性 标记，说明失效原因并指向 Google Patents
  • 静默失败改为明确提示：上述脚本 download_pdf 末尾的静默 return None 改为打印"未实现 + 推荐改用 Google Patents"提示，避免用户看到流程跑完却无文件
  • 度衍浏览器流程提示：uyanip 浏览器方式流程可用但未监听 download 事件保存文件，补充明确说明
  • wrapper 注释：patent-download.sh 补充分流逻辑说明（google → cli.py，其他 → download.py epub 旧入口）

文档完善

  • LICENSE.txt 版权行：修正为项目统一的 Copyright (c) 2025 杨卫薪律师（微信ywxlaw）（原为 2026 杨卫薪，缺后缀）
  • download.py / epub.py 交叉注释：说明 download.py 是 epub 平台的相对完整实现，platforms/epub.py 为 cli.py 统一架构下的占位

技术优化

  • 确认 scripts/platforms/__pycache__/ 未被 Git 跟踪（.gitignore 的 __pycache__/ 规则已正确生效），本地 .pyc 为运行时产物，无需清理

[2.2.0] - 2026-07-12 公开发布改造

  • 凭证改环境变量：账号不再入仓库，通过 PATENT_<平台>_USERNAME/_PASSWORD 环境变量配置；新增 config/.env.example 模板，用户 cp 为 .env 填写（.gitignore 不入库）
  • _creds.py 重写：读 os.environ，回退手动解析 .env（无 python-dotenv 依赖）
  • platforms.yaml 解耦：去掉所有账号字段，只保留平台元数据
  • cookies 忽略：config/pss_cookies.txt 从仓库移除（git rm --cached）+ .gitignore
  • 文件归位：patent-download.sh 移入 scripts/；config/accounts.md → references/accounts-setup.md（改写为账号获取 + ToS 合规说明，无密码）
  • LICENSE.txt：补 MIT 全文（frontmatter 已声明）
  • ToS 合规：账号登录通道（度衍/PatentStar/粤港澳/PSS）在 references 标注，由用户自评风险

[2.1.0] - 2026-07-12 目录结构规范化

  • 凭证集中：data/ → config/，账号单一来源 config/platforms.yaml
  • 代码零硬编码：cli.py 与 5 个平台脚本（pss / patentstar / uyanip / gpic / patentstar_browser）移除明文账号密码，统一改读 config/platforms.yaml
  • 新增 scripts/platforms/_creds.py：共享凭证加载工具
  • 删除死代码：scripts/api/、scripts/browser/（共 353 行无人调用的历史遗留）
  • 抽取参考文档：references/patent-number-formats.md、references/platform-status.md
  • SKILL.md 按渐进式披露瘦身，目录图与实际对齐
  • 安全：移除 patentstar.py 把 session cookie 打印到 stdout 的逻辑

[2.0.0] - 2026-07-11 Google Patents 成为首选通道

  • 新增 Google Patents 平台（推荐），实测 202421964517.8 成功下载
  • 标记 PatentStar API 失效（Ret=206），调低推荐度
  • 标记润桐 RainPat 服务器维护中（预计 2026-07-17 恢复）
  • 明确申请号 vs 公告号的区别说明

[1.0.0] - 2026-02-27 多平台架构

  • 添加度衍专利支持
  • 初始版本，解耦为多平台架构

Source: SKILL.md on GitHub

Third-party checks

1 warning1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is a comprehensive utility for downloading patent documentation from multiple global and regional platforms. It implements secure credential management using environment variables and includes a safety auditing tool to prevent the accidental exposure of sensitive account information in version control systems.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: MEDIUM · 1 issue

Provenance

Signed by skilld at b7b6d0b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

Capability

version
2.7.1
author
杨卫薪律师（微信 ywxlaw）
homepage
https://github.com/cat-xierluo/legal-skills

README badge

README badge for cat-xierluo/legal-skills/patent-download