# p-tools

**Repository Path**: kylinpan/p-tools

## Basic Information

- **Project Name**: p-tools
- **Description**: 一个小工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-03
- **Last Updated**: 2026-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 欢迎使用你的 Wails3 项目！

恭喜你生成了这个 Wails3 应用！这份 README 会带你完成接下来的步骤，把项目跑起来。

## 快速开始

1. 在终端中进入项目目录。

2. 以开发模式运行应用：

   ```
   wails3 dev
   ```

   这会启动应用，并对前端与后端的改动开启热重载。

3. 构建生产版本：

   ```
   wails3 build
   ```

   产物是 `bin/` 目录下的可执行文件（Windows 为 `bin/p-tools.exe`）。

4. 打包可安装的产物，用 `Makefile`（各平台必须在本平台打包）：

   ```
   make            # 列出所有打包目标
   make win-setup  # Windows → dist/p-tools-<版本>-<架构>-setup.exe
   make mac-dmg    # macOS  → dist/p-tools-<版本>-<架构>.dmg
   ```

   版本号只有一个来源：`build/config.yml` 的 `info.version`。exe 的版本资源
   (`build/windows/info.json`)、安装包版本 (`build/windows/nsis/wails_tools.nsh`)、
   macOS 的 `Info.plist` 和 `dist/` 里的文件名都由它派生，改版本只走这一个入口：

   ```
   make version VERSION=0.2.0     # 写回 config.yml 并重建上述派生文件
   make win-setup VERSION=0.2.0   # 也可直接带上，打包前会自动同步版本
   ```

## 运行行为

- 默认启动：静默驻留托盘，不弹窗口；带 `--show` 才会启动即显示启动器。
- 唤醒：`Ctrl+Alt+Space`（主热键被占用时自动切到 `Ctrl+Shift+Space`，并在托盘提示里标注）。
- 开机自启：托盘菜单的「开机自启」勾选项。Windows 写 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run\PTools`，macOS 写 `~/Library/LaunchAgents/com.ptools.app.plist`；登记的命令不带 `--show`，登录后静默驻留。勾选状态每次都回读登记的实际值，与系统保持一致。

## 探索 Wails3 的能力

项目已经搭好，接下来可以看看 Wails3 提供了什么：

1. **看示例**：最好的学习方式是阅读示例。到 `v3/examples` 目录下的 `examples` 里可以看到各种示例应用。

2. **运行示例**：想运行任意示例，进入该示例目录后执行：

   ```
   go run .
   ```

   注意：在 alpha 阶段，部分示例可能仍在开发中。

3. **读文档**：访问 [Wails3 文档](https://v3.wails.io/)，获取深入指南与 API 参考。

4. **加入社区**：有疑问或想分享进展？加入 [Wails Discord](https://discord.gg/JDdSxwjhGf)，或到 [GitHub 上的 Wails 讨论区](https://github.com/wailsapp/wails/discussions)交流。

## 项目结构

花一点时间熟悉项目结构：

- `frontend/`：前端代码（HTML、CSS、JavaScript/TypeScript）
- `main.go`：Go 后端的入口
- `internal/`：应用装配、平台适配（`internal/platform`）与各 Provider 实现
- `build/`：各平台的构建与打包配置，`build/config.yml` 是版本号等信息的来源

## 下一步

1. 在 `frontend/` 目录里改造前端，做出你想要的界面。
2. 在 `main.go` 与 `internal/` 里添加后端功能。
3. 用 `wails3 dev` 实时查看改动效果。
4. 准备就绪后，用 `wails3 build` 构建应用。

祝你用 Wails3 编码愉快！遇到问题或有疑问时，随时查阅文档或联系 Wails 社区。