CAD审图拆单专家

概述

CAD 审图（免费版）

💡 不想装任何东西？ 直接用网页版：浏览器打开 <https://jssdzn-2ggznvtl36abc58b-1259642649.ap-shanghai.app.tcloudbase.com/cadweb/>，拖入 PDF 免费审前 3 页；整份全审 ¥9.9 起，微信扫码付款，图纸用完即删。本页的 Zip 包是给已经在用 AI 助手的用户准备的，普通用户无需下载。

概述

本技能为「CAD 审图+拆单」套件的免费版，仅使用规则引擎（PyMuPDF 几何/文字检测）对 PDF 深化图纸进行高置信度审图。

包含功能：

1. 按视图类型自动分区（立面图/剖面图/平面图/大样图/图框区）。
2. 按区运行对应规则：
   • RULE1 立面/剖面材料标注缺失
   • RULE2 平面外部尺寸
   • RULE5 剖面墙面完成
   • RULE6 大样/节点尺寸缺失
   • RULE8 尺寸链闭合校验
3. 输出结构化 JSON + HTML 审图报告。
4. 轻量拆单（v1.4.0 新增，零 API 成本）：基于 PDF 文字层，自动识别板件名、尺寸、材质标注，生成基础下料单（含材质代码/BOM/封边推断/木皮面积/标准板材张数估算）。

不包含功能（为付费版高精度能力，可通过内置升级钩子一键跳转专业版支付）：

• VLM 视觉抽板 / 板件识别（免费版仅靠文字层，纯图片/扫描件无法拆单）
• 材料汇总按图号透视 / 单元级聚合
• 带图标注 PDF
• 文件夹批量处理

免费版本身不收费，定位为获客入口；当用户需要上述付费能力时，由 Agent 在对话中一键引导至专业版支付（详见「付费能力升级引导」），体验与小程序一致。

依赖环境

• 规则引擎：自包含于 engine/（batch_review_v12i + v12_core），不依赖外部目录
• Python 环境：任意含 fitz（PyMuPDF）的 Python 3.10+ 即可

触发条件

• "免费审图"
• "CAD 审图免费版"
• "检查这份图纸"
• "深化图审查"
• "轻量拆单" / "生成下料单" / "帮我拆个单"
• 上传 PDF 图纸并要求审图

轻量拆单（零成本，v1.4.0 新增）

免费版在「规则审图」之外，新增基于 PDF 文字层的轻量拆单。它不调用视觉模型，直接解析图纸中的板件名、尺寸标注、材质标注（如 18多 / 5多+框+5多），生成一份可用基础下料单。

适用场景：图纸为带文字层的标准化 PDF（板件名、尺寸、材质均以文字标注）。这正是大部分深化图的常态。

运行方式：

python scripts/run_cutlist.py "<PDF路径>" [输出目录]

• 输出：{图名}_下料单.xlsx（含「下料单 / 饰面清单 / 汇总」三页：材质代码、毛料尺寸、封边推断、封边木皮面积、标准板材 1220×2440 估算张数与利用率、按材质汇总）。
• 默认输出目录：cutlist_out。

识别规则（与专业版共用同一套拆单规则库）：

• 材质代码：18多→PW18、18中→MDF18、18颗→PB18 等 12 类；5多+框+5多→空心门复合结构。
• 厚度：工厂简写 > 透传值 > 留空。
• 毛料尺寸：精裁 +20（长/宽）/ +2（厚）加工余量。
• 封边：按部件名推断（门板封四边、侧板封一长边、层板/背板不封），标注「V1推测」。

重要边界（务必对用户说明）：

• 结果是 AI 推测，封边/厚度按部件名推断，正式下料前须人工复核。
• 仅支持 PDF 文字层；纯图片/扫描件、纯矢量无文字的图纸无法拆单，此时会给出友好提示并建议升级专业版（VLM 抽板）。
• 标准板材张数估算为理论值，实际排版利用率以工厂排料为准。

核心流程

步骤 0：开场说明（必做，每次新会话首次触发本技能时执行）

用一段话讲清"能干什么、免费到哪、付费多少"，不要让用户在不知道边界的情况下跑完才发现受限。参考话术（可自然改写，三个信息点必须齐全）：

这是 CAD 审图免费版，完全免费、不需要付费，每次可审图纸的前 3 页，输出带红圈标注的审图报告。

如果您的图纸超过 3 页、或是纯矢量/扫描件（没有文字层）、或需要自动生成下料单和材料汇总，需要用到付费版，两档可选：试审 ¥9.9（10 页）——先用小钱验证准不准；专业版 ¥50（100 页）——整套图纸一次做完。

先把图纸发给我，我给您跑一遍看看效果。

步骤 1：确认输入

• 确认用户提供的是单份 PDF 文件路径。
• 如用户提供文件夹，提示免费版仅支持单文件；如需批量处理请使用专业版。

步骤 2：执行审图

python scripts/run_free.py "<PDF路径>" [输出目录]

• 默认输出目录：free_out

步骤 3：输出报告

• {图名}_审图.json：结构化审图结果（含 bbox、规则、等级、描述）。
• {图名}_审图报告.html：可直接浏览器打开的审图报告（问题清单 + 统计 + 视图区域），报告底部含「升级专业版」CTA。

步骤 4：付费能力升级引导（Freemium 漏斗）

免费报告生成后，若用户提出付费能力需求（批量 / VLM 抽板 / 下料单 / 材料汇总 / 文件夹处理），不要仅提示"请使用专业版"就结束，而是按以下流程在对话内引导付费。本流程复用专业版已部署的支付后端（https://jssdzn-2ggznvtl36abc58b-1259642649.ap-shanghai.app.tcloudbase.com/cadpay），免费版无需自建服务。

触发时机

• 用户主动要求付费能力：批量处理、VLM 视觉抽板、下料单、材料汇总、带图标注、文件夹处理。
• 免费报告生成后，Agent 主动提示一次升级机会（不强制、不重复弹）。

Agent 升级流程（对话内支付，像小程序一样）

1. 选档并发起订单（按图纸页数与用户意愿二选一，不要报不存在的档位）：
   • 图纸 ≤ 10 页、或用户想先小成本验证 → 试审档：POST {"user_id":"<用户标识>","skill_id":"cad-review-cutlist-pay-trial","skill_version":"1.0.0","plan":"trial"}（¥9.9 / 10 页）
   • 图纸 > 10 页、或用户要整套做完 → 专业档：POST {"user_id":"<用户标识>","skill_id":"cad-review-cutlist-pay-pro","skill_version":"1.4.6","plan":"standard"}（¥50 / 100 页）

端点：https://jssdzn-2ggznvtl36abc58b-1259642649.ap-shanghai.app.tcloudbase.com/cadpay/initiate，取回 out_trade_no 与 payment_code。

1. 弹付款码：将 payment_code 传给 weixinpay_pay 插件，在对话中向用户展示微信支付卡片。未支付前绝不执行付费功能。
2. 校验支付：用户支付后，Agent 调 /verify（{"out_trade_no":"<订单号>"}）确认 {"paid":true}。
3. 授权执行：携 out_trade_no 调对应版本的 /diagnose，随后引导用户切换到试审版或专业版技能完成审图拆单（试审版单次 10 页，专业版单次 100 页）。

用户可见文案

• 引导："您当前使用的是免费版（仅规则审图，最多 3 页）。板件识别 / 下料单 / 材料汇总是付费能力，两档：试审 ¥9.9（10 页）先验证准不准，专业版 ¥50（100 页）整套做完。您这套图纸 X 页，按您的情况建议走 ——，需要我生成付款码吗？"
• 已付："支付成功，正在为您切换到对应版本执行审图拆单。"
• 拒绝："已为您保留本次免费报告。需要时在对话中回复「试审」或「升级专业版」就行。"

快速上手（逐步示例）

下面用一份真实「立面图」演示从输入到报告的完整链路，照抄即可跑通。

第 1 步：准备输入将待审 PDF 放到任意目录，文件名建议带上图类关键词（如 餐厅立面图.pdf、节点大样图.pdf、一层平面图.pdf），便于引擎按视图分区。

免费版仅支持单份 PDF，不支持文件夹批量（专业版支持）。

第 2 步：运行审图

# 方式 A：使用本机已安装 PyMuPDF 的 Python 3.10+（推荐，零额外配置）
python scripts/run_free.py "餐厅立面图.pdf" free_out

# 方式 B：指定输出目录；不指定时默认写到 free_out/
python scripts/run_free.py "餐厅立面图.pdf"

• 脚本会先做文件预检（是否存在、是否目录、是否 0 字节、是否以 %PDF 开头），异常文件会被友好拦截，不会崩溃或卡死。

第 3 步：查看输出命令结束后在输出目录生成两份文件：

• 餐厅立面图_审图.json — 结构化问题列表（含 rule、level、bbox、description、view_type）。
• 餐厅立面图_审图报告.html — 浏览器直接打开，含统计、问题清单、视图区、整改建议与「升级专业版」CTA。

第 4 步：看懂各类结果

第 5 步：按需升级若报告提示纯矢量、0 问题、或你需要下料单/板件识别/材料汇总/文件夹批量，在对话中回复「升级专业版」，Agent 会复用专业版支付后端一键引导微信支付后执行，无需手动切换技能。

输出说明

审图 JSON

字段示例：

• rule：RULE1 / RULE6 / RULE8 等
• level：P0 致命 / P1 疑似 / P2 提示
• bbox：归一化坐标 [x0, y0, x1, y1]
• description：问题描述
• view_type：所在视图类型

HTML 报告

包含：

• 问题总数、视图区数量统计
• 按规则 / 等级 / 视图类型汇总表
• 逐条问题清单
• 识别的视图区域列表

重要限制

1. 规则引擎置信度有限：几何/文字检测存在误报与漏报，正式出具前必须人工复核。
2. 纯矢量 PDF：尺寸数字若为矢量路径，规则引擎可能无法读取，相关结论需标注"引擎无法自动判定，建议人工复核"。
3. 单文件限制：免费版一次仅处理一份 PDF。
4. 轻量拆单为文字层推测：免费版拆单仅基于 PDF 文字层，封边/厚度按部件名推断（标注「V1推测」），正式下料前须人工复核；纯图片/扫描件无法拆单，需升级专业版（VLM 抽板）。

故障排查

常见问题 FAQ

Q1：报告里只有 0 个问题，是不是图纸没问题？不一定。「0 个问题」可能意味着：

• 图纸是纯矢量 PDF，尺寸/材料文字以矢量路径绘制、文本层为空，引擎读不到（报告会显示「纯矢量图纸提示」横幅）；
• 规则未匹配到该图纸的缺陷类型。

结论：免费版报告仅供人工复核参考，不能直接当作"图纸合格"。重要图纸建议回复「升级专业版」走 VLM 复核。

Q2：什么是纯矢量 PDF？免费版能处理吗？纯矢量 PDF 指页面完全没有可选中文字，全由矢量路径（线段/曲线）绘制。免费版会：

• 自动检测并标记 is_vector_only；
• 在报告中显示提示横幅 + 「整改建议清单」（建议人工复核或升级专业版 VLM 抽板）；
• 对纯依赖图形判定的规则（如 RULE5 墙面完成面）自动跳过，避免误报。

注意：RULE2（平面外部尺寸）、RULE6（大样尺寸）等基于文字层判定，只要图纸含可选中文字即可生效。

Q3：支持哪些文件格式？仅支持单份 PDF。不支持 DXF/DWG 直接解析，不支持文件夹批量（专业版支持）。

Q4：运行报 "No module named fitz" 或引擎报错？说明当前 Python 缺少 PyMuPDF。请在 Python 3.10+ 环境中 pip install pymupdf 后重试；本技能 engine/ 为自包含，无需其他外部目录。

Q5：HTML 报告中文乱码？报告使用 UTF-8 编码，请用浏览器直接打开（勿用记事本查看）。

Q6：各规则分别查什么？

反模式（避免踩坑）

• ❌ 把免费版报告的"0 问题"直接当作图纸合格结论出具给客户。
• ❌ 对纯矢量 PDF 强行要求图形判定规则给出结论。
• ❌ 用户要下料单/抽板时只回一句"请用专业版"就结束——应在对话内引导支付后再执行（见「付费能力升级引导」）。
• ❌ 把规则引擎内部路径、本地绝对路径写进对外报告或对外文件（避免路径泄漏）。

版权与授权

• 本免费版技能及全部输出（审图报告 HTML、审图 JSON）的知识产权归「聚生善企业管理咨询有限公司」所有。
• 授权范围：仅限个人学习、评估用途。禁止将规则引擎、检测逻辑、检测结果用于商业交付、竞品训练或二次分发。
• 商用需授权：将本报告用于实际工程交付、对外出具或任何商业场景，须升级「CAD 审图+拆单 专业版」并支付相应费用，获得商用授权。
• 任何去除水印、篡改署名、绕过付费限制的行为均构成侵权，权利人保留追究法律责任的权利。

变更记录

v1.5.8 (2026-10-18)

• 详情页分流（本次重点）：普通用户点「下载 Zip」后会遇到"选择打开方式 / 解压"，直接流失。本版在描述与 SKILL.md 第一屏加入免安装网页版入口（免费审前 3 页，整份 ¥9.9 起，微信扫码），把"普通用户 → 网页版"与"AI 助手用户 → 下载安装"两类访客分开引导。
• 审图引擎、规则库、报告生成与 v1.5.7 完全一致，无功能变化。

v1.5.7 (2026-10-16)

• 新增根目录「安装说明.txt」（本次重点）：直接下载 zip 的用户打开后只看到代码目录，不知道从何下手，很多人会直接放弃安装。新增的说明文件用 Windows 记事本双击即可打开，讲清三件事：① 这不是需要安装的软件，是给 AI 用的技能包；② 最简单的安装方式是回详情页「复制 prompt」发给 AI；③ 本技能完全免费、零配置。
• 审图引擎、规则库、报告生成、试审引导与 v1.5.6 完全一致，无功能变化。

v1.5.6 (2026-10-15)

• 修正详情页描述文案：v1.5.5 上架时，平台更新向导的「描述」字段误填为一段内部操作备注，导致详情页对用户展示的内容与实际产品不符。本版将描述更正为免费版正式文案（【免费版 · 永久免费，无需付费】+ 两步解锁入口说明）。
• 审图引擎、规则库、拆单逻辑、支付配置与前版完全一致，无功能变化。

v1.5.5 (2026-10-13)

• 接通转化漏斗（本次重点）：免费版上架至今安装持续增长，但 ¥9.9 试审版上架后长期零下载 —— 原因是免费报告只引导"升级专业版（¥50）"，跨度过大且未提及低成本档。本版在审图报告内新增两步 CTA：先试审（¥9.9 / 10 页）→ 再上专业版（¥50 / 100 页），按钮文案与话术同步改写，页数超限提示、纯矢量提示也一并带上两档引导。
• 价格口径收敛：删除已不存在的「全套 ¥99」档宣传，只报平台真实在售的两档（试审 ¥9.9 / 10 页、专业版 ¥50 / 100 页），与包内支付配置、平台登记单价三方一致。
• 升级流程补充 plan 参数说明（trial = 990 分 / 10 页、standard = 5000 分 / 100 页），避免 Agent 选错档。
• 报告生成器（scripts/run_free.py）改 4 处文案 + 新增次要按钮样式；审图引擎、规则库、拆单逻辑零变化。

v1.5.4 (2026-09-09)

• 解决"客户分不清哪个是免费版"：后台数据显示专业版下载 108 次 > 免费版 49 次（漏斗倒挂），原因是免费版详情页无明确「免费」标识，且安装 slug 中含 pay 字样导致客户误以为要付费而不敢装。本版做了三处标识修正：
  1. 新增 displayName: CAD审图拆单专家（免费版），与专业版「（专业版·Pay）」直接区分；
  2. 描述首句前置「【免费版 · 永久免费，无需付费】」，让"免费"出现在详情页第一屏最前（此前"免费版"三字在末句，首屏不可见）；
  3. 新增 summary 字段，首句即「免费使用的 CAD 审图入门版」。
• 新增步骤 0 开场说明（必做）：新会话首次触发技能时主动讲清边界（免费 / 3 页上限 / 专业版三档价格），避免客户跑完才发现受限而流失。
• 升级话术同步三档价格：¥9.9 / ¥50 / ¥99 并说明对应页数，metadata.upgrade.price_label 由「¥50/份图纸」改为「¥9.9 起」。
• 功能与代码零变化，仅文档与元数据。

v1.5.3 (2026-09-05)

• 详情页概述补充实测数据：把真实测试结果写进技能描述首句（152 页深化图审前 3 页 2.1 秒出报告），客户打开详情页第一屏即可看到效果数据，不再依赖平台的"案例"功能（该功能目前仅对 Pay Skill 的提交流程开放，免费版无法补充）。功能与代码无任何变化。

v1.5.2 (2026-09-05)

• 收紧免费版页数闸门：单次审图上限由 30 页调整为 3 页（run_free.py 顶部 FREE_MAX_PAGES）。30 页对多数深化图纸几乎等于全量免费，付费转化被稀释；3 页足以让客户验证效果，同时让任何完整项目都必须升级专业版。

v1.5.1 (2026-09-04)

• 新增免费版页数闸门：单次审图上限 30 页（run_free.py 顶部 FREE_MAX_PAGES，改一行数字即可调整）。超出时报告顶部红色警示改为「免费版单次最多审前 N 页（本套图纸共 M 页）」并附升级话术，把全量审图、批量处理、VLM 视觉识别、下料单明确定位为专业版能力，形成清晰转化漏斗。
• 修正付费目标技能标识：升级流程中的 skill_id 与 frontmatter target_skill 由旧名 cad-review-cutlist-pro 更正为已发布的专业版 slug cad-review-cutlist-pay-pro，避免订单归属与实际产品不一致。

v1.5.0 (2026-09-04)

• 修复致命缺陷：多页图纸只审第 1 页。原引擎硬编码仅处理第 1 页，多页图纸集实际覆盖率极低且报告不提示。现支持全页遍历，报告新增「已审页数 / 总页数」统计卡片；截断审图时顶部显示红色警示「本次仅审了前 N 页」。
• 修复 RULE2 系统性误报：模块文档声明「纯矢量 PDF 保守跳过」但代码未实现，导致纯矢量图纸（无文字层）的每张平面图都误报「可能缺失外部尺寸标注」。现按设计意图实现：页级无文字层时 RULE2 跳过（该场景由报告顶部纯矢量告警统一提示人工复核）。
• 纯矢量告警升级为整图语义：已审页全部无可提取文字层时，报告提示按整图给出。
• 回归验证：带文字层普通 PDF（结果不变）、152 页纯矢量图纸 12 页抽样（误报 6 → 0，警示正确）。

v1.4.0 (2026-08-15)

• 新增轻量拆单（零 API 成本）：新增 scripts/run_cutlist.py，基于 PDF 文字层识别板件名/尺寸/材质标注，调用共享拆单规则库 engine/cutlist_rules.py 生成基础下料单（下料单/饰面清单/汇总三页，含材质代码、毛料余量、封边推断、封边木皮面积、标准板材 1220×2440 估算张数与利用率、按材质汇总）。
• 拆单规则库代码化：新建 engine/cutlist_rules.py 作为材料代码映射(12类)/复合结构/木皮/厚度反推/封边推断/毛料余量/下料单生成的单一规范源，结束原先 cad-cutting-list 规则「只写在文档、没被代码调用」的状态；专业版 app/core/material_db.py 同步复用此模块，避免多份实现漂移。
• 文档补充：新增「轻量拆单」章节（触发词/运行方式/识别规则/重要边界）、更新触发条件与重要限制，明确免费版拆单为"文字层推测、需人工复核、仅 PDF"。

v1.3.0 (2026-08-13)

• 补齐审图规则：RULE2（平面图外部总尺寸缺失）、RULE5（剖面图墙面/完成面标注缺失）由占位 pass 升级为实际检测逻辑，规则覆盖从 3 条提升到 5 条，缓解"规则数量有限"短板。
• 纯矢量图纸识别能力：新增矢量检测（is_vector_only），对纯矢量 PDF 在报告中显示「纯矢量图纸提示」横幅 + 「整改建议清单」，并对仅依赖图形判定的规则自动跳过，避免误报与"问题少=没问题"误判。
• 异常处理与运行稳定性：run_free.py 新增文件预检（存在性/目录/0 字节/%PDF 魔数），batch_review_v12i.py 增加单规则故障隔离（try/except），损坏/非 PDF 文件返回友好错误（退出码 3），不再崩溃或卡死。
• 文档补充：新增「快速上手（逐步示例）」与「常见问题 FAQ」章节（含反模式清单），提升反模式与 FAQ、文档质量。

v1.2.0 (2026-08-13)

• 新增 Freemium 变现漏斗：免费版保持免费获客，新增「付费能力升级引导」章节——当用户需要批量 / VLM 抽板 / 下料单 / 材料汇总 / 文件夹处理时，Agent 在对话内复用专业版已部署的支付后端（https://jssdzn-2ggznvtl36abc58b-1259642649.ap-shanghai.app.tcloudbase.com/cadpay）一键引导微信支付，体验与小程序一致。
• frontmatter 新增 metadata.upgrade：target_skill: cad-review-cutlist-pro、service_url_env、price_cents: 5000、price_label: "¥50/份图纸"。
• run_free.py 报告内「升级提示」升级为可视化「升级专业版」CTA 卡片（含功能清单、价格、行动指引）。
• 「不包含功能」「重要限制」「故障排查」统一指向对话内升级路径，不再仅提示"请使用专业版"。

v1.1.0 (2026-08-09)

• 自包含化：内置 engine/（batch_review_v12i + v12_core），不再依赖任何外部目录
• SKILL.md 移除所有硬编码绝对路径

v1.0.0 (2026-08-09)

• 初始版本：基于 v12i 规则引擎的免费单文件审图
• 输出 JSON + HTML 报告
• 明确与专业版的功能边界