# Paper S3 EDCBook 翻页器 for wifi

**Repository Path**: leejason/pager-button

## Basic Information

- **Project Name**: Paper S3 EDCBook 翻页器 for wifi
- **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-03-16
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EDCBookBtn

<img src="data/demo.png" width="200" />

感谢 梦大 @梦西游啊游 [梦大官网](https://edcbook.cn)提供这么好的 系统，让我们能玩 M5 Paper S3. 

此应用完全为了方便摸🐟 , 需要手动绕过签名！

```zsh
xattr -rd com.apple.quarantine /Applications/EDCBookBtn.app
```

`EDCBookBtn` 是一个基于 Tauri 2 的极简桌面遥控按钮应用。主窗口是一个单按钮翻页器：单击发送 `right`，双击发送 `left`，适合做翻页器、遥控器或简化操作面板。

## 功能

- 常驻桌面右下角，窗口小、透明、无系统标题栏
- 主按钮单击下翻页，双击上翻页
- 主窗体支持右键菜单，可打开设置或直接关闭
- 空白区域可拖动窗口
- 设置窗口支持修改目标地址和整体透明度
- 透明度滑杆支持实时预览
- 启动时可自动通过 mDNS 扫描局域网里的 `edcbook` HTTP 服务
- 网络请求失败时会弹出“网络错误”提示

## 项目结构

- [`src/index.html`](src/index.html)：主窗体 UI 与交互
- [`src/assets/bg.png`](src/assets/bg.png)：主窗体背景图
- [`src/assets/btn.png`](src/assets/btn.png)：主按钮图片
- [`src/settings.html`](src/settings.html)：设置窗口
- [`src-tauri/src/lib.rs`](src-tauri/src/lib.rs)：Tauri 命令、请求发送、设置持久化、mDNS 发现
- [`src-tauri/tauri.conf.json`](src-tauri/tauri.conf.json)：窗口尺寸、透明、打包配置
- [`src-tauri/icons/`](src-tauri/icons/)：应用图标资源

## 拉取与更新

首次拉取：

```bash
git clone https://gitee.com/leejason/pager-button.git
cd pager-button
npm install
```

更新到最新 `master`：

```bash
git pull origin master
```

## 开发

先安装依赖：

```bash
npm install
```

启动开发模式：

```bash
npm run tauri dev
```

生产打包：

```bash
npm run tauri build
```

单独检查 Rust 侧是否可编译：

```bash
cd src-tauri
cargo check
```

## 地址与请求规则

设置里填写的地址可以是：

- `192.168.31.61`
- `192.168.31.61:8080`
- `http://192.168.31.61`
- `edcbook.local`

应用会自动规范化地址，然后发起：

- `GET /left?t=<timestamp>`
- `GET /right?t=<timestamp>`

当前主窗体交互约定：

- 单击按钮发送 `GET /right?t=<timestamp>`
- 双击按钮发送 `GET /left?t=<timestamp>`

如果没有已保存地址，应用会先尝试通过 `_http._tcp.local.` 自动发现包含 `edcbook` 的服务，找不到再弹出设置窗口。

## 说明

当前项目已经为 Windows 兼容做了基础适配：请求、设置、mDNS 发现、图标和主按钮交互都可以复用；macOS 继续保留私有 API 带来的圆角透明效果，Windows 侧则使用兼容样式，视觉效果不会和 macOS 完全一致。当前设置窗口在 Windows 上会使用系统标题栏与不透明窗口，以保证输入、焦点和拖动体验更稳定。设置会保存到 Tauri 的应用配置目录中，而不是浏览器 `localStorage`。