yacr CAD / 01

Open-source CAD · 早期预览 Open-source CAD · Early preview

Yet another CAD,
written in Rust.

一个核心，多种载体。 One core. Every surface.

Rust 核心负责 DWG/DXF 文档、几何、命令与 wgpu 渲染；React + Tauri 负责界面。一个核心，多种载体。 The Rust core owns DWG/DXF documents, geometry, commands, and wgpu rendering. React and Tauri handle the interface. One core, many surfaces.

EARLY
PREVIEW

项目仍在早期开发，尚无可交付产品。Linux/Wayland 是当前主开发目标，支持最完整；Android APK 已由维护者侧载运行。其他载体的运行时证据边界见下方平台卡片。 The project is still in early development and there is no shippable product yet. Linux/Wayland is the primary development target with the strongest support; the Android APK has been sideloaded and run by the maintainer. Runtime evidence boundaries for the other surfaces are in the platform cards below.

在线试用 Web 版Try the web app 下载 v0.1.5Download v0.1.5 GitHub
YACR Y-shaped part blueprint A technical line drawing of a Y-shaped part with a central hub, hatching, centre lines, and orange dimension arrows. Illustration only; not a product screenshot. 1 2 3 A B C 68.00 299.40 REF 345.80 REF 120° ⌀ 108.00 DETAIL / Y-01 PROFILE · REV A UNITS: MM YACR / Y-01 A3 PROFILE — Y 1:1 SCALE 1:1 · MM SHEET 1/1 REV A · 2026 ILLUSTRATION
工程示意图，不是产品截图。 Engineering illustration, not a screenshot. Y-01 · PLAN / 2026

223/981

条命令有实现路径commands with an implementation path

50 完整 + 173 部分 · 清单计数，不是兼容率 50 complete + 173 partial · list count, not a compatibility rate

DWG+DXF

读取 / 解析read / parse

DWG 兼容性未验收DWG compatibility is not verified

Rust+wgpu

核心与渲染core and renderer

现代 GPU 特性 · 面向几十万图元modern GPU features · 100K+ entity target

5

种载体surfaces

Linux / Windows / macOS / Android / Web

01架构Architecture

Rust 是核心，
但不是全部。 Rust at the core.
Not the whole story.

yacr 的文档、几何、命令和渲染核心是 Rust；界面是 React + TypeScript，运行在 Tauri WebView 中。不是 100% pure Rust，这是为了“一棵 React 树，多种载体”的有意取舍。 yacr’s document, geometry, command, and rendering core is Rust. The interface is React + TypeScript running inside a Tauri WebView. It is not 100% pure Rust — a deliberate trade-off for one React tree across many surfaces.

  1. 01 / DATA & RENDER Rust core cad-dbgeometrycommandswgpu
  2. 02 / BOUNDARY Host contract cad-hostcad-ui-core
  3. 03 / INTERFACE React + Tauri ReactTypeScriptWebView
  4. 04 / SURFACES 一棵树，五种载体One tree, five surfaces LinuxWindowsmacOSAndroidWeb

01

Rust core

文档、几何、命令、渲染的唯一权威。UI 和渲染都是派生。 The single authority for documents, geometry, commands, and rendering. UI and rendering are derived.

02

React chrome

同一棵 React 树覆盖桌面与移动，按宽度切换，不按构建目标分叉。 One React tree covers desktop and mobile, switching by width rather than by build target.

03

Native surface

native-below 用原生会话，dom-canvas 用 wasm 会话；两条路径各自持有文档。 Native sessions for native-below; wasm sessions for dom-canvas. Each path owns its document.

native-below

Linux Wayland · Windows · macOS · Android

native 会话持有 cad-db。透明 WebView 在上，原生 CAD surface 在下。 The native session owns cad-db. A transparent WebView sits above the native CAD surface.

dom-canvas

X11 / XWayland · Web

wasm 会话持有 cad-db，CAD 画在 DOM <canvas> 上。 The wasm session owns cad-db; CAD is drawn on a DOM <canvas>.

不是同一份文档状态在两边共享。共享的是契约与 UI，不是数据；另一侧不得实例化第二份文档状态。 The same document state is not shared across both. Contracts and UI are shared; data is not. Neither side may instantiate a second document state.

02功能Capabilities

先把看图和测量做对。 Get viewing and measuring right first.

从导入、数据库、渲染到测量与命令覆盖，每张卡片都写明能力边界。 From import and the database to rendering, measurement, and command coverage — every card states its boundary.

01

打开 DWG / DXFOpen DWG / DXF

acadrust 0.6.8（未修改）。DWG 与 DXF ASCII/二进制导入，异步导入、进度与取消。这里不宣称已验证的兼容矩阵。 acadrust 0.6.8, unmodified. DWG and DXF ASCII/binary import with asynchronous loading, progress, and cancel. No verified compatibility matrix is claimed.

02

数据库是唯一权威The database is the authority

cad-db 持有文档；写入走事务与 ChangeSet，依赖失效后只重建受影响的显示表示。不重解析底图。 cad-db owns the document. Writes go through transactions and ChangeSet; dependency invalidation rebuilds only the affected display representations. The source drawing is not re-parsed.

03

wgpu 渲染，面向大图纸wgpu rendering for large drawings

Rust + wgpu 使用现代 GPU 特性；批处理、导航 LOD、VRAM 预检，目标是几十万图元级别图纸仍能流畅缩放。性能验收未完成，这里描述的是实现路径，不是已验收的帧率指标。渲染是派生，不反向成为数据源。 Rust + wgpu uses modern GPU features: batching, navigation LOD, and VRAM preflight. The target is smooth zoom/pan on drawings with hundreds of thousands of entities. Performance acceptance is not complete; this describes the implementation path, not a certified frame-rate metric. Rendering is derived and never becomes the data source.

04

测量Measurement

距离、折线长度、角度、面积；单位、精度与几何来源可追溯。 Distance, polyline length, angle, and area — with traceable units, precision, and geometry provenance.

05

命令覆盖Command coverage

223 条有实现路径（50 完整 + 173 部分），758 条未实现。未支持的选项按名拒绝，不静默成功。 223 commands have an implementation path (50 complete + 173 partial); 758 are not implemented. Unsupported options are rejected by name, never silently accepted.

223 / 981 清单计数 · 非兼容率list count · not compatibility
  • 50完整complete
  • 173部分partial
  • 758未实现not implemented
06

一棵 React 树，多种载体One React tree, many surfaces

桌面与移动共用同一 UI，按宽度切换。Android 也是 native-below，不按构建目标把 CAD 命令送到 wasm。 Desktop and mobile share one UI, switching by width. Android is also native-below; CAD commands are not routed to wasm by build target.

07

天正图元，用 TypeScript 插件显示 Tianzheng entities via a TypeScript plugin

plugins/tch（tangent-ts）作为 git submodule 接入，负责天正/TCH 图元与 proxy graphics 显示；插件 bundle 进入所有载体产物。插件管理器状态持久化，vendor 实体可被选择并显示属性行。 plugins/tch (tangent-ts) is wired as a git submodule and handles Tianzheng/TCH entities and proxy-graphics display. The plugin bundle ships in every carrier. Plugin-manager state persists, and vendor entities can be selected with property rows.

无 proxy graphics 缓存时不显示；这不是 AutoCAD 兼容性声明。 No cached proxy graphics means no display; this is not an AutoCAD compatibility claim.

03工作流Workflow

从打开到出图，四步。 From open to output, in four moves.

查看与测量是主线；保存与出图各有明确的格式边界。 Viewing and measuring are the main line. Saving and output each have explicit format boundaries.

  1. 打开Open

    本地打开 DWG/DXF，或在 Web 版直接上传文件。 Open DWG/DXF locally, or upload a file directly in the web app.

    DWG · DXF · UPLOAD

  2. 查看Inspect

    平移、缩放、FIT、图层、选择与属性查看。 Pan, zoom, FIT, layers, selection, and properties.

    PAN · ZOOM · FIT · LAYERS

  3. 命令Command

    Ribbon 或经典菜单栏、命令历史，以及五个可浮动面板。 Ribbon or classic menu bar, command history, and five floatable panels.

    RIBBON · HISTORY · PANELS

  4. 保存 / 出图Save / Output

    DXF 另存（有损）、实验性新 DWG 导出、PNG/SVG/PDF（CLI/Web）。 Lossy DXF Save As, experimental new-DWG export, and PNG/SVG/PDF (CLI/web).

    没有 DWG 原地回写No in-place DWG writeback

04平台Platforms

一个核心，五种载体。 One core. Five surfaces.

状态按仓库当前证据边界标注，不等于产品验收。Linux/Wayland 是主开发目标；Android APK 已由维护者侧载运行；Windows/macOS 是真实宿主，运行时仍待验收。 Status reflects the evidence currently in the repository; it is not product acceptance. Linux/Wayland is the primary development target; the Android APK has been sideloaded by the maintainer; Windows/macOS are real hosts whose runtime still needs acceptance.

LNX 主开发Primary dev

Linux

native-below · Wayland / dom-canvas · X11

原生 Wayland 走 native-below，X11/XWayland 走 dom-canvas。Flatpak 分发；当前主开发目标，Wayland 支持最完整。 Native Wayland uses native-below; X11/XWayland uses dom-canvas. Distributed as Flatpak — the primary development target, with the strongest Wayland support.

  • 证据Evidence有界证据：GNOME/Mutter + P620 + scale=1Bounded evidence: GNOME/Mutter + P620 + scale=1
  • Flatpakio.github.zenglanmu.yacr
WEB 在线预览Live preview

Web

dom-canvas · wasm CadSession

wasm CadSession + DOM canvas。OPEN 走页面上传；SAVE/PLOT 走浏览器下载（DXF/SVG/PDF），不回写 DWG。 wasm CadSession + DOM canvas. OPEN uses an in-page upload; SAVE/PLOT uses browser downloads (DXF/SVG/PDF) and never writes DWG back.

  • 入口Entryyacr-examples.pages.dev
  • 证据EvidenceCI smoke 使用 SwiftShader 软件渲染，不是 GPU 或像素结论。CI smoke uses SwiftShader software rendering — not a GPU or pixel conclusion.
WIN 编译级Build-level

Windows

native-below · Win32 child HWND

真实 Tauri/WebView2 加 Win32 child HWND。缺少 WebView2 时以退出码 5 拒绝。 Real Tauri/WebView2 with a Win32 child HWND. Refuses with exit code 5 when WebView2 is missing.

  • 边界Boundary真实宿主已实现，预期可运行；当前证据为编译门禁 + Wine 拒绝合同，运行时/视觉/真 Windows 仍待验收。The real host is implemented and expected to run; current evidence is a build gate + Wine refusal contract. Runtime, visuals, and real Windows still need acceptance.
MAC 编译级Build-level

macOS

native-below · WKWebView + NSView

真实 Tauri/WKWebView 加 CAD 子 NSView（Metal）。 Real Tauri/WKWebView with a CAD child NSView (Metal).

  • 边界Boundary真实宿主已实现，预期可运行；当前证据仅 CI 编译，窗口/Metal/层序/DPI/像素仍待验收。The real host is implemented and expected to run; current evidence is CI compile only. Window, Metal, layer order, DPI, and pixels still need acceptance.
AND 维护者侧载Maintainer sideload

Android

native-below · Vulkan SurfaceView

Tauri WebView + 原生 CadSession + Vulkan SurfaceView；wasm 会话不实例化。SAF 打开与 DXF 导出已接线，DWG 保存显式延后。维护者已侧载 APK 并运行成功。 Tauri WebView + native CadSession + Vulkan SurfaceView; the wasm session is not instantiated. SAF open and DXF export are wired; DWG save is explicitly deferred. The maintainer has sideloaded the APK and run it successfully.

  • 边界Boundary维护者侧载运行成功（非 CI 验收）；设备/真实 GPU/像素的正式验收仍待补。The maintainer sideloaded and ran it successfully (not a CI acceptance); formal device, real-GPU, and pixel acceptance is still pending.

05下载Download

下载 v0.1.5 Download v0.1.5

主按钮走 Cloudflare R2 国内镜像；GitHub Release 作为上游与校验来源。若 CDN 未配置，自动回退 GitHub。 Primary buttons use the Cloudflare R2 mirror for mainland China. GitHub Releases remain the upstream source and checksum reference. If the CDN is not configured, links fall back to GitHub automatically.

GitHub 在国内可能无法访问，优先使用 Cloudflare 镜像；镜像文件与上游 Release 同名，可用 SHA-256 校验。 GitHub may be unreachable from mainland China, so prefer the Cloudflare mirror. Mirror files keep the upstream Release filenames and can be verified with SHA-256.

RELEASE / v0.1.54 ASSETSSHA-256SIGNING.txt

Linux

FLATPAK

yacr-0.1.5-linux-x86_64.flatpak

105,454,832 bytes · ≈ 100.6 MiB

  • Flatpak；需要 org.gnome.Platform//51Flatpak; requires org.gnome.Platform//51
  • app id io.github.zenglanmu.yacrapp id io.github.zenglanmu.yacr
  • 提供 .sha256 与 .flatpak.gpgShips with .sha256 and .flatpak.gpg
下载 FlatpakDownload Flatpak GitHub SHA-256
flatpak install --user yacr-0.1.5-linux-x86_64.flatpak
flatpak run io.github.zenglanmu.yacr

校验与签名说明： Checksums and signing notes:

SIGNING.txt .flatpak.gpg GitHub Release 所有 SHA-256 均指向上游 GitHub。 All SHA-256 links point to upstream GitHub.

06常见问题FAQ

几个直接的问题。 Straight answers.

关于许可、成熟度、技术取舍与下载的边界，都在这里。 Licensing, maturity, technical trade-offs, and download boundaries — answered without hedging.

还有问题？去 GitHub IssuesStill curious? Open a GitHub issue
yacr 免费吗？Is yacr free?

是。yacr 以 AGPL-3.0 发布，源码公开在 GitHub。没有付费版本，也没有被锁住的导出功能。 Yes. yacr is released under AGPL-3.0 and the source is public on GitHub. There is no paid tier and no locked export feature.

现在能当生产 CAD 用吗？Can I use it as a production CAD tool today?

不能。项目仍在早期开发，尚无可交付产品。Linux/Wayland 是主开发目标，Android APK 已由维护者侧载运行；Windows、macOS、Web 的运行时证据边界见上方平台卡片，均不等于验收。 No. The project is still in early development and there is no shippable product. Linux/Wayland is the primary development target and the Android APK has been sideloaded by the maintainer. The runtime evidence boundaries for Windows, macOS, and the Web are listed in the platform cards above; none of them equals acceptance.

为什么 UI 用 Web 技术而不是纯 Rust？Why use web tech for the UI instead of pure Rust?

因为界面要覆盖桌面、移动与 Web。一棵 React 树可以由同一套组件和布局规则驱动，Rust 核心继续作为唯一数据源。代价是它不是 100% pure Rust；这是有意的取舍，不是遗漏。 Because the interface has to cover desktop, mobile, and the web. One React tree can be driven by the same components and layout rules while the Rust core remains the single data source. The cost is that this is not 100% pure Rust — a deliberate trade-off, not an oversight.

支持 DWG 保存吗？Does it support saving DWG?

没有 DWG 原地回写。SAVE 目前是有损 DXF 另存；源文件是 DWG 时，会写出一个实验性的新 DWG 文件，而不是覆盖原文件。 There is no in-place DWG writeback. SAVE is a lossy DXF Save As today; when the source is DWG, it writes an experimental new DWG file instead of overwriting the original.

命令覆盖 223/981 是什么？What does 223/981 command coverage mean?

它是命令清单的计数：981 条命令中 223 条有实现路径（50 完整 + 173 部分），758 条未实现。它不是 AutoCAD 兼容率；未支持的选项会按名称拒绝，不会静默成功。 It is a count of the command list: of 981 commands, 223 have an implementation path (50 complete + 173 partial) and 758 are not implemented. It is not an AutoCAD compatibility rate. Unsupported options are rejected by name, never silently accepted.

国内怎么下载？How do I download from mainland China?

优先使用 Cloudflare R2 镜像；GitHub Release 是上游与校验来源。镜像文件与上游同名，下载后用 .sha256 校验即可。若 CDN 未配置，下载按钮会自动回退到 GitHub。 Prefer the Cloudflare R2 mirror; GitHub Releases are the upstream and checksum source. Mirror files keep the upstream filenames — verify them with the .sha256 file after downloading. If the CDN is not configured, buttons fall back to GitHub automatically.