From 4acb4077f125b5a1dab417458207048e3d6586da Mon Sep 17 00:00:00 2001
From: Hsdi <admin@Hsdi.cc>
Date: Sun, 15 Mar 2026 01:12:56 +0800
Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 91 insertions(+)

diff --git a/README.md b/README.md
index 2a5117f..bf3a22c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,93 @@
 # Shortcut_Sync_PotPlayer
 
+一个用于 `PotPlayer` 多窗口联动控制的小工具。
+
+运行后，程序会监听常用播放控制按键；当你在 `PotPlayer` 窗口，或本工具窗口中操作时，会把对应指令同步发送给其他已打开的 `PotPlayer` 窗口，适合双语字幕对照、多个版本同步播放、剪辑比对等场景。
+
+## 功能特性
+
+- 自动检测当前已打开的 `PotPlayer` 窗口
+- 同步播放 / 暂停
+- 同步快退 / 快进
+- 同步小步进度调整：`Shift + Left / Right`
+- 同步大步进度调整：`Ctrl + Left / Right`
+- 工具窗口常驻顶层，方便查看当前状态
+- 仅在你聚焦 `PotPlayer` 或本工具窗口时生效，避免误触
+
+## 运行环境
+
+- Windows
+- Python 3.9+
+- 已安装 `PotPlayer`
+
+## 依赖安装
+
+项目依赖：
+
+- `keyboard`
+- `pywin32`
+
+安装命令：
+
+```bash
+pip install keyboard pywin32
+```
+
+> `tkinter` 为 Python 标准库的一部分，通常无需单独安装。
+
+## 启动方式
+
+在项目目录下运行：
+
+```bash
+python main.py
+```
+
+启动后会弹出一个置顶的小窗口，用于显示当前状态和快捷键说明。
+
+## 使用说明
+
+1. 先打开两个或以上的 `PotPlayer` 窗口。
+2. 运行本工具。
+3. 将焦点放在任意一个 `PotPlayer` 窗口，或本工具窗口。
+4. 使用下列快捷键进行联动控制。
+
+## 快捷键
+
+| 快捷键 | 作用 |
+| --- | --- |
+| `Space` | 同步播放 / 暂停 |
+| `Left` | 同步后退 |
+| `Right` | 同步前进 |
+| `Shift + Left` | 同步小步后退 |
+| `Shift + Right` | 同步小步前进 |
+| `Ctrl + Left` | 同步大步后退 |
+| `Ctrl + Right` | 同步大步前进 |
+
+## 同步逻辑
+
+- 如果当前焦点在某个 `PotPlayer` 窗口上，按键会同步到“其他” `PotPlayer` 窗口
+- 如果当前焦点在本工具窗口上，按键会同步到“全部” `PotPlayer` 窗口
+- 如果当前没有聚焦 `PotPlayer` 或本工具窗口，程序不会执行同步
+- 当只打开一个 `PotPlayer` 窗口时，不会进行同步
+
+## 注意事项
+
+- 本工具仅支持 Windows
+- 仅对窗口类名为 `PotPlayer64` 或 `PotPlayer` 的窗口生效
+- 部分快捷键监听场景下，可能需要以管理员身份运行 Python 或终端
+- 本工具发送的是窗口消息和按键消息，实际步进时长取决于你在 `PotPlayer` 中的快捷键设置
+
+## 项目结构
+
+```text
+.
+├── main.py     # 主程序
+├── README.md   # 项目说明
+└── LICENSE     # 开源许可
+```
+
+## 许可证
+
+本项目采用 [GPL-3.0](./LICENSE) 许可证。
+