企业官网建设流程全解析

中国专利交底书工具 patent-disclosure-skill 运行报错十大常见问题与快速解法清单

【免费下载链接】patent-disclosure-skill中国专利.skill：专利点挖掘与交底书（发明/实用/外观）编写，通俗解读专利，嗅探政策动向，辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skill

patent-disclosure-skill（中国专利.skill）是一款面向研发人的专利交底书编写、专利通俗解读与审查答复辅助工具：从项目材料中挖掘专利点、自动生成发明/实用新型/外观三种交底书，还能把晦涩专利读成人话笔记入库 Obsidian。新手第一次跑起来时，最常遇到「依赖缺失、浏览器起不来、终端乱码、出图失败」这十类问题。本文按报错频率整理成清单，每条都给出最快的解法，照着做 5 分钟即可恢复。

十分钟速查表：报错对照一下

官方安装说明见 INSTALL.md，工具脚本说明见 tools/README.md，技能路由见 SKILL.md。

问题一：Python 版本报错，提示需要 3.9+

本技能要求Python 3.9 及以上（含 pip）。若命令行python --version低于 3.9，所有脚本都会直接报错。

快速解法：

• 安装或切换到 Python 3.9–3.12（推荐 3.10–3.12），再重新进入终端运行；
• 涉及可选 STEP 解析时，建议单独建 venv：Python 3.13 常缺少 CadQuery 预编译包，隔离环境最稳（见 tools/README.md「CAD / STEP」）。

问题二：No module named 'playwright' / 'docx'缺依赖

最常见的入门报错：脚本提示找不到playwright、docx、mammoth等模块。原因是还没在技能根目录装依赖。

快速解法（在仓库根目录执行一次即可）：

pip install -r requirements.txt

• 解读模式额外需要：pip install -r tools/patent_reader/requirements.txt（含 PDF 解析 pymupdf），见 tools/patent_reader/README.md；
• 审查答复模式额外需要：pip install -r tools/oa/requirements-oa.txt；
• 国知局查新爬虫：pip install -r tools/crawl/requirements-cnipa.txt（已装主依赖通常可跳过）。

问题三：浏览器报错Executable doesn't exist

出图与查新共用 Playwright 浏览器，启动失败通常报Executable doesn't exist或探测ok=false。

快速解法：

1. 先探测本机浏览器：python tools/shared/browser.py --probe，探测顺序为 系统 Chrome → Edge → Playwright 自带 Chromium（见 tools/shared/browser.py）；
2. 有 Chrome 或 Edge（多数电脑都有）就能直接用，不必装 Node 或 npx；
3. 两者都没有时，执行一次python -m playwright install chromium即可。

无浏览器时不必慌：交底书仍可先出 Markdown（mermaid 围栏保留），补齐浏览器后重跑出图脚本即可。

问题四：PowerShell 出现红字 NativeCommandError，其实是误报

Windows PowerShell 常把脚本的 stderr 中文标记为红色NativeCommandError，看起来像崩了，其实脚本可能已成功。

快速解法：

• 以退出码 0 + 机读前缀为准：EPUB_HITS_JSON:、PROBE:、MERMAID:、DOCX: ok=1等前缀出现即成功；
• 不要因此重复安装依赖，也不要把查新降级成 WebSearch；
• 不要把2>&1混进 JSON 流，避免把结果搅进错误流（说明见 INSTALL.md）。

问题五：Windows 终端中文输出乱码

GB 编码终端打印中文 stderr 时易出现方框乱码。

快速解法：

• 设置环境变量PYTHONUTF8=1再运行（脚本已自带 UTF-8 处理，见 tools/shared/stdio_utf8.py）；
• 通常无需先chcp 65001；乱码只影响观感，不影响产出文件内容。

问题六：Word 里 mermaid 框图变成了代码块

定稿时若浏览器不可用或某个图渲染失败，脚本会自动降级：保留 `bash python tools/shared/mermaid_render.py -i draft.md -o "案件名_20260915103000.md"

判读成功：输出前缀 `MERMAID:` 与 `DOCX: ok=1` 且退出码 0。交付命名须带 `_{YYYYMMDDHHmmss}` 时间戳，见 [prompts/disclosure/invention/disclosure_builder.md](https://link.gitcode.com/i/832e5216f4c289b26533bc145aab4e75)。 [![patent-disclosure-skill 初版交底书与 mermaid 图目录生成效果](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/docs/效果例-初版生成.jpg?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/26f6905a5f87cb49d3a9c8787a1ffa19) ## 问题七：公式变纯文本，stderr 出现 `omml_text_fallback` 公式默认走 OMML（可编辑 Office 公式，`latex2mathml` 已在主依赖中）。个别公式转换失败时会**保留 LaTeX 原文**，并在 stderr 提示 `omml_text_fallback`。 **快速解法**： 1. 确认确实需要图片形式公式后，执行 `pip install matplotlib`（默认主依赖不含，约 100MB，须用户确认后安装）； 2. 重出 Word：`python tools/shared/md_to_docx.py -i 定稿.md -o 定稿.docx --base-dir 定稿目录 --math-render`，OMML 失败的公式将改用 PNG 嵌入（见 [tools/shared/math_render.py](https://link.gitcode.com/i/33c0a64479b08df14de8818ad5265626)）。 [![patent-disclosure-skill 实用新型线稿含部件序号引出效果](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/docs/效果例-实用新型专利线稿含部件序号引出线.png?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/26f6905a5f87cb49d3a9c8787a1ffa19) ## 问题八：`.doc`、`.ppt` 老格式转换失败 文档转换只支持 OOXML 新格式：`.docx` / `.pptx`（另存为 `.ppsx` 可以），**老版 `.doc`、`.ppt` 不支持**，会直接报错。 **快速解法**： - 在 Word / WPS / PowerPoint 中把文件「另存为」`.docx` / `.pptx` 再扫描； - 转换命令：`python tools/shared/docx_to_md.py -i 设计说明.docx -o outputs/case/design.md`； - 若 docx 版式复杂导致转换警告（部分样式、WMF 图），仍可生成可用 Markdown；版式严重崩坏时建议先另存 PDF 再扫（见 [tools/README.md](https://link.gitcode.com/i/909aea47f0a2741f5f61de0516b4ed17)）。 ## 问题九：国知局查新失败或无结果、外观专利取不到 PDF 查新优先走国知局公布公告站（`tools/crawl/cnipa_epub_search.py`），网络波动或检索词不当时可能无结果；外观设计（`CN…S`）常**没有 PDF CDN**，直接抓全文会失败。 **快速解法**： 1. 查新异常或无果时，按流程**降级 WebSearch**（Google 学术无专利类型过滤，实用新型建议回国知局关键词检索），来源表见 [references/patent_type_search.yaml](https://link.gitcode.com/i/8f2106a25852bfb0edaf9b25f224a857)； 2. 外观专利改走视图取证：`python tools/patent_reader/extract/fetch_design_views.py --pub CN309939145S -o tmp/patent_reader/demo_design`； 3. 核对公开号是否抄错（国知局 epub 可核验），或请用户自备 PDF，源站配置见 [references/patent_pdf_sources.yaml](https://link.gitcode.com/i/3cc1897770de2971b522008c76ae9b08)。 [![外观设计专利交底材料的产品图示例](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/examples/example_design_desk_lamp/knowledge/assets/mi_desk_lamp_pro.jpg?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/26f6905a5f87cb49d3a9c8787a1ffa19) ## 问题十：Obsidian 库找不到 / OA 向量检索报错 两类库相关报错：解读时提示未找到 Obsidian 库；审查答复（模式 D）向量自检失败。 **快速解法**： 1. Obsidian 库路径未配置时，解读会降级输出到 `outputs/patent_reader/`（效果弱一截）。手动探测并持久化： ```bash python tools/patent_reader/vault/check_obsidian_env.py --set "D:\你的库路径" --setx

入库后在 Obsidian 中Ctrl+R重载即可看到笔记与图谱；配置指南见 docs/obsidian-setup-guide.md。

2. 向量检索失败（API Key 错误、超时等）不影响主流程：
   • 查看状态：python tools/oa/config.py status，自检python tools/oa/config.py selftest；
   • 不想折腾向量可直接python tools/oa/config.py skip-vector，标签检索始终可用，中途也能再开启并重建索引；
   • 草稿必须人工复核后再递交，流程见 docs/oa/README.md 与 tools/oa/README.md。

附：模块路径速查，报错定位更快

💡 一句话总结：九成报错都出在「依赖 + 浏览器」两环。先pip install -r requirements.txt，再browser.py --probe，然后以退出码 0 和机读前缀判断成败——不慌不乱，五分钟恢复运行。

【免费下载链接】patent-disclosure-skill中国专利.skill：专利点挖掘与交底书（发明/实用/外观）编写，通俗解读专利，嗅探政策动向，辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skill