Hour Share 文档

简介

Hour Share 是一个本地网络工具，用于在同一 Wi-Fi 网络中的设备之间共享文件和文本。它由一个快速的 Node.js CLI 运行器和一个提供网页控制面板的 Python Flask 服务器组成。通过扫描二维码，任何设备都可以立即访问控制面板，上传、下载和共享内容 — 无需互联网连接或账户。

功能

• 二维码连接 — 从控制面板扫描二维码，在同一个 Wi-Fi 的任何设备上打开它。
• 文件上传下载 — 上传最大 100 MB 的文件。一键下载 — 密码保护。
• 文本共享 — 粘贴文本、代码片段或链接，通过接收面板立即共享。
• 密码保护 — 每个传输包和群组都有 bcrypt 密码保护 — 即使在共享网络中也安全。
• 自动过期 — 所有传输包、群组及其内容在 60 分钟后自动过期 — 不留磁盘垃圾。
• 群聊 — 使用名称和密码创建或加入群组 — 实时共享文件和文本。

安装

通过 npm 全局安装并运行：

# Install globally
npm install -g hourshare

# Start Hour Share
hourshare

从源码构建

# Clone the repository
git clone https://github.com/Curzyori/hour-share.git
cd hour-share

# Set up Python environment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Run the server directly
python3 server.py

技术规格

• CLI： Node.js (vanilla, no deps)
• 服务器： Python 3.10+, Flask 3
• 前端： Vanilla HTML/CSS/JS (no build step)
• 认证： bcrypt password per bundle
• 存储： File-based JSON (no DB)
• 许可证： MIT

工作原理

Hour Share 在您的本地机器上运行一个 Python Flask 服务器，通过 HTTP 提供网页控制面板。Node.js CLI（`hourshare`）在后台启动服务器，在浏览器中打开控制面板 URL，并显示二维码。同一个 Wi-Fi 上的任何设备都可以扫描二维码打开控制面板。文件和文本存储在服务器的 JSON 文件中，并在 60 分钟后过期。可选的密码保护使用 bcrypt 确保您的传输安全。