# worknote

**Repository Path**: gitmchao/worknote

## Basic Information

- **Project Name**: worknote
- **Description**: 办公便签，随手记录任务与想法，自动归类整理的桌面便签工具。基于 Tauri 2 构建，安装包小、启动快、资源占用低。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-30
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Worknote · 办公便签

> 随手记录任务与想法，自动归类整理的桌面便签工具。基于 Tauri 2 构建，安装包小、启动快、资源占用低。

> ⚠️ **AI 生成声明**：本项目由 AI 辅助生成（AI-assisted / AI-generated），代码与文档可能存在错误、遗漏或不成熟之处。请在使用前自行甄别、审查与测试，风险自负；生产环境使用前建议进行充分的安全与质量评估。

## 功能特性

- **全局速记**：任意界面按 `Ctrl+Alt+Space` 唤出速记悬浮窗，屏幕居中弹出，可鼠标拖动，`Enter` 保存、`Esc` 或点击 ✕ 关闭
- **剪贴板速记**：复制任意文字后按 `Ctrl+Alt+C`，自动填入速记窗
- **智能分类**：输入时实时预览分类结果——笔记/任务/想法自动识别，支持项目、优先级、截止时间、标签、@提及
- **规则 + LLM 双引擎**：本地规则秒级分类；可选配置 OpenAI 兼容接口，用大模型提升分类准确度
- **任务管理**：状态流转（待办/进行/完成）、项目视图、合并与重命名项目
- **截止提醒**：到期通过系统通知提醒；每天 18:00 自动回顾当日未完成待办
- **数据安全**：每日凌晨 3:00 自动快照；30 天未活跃项目自动冷归档
- **统计与导出**：多维统计报表，支持导出 Markdown / JSON
- **托盘常驻**：关闭主窗口最小化到托盘，单实例运行

## 快捷键

| 快捷键 | 功能 |
|---|---|
| `Ctrl+Alt+Space` | 唤出速记悬浮窗 |
| `Ctrl+Alt+C` | 剪贴板内容填入速记窗 |
| `Enter` | 保存速记 |
| `Esc` | 关闭速记窗 |

## 技术栈

- **桌面框架**：Tauri 2（Rust 后端 + 系统 WebView）
- **前端**：React 18 + TypeScript + Vite
- **存储**：SQLite（本地文件，无需服务端）
- **通知**：系统原生通知

## 快速开始

### 环境要求

- Node.js ≥ 18
- Rust ≥ 1.77
- Windows：需安装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/)（含 C++ 桌面开发与 WebView2）

### 开发运行

```bash
npm install
npm run tauri:dev
```

### 打包发布

```bash
npm run tauri:build
```

产物位于 `src-tauri/target/release/bundle/nsis/`：

| 安装包 | 大小 | 说明 |
|---|---|---|
| `-offline.exe` | ~254 MB | 内置 WebView2 运行时，断网可安装 |
| `-online.exe` | ~4.5 MB | 安装时自动检测，缺 WebView2 则联网下载 |

安装器特性：自动检测并安装 WebView2、支持自定义安装路径、免管理员权限（当前用户模式）。

## 目录结构

```
worknote/
├── src/                  # 前端源码（React + TS）
│   ├── components/       # 主窗口 / 速记窗组件
│   ├── lib/              # API 封装、事件、类型
│   └── styles/           # 全局样式
├── src-tauri/            # Rust 后端
│   ├── src/
│   │   ├── lib.rs        # 应用入口：托盘、热键、后台任务
│   │   ├── cmd.rs        # Tauri 命令层
│   │   ├── db.rs         # SQLite 数据层
│   │   ├── llm.rs        # LLM 分类客户端
│   │   ├── classify.rs   # 分类引擎（规则）
│   │   └── snapshot.rs   # 每日快照
│   ├── icons/            # 应用图标
│   └── tauri.conf.json   # 打包与窗口配置
└── package.json
```

## 数据存储

所有数据保存在本地：`%APPDATA%/cn.worknote.app/`（`data.db` 与快照），卸载应用不会删除数据。

## License

本项目基于 [Apache License 2.0](LICENSE) 开源。