# tools-tauri

**Repository Path**: andy1215/tools-tauri

## Basic Information

- **Project Name**: tools-tauri
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 桌面工具箱

桌面工具箱是一个基于 Tauri 2、Vue 3 和 TypeScript 构建的桌面应用，主要面向 Windows 11 的日常效率场景。项目最初来自默认的 Tauri 模板，现已扩展为一个带分类首页、多功能页面、桌面端持久化、系统托盘、拖拽导入和自定义图标的桌面工具集。

## 功能概览

首页按分类展示功能入口，点击后进入具体页面：

- 效率：任务清单、番茄钟、日程规划、习惯打卡
- 记录：便签记录、常用片段、倒计时
- 工具：批量重命名、密码生成器、快速计算器

当前已经接入的桌面端能力包括：

- 通过 Tauri 命令实现的 Rust 本地持久化
- 系统托盘显示、隐藏和退出操作
- 批量重命名页面的文件拖拽导入
- 用于打包发布的自定义应用图标资源

## 技术栈

- 前端：Vue 3、TypeScript、Vite
- 桌面运行时：Tauri 2
- 原生后端：Rust
- 包管理工具：pnpm

## 项目结构

- `src/App.vue`：应用壳层，负责顶栏、状态协调和视图切换
- `src/components/views/`：各功能页组件，例如 `TodosView.vue`、`PomodoroView.vue`
- `src/components/HomeView.vue`：首页分类与收藏入口
- `src/components/SettingsModal.vue`：设置 / 关于 / 数据弹窗
- `src/toolboxContext.ts`：共享注入类型和上下文定义
- `src/main.ts`：Vue 启动入口
- `src-tauri/src/lib.rs`：Tauri 命令、托盘、SQLite 持久化、真实文件重命名
- `src-tauri/src/main.rs`：原生入口
- `src-tauri/icons/`：应用图标源文件和导出的平台图标
- `src-tauri/tauri.conf.json`：窗口、打包和构建配置

## 开发命令

安装依赖：

```bash
pnpm install
```

仅运行前端开发服务：

```bash
pnpm dev
```

启动桌面应用开发模式：

```bash
pnpm tauri dev
```

构建前端产物并进行前端类型检查：

```bash
pnpm build
```

格式化前端、配置和 Markdown 文件：

```bash
pnpm format
```

检查 Prettier 格式是否一致：

```bash
pnpm format:check
```

打包桌面应用：

```bash
pnpm tauri build
```

检查 Rust 侧是否能正常编译：

```bash
cargo check --manifest-path src-tauri/Cargo.toml
```

格式化 Rust 文件：

```bash
cargo fmt --manifest-path src-tauri/Cargo.toml
```

## 使用说明

- 核心数据通过 Tauri 写入本地 SQLite 数据库，并支持备份与恢复。
- 批量重命名会真实修改文件名，建议先使用测试文件验证规则。
- 托盘、通知和文件操作应以 Windows 11 实际行为为准，不要只按浏览器逻辑判断。

## 贡献说明

仓库贡献和实现约定请查看 `AGENTS.md`。