diff --git a/README.md b/README.md new file mode 100644 index 0000000..73170b3 --- /dev/null +++ b/README.md @@ -0,0 +1,90 @@ +# 网页版提词器 (Web Teleprompter) v1.5 + +一个功能强大、简单易用的网页版提词器工具。专为演讲、视频录制、直播等场景设计,支持多设备远程协同控制。 + +## ✨ 主要功能 + +### 📝 文本提词器 (核心版本) +位于 `new/` 目录,包含以下特性: + +* **智能文本处理**: + * 支持文本粘贴与编辑。 + * **智能格式化**:自动根据标点符号进行分段,优化阅读体验。 + * **强制分段**:支持设置最大段落字数,防止单行过长。 + * **撤销/重做**:支持撤销格式化操作。 +* **专业的显示控制**: + * **镜像模式**:支持横向镜像翻转,适配专业提词器玻璃。 + * **样式自定义**:自由调节字体大小、行间距、文字颜色、背景颜色。 + * **全屏模式**:沉浸式阅读体验。 +* **平滑滚动控制**: + * 可调节滚动速度 (0.1 - 200)。 + * 支持暂停/开始、重置。 + * 支持上一行/下一行精准微调。 + * **键盘快捷键支持**。 +* **🤝 远程协作 (Beta)**: + * 基于 P2P 技术 (PeerJS) 实现。 + * **多端同步**:支持手机/平板作为遥控器控制电脑端提词器。 + * **全量同步**:实时同步文本内容、滚动状态、速度设置及跳转进度。 + * **简易连接**:通过 4 位数字房间 ID 快速连接。 + * 无需服务器中转,隐私安全。 +* **移动端适配**: + * 针对手机端优化的提示与交互体验。 + +### 📄 PDF 提词器 +位于 `new/pdf/` 目录: +* 支持直接上传 PDF 文件。 +* 自动处理 PDF 内容进行提词播放。 +* 支持镜像翻转与速度控制。 + +## 🚀 快速开始 + +### 方式 1:直接运行 +本项目为纯静态网页,无需安装任何依赖。 +1. 进入 `new` 文件夹。 +2. 双击 `index.html` 在浏览器中打开即可使用。 + +### 方式 2:部署 +可以将 `new` 文件夹内的内容部署到任何静态网页托管服务(如 GitHub Pages, Vercel, Nginx 等)。 + +## 🎮 操作指南 + +### 快捷键 +* **空格键 (Space)**: 暂停 / 继续滚动 +* **R 键**: 重置滚动到顶部 +* **F 键**: 切换全屏模式 +* **Enter 键**: 在跳转输入框中确认跳转 + +### 远程控制使用方法 +1. **主机端(显示端)**: + * 打开高级功能菜单 -> 远程协作。 + * 点击“创建房间”。 + * 将生成的 4 位数字 ID 发送给控制端。 +2. **控制端(遥控端)**: + * 打开同样的网页。 + * 打开高级功能菜单 -> 远程协作。 + * 输入主机端的 ID,点击“加入”。 + * 连接成功后,控制端的任何操作(滚动、修改文本、设置)都会实时同步到主机端。 + +## 📂 目录结构 + +``` +/ +├── new/ # ✨ 最新稳定版本 (v1.5) +│ ├── index.html # 主程序入口 +│ ├── script.js # 核心逻辑 (含 Teleprompter 类与 RemoteController 类) +│ ├── styles.css # 样式文件 +│ └── pdf/ # PDF 提词器模块 +│ └── index.html +├── index.html # (旧版本) +├── script.js # (旧版本) +└── styles.css # (旧版本) +``` + +## 🛠️ 技术栈 +* HTML5 / CSS3 / JavaScript (ES6+) +* **PeerJS**: 用于实现 WebRTC 远程 P2P 通信。 +* **PDF.js**: 用于解析和渲染 PDF 文件。 +* **Mammoth.js**: 用于文档处理支持。 + +## 📄 版权信息 +© 2025 SuperJia. All Rights Reserved.