# workspace

**Repository Path**: yu-caiyi/workspace

## Basic Information

- **Project Name**: workspace
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: electron_work_space_app_1.0.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# Work Space - 桌面工作空间管理器

一个类似 macOS 台前调度的桌面级工作空间管理应用，帮助你组织不同工作环境下的网页和软件。

## 技术栈

- **Electron** - 跨平台桌面应用框架
- **React 18** - UI 框架
- **TypeScript** - 类型安全
- **Vite** - 构建工具
- **Zustand** - 状态管理
- **Tailwind CSS** - 样式框架

## 功能特性

### 工作空间管理
- 创建/删除/重命名工作空间
- 为每个工作空间设置不同颜色
- 快速切换工作空间
- 数据持久化到本地存储

### 应用管理
- 向工作空间添加网页应用
- 向工作空间添加本地软件
- 点击快速启动应用
- 网格布局展示应用卡片

### 用户体验
- 深色主题
- 流畅的动画效果
- 响应式布局
- 简洁直观的 UI

## 项目结构

```
work-space/
├── src/
│   ├── main/           # Electron 主进程
│   │   └── index.ts
│   ├── preload/        # Preload 脚本
│   │   └── index.ts
│   └── renderer/       # React 渲染进程
│       ├── components/  # UI 组件
│       │   ├── WorkspaceList.tsx
│       │   └── AppGrid.tsx
│       ├── store/      # Zustand 状态管理
│       │   └── index.ts
│       ├── types/      # TypeScript 类型
│       │   └── index.ts
│       ├── App.tsx
│       ├── main.tsx
│       └── index.css
├── index.html
├── package.json
├── vite.config.ts
├── tailwind.config.js
└── tsconfig.json
```

## 快速开始

### 安装依赖

```bash
npm install
```

### 开发模式

```bash
npm run electron:dev
```

这将同时启动 Vite 开发服务器和 Electron 应用窗口。

### 构建应用

```bash
npm run electron:build
```

## 使用说明

### 创建工作空间

1. 点击左侧底部的「新建工作空间」按钮
2. 输入工作空间名称
3. 选择一个喜欢的颜色
4. 点击「创建」

### 添加应用

1. 切换到想要添加应用的工作空间
2. 点击右上角的「添加应用」按钮
3. 填写应用信息：
   - 应用名称
   - 选择应用类型（网页或软件）
   - 对于网页，输入网址
   - 对于软件，输入可执行文件路径
4. 点击「添加」

### 启动应用

点击应用卡片即可打开对应的网页或软件。

### 删除应用

将鼠标悬停在应用卡片上，点击右上角的 × 按钮即可删除。

## 开发命令

- `npm run dev` - 仅启动 Vite 开发服务器（无 Electron）
- `npm run build` - 仅构建前端资源
- `npm run preview` - 预览构建结果
- `npm run electron:dev` - 启动 Electron 开发模式
- `npm run electron:build` - 构建可分发的 Electron 应用

## License

MIT