# Workbench

**Repository Path**: girls-lover/workbench

## Basic Information

- **Project Name**: Workbench
- **Description**: 个人工作台 (Personal Workbench)
本地运行、浏览器操作的个人工作台：项目台账、看板、任务待办、富文本笔记、资料库（含磁盘文件引用 + 在线预览）、收件箱、全局搜索、一键备份。
数据完全保留在本地（SQLite + 本地 git 自动备份），代码仓库仅托管应用本体，不含任何业务数据。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-14
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🗂️ 个人工作台 (Personal Workbench)

> 本地运行、浏览器操作的个人工作台：项目台账、看板、任务待办、富文本笔记、资料库（含磁盘文件引用 + 在线预览）、收件箱、全局搜索、一键备份。
>
> 数据完全保留在本地（SQLite + 本地 git 自动备份），代码仓库仅托管应用本体，不含任何业务数据。

---

## ✨ 功能总览

| 模块 | 说明 |
|---|---|
| 📊 仪表盘 | 今日待办、逾期提醒、进行中项目、本周完成、最近更新 |
| 📁 项目台账 | 跨团队协作、状态/优先级、负责人/参与人、起止日期、里程碑、风险登记、外部链接 |
| 🗂️ 看板 | **任务看板 / 项目看板**双模式，拖拽卡片变更状态；点项目卡片打开项目详情抽屉 |
| ✅ 任务待办 | 优先级、截止日期、标签、按项目/状态筛选 |
| 📝 笔记 | 富文本（所见即所得）+ Markdown 源码双模式、文件夹/标签/关联项目、会议纪要模板、自动保存 |
| 🗄️ 资料库 | **双模式文件管理** + **在线预览**（见下） |
| 📥 收件箱 | 快速速记，一键归入任务/笔记 |
| 🔍 全局搜索 | 跨项目/任务/笔记/收件箱/文件 |
| ⚙️ 设置与备份 | 一键备份（可选 AES-256-GCM 加密）、一键恢复、运行信息 |

### 🗄️ 资料库：双模式 + 在线预览

- **🔗 磁盘引用**：登记磁盘任意位置的文件（不复制），只存路径+项目+标签，文件留在原处；被移动后自动标红，可「重新定位」；删除仅移除引用、不删原文件
- **📄 归档**：把文件复制进工作台 `files\` 统一保管
- **从资料库选择**：项目抽屉里可直接勾选资料库已有文件关联到项目，无需重复登记
- **👁️ 在线预览**：点文件名即预览 —— docx / xlsx / pdf / 图片 / 音视频 / txt / Markdown / 代码，无需跳出浏览器；也可一键「本地打开」调用系统默认程序
- 浏览范围默认限定在可配置的根目录（`app\config.json` 的 `allowedRoots`），防止越权

---

## 🚀 快速开始

```bash
cd app
npm install
npm run build
npm run start   # 或直接 node server.js
```

启动后浏览器访问 **http://127.0.0.1:3978**（默认端口，可在 `app\config.json` 修改）。

### 无命令行体验（Windows）

- 双击 `启动工作台.vbs` → 后台启动并自动打开浏览器（若已在运行则直接开浏览器）
- 双击 `停止工作台.vbs` → 停止服务

> ⚠️ 若本机 PATH 中有旧版 npm（如 nodejs14 残留的 npm 6）导致 `npm install` 卡死，请用新版 Node 自带 npm 的完整路径：
> ```
> & "C:\Program Files\nodejs\node.exe" "C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js" install
> ```
> 国内网络建议先配置镜像：`npm config set registry https://registry.npmmirror.com`

---

## 💾 数据与备份

- 数据目录：`data\`（SQLite：`workbench.db`，WAL 模式）
- 文件目录：`files\`（归档文件）
- 备份目录：`backups\`（一键备份生成 `workbench-时间.zip` 或加密版 `.enc`）
- 数据每次变更自动提交到本地 git（`data\` 内，30 秒节流，提交前自动 WAL checkpoint 保证完整性），可回滚历史版本
- **代码推送到本仓库（Gitee 私有），数据永不推送**

---

## 🔄 换电脑迁移

1. 新电脑 `git clone https://gitee.com/girls-lover/workbench.git`
2. `cd app && npm install && npm run build`
3. 把旧电脑 `backups\` 里的备份（或整个 `data\` + `files\`）拷过去
4. 浏览器打开工作台 → 设置与备份 → 恢复，选择备份文件（加密备份需密码）

---

## 🛠️ 技术栈

- 前端：Vue 3 + Vite + Element Plus + Pinia + Vue Router + Tiptap（富文本）+ docx-preview / SheetJS（在线预览）
- 后端：Node.js + Express + better-sqlite3（WAL）+ multer（上传）+ archiver / adm-zip（备份/恢复）+ Node crypto（AES-256-GCM 加密）

## 📄 License

个人使用 · 私有仓库