Skip to content

Repository files navigation

DrawSpace

CI GitHub Release License

DrawSpace 是一款基于 Electron 和 Excalidraw 的本地桌面画布管理工具。它以用户选择的本地目录作为工作区,提供画布工作区管理能力,画布内容不会上传到远程服务器。

界面预览

工作区首页,支持最近画布、收藏和本地存储状态:

工作区首页

内嵌 Excalidraw 编辑器,支持多标签与自动保存:

画布编辑器

全部画布视图,可按文件夹组织,并切换卡片/列表:

全部画布

AI生图

深色主题:

深色主题

首次启动时选择工作区目录:

选择工作区

功能

  • 选择本地文件夹作为工作区,递归索引 .excalidraw 文件
  • 新建、打开、重命名、移动、复制、收藏、搜索和删除画布
  • 卡片/列表视图、最近打开、排序、分页和多标签编辑
  • 自动保存、串行保存、外部修改检测、冲突副本和异常恢复
  • 回收站、恢复、永久删除和清空回收站
  • 内嵌 Excalidraw 编辑器,支持 PNG、SVG 和 Excalidraw 文件导出
  • 浅色、深色和跟随系统主题
  • Windows 自定义标题栏、托盘和 NSIS 安装程序
  • AI生图功能

下载与安装

前往 GitHub Releases 下载最新的 DrawSpace-版本号-x64.exe。

目前提供 Windows 10/11 x64 安装程序。安装包尚未进行商业代码签名,Windows 可能显示“未知发布者”或 SmartScreen 提示,请仅从本项目 Releases 页面下载。

快速开始

  1. 安装并启动 DrawSpace。
  2. 选择一个本地文件夹作为工作区。
  3. 新建画布,或打开工作区内已有的 .excalidraw 文件。
  4. 编辑内容会自动保存到所选工作区。

常见问题

Windows 提示未知发布者

当前安装程序未进行商业代码签名,因此 Windows 可能显示安全提示。请核对下载地址来自本项目 GitHub Releases 页面。

如何备份或迁移数据

备份整个工作区即可保存画布正文和工作区配置。若需要同时迁移缩略图、恢复记录等本机状态,还应备份 DrawSpace 的 userData 目录。

工作区可以放在同步盘如坚果云中吗

可以。DrawSpace 只读写本地目录,同步由同步盘客户端负责。

从源码运行

环境要求:

  • Node.js 22
  • npm 10 或更高版本
  • Windows 10/11 是主要运行和打包平台;Linux/macOS 可用于开发

安装依赖并启动开发环境:

npm ci
npm run dev

检查与测试

npm run typecheck
npm test
npm run lint

tests/unit/ 存放单元测试,tests/integration/ 存放服务与数据库集成测试,tests/e2e/ 存放 Playwright 端到端测试。运行 Electron E2E 测试:

npm run test:e2e

构建

生成应用代码:

npm run build

在 Windows 上生成 NSIS x64 安装程序:

npm run package:win

打包产物位于 release/,该目录不会提交到 Git。打包前请退出��在运行的已打包应用,避免文件扫描器或安装程序进程锁定 app.asar。

参与贡献

欢迎提交 Issue 和 Pull Request。开始前请阅读 贡献指南 与 安全策略。

开源协议

本项目使用 MIT License。Excalidraw 及其他第三方依赖遵循各自的开源协议。

About

A local-first desktop workspace for managing and editing Excalidraw drawings,

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages