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

中国专利交底书工具 patent-disclosure-skill 运行报错十大常见问题与快速解法清单【免费下载链接】patent-disclosure-skill中国专利.skill专利点挖掘与交底书发明/实用/外观编写通俗解读专利嗅探政策动向辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skillpatent-disclosure-skill中国专利.skill是一款面向研发人的专利交底书编写、专利通俗解读与审查答复辅助工具从项目材料中挖掘专利点、自动生成发明/实用新型/外观三种交底书还能把晦涩专利读成人话笔记入库 Obsidian。新手第一次跑起来时最常遇到「依赖缺失、浏览器起不来、终端乱码、出图失败」这十类问题。本文按报错频率整理成清单每条都给出最快的解法照着做 5 分钟即可恢复。十分钟速查表报错对照一下#典型报错 / 现象快速解法详细小节1Python 3.9版本提示换 Python 3.9–3.12问题一2No module named playwright重装依赖问题二3Executable doesnt exist装系统浏览器或 Chromium问题三4PowerShell 红字NativeCommandError看退出码不是真失败问题四5终端中文乱码设PYTHONUTF81问题五6Word 里框图是代码块重跑 mermaid_render问题六7omml_text_fallback公式变文本装 matplotlib 重出问题七8.doc/.ppt转不了另存为 docx / pptx问题八9国知局查新无结果降级 WebSearch / 视图取证问题九10Obsidian 库没找到 / 向量报错设库路径 / 跳过向量问题十官方安装说明见 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 解析时建议单独建 venvPython 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 doesnt exist出图与查新共用 Playwright 浏览器启动失败通常报Executable doesnt exist或探测okfalse。快速解法先探测本机浏览器python tools/shared/browser.py --probe探测顺序为 系统 Chrome → Edge → Playwright 自带 Chromium见 tools/shared/browser.py有 Chrome 或 Edge多数电脑都有就能直接用不必装 Node 或 npx两者都没有时执行一次python -m playwright install chromium即可。无浏览器时不必慌交底书仍可先出 Markdownmermaid 围栏保留补齐浏览器后重跑出图脚本即可。问题四PowerShell 出现红字 NativeCommandError其实是误报Windows PowerShell 常把脚本的 stderr 中文标记为红色NativeCommandError看起来像崩了其实脚本可能已成功。快速解法以退出码 0 机读前缀为准EPUB_HITS_JSON:、PROBE:、MERMAID:、DOCX: ok1等前缀出现即成功不要因此重复安装依赖也不要把查新降级成 WebSearch不要把21混进 JSON 流避免把结果搅进错误流说明见 INSTALL.md。问题五Windows 终端中文输出乱码GB 编码终端打印中文 stderr 时易出现方框乱码。快速解法设置环境变量PYTHONUTF81再运行脚本已自带 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: ok1 且退出码 0。交付命名须带 _{YYYYMMDDHHmmss} 时间戳见 [prompts/disclosure/invention/disclosure_builder.md](https://link.gitcode.com/i/832e5216f4c289b26533bc145aab4e75)。 [](https://link.gitcode.com/i/26f6905a5f87cb49d3a9c8787a1ffa19) ## 问题七公式变纯文本stderr 出现 omml_text_fallback 公式默认走 OMML可编辑 Office 公式latex2mathml 已在主依赖中。个别公式转换失败时会**保留 LaTeX 原文**并在 stderr 提示 omml_text_fallback。 **快速解法** 1. 确认确实需要图片形式公式后执行 pip install matplotlib默认主依赖不含约 100MB须用户确认后安装 2. 重出 Wordpython tools/shared/md_to_docx.py -i 定稿.md -o 定稿.docx --base-dir 定稿目录 --math-renderOMML 失败的公式将改用 PNG 嵌入见 [tools/shared/math_render.py](https://link.gitcode.com/i/33c0a64479b08df14de8818ad5265626)。 [](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://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 中CtrlR重载即可看到笔记与图谱配置指南见 docs/obsidian-setup-guide.md。向量检索失败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。附模块路径速查报错定位更快模块路径对应问题浏览器探测tools/shared/browser.py问题三mermaid 出图tools/shared/mermaid_render.py问题六Word 转换tools/shared/md_to_docx.py问题六、七文档转换tools/shared/docx_to_md.py问题八查新爬虫tools/crawl/cnipa_epub_search.py问题九解读入库tools/patent_reader/vault/write_patent_obsidian_note.py问题十OA 配置tools/oa/config.py问题十主依赖清单requirements.txt问题二 一句话总结九成报错都出在「依赖 浏览器」两环。先pip install -r requirements.txt再browser.py --probe然后以退出码 0 和机读前缀判断成败——不慌不乱五分钟恢复运行。【免费下载链接】patent-disclosure-skill中国专利.skill专利点挖掘与交底书发明/实用/外观编写通俗解读专利嗅探政策动向辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考