ExcalidrawZ README

项目的 README,来自 github.com/chocoford/ExcalidrawZ。合并为一个 markdown 文件:README.md。

ExcalidrawZ logo

A native Excalidraw client for macOS, iPadOS, and iOS. Powered by SwiftUI.

GitHub Twitter Discord

Donation to Chocoford

Excalidraw is an excellent drawing tool. ExcalidrawZ keeps the familiar Excalidraw canvas, then adds native file management, iCloud sync, history, export, AI assistance, MCP integration, and Apple-platform interaction details around it.

Download

Download Link - App Store

Non-App Store version

  1. Download the latest .dmg from Releases.
  2. Open the .dmg and drag ExcalidrawZ into Applications.

Preview

App overview

Features

Native File Management

ExcalidrawZ manages drawings as real app documents instead of loose browser downloads.

File History

ExcalidrawZ records checkpoints for app-managed drawings, so you can review earlier versions and restore important work when needed.

File History

Excalidraw Editing, Native Controls

The canvas remains compatible with Excalidraw while the surrounding app is built for Apple platforms.

Collaboration

Use Excalidraw collaboration when you want to draw with others.

Collaboration

AI Drawing Assistant

ExcalidrawZ includes an AI assistant designed for canvas work.

ai_chat

MCP Services

ExcalidrawZ can expose the current app as an MCP server for compatible AI clients.

MCP

Math and Diagram Tools

ExcalidrawZ includes richer tools for technical drawings and study notes.

Math&Diagram

Locked Files and AI Visibility

For sensitive drawings, ExcalidrawZ adds protection around both storage and AI access.

file_lock

Share, Export, and Backup

ExcalidrawZ supports common export and sharing workflows.

Export editable image

Supported Formats

ExcalidrawZ can open, import, edit, or export common Excalidraw-related formats:

Contact

Welcome to my Discord server to share suggestions or report issues for ExcalidrawZ.

Development Guide

Signing configuration

Create Config/Overrides.xcconfig relative to the repository root, alongside Config/Project.xcconfig:

DEVELOPMENT_TEAM = YOUR_TEAM_ID
ICLOUD_CONTAINER = iCloud.com.yourname.ExcalidrawZ
APP_GROUP_IDENTIFIER = group.com.yourname.ExcalidrawZ

Replace these example values with identifiers registered to your Apple Developer team. The shared configuration leaves DEVELOPMENT_TEAM empty; set your team in the local overrides. The app and QuickLook extension must use the same App Group. All targets, including the extension and tests, inherit the team from Config/Project.xcconfig, which includes your local overrides. These overrides apply to all build configurations.

Runtime configuration

Create Config/Secrets.plist relative to the repository root. The project already references this file and includes it in both app targets' resources. The app's configuration loader stops with Unable to load Secrets.plist if the file is missing or invalid.

For local drawing development, this minimal configuration is sufficient:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>COLLAB_URL</key>
    <string>https://example.com</string>
</dict>
</plist>

COLLAB_URL must be a valid absolute URL. The example URL is a placeholder for local drawing work; to test collaboration, replace it with the URL of your deployed collaboration-enabled Excalidraw web client.

Optional string keys are ONEDRIVE_CLIENT_ID, GOOGLE_DRIVE_MACOS_CLIENT_ID, and GOOGLE_DRIVE_IOS_CLIENT_ID. Configure your own OAuth client IDs when developing the corresponding integrations.

Config/Overrides.xcconfig and Config/Secrets.plist are ignored by Git and should stay local.

ExcalidrawZ (chocoford/ExcalidrawZ)

正在搜索数据库…

这是什么?这是一款面向 macOS、iPadOS 和 iOS 的原生 Excalidraw 客户端,使用 SwiftUI 构建。它保留了熟悉的 Excalidraw 画布,并增加了原生文件管理、iCloud 同步、文件历史、导出和 AI 辅助功能。
这是网页应用还是桌面应用?这是原生应用,不是网页。画布与 Excalidraw 兼容,但应用本身是为苹果设备专门打造的。
我该如何在 Mac 上安装?从 Releases 页面下载最新的 .dmg 文件,打开后将 ExcalidrawZ 拖入“应用程序”文件夹。这是非 App Store 版本。
协作功能开箱即用吗?从源代码构建时默认不可用。示例中的 COLLABURL 只是占位符,因此要实现真正的协作,你需要提供自己部署的、支持协作功能的 Excalidraw 网页客户端的 URL。
它能在 Windows 或 Linux 上运行吗?不能。该应用仅面向苹果平台开发:macOS、iPadOS 和 iOS。
我的绘图存放在哪里?AI 能看到它们吗?绘图是由应用管理的文件,可以通过 iCloud 在你的苹果设备之间同步。加锁的文件对 AI 隐藏,你还可以控制每个文件是否对 AI 可见。
和直接使用浏览器版 Excalidraw 有什么不同?绘图会被当作真正的应用文档来管理,支持分组、自定义排序、iCloud 同步和历史检查点,而不是零散的浏览器下载文件。画布本身仍与 Excalidraw 兼容。
它能打开和导出哪些文件格式?它可以打开、导入、编辑和导出 .excalidraw、.excalidraw.png 和 .excalidraw.svg 文件,也支持 PDF 的导入和导出,以及图片导出。
AI 工具能连接到它吗?可以。该应用可以通过本地 HTTP 端点作为 MCP 服务器运行。基础模式提供 excalidraw-mcp 绘图工作流,优化模式则增加更深入的 ExcalidrawZ 集成。
敏感绘图如何保护?你可以使用本地身份验证为文件加锁,对文件及其检查点进行加密,并使用恢复密钥作为备用访问方式。
有哪些类似的项目?ipadn, zulu, sill, OpenYoink, Crest, excalidraw, opendisplay, MacPacker
作者
chocoford
大小
130.3 MB
星标
2K
时长
3年
提交 · 90 天