十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

patent-disclosure-skill 出图提速技巧:mmdc-scale 与视口参数调优完整指南

patent-disclosure-skill 出图提速技巧:mmdc-scale 与视口参数调优完整指南 patent-disclosure-skill 出图提速技巧mmdc-scale 与视口参数调优完整指南【免费下载链接】patent-disclosure-skill中国专利.skill专利点挖掘与交底书发明/实用/外观编写通俗解读专利嗅探政策动向辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skillpatent-disclosure-skill中国专利技能是一款覆盖发明、实用新型、外观设计的专利交底书编写技能从项目材料挖掘专利点用 mermaid 画出系统框图与流程图并一键输出 Markdown Word 定稿。本文带你调优出图脚本 tools/shared/mermaid_render.py 的三个视口参数--mmdc-scale、--mmdc-width、--mmdc-height让框图出得更快、更清晰、不占地方。先搞懂出图链路是怎么跑起来的交底书的 3.2 系统框图和 3.4 流程图都要求用 fenced mermaid 源码定稿时统一交给mermaid_render.py转成 PNG再顺手生成 Word。整条链路长这样起浏览器tools/shared/browser.py 按「系统 Chrome → Edge → Playwright 自带 Chromium」顺序探测启动出图和国知局查新共用同一套浏览器加载内置引擎仓库自带 tools/shared/vendor/mermaid.min.jsv11.4.1不需要Node、npm也不需要mmdc逐块截图每个mermaid 围栏 → Playwright 起浏览器 → 内置 mermaid.min.js 渲染 → PNG 截图 → md docx 定稿出图效果大致长这样批任务调度示例的系统框图 [![patent-disclosure-skill 交底书系统框图出图示例批任务调度模块架构图](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/examples/example_batch_job_scheduler/knowledge/docs/sample_assets/sample_fig_modules.png?utm_sourcegitcode_repo_files)](https://link.gitcode.com/i/7a173adc051b6b3029eb9c8d12323493) 流程类的图如任务排队调度同理一图一块逐块出 [![patent-disclosure-skill 交底书流程图出图示例批任务调度队列流程图](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/examples/example_batch_job_scheduler/knowledge/docs/sample_assets/sample_fig_queue.png?utm_sourcegitcode_repo_files)](https://link.gitcode.com/i/7a173adc051b6b3029eb9c8d12323493) 小提醒这三个视口参数只影响**发明的 mermaid 出图**。实用新型/外观设计按 [figure_plan.yaml](https://link.gitcode.com/i/e87a6095503524021d99786e6637457a) 嵌实拍图、线稿或 CAD 视图不走 mermaid 这条路。实用新型的出图效果参考这张结构线稿含部件序号引出线 [![patent-disclosure-skill 实用新型专利线稿出图结构轮廓与部件序号引出线](https://raw.gitcode.com/GitHub_Trending/pa/patent-disclosure-skill/raw/d029f81da0257c7e2945aad3cc1491a9e4bc9213/docs/效果例-实用新型专利线稿含部件序号引出线.png?utm_sourcegitcode_repo_files)](https://link.gitcode.com/i/7a173adc051b6b3029eb9c8d12323493) ## 三个参数分别管什么 参数定义在 [mermaid_render.py](https://link.gitcode.com/i/4473d4bdbf63c46c1fd8d235d982a5ea#L394-L414) 的命令行入口语义如下 | 参数 | 默认值 | 控制什么 | 调大/调小的影响 | |------|--------|----------|------------------| | --mmdc-scale N | 2 | device_scale_factor设备像素比 | 越大越清晰PNG 文件也越大必须为正数 | | --mmdc-width PX | 1400 | 渲染视口宽度像素 | 视口是画布不是裁剪框宽图放得开布局更舒展 | | --mmdc-height PX | 1050 | 渲染视口高度像素 | 竖向长的流程图给足高度避免节点挤行 | 三个参数都低于下限会被拒绝scale 必须 0宽高建议 **不小于 400**见 [mermaid_render.py](https://link.gitcode.com/i/4473d4bdbf63c46c1fd8d235d982a5ea#L416-L421) 的参数校验。截图时页面会给图块加 16px 内边距并留白所以最终 PNG 是「图 少量白边」Word 里观感干净。 参数名里的 mmdc 是历史遗留早期用 mermaid-cli 时的命名现在实际走的是 Playwright 直出 PNG名字没改语义就是「缩放倍率 / 视口宽 / 视口高」可以放心用。 ## 五个提速实践 **1️⃣ 优先复用系统浏览器别多下 Chromium** browser.py 会自动探测本机 Chrome → Edge只有都没有时才需要 python -m playwright install chromium整机一次。一条命令自测 bash python tools/shared/browser.py --probe输出oktrue就能直接出图。这一步省掉的下载往往是整条链路最耗时的部分。2️⃣ 一条命令出全md PNG Wordmermaid_render.py默认在转完 PNG 后直接调用md_to_docx.py不用两步跑python tools/shared/mermaid_render.py -i draft.md -o 一种XXX方法及系统_20260408143025.md看机读前缀判成败即可MERMAID: okN fail0和DOCX: ok1、退出码 0 就是成功SKILL.md 也强调stderr 有中文或 PowerShell 红字不等于失败。3️⃣ 单块失败不中断先交付再补图某块 mermaid 语法报错时脚本只保留该块围栏源码、其余块照常出图Markdown 和 Word 仍会产出失败块在 Word 里是代码块。等语法修好后重跑同一条命令即可补齐 PNG无需推倒重来。4️⃣ 只想要图--no-docx跳过 Word调试布局、只想快速看 PNG 效果时python tools/shared/mermaid_render.py -i draft.md -o draft_figures.md --no-docx少跑一轮 Word 转换迭代速度直接翻倍确认版式后再按第 2 条出完整定稿。5️⃣ 别为出图装 Node / mmdc仓库里 tools/package.json 只是旧 mmdc 方案的可选遗留主路径完全不经过它。tools/README.md 明确「禁止为出图执行npm install/npx」——省下的是整个 Node 工具链的下载与浏览器下载时间。视口参数调优速查表场景推荐命令片段理由日常定稿不加参数默认 1400×1050scale 2清晰度与体积均衡Word 内嵌默认最大宽 5.5″×高 8.2″ 等比缩放够用放大后发虚--mmdc-scale 3像素密度提升投影/打印更锐利横向很宽的框图--mmdc-width 1800视口加宽子图subgraph不易换行挤压竖向很长的流程图--mmdc-height 1400给足画布高度节点纵向排开图文件过大--mmdc-scale 1.5牺牲一点清晰度换小体积组合示例更高清晰度python tools/shared/mermaid_render.py -i draft.md -o 定稿_20260408143025.md --mmdc-scale 3 --mmdc-width 1600 --mmdc-height 1200初版生成后的交付目录里时间戳命名的交底书与mermaid_figures/图目录并存多轮迭代互不覆盖常见问题FAQQ终端里NativeCommandError、乱码是不是出图失败了不是。Windows PowerShell 会把 stderr 标红脚本本身以退出码 0 机读前缀MERMAID:/DOCX:/PROBE:为准也不要用21把 JSON 混进错误流。QWord 里图被裁了一般是公式/图片超高被压。md_to_docx.py支持--image-max-width-inches/--image-max-height-inches按纸张边距放宽上限源头解决则是给流程图加--mmdc-height减少纵向密度。Q没有 Chrome 也没有 Edge 怎么办执行一次python -m playwright install chromium之后--probe会显示channelchromium。细节见 INSTALL.md。相关资料索引出图脚本tools/shared/mermaid_render.py浏览器探测与启动tools/shared/browser.py内置渲染引擎tools/shared/vendor/mermaid.min.js出图/查新工具总览tools/README.md定稿命名与 mermaid 约定§7.3prompts/disclosure/invention/disclosure_builder.md安装与浏览器自检INSTALL.md出图降级与围栏保留的回归测试tests/shared/test_mermaid_browser.py按这份指南调参后你的交底书框图应该能做到默认配置一步出全个别大图微调一个视口参数即可全程不碰 Node。把「图」这一步跑顺了整份交底书的交付体验会顺滑很多 【免费下载链接】patent-disclosure-skill中国专利.skill专利点挖掘与交底书发明/实用/外观编写通俗解读专利嗅探政策动向辅助审查答复。项目地址: https://gitcode.com/GitHub_Trending/pa/patent-disclosure-skill创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表