OpenCADStudio 交付校验完整指南audit 审计 save_verified 如何用 SHA-256 保证 DWG 无损导出【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudioOpenCADStudio是一款用 Rust 构建的开源 CAD 应用支持 2D 绘图、3D 建模与 DWG/DXF 格式、GPU 加速渲染。它内置了一套面向交付的校验机制在把图纸正式写出export之前用audit操作做无损审计再用save_verified操作完成交付级验证保存并返回一份SHA-256 哈希作为完整性凭据。本文带你完整看懂这套机制如何确保 DWG 导出无损、可验证、失败可诊断。为什么 DWG 导出需要无损校验普通软件保存文件往往只关心写没写进去而交付给甲方、档案馆或下游 CAD 工具的文件真正要回答的是三个问题结构完整吗每个实体所在的图层、引用的块是否都在文档里声明过导出有损吗转换到目标版本时会不会悄悄丢掉不支持的记录文件一致吗我写出去的字节跟别人或未来的我重开之后语义是否完全一致audit与save_verified正是为这三个问题而设计。它们不是给人看个差不多而是把每一步都变成可断言、可复算的检查项。audit 审计交付前的无损体检audit是一个只读、不改动图纸的操作。它会针对你指定的target_format/target_version比如dwg2000给出完整的体检报告。关键认知一份在内存里看起来很干净的文档换到另一种格式也可能是有损的。所以目标格式本身就是审计的一部分。audit会检查并返回检查项说明实体清单manifest按类型、按图层统计每个实体作为语义指纹未声明图层实体落在文档未声明的图层上undeclared_layer视为 error缺失块块参照Insert引用了不存在的块missing_block重复句柄两个实体共用同一个句柄duplicate_entity_handle不可序列化记录某实体/对象无法转成 JSON说明结构异常非有限边界坐标出现 NaN/Inf会导致后续渲染或出图异常丢失记录数dropped_on_save转换到目标版本会被丢弃的条数0 标记为lossy_conversion警告源文件 SHA-256对源文件字节计算哈希作为输入指纹DXF 句柄引用图针对 ASCII DXF 检测悬空、重复句柄引用见下文报告里summary字段区分errors与warnings只要errors 0状态就是failedsave_verified会直接拒绝落盘。相关源码审计与保存校验主逻辑src/app/automation.rs官方自动化文档含 audit / save_verified 用法docs/automation/README.mdsave_verified交付级验证保存的七道关卡save_verified是真正交付文件时该用的操作。它要求一个显式绝对路径且后缀必须是.dwg或.dxf。整个流程像一条流水线任何一关不过都会保留输出文件用于诊断并明确报failed而不是假装成功。它的验证顺序如下拒绝静默覆盖目标文件已存在且未传overwritetrue→ 直接失败destination_exists。先跑审计内部调用document_audit若errors 0→audit_failed不写盘。有损转换需确认若dropped_on_save 0且未传allow_lossytrue→lossy_conversion_not_acknowledged把会丢多少条明确报给你。写目标版本用与正常保存一致的快照写出请求的版本。计算 SHA-256对刚写出的文件字节计算哈希写入返回结果作为完整性凭据。DXF 句柄图复检若是 DXF重新审计落盘后的句柄引用发现重复/悬空 →invalid_dxf_handle_graph。重开 版本 清单比对把文件重新读入校验真实版本是否与请求一致version_mismatch并对比写前/写后的语义实体清单——只要清单变了就报semantic_mismatch。只有全部通过才返回verified: true并带上sha256、bytes、目标格式/版本、实体清单与审计报告。这就是SHA-256 保证无损导出的本质哈希不是装饰而是把我交出去的这份字节钉死成一个可复算的指纹再配合重开比对清单确保重开后的语义 写前的语义。一个可复用的交付调用官方文档给出了交付调用的标准形态此处为格式示意非代码块要求op: save_verified path: C:\drawings\issued\plan.dwg target_format: dwg target_version: 2000 overwrite: false配合交付前的审计调用op: audit parameters: { target_format: dwg, target_version: 2000 }完整文档与更多示例见 docs/automation/README.md。DXF 句柄引用图为什么还要裸文件审计DXF 用一组句柄handle表达对象之间的引用关系如 330/340/350/360/390 等组码。如果句柄引用指向一个不存在的对象文件就是悬空的别的 CAD 工具打开时会报错或丢内容。audit_ascii_dxf_references会对落盘后的 ASCII DXF 做裸文件级审计检测三类问题重复句柄duplicate_handles同一句柄被声明多次。悬空句柄dangling_handles引用了未声明的句柄。孤儿对象orphaned_objects挂在根字典下却未被正确登记的对象。若是二进制 DXF以AutoCAD Binary DXF开头该裸审计会标记skipped: binary_dxf并跳过因为组码级句柄审计只适用于 ASCII DXF。这段逻辑同样位于 src/app/automation.rs。配套脚本把无损交付变成可重复验收项目自带了可重复运行的验收脚本把 audit save_verified 跑成一条端到端流水线验收脚本docs/automation/mcp_acceptance.py —— 用 MCP 创建几何审计并验证保存 DWG 2000/2013/2018 与 DXF 2000输出视口 PNG 与 JSON 报告。冒烟脚本docs/automation/mcp_smoke.py原生通道说明--serve无头入口JSON 行式请求docs/automation/native.mdAPI 规范docs/automation/API-SPEC.md对普通用户来说你不必手写这些脚本只要把交付前audit、交付时save_verified当作固定动作就能拿到一份带 SHA-256 指纹、失败可诊断的无损交付。小结audit 交付前的无损体检结构完整 有损检测 源文件 SHA-256 DXF 句柄图只读不改动。save_verified 交付级保存拒覆盖 → 先审计 → 有损需确认 → 写版本 → 算 SHA-256 → 复检 DXF → 重开比对版本与语义清单。SHA-256 的角色把交付字节钉成可复算指纹再叠加重开比对清单共同保证DWG 导出无损、可验证、失败不静默。想要更细的字段与错误码定义可对照 docs/automation/README.md 与 src/app/automation.rs 中的实现。【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OpenCADStudio 交付校验完整指南audit 审计 save_verified 如何用 SHA-256 保证 DWG 无损导出【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudioOpenCADStudio是一款用 Rust 构建的开源 CAD 应用支持 2D 绘图、3D 建模与 DWG/DXF 格式、GPU 加速渲染。它内置了一套面向交付的校验机制在把图纸正式写出export之前用audit操作做无损审计再用save_verified操作完成交付级验证保存并返回一份SHA-256 哈希作为完整性凭据。本文带你完整看懂这套机制如何确保 DWG 导出无损、可验证、失败可诊断。为什么 DWG 导出需要无损校验普通软件保存文件往往只关心写没写进去而交付给甲方、档案馆或下游 CAD 工具的文件真正要回答的是三个问题结构完整吗每个实体所在的图层、引用的块是否都在文档里声明过导出有损吗转换到目标版本时会不会悄悄丢掉不支持的记录文件一致吗我写出去的字节跟别人或未来的我重开之后语义是否完全一致audit与save_verified正是为这三个问题而设计。它们不是给人看个差不多而是把每一步都变成可断言、可复算的检查项。audit 审计交付前的无损体检audit是一个只读、不改动图纸的操作。它会针对你指定的target_format/target_version比如dwg2000给出完整的体检报告。关键认知一份在内存里看起来很干净的文档换到另一种格式也可能是有损的。所以目标格式本身就是审计的一部分。audit会检查并返回检查项说明实体清单manifest按类型、按图层统计每个实体作为语义指纹未声明图层实体落在文档未声明的图层上undeclared_layer视为 error缺失块块参照Insert引用了不存在的块missing_block重复句柄两个实体共用同一个句柄duplicate_entity_handle不可序列化记录某实体/对象无法转成 JSON说明结构异常非有限边界坐标出现 NaN/Inf会导致后续渲染或出图异常丢失记录数dropped_on_save转换到目标版本会被丢弃的条数0 标记为lossy_conversion警告源文件 SHA-256对源文件字节计算哈希作为输入指纹DXF 句柄引用图针对 ASCII DXF 检测悬空、重复句柄引用见下文报告里summary字段区分errors与warnings只要errors 0状态就是failedsave_verified会直接拒绝落盘。相关源码审计与保存校验主逻辑src/app/automation.rs官方自动化文档含 audit / save_verified 用法docs/automation/README.mdsave_verified交付级验证保存的七道关卡save_verified是真正交付文件时该用的操作。它要求一个显式绝对路径且后缀必须是.dwg或.dxf。整个流程像一条流水线任何一关不过都会保留输出文件用于诊断并明确报failed而不是假装成功。它的验证顺序如下拒绝静默覆盖目标文件已存在且未传overwritetrue→ 直接失败destination_exists。先跑审计内部调用document_audit若errors 0→audit_failed不写盘。有损转换需确认若dropped_on_save 0且未传allow_lossytrue→lossy_conversion_not_acknowledged把会丢多少条明确报给你。写目标版本用与正常保存一致的快照写出请求的版本。计算 SHA-256对刚写出的文件字节计算哈希写入返回结果作为完整性凭据。DXF 句柄图复检若是 DXF重新审计落盘后的句柄引用发现重复/悬空 →invalid_dxf_handle_graph。重开 版本 清单比对把文件重新读入校验真实版本是否与请求一致version_mismatch并对比写前/写后的语义实体清单——只要清单变了就报semantic_mismatch。只有全部通过才返回verified: true并带上sha256、bytes、目标格式/版本、实体清单与审计报告。这就是SHA-256 保证无损导出的本质哈希不是装饰而是把我交出去的这份字节钉死成一个可复算的指纹再配合重开比对清单确保重开后的语义 写前的语义。一个可复用的交付调用官方文档给出了交付调用的标准形态此处为格式示意非代码块要求op: save_verified path: C:\drawings\issued\plan.dwg target_format: dwg target_version: 2000 overwrite: false配合交付前的审计调用op: audit parameters: { target_format: dwg, target_version: 2000 }完整文档与更多示例见 docs/automation/README.md。DXF 句柄引用图为什么还要裸文件审计DXF 用一组句柄handle表达对象之间的引用关系如 330/340/350/360/390 等组码。如果句柄引用指向一个不存在的对象文件就是悬空的别的 CAD 工具打开时会报错或丢内容。audit_ascii_dxf_references会对落盘后的 ASCII DXF 做裸文件级审计检测三类问题重复句柄duplicate_handles同一句柄被声明多次。悬空句柄dangling_handles引用了未声明的句柄。孤儿对象orphaned_objects挂在根字典下却未被正确登记的对象。若是二进制 DXF以AutoCAD Binary DXF开头该裸审计会标记skipped: binary_dxf并跳过因为组码级句柄审计只适用于 ASCII DXF。这段逻辑同样位于 src/app/automation.rs。配套脚本把无损交付变成可重复验收项目自带了可重复运行的验收脚本把 audit save_verified 跑成一条端到端流水线验收脚本docs/automation/mcp_acceptance.py —— 用 MCP 创建几何审计并验证保存 DWG 2000/2013/2018 与 DXF 2000输出视口 PNG 与 JSON 报告。冒烟脚本docs/automation/mcp_smoke.py原生通道说明--serve无头入口JSON 行式请求docs/automation/native.mdAPI 规范docs/automation/API-SPEC.md对普通用户来说你不必手写这些脚本只要把交付前audit、交付时save_verified当作固定动作就能拿到一份带 SHA-256 指纹、失败可诊断的无损交付。小结audit 交付前的无损体检结构完整 有损检测 源文件 SHA-256 DXF 句柄图只读不改动。save_verified 交付级保存拒覆盖 → 先审计 → 有损需确认 → 写版本 → 算 SHA-256 → 复检 DXF → 重开比对版本与语义清单。SHA-256 的角色把交付字节钉成可复算指纹再叠加重开比对清单共同保证DWG 导出无损、可验证、失败不静默。想要更细的字段与错误码定义可对照 docs/automation/README.md 与 src/app/automation.rs 中的实现。【免费下载链接】OpenCADStudioA CAD application built with Rust — 2D/3D drawing, DWG/DXF support, and GPU-accelerated rendering项目地址: https://gitcode.com/gh_mirrors/op/OpenCADStudio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
