# website-tools

**Repository Path**: lidy5436/website-tools

## Basic Information

- **Project Name**: website-tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网站工具包（Electron 模板）

基于 **Electron + electron-vite + Vue 3 + JavaScript** 的桌面工具包模板。预置侧边栏多工具导航、系统托盘、全局快捷键、本地配置和自动更新。

## 开发

```bash
npm install
npm run dev
```

打包 Windows 安装包：

```bash
npm run build:win
```

产物在 `dist` 目录。

## 目录

```
src/main/          主进程（窗口、托盘、快捷键、配置、更新、IPC）
src/preload/       通过 window.api 暴露给渲染进程的安全桥
src/renderer/      Vue 界面
src/shared/        主进程和渲染进程共用的 IPC 通道名
resources/         应用图标（托盘也用这份）
```

## 如何新增一个工具

1. 在 `src/renderer/src/views/tools/` 新建一个 Vue 页面，可参考 `JsonFormatter.vue`。
2. 在 [`src/renderer/src/tools/registry.js`](src/renderer/src/tools/registry.js) 加一条记录（id、title、path、component）。
3. 不用改路由文件：`router/index.js` 会根据注册表自动生成 hash 路由。

生产环境必须用 **hash 路由**（`#/tools/json`）。Electron 打包后走 `file://`，history 模式刷新会 404。

## 本地配置

主进程用 `electron-store`，文件在用户目录的 `settings.json`。默认项在 `src/main/store.js`：

- 关闭窗口是否隐藏到托盘
- 主题（浅色 / 深色 / 跟随系统）
- 显示/隐藏快捷键
- 窗口位置和大小

渲染进程只通过 `window.api.store` 读写，不要直接碰 Node。

## 自动更新

1. 把 [`electron-builder.yml`](electron-builder.yml) 里 `publish.owner` / `publish.repo` 改成你的 GitHub 仓库。
2. 用 `npm run build:win` 打安装包，上传到 GitHub Releases。
3. 已安装的用户会在启动数秒后检查更新；设置页也可以手动检查。

开发环境默认跳过更新。未改 GitHub 占位符时，检查失败会在设置页显示原因。

## 脚本

| 命令 | 作用 |
| --- | --- |
| `npm run dev` | 开发调试 |
| `npm run build` | 只编译，不打包安装包 |
| `npm run build:win` | 编译并打 Windows NSIS 安装包 |
| `npm run lint` | ESLint |