符合 ASME Y14.5-2018 · 桌面独立运行 · 当前版本 v1.0.4

把截图,变成
经得起检验的工程图。

GDT Studio 是一款独立桌面 GD&T 工作台——以位图(截图粘贴 / 图片导入)为底图, 快速完成尺寸与几何公差标注、编辑、合规校验与多页 PDF 导出。 整体逻辑参照 主流工程软件的 Drafting 工作台:图纸页 → 视图 → 标注, 视图带独立比例与父子联动,图框标题栏走背景层。

14 类几何公差 36 条合规规则 21 项画布工具 矢量符号自绘
0 类
几何公差符号
形状 / 轮廓 / 方向 / 位置 / 跳动
0 条
合规校验规则
DN-001 ~ DN-036 · 对应标准条款
0 项
画布工具
尺寸 5 · 文本 4 · 公差 4 · 形状 8
0 种
视图类型
正视 / 剖视 / 放大 / 轴测 / 断裂 …
为什么是 GDT Studio

不堆功能,只解决真问题

它的存在只为一个场景:把手里已有的二维图像,快速变成一张符合 ASME Y14.5-2018、经得起评审的标注图纸。

NO CAD LICENSE

无需 CAD 许可证

桌面独立程序,不依赖任何商业 CAD 平台。个人与小团队零成本上手,双击即用。

SCREENSHOT → DRAWING

截图即图纸

工作流贴合真实场景:PDF 图纸、照片、扫描件,Win+Shift+S 截图后 Ctrl+V 即贴即标;系统全局热键 Alt+A,程序最小化时也能截。

ANNOTATE = VALIDATE

标注即校验

36 条规则内建于工具:改一处参数即时刷新,问题定位到具体元素与标准条款,双击即可跳转选中。

VECTOR SYMBOLS

符号矢量自绘

全部 GD&T 符号按矢量路径绘制,不依赖字体字形——不缺字、不乱码;PDF 输出为矢量对象,600 DPI 同样锐利。

YOUR DATA

数据自有 · 完全离线

工程文件 .gdt(JSON v2.0)保存在本地,底图快照 base64 内嵌,可随时二次编辑;软件功能不依赖联网。

CROSS PLATFORM

跨平台桌面程序

基于 Python + PySide6 单一代码库,Windows / macOS / Linux 均可运行;已针对 Windows 桌面完整验证。

核心能力

从底图到出图,一站式标注工作台

主流工程软件的 Drafting 式图纸结构,加上一套面向 GD&T 的专属标注、校验与模板工具链。

Drafting 式图纸结构

Drawing(.gdt)→ Sheet 图纸页 → View 视图 → 标注,层级与主流工程软件的 Drafting 模块一致。

  • A0 ~ A4 幅面 / 横纵向 / 多页管理
  • 9 种视图类型:正视·投影·剖视·局部放大·辅助·轴测·裁剪·断裂·展开
  • 视图独立比例(SCALE 标签)+ 剖视/放大图父子联动
  • 背景层图框 + 12 字段可编辑标题栏,逐页配置
  • 图纸树面板:Sheet → View → 标注层级浏览

位图底图工作流

截图即贴即标,一视图可携带多张底图,并自带一整套底图净化工具。

  • 剪贴板截图一键粘贴 / 本地图片导入
  • 去底色:纯色 / 渐变底确定性建模 + 边缘连通泛洪,去得干净、不伤原图
  • 黑白线框图(固定阈值 / Otsu 自动)
  • 矢量线框图:marching squares 提轮廓 + Douglas-Peucker 简化,生成真矢量底图,带进度条
  • 亮度 / 对比度(不改原始像素)、90° 旋转、锁定、置灰显示

完整 GD&T 标注库

覆盖 ASME Y14.5-2018 的尺寸、几何公差、基准体系与修饰符号。

  • 尺寸:线性 / 角度 / 半径 R / 直径 ⌀ / n× 数量 / 上下偏差 / 基本尺寸框 / 参考尺寸括号 / 深度·沉头·埋头前缀
  • 14 类几何公差特征控制框(FCF),按标准五类分组
  • 基准特征符号(ASME 实心三角)/ 基准目标(点·线·面)/ DRF 基准注册表
  • 11 种修饰符号:Ⓜ Ⓛ Ⓟ Ⓣ Ⓕ Ⓢ Ⓤ Ⓘ CF …
  • 引线终止三方式:箭头(表面)/ 黑点(轴线)/ 尺寸线延长
  • 符号面板 Ω:点符号即插入光标处

合规校验引擎

标准不是参考资料,而是写进代码的约束——36 条规则,每条对应具体条款。

  • 规则 DN-001 ~ DN-036:错误 E / 警告 W / 提示 I 三级
  • 标注变更实时校验 + 一键全图检查
  • 报告含级别 / 规则 ID / 元素 / 问题描述 / 条款依据 / 修改建议
  • 问题项双击 → 自动定位并选中对应元素
  • 问题清单导出 CSV,便于归档与评审

模板库与固定表格

在软件里画好一页即可存成模板;五张工程常用表格一键插入、自动更新。

  • 页模板:整页模型克隆——图层 / 表格 / 合并单元格 / 富文本 / 字体全保留,套完即可编辑
  • 工程模板:多页工程一次存成、勾选一次全铺出
  • 自定义字段:{{字段名}} 占位,值在渲染层统一替换
  • 固定表格:产品关键特性 / 基准体系(自动归集)/ 零件明细 / 未注公差(多变体)/ 图纸索引(随图纸树自动更新)
  • 支持自定义固定表格

交互与导出

点击式快速标注,多格式导出,桌面级工程化细节全部就位。

  • 智能尺寸:取两点自动判断水平 / 垂直;FCF 2 击、基准 1 击
  • 精准吸附:端点 / 中点 / 中心 / 轮廓 / 公差框角,8px 半径亮绿标记
  • 命中区只认看得见的笔画——空白处不吃点击,叠在一起的小标注也能分别选中
  • 拖尺寸线中点即调整标注线到测量点的距离;端点 / 手柄均可拖动
  • Shift 轴向约束、多选五向对齐、50 步撤销重做
  • 长文本框(自动折行)/ 可编辑表格(合并·分解单元格 / 字体字号)
  • 导出:多页矢量 PDF、PNG / JPG(150/300/600 DPI、透明背景)、.gdt 工程、CSV 标注清单;支持 DXF 图框导入
界面即工作台

熟悉主流工程软件的人,零学习成本

菜单、工具栏分组、取点方式与面板逻辑,全面对照主流工程软件的 Drafting 工作台组织。

工具栏五组 · 21 项画布工具

尺寸5 项
Dimensions(智能) · Length / Distance · Angle · Radius · Diameter
文本4 项
Text · Text With Leader · 长文本框 · 表格(可编辑)
公差4 项
Geometrical Tolerance(符号下拉跨会话记忆) · Datum Feature · Datum Target · 符号面板 Ω
形状8 项
Center Line · Line · Arrow Line · Polyline · Rectangle · Ellipse · Triangle · 坐标系示意
表格5 项
产品关键特性/更改记录 · 基准体系 · 零件明细 · 未注公差标准 · 图纸索引(一键插入当前视图)

每组为独立工具条:可拖动调整组间顺序、拖出浮动为工具框,布局随工程退出保存恢复。

面板与菜单体系

菜单栏
文件 / 图纸 / 视图 / 编辑 / 显示 / 检查 / 设置 / 窗口 / 帮助——「窗口」菜单负责多工程切换与单独关闭。
图纸树面板
Sheet → View → 标注层级,点击即激活 / 定位,右键管理图纸页与视图。
画布
视图容器 + 背景层图框标题栏;在哪个视图内点击,标注就归属哪个视图——与主流工程软件的视图激活逻辑一致。
属性面板
全参数编辑(公差值 / 基准 / 修饰符 / 引线方式 / 受控要素类型…),改动自动进入撤销栈。
自定义字段页
{{字段名}} 取值的全工程统一编辑入口。
合规校验面板
实时问题列表 + 双击定位 + CSV 导出;状态栏同步显示「错误 N · 警告 N · 标注 N」。
标准合规

严格对齐 ASME Y14.5-2018

标准怎么规定,工具就怎么约束——包括对已删除要素的显式处理。

特征控制框(FCF)图形规范

几何比例、格宽与线宽严格按 §3 符号与图面惯例执行;全部符号矢量自绘,PDF 输出不失真。

  • 1几何特征符号
  • 2公差值 + 修饰符
  • 345第一 / 二 / 三基准
引线终止:箭头(表面)
引线终止:黑点(轴线)
尺寸线延长引出

字高 h 默认 3.5 mm · 框高 h + 2 mm(上下各 1 mm)· 线宽 0.35 mm 细实线 · 分隔线贯通全高
基准按功能优先级自左向右排列;字母后可跟 Ⓜ / Ⓛ 边界修饰,RMB 为默认状态不标注

校验规则示例(DN-001 ~ DN-036)

规则触发条件级别
DN-001形状公差 FCF 引用基准(§5 只控制要素自身)E
DN-002方向公差(平行/垂直/倾斜)未引用基准E
DN-006平面度 / 圆度 / 圆柱度 / 轮廓度 / 跳动公差值带 ⌀E
DN-008基准字母使用 I / O / Q(易与 1、0 混淆)E
DN-010FCF 引用未注册的基准字母(未放置基准符号)E
DN-018明确画出 RFS 符号(Rule #2 默认状态,禁止标注)E
DN-024FCF 缺失公差值E
DN-026轴线类公差引线终止为箭头而非黑点W
DN-036用到某套基准却没有对应的「基准体系」表W
设计取向:每一条规则都可在报告中给出「条款依据 + 修改建议」;规则集本身也按标准审查迭代修订(见仓库 docs/02_标准校验问题清单.md)。

支持并校验的要素

尺寸、公差框、基准体系均按 2018 版语义构建,标注变更即时刷新合规状态。

尺寸偏差 / 上下偏差基本尺寸方框参考尺寸括号 特征控制框基准体系 DRFMMC / LMC / MMB / LMB 投影公差 Ⓟ相切平面 Ⓣ自由状态 Ⓕ 统计公差 Ⓢ独立要求 Ⓘ连续特征 CF 全周 / 全表面基准目标(点/线/面)

同轴度 / 对称度处理

同轴度(Concentricity)与对称度(Symmetry)已自 ASME Y14.5-2018 中删除——二者依赖「逐点测量中位要素」、检测结果不可重现,工程意图应由 位置度 / 跳动 / 轮廓度 表达。

符号保留(兼容 2009 及更早旧图)插入时属性面板黄色提示 全图检查报 Warning不阻断出图
模板体系

画一次,用一百次

页模板、工程模板、自定义字段与五张自动更新的固定表格,把重复劳动一次清零。

两类模板文件(.gdtpl)

  • 页模板(kind: page)存整页模型:套用时各平面视图原样克隆进新页——表格仍是表格、合并单元格 / 列宽行高 / 富文本 / 字体全在,前景与背景图层也保留,套完就能双击改字。
  • 工程模板(kind: project)把整个工程(一叠图纸页 + 标注样式)存成一个文件;新建工程时勾选一次,全部图纸页一次生成。
  • 自定义字段标题栏 / 表格里的 {{字段名}} 占位符,值挂在渲染层统一替换——改一处取值,全套图纸页同步生效。
  • 固定表格一键插入默认落在模板原始坐标;未注公差标准表支持多零件变体切换(默认「冲压单件」),图纸索引表内容随图纸树自动更新(连续同名页合并为「4-7」式区间)。
# 工程文件 .gdt —— JSON v2.0,保留全部图纸页 / 视图 / 标注参数 / 图层 / 快照(base64 内嵌) { "format": "gdtstudio-template", "version": 2, "kind": "page", "name": "首页", "paper_mm": [420.0, 297.0], "frame": "frame A3.dxf", "page": { "name": "首页", "paper": "A3", "landscape": true, "scale": 1.0, … } }

五张固定表格

  • 产品关键特性 / 更改记录特征等级 / 类型 / 描述 / 区域 + 更改标记 / 通知书号 / 内容 / 签字 / 日期。
  • 基准体系从图纸里的基准目标与基准特征自动归集(同基名合一行),一套一张;DN-036 会检查「用了基准却没表」。
  • 零件明细(BOM)序号 / 层级 / 零件号 / 零件名 / 图纸号 / 材料 / 重量 / 备注,层级行预置。
  • 未注公差标准未注匹配面 / 剪切边 / 孔位置度 / 孔尺寸公差,零件变体与行内容均可在设置里自定义。
  • 图纸索引图纸树的纯函数:按基名归并连续同名页,单页「4」、多页「4-7」,刷新幂等。

定位表格一律只认标题文字——模板是用户自己另存的,ID 与位置每次都变,标题是唯一稳定特征。自定义固定表格以 custom:* 键注册,自动格显示 {{变量名}} 只读占位。

五分钟上手

五步,从空白到可出图的标注图

无需 CAD 基础,点击式快速标注:尺寸 3 击、公差框 2 击、基准 1 击。
想先看效果,打开自带的 示例图纸.gdt 照着走一遍最快——六页里把基准体系表、位置度、零件明细都标全了。

1

建工程 · 贴底图

新建工程后 Ctrl+V 把截图粘贴为当前视图快照;或 Alt+A 框选截图(系统全局热键,最小化也能用)。

2

插入视图

「插入视图」九种类型任选;每个视图可设独立比例,视图框自动标注 SCALE 1:x。

3

标注

智能尺寸两点成标,拖尺寸线中点可调它到测量点的距离;位置度 FCF 两击落框;基准特征符号一击贴轮廓,方框自动生成。

4

校验修正

「全图合规检查」实时刷新;双击问题项自动定位选中元素,按条款建议逐条修正。

5

导出交付

多页矢量 PDF 一次导出全部图纸页;或 PNG / JPG / .gdt / CSV 标注清单。Ctrl+S 保存工程。

常用快捷键

Ctrl+V粘贴截图到当前视图
Ctrl+I导入图片到当前视图
Alt+A框选截图(全局热键)
Ctrl+Z / Ctrl+Y撤销 / 重做(50 步)
Ctrl+D复制选中标注
Delete删除选中标注
Esc取消当前工具
Shift + 拖动单独移动 FCF 引线终点
Ctrl + 滚轮缩放画布(锚定光标)
中键拖动平移画布
Ctrl+O / Ctrl+S打开 / 保存工程
双击元素属性面板全参数编辑
应用场景

谁在用,用来做什么

凡是「手里有图、需要按标准标出来」的场合,都是它的位置。

制造与质量

把客户 PDF、来料图纸快速转成带公差的标注图;一键全图合规检查,问题清单导出 CSV 归档评审,多页 PDF 直接交付。

旧图纸阅读与修订

同轴度 / 对称度等 2009 及更早版本符号完整保留——读旧图、改旧图不误判;新设计则按 2018 版语义校验并给出替换建议。

GD&T 教学与培训

14 类公差符号 + 实时规则校验,学员每标一处即时得到条款级反馈;FCF 构成、基准优先级、修饰符冲突规则全部可视化。

个人与小团队

没有 CAD 许可证也能出规范的工程图:模板一次建好、团队复用;.gdt 工程文件本地保存,即传即改,零平台成本。

图纸归档与复用

页模板 / 工程模板沉淀企业图框与常用页;图纸索引表、基准体系表随内容自动更新,多页工程管理不再靠手维护。

3D 关联(预留)

数据模型已带 source_3d_ref 字段与 ViewSnapshotProvider 抽象接口——接入 STEP / STL 正交视图快照即可升级为三维标注链路。

技术架构

分层清晰的桌面工程

核心逻辑不依赖界面——模型、渲染、校验、IO 各自独立,可测试、可替换、可扩展。

模块分层

UI 层
main_window菜单 · 命令 canvas画布交互 panels属性 · 图纸树 · 图层 symbol_palette符号面板
核心模型
modelSheet / View / 标注 spec符号库 · 标准常量 sheet_names页名归并 brand · migrate标识 · 数据迁移
渲染层
symbols矢量符号 draw元素绘制 items图元 · 命中区 imagefx亮度和对比度 bgremove · vectorize去底 · 矢量化
校验引擎
validation/rulesDN-001 ~ DN-036 · 实时 + 全图 richtext富文本 · 符号分段渲染
IO 层
files.gdt JSON v2.0 exportPDF / PNG / JPG / CSV dxf图框导入 templates模板库 · 固定表格
扩展 / 基础
ext/snapshot3D 接口预留 updater整包自动升级 util飞行记录仪 appconfig配置
桌面工程化 单实例(双击转发给已运行实例)· 原生崩溃日志 · 自动升级(sha256 清单校验 + 整包替换)· 文件关联 .gdt / .gdtpl · 旧版数据一次性迁移

技术规格

项说明
技术栈Python 3.9 ~ 3.13 + PySide6 ≥ 6.6(Qt for Python)
平台Windows / macOS / Linux,已针对 Windows 桌面完整验证
分发整包 约 41.7 MB(目录模式,含 VC 运行库,冷启动更快);单文件 exe 约 35 MB
升级整包替换:sha256 清单校验 → 解包 → 覆盖,主备两个升级源自动回退
工程文件.gdt(JSON v2.0),快照 base64 内嵌;自动迁移 v1.0
模板文件.gdtpl,page / project 两类
图层BaseImage / Annotation / Construction 三层,可显隐与锁定
样式字高默认 3.5 mm、线宽 0.35 mm、箭头 3~5 mm、公差小数位默认 1 位
3D 预留ViewSnapshotProvider 接口 + source_3d_ref 字段,OCP / vtk 两条实现路径已注释

需求规格由 GD&T 标准专家签发(Rev A),规则集经标准符合性审查迭代修订;仓库内含 98 项自动化回归闸门。

常见问题

先问清楚,再决定

需要安装 CAD 环境吗?
不需要。GDT Studio 是独立的桌面程序,不依赖任何商业 CAD 平台。Windows 下下载整包(约 41.7 MB,解压即用,无需 Python 环境);也可从源码以 Python 3.9 ~ 3.13 + PySide6 ≥ 6.6 运行。装好后自带一份完整示例工程(六页 / 85 处标注),直接打开就能看到基准体系表、位置度与轮廓度、零件明细的实际写法。
底图是位图,导出会模糊吗?
标注与符号全部为矢量,高 DPI 导出不受影响;位图部分随 DPI 做像素放大。如需彻底摆脱锯齿,可用截图处理面板的矢量线框图转化——marching squares 提轮廓 + Douglas-Peucker 简化后生成真矢量底图,可无损缩放。
同轴度 / 对称度为什么还能选?
二者已自 ASME Y14.5-2018 删除,但 2009 及更早版本的既有图纸存量巨大。工具保留这两个符号用于阅读与修订旧图:插入时属性面板显示黄色提示,全图检查报 Warning 而不阻断出图;新设计建议改用位置度 / 跳动 / 轮廓度。
数据存在哪里,离开网络能用吗?
工程以 .gdt(JSON v2.0)文件保存在本地,底图快照以 base64 内嵌,可整体拷贝、二次编辑。标注、校验、导出功能完全离线可用;自动升级为可关闭的后台静默检查,不会阻断启动与使用。
一次能管理多少图纸页?
一个工程可含多张 Sheet(A0~A4、横纵向混排),PDF 支持全部图纸页一次导出为多页 PDF;「窗口」菜单支持多工程并行切换。页名重复时自动按页序追加 .1 / .2 后缀,图纸索引表同步归并为「4-7」式区间。
后续会有 3D 模型导入吗?
架构已预留:数据模型带 source_3d_ref 字段(模型文件 / 特征 ID / 视图方向),gdt/ext/snapshot.py 定义 ViewSnapshotProvider 抽象接口,注释中给出 OCP / vtk 两条实现路径。接入 STEP / STL 正交视图快照渲染后,即可从三维模型直接生成标注底图。
获取软件

下载最新版本,直接开工

Windows 桌面版整包,解压即用——不需要 Python 环境,也不需要任何 CAD 平台。 装好后自带一份六页示例工程,可对照查看基准体系表、位置度 / 轮廓度与零件明细的实际写法。

版本 v1.0.4 大小 约 41.7 MB 发布 2026/10/17 GDTStudio-1.0.4-win64.zip