一个轻量级 Windows 桌面截图钉图工具,集 截图 · 钉图 · OCR 文字识别 · 百度翻译 于一体。
单击桌面悬浮小圆标即可框选截图,截图会以置顶窗口"钉"在桌面上,随时提取文字、翻译或复制图片,不打断你的工作流。
| 功能 | 说明 |
|---|---|
| 🎯 悬浮 logo | 桌面始终置顶的小圆标,单击截图,可拖动到任意位置,右键菜单可显示/隐藏/退出 |
| 📌 钉图窗口 | 截图以无边框置顶窗口显示,拖动移动、滚轮缩放,不遮挡其他操作 |
| 🔤 提取文字 | 基于 RapidOCR 的离线文字识别,结果展示在下方面板,支持一键复制 |
| 🌐 百度翻译 | 调用百度翻译 API 将识别文字翻译为中文,按钮实时显示翻译进度百分比 |
| 📋 复制图片 | 将截图原图写入系统剪切板,可直接粘贴到微信聊天框、Word、笔记等 |
| ⌨️ 全局快捷键 | 默认 Ctrl+Shift+A 一键截图,可在配置文件中自定义 |
| 🚀 开机自启动 | 托盘菜单一键开关,写入注册表自动生效 |
| 🖥️ 系统托盘 | 托盘图标右键菜单:截图 / 显示隐藏悬浮窗 / 开机自启动 / 退出 |
- 操作系统:Windows 10 / 11
- Python:3.9 ~ 3.12
- 百度翻译 API:需自行申请(申请地址)
git clone https://github.com/LBL667/FloatScreen.git
cd FloatScreenpython -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt复制示例配置并填入你自己的百度翻译 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排除,切勿提交到仓库。
python main.py桌面出现蓝色小圆标,单击或按 Ctrl+Shift+A 即可截图。
- 单击桌面悬浮圆标,或
- 按
Ctrl+Shift+A(全局快捷键),或 - 右键托盘图标 → 「截图」
框选区域后自动生成钉图窗口。
| 操作 | 效果 |
|---|---|
| 拖动窗口 | 移动钉图位置 |
| 滚轮 ↑ | 放大 |
| 滚轮 ↓ | 缩小 |
| 翻译 | 识别文字并翻译为中文,按钮显示进度百分比 |
| 提取文字 | OCR 识别,结果显示在下方面板 |
| 复制图片 | 截图存入剪切板,可粘贴到微信 / 文档 |
| 删除 | 关闭钉图窗口 |
| 面板内 复制 | 复制识别/翻译文字 |
面板内 收起 / Esc |
关闭结果面板 |
右键托盘图标:
- 截图 — 立即开始框选
- 显示/隐藏悬浮窗 — 切换桌面圆标
- 开机自启动 — 勾选后开机自动运行(写入注册表)
- 退出 — 退出程序
使用 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。