# personal-workbench

**Repository Path**: wasp_nest/personal-workbench

## Basic Information

- **Project Name**: personal-workbench
- **Description**: AI-Workspace 个人工作台插件
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 个人工作台插件

## 简介

这是 AI-Workspace 的一体化个人工作台插件。它提供了一个以组件为核心的流式网格工作空间，不依赖无限画布，而是采用横向受限、纵向自然增长的布局方式。页面本身就是工作台，集成了任务管理、笔记、看板、日程等多种实用工具，是个人事务与项目管理的得力助手。

## 主要特性

### 🎨 页面与布局
- **多工作台**：支持创建、切换多个独立工作台。
- **沉浸式体验**：工作台使用宿主空间，隐藏重复标题，优化留白。
- **定制化横幅**：每个工作台顶部包含可自定义图片、高度、名称的横幅，支持添加多段文字并拖动定位。
- **响应式网格**：基于 12 列流式网格，新增、调整宽度或排序时会自动重排后续内容。
- **编辑模式**：支持拖动排序和右下角拖拽缩放，并提供落点吸附与缩放反馈。
- **显示比例**：内置 85%-150% 的卡片内容缩放功能（默认 120%）。

### 📦 布局容器
分组功能已升级为真正的**布局容器**：
- **灵活添加**：可直接向容器内部添加组件。
- **跨区域移动**：支持组件在页面和不同容器之间自由移动。
- **独立配置**：容器拥有独立的网格列数、背景颜色、边框样式（支持实线、虚线、点线或无边框）。
- **安全删除**：删除容器时，内部组件会自动移回页面，不会丢失业务数据。

### 🧩 内置组件
插件内置了丰富的功能组件，涵盖工作与生活的各个方面：

- **任务管理**：Todo 列表、项目看板、甘特图、项目进度、小组管理。
- **知识管理**：灵感记录、Markdown 笔记、学习空间进度。
- **时间管理**：实时时钟、月历、日程提醒、按日期保存的个性内容。
- **实用工具**：天气、文件目录、工作区概览、快捷入口、图片画廊。

### 💾 数据存储
- **业务数据**：继续使用 Markdown 格式存储在当前工作区。
- **布局配置**：卡片的位置、尺寸、容器配置等保存在 `layout.json`。
- **存储路径**：每个工作台的数据独立保存在 `.woniu-workbench/<工作台名称>/` 目录下。
- **平滑迁移**：旧版自由画布的 `layout.json` 会自动按原纵横顺序迁移到新的 Schema v2 格式。

## 项目结构

```text
src/
├── workbench/
│   ├── components/
│   │   ├── banner/      # 横幅组件 (WorkbenchBanner)
│   │   ├── card/        # 通用卡片组件 (WorkbenchCard)
│   │   ├── container/   # 布局容器组件 (WorkbenchContainer)
│   │   ├── dashboard/   # 仪表盘视图 (WorkbenchDashboard)
│   │   ├── grid/        # 网格布局引擎 (WorkbenchGrid)
│   │   ├── group/       # 分组/容器逻辑
│   │   ├── list/        # 列表模式视图 (WorkbenchList)
│   │   └── view/        # 主视图控制器 (WorkbenchView)
│   ├── workbench.ts     # 插件核心入口逻辑
│   └── layout.ts        # 布局状态与处理逻辑
├── icons/               # SVG 图标资源
└── utils/               # 工具函数与类型定义
```

## 快速开始

### 开发

1. **安装依赖**：
   ```powershell
   npm install
   ```

2. **启动开发服务器**：
   ```powershell
   npm run plugin:dev
   ```
   
   在 AI-Workspace 的“空间与插件”设置中，刷新并发现本机开发的插件即可预览。

### 构建

运行构建命令生成发布文件：

```powershell
npm run plugin:build
```

构建成功后会生成 `.wplugin.zip` 文件，您可以将其上传到 Gitee Release 或插件下载地址。插件更新机制由宿主根据 `manifest.json` 中的版本和发布地址自动管理。

## 许可证

本项目遵循开源许可证（具体信息请查阅项目根目录下的 LICENSE 文件）。