Skip to content

wangdoyos/ExcaLib

Repository files navigation

ExcaLib Logo

ExcaLib

🎨 Excalidraw 批量管理工具 | Excalidraw Batch Manager

功能特性快速开始使用指南技术栈开发

FeaturesQuick StartUser GuideTech StackDevelopment


🇨🇳 中文

✨ 功能特性

功能 描述
📁 文件夹管理 添加、删除监控文件夹,自动扫描 .excalidraw 文件
🖼️ 可视化预览 瀑布流/列表视图,实时缩略图预览
✏️ 内置编辑器 集成 Excalidraw 编辑器,支持完整绘图功能
📚 素材库支持 本地素材库持久化存储
🔍 搜索排序 按文件名搜索,按名称/修改时间/创建时间排序
☑️ 批量操作 多选文件,批量导出 PNG/SVG,批量删除
🌙 深色模式 浅色/深色/跟随系统三种主题模式
🌍 国际化 支持中文/英文界面切换

📥 快速开始

系统要求

  • macOS 10.15+
  • Windows 10+
  • Linux (Ubuntu 18.04+, Fedora 32+)

安装

# 克隆仓库
git clone https://github.com/your-username/ExcaLib.git
cd ExcaLib

# 安装依赖
npm install

# 开发模式运行
npm run tauri dev

# 构建生产版本
npm run tauri build

📖 使用指南

添加文件夹

  1. 点击左侧边栏的 按钮
  2. 选择包含 .excalidraw 文件的文件夹
  3. 应用会自动扫描并显示所有文件

编辑文件

  • 点击任意文件卡片进入编辑器
  • 支持所有 Excalidraw 标准功能
  • 点击 保存 按钮保存更改

批量操作

  1. 点击 多选 按钮进入选择模式
  2. 点击文件卡片选择/取消选择
  3. 使用工具栏按钮:
    • 📤 导出 PNG - 批量导出为 PNG 图片
    • 📤 导出 SVG - 批量导出为 SVG 矢量图
    • 🗑️ 批量删除 - 删除选中的文件

切换主题

  • 点击顶部工具栏的 🌙 图标
  • 选择 浅色模式 / 深色模式 / 跟随系统

切换语言

  • 点击顶部工具栏的 🌐 图标
  • 选择 中文English

🇺🇸 English

✨ Features

Feature Description
📁 Folder Management Add/remove watch folders, auto-scan .excalidraw files
🖼️ Visual Preview Masonry/List view with real-time thumbnails
✏️ Built-in Editor Integrated Excalidraw editor with full drawing capabilities
📚 Library Support Local library with persistent storage
🔍 Search & Sort Search by filename, sort by name/modified/created date
☑️ Batch Operations Multi-select files, batch export PNG/SVG, batch delete
🌙 Dark Mode Light/Dark/System theme modes
🌍 i18n Chinese/English interface

📥 Quick Start

System Requirements

  • macOS 10.15+
  • Windows 10+
  • Linux (Ubuntu 18.04+, Fedora 32+)

Installation

# Clone repository
git clone https://github.com/your-username/ExcaLib.git
cd ExcaLib

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

📖 User Guide

Add Folders

  1. Click the button in the sidebar
  2. Select a folder containing .excalidraw files
  3. The app will automatically scan and display all files

Edit Files

  • Click any file card to enter the editor
  • All standard Excalidraw features are supported
  • Click Save to save your changes

Batch Operations

  1. Click Select to enter selection mode
  2. Click file cards to select/deselect
  3. Use toolbar buttons:
    • 📤 Export PNG - Batch export as PNG images
    • 📤 Export SVG - Batch export as SVG vectors
    • 🗑️ Delete - Delete selected files

Switch Theme

  • Click the 🌙 icon in the top toolbar
  • Choose Light / Dark / System

Switch Language

  • Click the 🌐 icon in the top toolbar
  • Select 中文 or English

🛠️ 技术栈 | Tech Stack

Tauri
Tauri v2
React
React 18
TypeScript
TypeScript
Vite
Vite
Rust
Rust

主要依赖 | Key Dependencies

  • @excalidraw/excalidraw - 核心绘图引擎 | Core drawing engine
  • @arco-design/web-react - UI 组件库 | UI component library
  • zustand - 状态管理 | State management
  • react-router-dom - 路由管理 | Routing

💻 开发 | Development

项目结构 | Project Structure

ExcaLib/
├── src/                    # React 前端源码 | React frontend source
│   ├── components/         # UI 组件 | UI components
│   │   ├── editor/         # 编辑器组件 | Editor components
│   │   ├── gallery/        # 画廊组件 | Gallery components
│   │   └── layout/         # 布局组件 | Layout components
│   ├── stores/             # Zustand 状态管理 | Zustand stores
│   ├── services/           # API 服务 | API services
│   ├── i18n/               # 国际化配置 | i18n config
│   ├── utils/              # 工具函数 | Utility functions
│   └── styles/             # 全局样式 | Global styles
├── src-tauri/              # Tauri/Rust 后端 | Tauri/Rust backend
│   ├── src/
│   │   ├── commands/       # Tauri 命令 | Tauri commands
│   │   └── models/         # 数据模型 | Data models
│   └── Cargo.toml
└── package.json

开发命令 | Development Commands

# 开发模式 | Development mode
npm run tauri dev

# 构建生产版本 | Build for production
npm run tauri build

# 类型检查 | Type check
npx tsc --noEmit

# 代码检查 | Lint
npm run lint

📄 许可证 | License

MIT License


Made with ❤️ by wangdoyo

About

批量管理、预览、编辑你的excalidraw文件

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors