Skip to content

About

多功能悬浮窗

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

多功能悬窗 FloatScreen

一个轻量级 Windows 桌面截图钉图工具,集 截图 · 钉图 · OCR 文字识别 · 百度翻译 于一体。

单击桌面悬浮小圆标即可框选截图,截图会以置顶窗口"钉"在桌面上,随时提取文字、翻译或复制图片,不打断你的工作流。


✨ 功能特性

功能 说明
🎯 悬浮 logo 桌面始终置顶的小圆标,单击截图,可拖动到任意位置,右键菜单可显示/隐藏/退出
📌 钉图窗口 截图以无边框置顶窗口显示,拖动移动、滚轮缩放,不遮挡其他操作
🔤 提取文字 基于 RapidOCR 的离线文字识别,结果展示在下方面板,支持一键复制
🌐 百度翻译 调用百度翻译 API 将识别文字翻译为中文,按钮实时显示翻译进度百分比
📋 复制图片 将截图原图写入系统剪切板,可直接粘贴到微信聊天框、Word、笔记等
⌨️ 全局快捷键 默认 Ctrl+Shift+A 一键截图,可在配置文件中自定义
🚀 开机自启动 托盘菜单一键开关,写入注册表自动生效
🖥️ 系统托盘 托盘图标右键菜单:截图 / 显示隐藏悬浮窗 / 开机自启动 / 退出

📋 环境要求

  • 操作系统:Windows 10 / 11
  • Python:3.9 ~ 3.12
  • 百度翻译 API:需自行申请(申请地址)

🚀 快速开始

1. 克隆仓库

git clone https://github.com/LBL667/FloatScreen.git
cd FloatScreen

2. 安装依赖

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

3. 配置密钥

复制示例配置并填入你自己的百度翻译 API 密钥:

copy config.example.json config.json

编辑 config.json,填入你在 百度翻译开放平台 申请的密钥:

{
  "baidu": {
    "appid": "你的APP_ID",
    "secret_key": "你的密钥",
    "api_key": "你的API_KEY",
    "from": "auto",
    "to": "zh"
  },
  "hotkey": "ctrl+shift+a",
  "logo_size": 52
}
字段 说明
appid 百度翻译开放平台 → 开发者信息 → APP ID
secret_key 百度翻译开放平台 → 开发者信息 → 密钥
api_key 百度翻译开放平台 → 开发者信息 → API Key
from 源语言,auto 为自动检测
to 目标语言,zh 为中文
hotkey 全局截图快捷键
logo_size 悬浮 logo 直径(像素)

⚠️ 重要:config.json 包含个人密钥,已被 .gitignore 排除,切勿提交到仓库。

4. 运行

python main.py

桌面出现蓝色小圆标,单击或按 Ctrl+Shift+A 即可截图。


📖 使用说明

截图

  • 单击桌面悬浮圆标,或
  • 按 Ctrl+Shift+A(全局快捷键),或
  • 右键托盘图标 → 「截图」

框选区域后自动生成钉图窗口。

钉图窗口操作

操作 效果
拖动窗口 移动钉图位置
滚轮 ↑ 放大
滚轮 ↓ 缩小
翻译 识别文字并翻译为中文,按钮显示进度百分比
提取文字 OCR 识别,结果显示在下方面板
复制图片 截图存入剪切板,可粘贴到微信 / 文档
删除 关闭钉图窗口
面板内 复制 复制识别/翻译文字
面板内 收起 / Esc 关闭结果面板

托盘菜单

右键托盘图标:

  • 截图 — 立即开始框选
  • 显示/隐藏悬浮窗 — 切换桌面圆标
  • 开机自启动 — 勾选后开机自动运行(写入注册表)
  • 退出 — 退出程序

📦 打包为 exe

使用 PyInstaller 一键打包:

pyinstaller FloatScreen.spec

打包完成后,可执行文件位于 dist\FloatScreen\FloatScreen.exe。

将 config.json 复制到 dist\FloatScreen\ 目录下与 exe 同级,程序运行时自动读取。


🗂️ 项目结构

FloatScreen/
├── main.py                # 程序入口
├── config.py              # 配置加载
├── config.example.json    # 配置模板(不含密钥)
├── config.json            # 实际配置(已被 gitignore,需自行创建)
├── hotkey.py              # 全局快捷键
├── tray.py                # 系统托盘图标与菜单
├── autostart.py           # 开机自启动(注册表)
├── floating_logo.py       # 桌面悬浮圆标
├── app.ico                # 应用图标
├── FloatScreen.spec       # PyInstaller 打包配置
├── requirements.txt       # 依赖列表
├── screenshot/
│   └── selector.py        # 全屏框选截图
├── services/
│   ├── ocr.py             # OCR 文字识别
│   └── translator.py      # 百度翻译 API
└── window/
    └── pin_window.py      # 钉图窗口(翻译/提取/复制/删除)

🛠️ 技术栈

技术 用途
PySide6 GUI 框架
RapidOCR 离线 OCR 文字识别
百度翻译 API 文本翻译
keyboard 全局快捷键监听
PyInstaller 打包为 exe

❓ 常见问题

翻译报错 / 无结果

检查 config.json 中三个密钥是否填写正确。可前往百度翻译开放平台确认 API 是否开通通用翻译服务。

OCR 识别慢 / 首次启动卡顿

RapidOCR 首次加载模型需要数秒,属正常现象。后续识别会快很多。

全局快捷键无效

可能被其他软件占用。修改 config.json 中 hotkey 字段换一个组合键,如 "ctrl+alt+s"。

开机自启动没生效

确认托盘菜单中「开机自启动」已勾选。程序通过注册表 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 实现,无需管理员权限。若 exe 路径变动需重新勾选。


📄 许可证

本项目采用 MIT License。

About

多功能悬浮窗

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages