# ptray

**Repository Path**: brt2/ptray

## Basic Information

- **Project Name**: ptray
- **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-04-01
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyTray DevKit

Windows 系统托盘工具集，基于 `pystray` + `tkinter`，通过插件机制扩展功能。

## 快速开始

安装依赖：

```bash
pip install -r requirements.txt
```

启动：

```bash
python main.py
```

## 功能插件

| 插件 | 热键 | 说明 |
|------|------|------|
| TimerPlugin | 无 | 倒计时提醒 |
| DictPlugin | F8 | 剪贴板单词查询（ECDICT） |
| ClipboardPlugin | media_next / F6 / F7 | 文本摘录到 Markdown 文件 |
| OcrPlugin | 无 | 截图 OCR 识别 |
| RecorderPlugin | F9 | 录音保存 WAV |
| ImeSyncPlugin | 无 | 输入法内容跨设备同步（需服务端） |

## 输入法同步服务端

独立运行服务端：

```bash
python ime_sync_server.py
```

客户端配置文件位于 `~/.config/ptray/ime.cfg`，首次运行自动生成：

```json
{
  "host": "127.0.0.1",
  "port": 12123
}
```

## 文档

- [架构说明](doc/ARCHITECTURE.md) — TrayApp 与插件结构、开发指南
- [输入法同步协议](doc/IME_SYNC_PROTOCOL.md) — SSE 协议格式与心跳机制