PixWit

外观

PixWit 使用手册 ​

打开方式：托盘右键 → 帮助 → 使用手册（应用内打开本手册）；在线项目主页 gitee.com/bjs1999/PixWit。

手册里带默认值的快捷键，除标注为「系统内置」的外，都可以在 设置中心 → 快捷键设置 中修改；界面上看到的文案以实际程序为准。

目录 ​

快速上手 ​

主界面 ​

PixWit 启动后主界面是一条固定在屏幕上的细长工具条（宽 60px、始终置顶），从上到下依次是：

部位说明
拖动把手 ⋮⋮⋮按住即可把工具条拖到屏幕任意位置；也可以把图片 / 视频文件直接拖到主界面上打开
区域截图等同于按 F1，进入截图选区
打开图片打开图片或视频文件（提示为「打开图片/视频」）
录制屏幕开始录制屏幕（快捷键 F3）
底部 ×只隐藏主界面，程序继续在托盘常驻；要退出请用托盘菜单 → 退出

📷 插图占位（图 1）

主界面工具条 — 展示 60px 宽的置顶工具条：拖动把手、区域截图、打开图片、录制屏幕、底部 × 补图：图片放到 docs/public/images/main-toolbar.webp，然后删除本提示块并打开下一行注释

贴边自动隐藏（默认开启）：把主界面拖到屏幕边缘会自动吸附，鼠标移开后延时收起到屏幕边缘、只留一条细边（左右 8px、上下 6px），鼠标移回细边自动弹出；拖到桌面中间则不会自动隐藏。收起不等于退出，截图、录屏等快捷键照常可用。

单实例：重复启动 PixWit 不会开出第二个程序，而是把已有主界面显示出来并置顶。

托盘菜单 ​

右键托盘图标可看到全部入口（录制中会多出停止/暂停两项）：

菜单项作用
历史截图 → 🖼️ 快速浏览打开历史截图浏览窗口
历史截图 → 📂 打开历史文件夹用资源管理器打开历史截图目录
历史截图 → 📁 更改保存路径...修改历史截图保存位置，可选择把旧截图迁移过去
历史截图 → 🗑️ 清空历史记录删除历史目录里的截图文件
⏹️ 停止录制仅录制中出现，停止当前录制（菜单上会显示当前快捷键）
⏸️ 暂停录制 / ▶️ 恢复录制仅录制中出现，切换暂停与恢复
设置中心...打开设置中心（通用 / 截图 / 标注 / 录制 / 快捷键 / 保存 / AI 服务）
显示主界面（可勾选）勾选显示、取消隐藏；只影响当前这次运行，不写入配置
开机自动启动（可勾选）管理员账户通过任务计划、普通账户通过启动项实现开机自启
🌙 深色主题 / ☀️ 亮色主题（可勾选）切换深色 / 亮色主题
🌐 语言 / Language中文、English、日本語、한국어、Français、Español、Русский、Português（切换后部分界面需重启生效）
帮助 → 使用手册打开本手册
帮助 → 检查更新手动检查新版本
帮助 → 停止检查更新（可勾选）关闭「启动后自动检查更新」
帮助 → 反馈与建议复制 QQ 群号并弹出提示
帮助 → 打开日志文件打开日志目录，排查问题用
帮助 → 🌐 官方网站打开 pixwit.cn
帮助 → 关于 PixWit查看版本与联系方式
退出退出程序；正在录制时会先确认

📷 插图占位（图 2）

托盘右键菜单 — 展示历史截图、设置中心、显示主界面、开机自动启动、主题、语言、帮助等全部入口 补图：图片放到 docs/public/images/tray-menu.webp，然后删除本提示块并打开下一行注释

截图功能 ​

触发与取消 ​

  • 默认快捷键 F1，也可以点主界面 区域截图，或在通用设置里把托盘的某个键设为「区域截图」。
  • 选区完成后会打开编辑窗口；编辑窗口打开时再按一次截图键 = 把当前图直接转成贴图。
  • 有模态对话框弹出或程序正在处理其它任务时，按热键不会响应。
  • 勾选 全屏截图（按快捷键直接截取整个屏幕） 后，按热键会立刻抓取鼠标所在屏幕的整屏，自动复制到剪贴板并打开编辑窗口，不再进入选区。

选区操作 ​

屏幕上会显示当前可用的操作提示（左上角，可在设置里关掉「显示操作提示信息框」）：

状态提示
正在拖拽拖拽选择区域，ESC取消
已选中拖拽边框调整，ESC取消
已自动检测到窗口/控件Tab/滚轮切换，单击/Enter确认，ESC取消
未检测到拖拽选区，C取色，Tab切换，ESC取消

鼠标与键盘：

操作效果
左键拖拽新建选区
拖边缘 / 四角调整大小（边缘 12px 内响应，共 8 个手柄）
在选区内拖动整体移动选区
在选区外点击（自由模式）最近的一条边跳到点击位置并继续拖拽
右键取消本次截图（不复制、不保存）
双击快速确认：复制 + 存历史 + 关闭窗口
单击检测到的窗口/控件直接确认为选区
Enter / Space确认为选区（Space 仅在已检测到窗口/控件时有效）
Enter（已选中时）快速确认：复制 + 存历史 + 关闭
Ctrl+C复制并进入编辑窗口
Ctrl+X复制并关闭
Ctrl+S保存（弹出保存对话框）并关闭
Esc取消整场截图
方向键逐边微调选区：默认向外扩 1px，Shift 向内缩 1px，Ctrl 步长 10px
  • 选区小于 10×10 像素会被视为无效并自动取消。
  • 选区模式（设置中心 → 截图设置 → 选区设置）：
    • 自由选区（默认）；
    • 固定比例：可选 1:1（正方形）、4:3、9:16（竖屏）、16:9（横屏）；
    • 固定尺寸（印章模式）：可选 800×600 / 1024×768 / 1280×720 / 1920×1080 / 500×500 / 自定义（10~9999 px）。此模式下左键单击即放置并确认选框，只能移动不能缩放。
  • 遮罩透明度默认 50：0 时未选中区域全黑，100 时完全透明。滑杆实时生效。
  • 允许跨屏截图默认关闭；关闭时选区限制在鼠标所在屏幕内。多屏且各屏缩放比例不同时建议保持关闭。
  • 选区旁边会显示尺寸数字，形如 1920 x 1080；有比例/尺寸约束时追加 1:1、[800×600] 之类的标记。

📷 插图占位（图 3）

区域截图选区 — 建议同框展示：选区尺寸数字、8 个缩放手柄、UI 检测框、左上角操作提示 补图：图片放到 docs/public/images/selection-and-detect.webp，然后删除本提示块并打开下一行注释

UI 检测模式 ​

设置中心 → 截图设置 → 窗口检测提供三种模式（默认「无」）：

模式说明
无（不框选）不自动框选，性能最好
仅窗口模式（快速）自动框选窗口边界，响应快，推荐日常使用
仅元素模式（精细）自动框选窗口内的具体控件，最精确但较慢
  • 选区状态下按 Tab 可循环切换 无 → 仅窗口 → 仅元素 → 无，右上角会提示 检测模式: 仅窗口模式（取值是 无检测 / 仅窗口模式 / 仅元素模式，约 3 秒后消失），切换结果会被记住。
  • 多个窗口/控件重叠时，用滚轮在同一位置的不同层级之间循环（上滚选更内层、更小的元素，下滚选更外层、更大的窗口）。
  • 确认为选区：单击检测框，或按 Enter / Space。
  • 元素检测会优先走 MSAA，遇到不支持的程序自动回退到 UIA；检测失败或超时时不会弹出任何提示，把鼠标移开再移回、或用滚轮换一层即可重试。

截图工具栏 ​

工具栏按钮的显隐与顺序可以完全自定义（设置中心 → 标注设置 → 工具栏按钮，详见「截图编辑与标注」章节）。默认从左到右是：截图/录制切换、箭头、画笔、矩形、圆形、直线、折线、文字、序号、马赛克、撤销、裁剪纯色边框、滚动截图、文字识别、识别二维码/条形码、AI下拉菜单、水印、关闭、保存、贴图、复制；翻译、提取表格、提取LaTeX公式、LLM解读、AI对话这 5 个默认隐藏。

几点补充：

  • AI 下拉菜单：左键点主按钮执行当前「默认操作」，左键点 ▼ 打开菜单选择其它功能（翻译还带 10 种目标语言子菜单）；菜单里的「⚙ 设为默认操作」可以改主按钮的默认功能。
  • 水印按钮是可勾选开关，选中即显示水印、取消即隐藏（水印参数在标注设置页）。
  • 录制模式下工具栏只显示录制三件套：区域/全屏、视频/GIF、开始录制。

📷 插图占位（图 4）

截图编辑窗口工具栏 — 标注展示 AI 下拉菜单展开态、水印开关选中态，以及右侧关闭/保存/贴图/复制 补图：图片放到 docs/public/images/editor-toolbar.webp，然后删除本提示块并打开下一行注释

滚动截图 ​

先框好区域，再点工具栏的 滚动截图：

  • 左键 = 按上次记忆的模式直接开始；右键 = 弹出 自动 / 手动 选择菜单并立即按该模式开始（默认自动）。
  • 自动模式由程序每 0.5 秒滚动一次并拼接；鼠标移出选区会自动暂停，移回选区自动继续。手动模式需要你自己滚动页面。
  • 控制条上的状态文字会依次显示：正在滚动截图... 高度: N px · 鼠标移出选区暂停、已暂停 (N px) · 移回选区自动继续、请手动滚动页面...、手动模式 高度: N px、↓ 向下扩展 (Enter完成)。
按键功能
Enter（第一下）结束滚动，进入手动微调阶段（按钮提示变为「完成截图 (Enter)」）
Enter（第二下）完成并出图
Esc取消滚动截图，丢弃结果
↓ / ↑微调阶段向下扩展 / 向上收 5px
Shift+↓ / Shift+↑同上，步长 50px
滚轮（微调阶段）扩展/收缩选区，一格约 30px

完成后的结果：自动生成贴图（水平居中于原选区、顶部对齐），并自动复制到剪贴板、存入历史记录。滚动截图本身不会自动写文件；在贴图窗口右键「💾 保存」才会弹出 保存滚动截图 对话框（默认文件名前缀 PixWit_scrolling）。

📷 插图占位（图 5）

滚动截图控制条 — 展示自动/手动模式状态文字与「完成截图 (Enter)」按钮 补图：图片放到 docs/public/images/scroll-capture.webp，然后删除本提示块并打开下一行注释

拾色器 ​

拾色器默认启用（设置中心 → 截图设置 → 启用拾色器），只在截图模式下生效。

  • 放大镜为 110×110 px、8 倍放大，跟随光标显示在右下 20px，靠近屏幕边缘时自动翻到另一侧。
  • 信息面板与放大镜等宽，依次显示色块、色值和坐标；坐标是当前屏幕内的逻辑坐标，用键盘微调后会追加偏移量，如 [+5, -3]。
按键功能
C复制当前颜色到剪贴板，并在约 0.2 秒后关闭截图窗口（面板下方提示 已复制到剪贴板！）
Shift（单按）循环切换颜色格式：RGB → #HEX → HEX，选择会被记住
方向键微调取色点 1 像素
Shift + 方向键微调 10 像素
R重置微调偏移，回到鼠标位置
右键退出截图

复制内容只含色值、不含坐标，格式随「颜色格式」变化（默认 #HEX）：

颜色格式复制内容
RGB(255, 128, 64)
#HEX#FF803F
HEXFF803F

鼠标微调过取色点时，放大镜边框会变成橙色提醒。

📷 插图占位（图 6）

拾色器放大镜 — 展示 110×110 放大镜、色块/色值/坐标面板、橙色微调边框 补图：图片放到 docs/public/images/color-picker.webp，然后删除本提示块并打开下一行注释

水印 ​

水印的开关在截图工具栏的水印按钮上（默认关闭），参数在 设置中心 → 标注设置 → 水印设置：

设置项默认值说明
水印文字：PixWit最长 100 字
字号：248~72 px
颜色：半透明灰点击色块选择（支持透明度）
水印字体：默认（微软雅黑）可改系统字体
位置：右下角左上角 / 右上角 / 左下角 / 右下角 / 平铺（倾斜45°）
边距：200~200 px
平铺间距：150仅「平铺」位置时显示
同时添加日期时间不勾选勾选后可选时间格式
时间格式：yyyy-MM-dd HH:mm:ss6 种格式可选

选区阶段和编辑窗口里都会实时预览水印效果，输出时会真正烧录进图片。设置页本身不提供预览图。

📷 插图占位（图 7）

水印效果与设置 — 建议同框展示：右下角水印文字 + 平铺（倾斜45°）+ 标注设置里的水印参数 补图：图片放到 docs/public/images/watermark.webp，然后删除本提示块并打开下一行注释

保存与提示 ​

  • 保存对话框标题为 保存截图，可保存为 PNG / JPEG / WebP / BMP，也支持导出 PDF。
  • 勾选 截图保存提示窗口 后，保存成功会弹系统通知「截图保存成功 / 已保存：<文件名>」（默认关闭）。
  • 复制后关闭窗口 默认开启：截图里点「复制」或按 Ctrl+C 后窗口关闭。
  • 拖拽选区后自动完成截图 默认关闭：开启后松手即完成截图，不再进入编辑窗口。
  • 启用 OCR 索引 默认关闭：开启后截图会在后台做文字识别，可在历史截图里按文字搜索。

截图设置页速查 ​

分组设置项默认
选区设置遮罩透明度、窗口检测、全屏截图、允许跨屏截图、选区模式（+ 比例 / 尺寸）50、无、关、关、自由选区
交互行为启用拾色器、复制后关闭窗口、双击复制截图且关闭窗口、拖拽选区后自动完成截图开、开、开、关
提示与显示截图保存提示窗口、显示操作提示信息框、显示直线长度标签、HDR曝光补偿关、开、关、100（仅 HDR 屏显示）
贴图设置隐藏贴图边框关
图像处理启用 OCR 索引、裁剪容差、裁剪边距关、30、5

📷 插图占位（图 8）

截图设置页 — 五组设置：选区设置 / 交互行为 / 提示与显示 / 贴图设置 / 图像处理 补图：图片放到 docs/public/images/settings-screenshot.webp，然后删除本提示块并打开下一行注释

截图编辑与标注 ​

截图选区完成后会打开编辑窗口，所有绘制工具都在一个可拖动的浮动工具栏上。

工具栏按钮 ​

工具栏按钮可以自由增删与排序（设置中心 → 标注设置 → 工具栏按钮）。默认从左到右：

按钮悬停提示说明
截图/录制切换切换到录制模式在截图与录制之间切换；编辑窗口里不显示
箭头箭头 (右键: 无文字框/带文字框)画箭头，可带图注文字
画笔画笔自由手绘
矩形矩形 (右键: 填充/描边)画矩形（可按「默认圆角半径」带圆角）
圆形圆形 (右键: 填充/描边)画椭圆
直线直线 (右键: 实线/虚线)画直线，也可拖成弧线
折线折线 (右键: 实线/虚线)连续多段折线
文字文字内联文字标注
序号序号 (再次点击重置,选中输入数字修改)自动递增的序号标记
马赛克马赛克马赛克遮挡，也可用于抹除文字
撤销撤销 (Ctrl+Z)撤销上一步
裁剪纯色边框裁剪纯色边框自动裁掉图片四周的纯色边框
滚动截图滚动截图 (右键: 自动/手动)长截图
文字识别文字识别 (Ctrl+O)OCR
识别二维码/条形码识别二维码/条形码扫码取内容
AI下拉菜单点击下拉箭头选择其他功能AI 功能主按钮 + ▼ 菜单
水印添加/取消水印水印开关（选中=显示，取消=隐藏）
关闭关闭 (Esc)直接关闭、不保存不复制
保存保存 (Ctrl+S)保存到文件
贴图贴图 (F1)把当前图钉在屏幕上
复制复制 (Ctrl+C)复制到剪贴板，窗口保持打开

另有 5 个 AI 按钮默认不显示，需要时在设置里添加到工具栏：翻译 (Ctrl+T)、提取表格 (Ctrl+E)、提取LaTeX公式 (Ctrl+M)、LLM解读 (Ctrl+I)、AI对话 (Ctrl+D)。

工具右键菜单 ​

只有下面 6 个按钮带右键菜单（其余工具的样式在「样式弹窗」里改）。菜单是单选带勾选的，选完会立即激活该工具，并且既影响以后新画的图形，也会作用于当前选中的同类图形：

按钮右键菜单项记忆说明
圆形 / 矩形描边 / 填充按工具分别记忆填充模式用线条颜色 + 透明度填充，填充后无描边
直线 / 折线实线 / 虚线按工具分别记忆实时预览，保存与导出都按虚线绘制
箭头无字 / 有字记忆选「有字」后画完箭头自动弹出图注输入框；选「无字」会清空选中箭头的图注
滚动截图自动 / 手动记忆选定后立即按该模式执行；平时左键点击按记忆的模式执行

样式弹窗 ​

左键点击任一工具按钮会弹出该工具的样式弹窗（不抢焦点，可边调边画）。不同工具显示不同控件：

控件适用工具操作默认
粗细圆点全部圆点越大越粗；滚轮 ±13
8 个预设色 + 自定义颜色全部点色块改颜色；「自定义颜色...」打开取色对话框—
透明度圆点画笔、直线、折线、箭头、圆形、矩形；文字（有边时）滚轮 ±5（棋盘格底显示实际浓淡）100（完全不透明）
箭头形状箭头经典箭头 / 锥形箭头锥形箭头
马赛克形状马赛克画笔形状 / 矩形形状 / 启用文本抹除画笔形状，文本抹除关闭
序号样式序号空心圆 / 无圆 / 实心圆空心圆（实心圆仅在截图编辑窗口提供）
文字边框文字无边 / 有边无边

透明度按「透明度」显示：界面里的数值是「透明度」，0% 最实、100% 完全透明，向上滚一格更透明。普通工具最低到 10%；填充的矩形/圆形和文字底框可以到 0%（只剩边框）。

📷 插图占位（图 9）

工具样式弹窗 — 展示粗细圆点、8 个预设色、透明度圆点（棋盘格底）、箭头形状等控件 补图：图片放到 docs/public/images/style-popup.webp，然后删除本提示块并打开下一行注释

画布操作 ​

操作效果
左键拖动用当前工具绘制；点空白拖动可移动编辑窗口
Space（按住）+ 拖动抓手模式移动窗口
点选标注单击对象本体选中；填充的矩形/圆形点内部即可选中；点空白取消选中
拖动选中对象整体移动；拖 8 个控制点缩放（直线/箭头是起点/中点/终点 3 个点，画笔没有控制点）
Shift + 画直线/箭头角度吸附 15°
Shift + 画圆形/矩形约束为正圆 / 正方形
Shift + 点预设色文字「有边」时，取该颜色作为边框色（而不是文字色）
Tab在可标注对象间循环选中（鼠标附近有多个重叠对象时优先在这几个之间循环）
Delete / Backspace删除选中的标注
Ctrl+Z撤销：编辑文字时取消编辑、折线中丢弃折线、绘制中取消本次绘制，否则删除最后一个标注 / 还原截图图像（没有重做）
滚轮调整当前工具的粗细（±1）；序号调半径
Shift + 滚轮调整不透明度（±5）
填充的矩形/圆形 + 滚轮直接调整填充透明度
文字 / 图注编辑中滚轮调整字号（±2，范围 8~160）
右键折线绘制中=结束折线；否则=直接退出编辑窗口，不保存也不复制
双击折线中=结束折线；正在绘制/待建文本框=取消；双击箭头=编辑或添加图注；其它情况=复制并关闭（可在截图设置里关闭「双击复制截图且关闭窗口」）
Enter在没有折线、序号编辑、文字焦点时=复制并关闭

调整会即时提示：粗细: N px、透明度: N%、透明度: N%（聚光灯 N%）、字体: N pt。「显示直线长度标签」打开后还会显示 N px（默认关闭）。

聚光灯：填充的矩形/圆形把透明度滚到 100% 后继续向上滚，会从填充切换为「聚光灯」浓度叠加，提示会变成 透明度: N%（聚光灯 N%）——即整张图压暗、只留所选区域清晰。

各工具细节 ​

折线

  • 按下拖出一段、松手确认该段（位移过小视为误点忽略），移动鼠标即可预览下一段。
  • 结束：双击 / 右键 / Enter，或切换到其它工具时自动完成；顶点少于 2 个则整条丢弃。
  • 取消：Esc（整条丢弃）。退点：Backspace / Delete 删掉最后一个点，只剩一个点时整条取消。

序号

  • 单击画布新增序号并自动递增；再次点击序号按钮会把序号重置为 1，并提示 序号已重置为 1。
  • 改单个序号：选中后直接按数字键累积输入（实时生效），Backspace 退位，Enter 确认，Esc 恢复原值；切换到别的对象时会自动确认。
  • 大小：选中后滚轮改半径，或拖动控制点。
  • 样式三态：空心圆（默认）、无圆（只有数字，字号更大）、实心圆（实心填充 + 白字）。

箭头

  • 形状可选 经典箭头（线 + 三角头）或 锥形箭头（实心锥形），默认锥形。
  • 带文字框：右键选 有字 后，画完自动弹出图注输入框；双击箭头可再次编辑或补加图注；图注固定为白底圆角 + 细灰边框，并跟随箭头移动。
  • 拖中部变弯：选中直线或箭头后拖中点控制点，可把它弯成弧线；控制点拖回中点附近自动恢复直线。锥形箭头太短时不支持弯曲（会退回成整体移动），箭头变长后恢复弯曲能力。

文字

  • 选中文字工具后在画布单击，稍候会出现内联输入框；Esc 取消、Ctrl+Enter 确认、点击输入框外也会自动确认；内容为空则不生成标注。
  • 默认字号 21px（可调 11~96），字体取自行「文字标注字体」（默认跟随系统）。
  • 重新编辑：点文字本体即可进入编辑（注意选中文字时不显示控制点，点四个角附近可能变成缩放）。
  • 有边 模式可加底框：Shift + 滚轮 调底框填充不透明度（最低 0%，只剩边框），Shift + 点预设色 / 自定义颜色 改边框色。

马赛克

  • 形状可选画笔（自由涂抹）或矩形；勾选「启用文本抹除」后更适合处理文字区域。

保存、复制与关闭 ​

操作说明
保存（按钮 / Ctrl+S）先自动确认正在输入的文字与图注，渲染全部标注后保存到文件，约 0.1 秒后窗口自动关闭
复制（按钮 / Ctrl+C）复制到剪贴板，窗口保持打开，可以继续编辑
复制并关闭（Ctrl+X 或 Enter）复制到剪贴板、写入历史并关闭窗口（没有对应的工具栏按钮）
关闭（按钮 / Esc）直接关闭，不保存不复制。Esc 是三级级联：先取消正在进行的编辑 → 再取消工具选择 → 最后关闭窗口
贴图（按钮）把结果钉在屏幕上
裁剪纯色边框以左上角像素为参考色，自动裁掉四周纯色边框；检测不到边框就不动作；裁剪成功后直接进入贴图并关闭。容差与保留边距在 设置中心 → 截图设置 → 图像处理 里调整
撤销同 Ctrl+Z

编辑窗口始终置顶，没有置顶开关；旋转、格式转换、打印等操作在图片查看器里。

贴图与剪贴板 ​

什么是贴图 ​

贴图是把一张图钉在屏幕上当参考（俗称「便签」）：无边框、始终置顶、可缩放、可调透明度。贴图在创建时会自动复制到剪贴板，并写入历史截图。

产生贴图的 4 种方式：

  1. 截图工具栏点击 贴图 按钮；
  2. 选区还在屏幕上时，再按一次截图快捷键（默认 F1）直接转成贴图；
  3. 滚动截图完成后自动生成贴图；
  4. 按 Ctrl+Shift+V 把剪贴板里的内容贴出来。

贴图窗口操作 ​

操作效果
按住左键拖动移动贴图
拖边缘 / 四角缩放（10% ~ 500%），缩放时对侧锚点保持不动
滚轮平滑缩放，每格 8%；接近 100% 时磁吸到 100% 并提示 ✓ 100%
Ctrl + 滚轮调透明度，每格 0.1（不透明度范围 10% ~ 100%），浮层显示 透明度 N%
双击复制到剪贴板并关闭窗口
Shift + 点图片边缘进入裁剪模式
空格进入编辑模式（等同于右键「✏️ 编辑」，会打开截图编辑窗口）
Esc普通模式=关闭贴图（不复制）；裁剪模式=退出裁剪
Enter裁剪模式下确认裁剪
Ctrl+S / Ctrl+C保存 / 复制
Ctrl+X复制并关闭
Ctrl+0 / Ctrl+= / Ctrl+-缩放重置 100% / 放大 1.3 倍 / 缩小
Ctrl+Z撤销裁剪（最多可退 20 步）

贴图右键菜单 ​

菜单项说明
✏️ 编辑（Space）打开截图编辑窗口继续编辑，编辑完成后按原位置生成新贴图
💾 保存（Ctrl+S）保存贴图，默认文件名前缀 PixWit_sticky
📋 复制（Ctrl+C）复制到剪贴板
✂️ 裁剪进入裁剪模式
🔄 旋转 → ↩️ 向左旋转 90° / ↪️ 向右旋转 90°旋转贴图
↔️ 镜像水平翻转
👁 透明度 → 0% (不透明) / 25% / 50% / 75%按「透明度」命名：0% 最实、75% 最淡；更细的调整用 Ctrl+滚轮
❌ 关闭关闭当前贴图（不复制）
🚫 关闭所有贴图屏幕上存在 2 张及以上贴图时才出现；逐张关闭且不复制

裁剪模式下的右键菜单只有两项：✅ 确认裁剪（Enter）、❌ 取消裁剪（Esc）。

📷 插图占位（图 10）

贴图窗口与右键菜单 — 展示置顶贴图、透明度档位菜单、关闭所有贴图 补图：图片放到 docs/public/images/sticky-window.webp，然后删除本提示块并打开下一行注释

裁剪贴图 ​

  • 进入裁剪模式后，裁剪框带黑色遮罩、白色边框与三分法虚线网格，可拖动移动、拖 8 个控制点缩放（最小 5%），底部显示像素尺寸。
  • Enter 确认：就地裁剪当前贴图并退出裁剪模式，可以 Ctrl+Z 撤销。
  • Esc 取消裁剪，图片保持原样。
  • 右键菜单里的 ✅ 确认裁剪 与 Enter 的实现路径不同：它会生成一张新贴图并关闭原贴图，且不进入撤销栈。日常建议用 Enter / Esc。

剪贴板贴图（Ctrl+Shift+V） ​

  • 设置中心 → 快捷键设置里的「🖼️ 剪贴板贴图」默认是 Ctrl+Shift+V。
  • 按一次：把剪贴板里最新的图片贴到光标位置（以首次按下时的光标为锚点，多张之间按 30px 网格错位排布，不会贴到屏幕外）。
  • 连按：依次往前贴出剪贴板历史里的第 2 张、第 3 张……一轮最多 10 张，超过 5 秒没有继续按就重新从最新一张开始（走到最旧后也会重新从头一轮）。
  • 剪贴板里是文本时，会先渲染成一张浅色便签卡片再贴出（白底圆角、最大宽度 720px、最高约屏幕的 70%，单次最多 2 万字符，超出会显示 …（已截断））；贴出后它就是图片，双击复制到剪贴板的是图片。卡片本身没有可点的按钮。
  • 剪贴板里是复制的图片文件时（历史为空的情况），最多贴出 3 张。
  • 剪贴板历史只保存在内存里（上限 10 张 / 256MB），退出程序即清空，也不会进入历史截图库；如果剪贴板和历史都没有内容，按快捷键不会有反应。

📷 插图占位（图 11）

文本剪贴板贴出的便签卡片 — 展示白底圆角卡片、最大宽度限制与截断提示 补图：图片放到 docs/public/images/clipboard-text-card.webp，然后删除本提示块并打开下一行注释

贴图相关设置 ​

设置中心 → 截图设置 → 贴图设置：

设置项默认说明
隐藏贴图边框（不显示蓝色发光边框）关勾选后新贴图不带蓝色发光边框

录屏功能 ​

开始录制 ​

三种入口：

  1. 主界面点 录制屏幕；
  2. 按录制快捷键（默认 F3，再按一次即停止）；
  3. 把托盘的左/中/右键单击行为设为「开始/停止录制」后点托盘图标。

录制范围有两种（设置中心 → 录制设置 → 🎯 录制模式）：

  • 区域录制：先用选区框出范围，再点工具栏的「开始录制」；录制中还能用工具栏在两个范围之间切换。
  • 全屏录制：直接录鼠标所在的那块屏幕。

点击开始后有 3 秒倒计时（屏幕中心显示半透明黑圆和数字，底部文字「即将开始录制...」，鼠标可穿透）。倒计时期间 Esc 不生效；想反悔可以再按一次 F3 或点主界面录制按钮取消。

录制中的状态提示：

场景提示
区域录制录制区四角显示红色闪烁的 L 形角标（暂停时变绿色）；工具栏状态文字依次为 ⚪ 准备录制、🔴 录制中 00:00:00、⏸️ 已暂停、⏳ 正在处理...
全屏录制屏幕四周显示一圈红色闪烁边框（暂停时绿色常亮），并显示悬浮控制窗
托盘弹出气泡「区域录制已开始 / 全屏录制已开始」，提示「再按 F3 停止录制」；托盘提示文字变为 PixWit - 🔴 录制中（按F3停止）

📷 插图占位（图 12）

录制状态与控制 — 建议同框展示：区域录制红色 L 角标 + 全屏录制悬浮控制窗（时长与 FPS） 补图：图片放到 docs/public/images/recording-control.webp，然后删除本提示块并打开下一行注释

录制中控制 ​

操作入口
暂停 / 恢复快捷键 F4（只在录制中生效）、控制窗按钮、区域录制工具栏按钮、托盘「⏸️ 暂停录制 / ▶️ 恢复录制」
停止快捷键 F3、控制窗「停止」、区域录制工具栏「停止录制」、托盘「⏹ 停止录制」

暂停期间不计入录制时长，也不会录到画面与声音。

全屏录制的控制窗显示暂停/恢复、停止按钮、时长 00:00:00 和实时帧率 FPS: 实际/目标 (百分比)。右上角的 ✕ 在录制中点击会先确认，确认后会停止录制并丢弃这次录制。

停止后先弹出「处理中 / 正在处理录制文件，请稍候...」，等待混流或转码完成。

画面上的鼠标与按键（设置中心 → 录制设置 → 录制效果）：

  • 录制时显示鼠标点击位置：点击处画一个橙色扩散圆环——只在视频里可见，屏幕上不会出现。
  • 录制时显示键盘按键：按下的按键在画面底部居中显示（黑底蓝字，最多同时 3 个，约 1.5 秒淡出）。
  • 录制时显示鼠标光标、全屏录制时显示快捷键提示窗口、全屏录制时显示控制工具栏（不被录入） 也在此组。

录制时标注 ​

标注工具的入口在两条录制路径上略有不同：

路径可用按钮
区域录制（选区工具栏）恢复鼠标穿透（按Esc）、直线标注、箭头标注、圆形标注、矩形标注、撤销标注
全屏录制（控制窗）画笔、直线、箭头、圆形、矩形、撤销、样式（颜色和粗细）

默认快捷键（只在录制过程中注册，停止录制后失效）：

快捷键功能
Alt+I画直线
Alt+J画箭头
Alt+O画圆形
Alt+K画矩形
Alt+Esc退出标注（恢复鼠标穿透）
  • 标注工具未选中时鼠标完全穿透，不影响你操作其它软件；选中工具后即可在屏幕上绘制，圆形/矩形按住 Shift 可约束为正圆/正方形。
  • 控制工具栏所在的区域是排除区，不能在上面标注；录制中的鼠标点击与按键提示同样会进入视频。
  • 若在「📸 录制时截图」里勾选了 录制时允许截图，录制期间不会再创建标注窗口，也就是录制中无法标注。

摄像头画中画 ​

  • 开关：录制设置 → 📹 摄像头（画中画）→ 启用画中画（仅全屏录制），默认关闭；勾选会自动切换到全屏录制（区域录制不支持画中画）。
  • 使用前先点 🔍 检测摄像头，在下拉框里选择设备（首项为「不使用摄像头」），再用 👁️ 预览摄像头 验证画面。
  • 录制中摄像头画面固定在录制屏幕的右下角（宽 320px，高度按摄像头比例），左键拖动预览窗可以换位置，位置即最终视频中的位置；摄像头分辨率由程序自动择优。
  • 常见失败提示：「未检测到摄像头，无法启用画中画录制。请连接摄像头后重试」「摄像头预热失败，无法开启画中画录制」「无法启动摄像头，画中画录制失败。请检查摄像头是否被其他程序占用」。

📷 插图占位（图 13）

摄像头画中画 — 展示右下角 320px 宽的摄像头预览窗与录制设置里的检测/预览按钮 补图：图片放到 docs/public/images/camera-pip.webp，然后删除本提示块并打开下一行注释

音频 ​

录制设置 → 🔊 录制声音，四选一：

选项说明
静音（无声音）不录任何声音
系统声音（推荐）默认选项，录制电脑播放的声音
麦克风只录麦克风
系统声音 + 麦克风同时录两路，此时才显示「🔉 音量控制」组
  • 选 GIF 格式时声音会被强制设为「静音」（GIF 不支持音频），改回 MP4/MKV 会自动选回「系统声音」。
  • 音量控制：系统声音默认 100%、麦克风默认 150%，范围 0–500%。
  • 检测麦克风 / 录音测试 / 播放：检测到设备后可以录 2 秒试听，确认麦克风工作正常。
  • 若系统没给麦克风权限，会提示到「Windows 设置 → 隐私和安全性 → 麦克风」里打开访问权限并允许桌面应用使用。

输出格式与画质 ​

设置项选项说明
📼 输出格式MP4 视频（推荐，兼容性好）/ MKV 视频（高级，可靠性更好）/ GIF 动图默认 MP4
🎬 视频质量清晰（文件较大，质量最好，CRF 18）/ 均衡（推荐，CRF 23）/ 压缩（文件最小，CRF 28）默认均衡；GIF 格式下该组仍生效，用来决定 GIF 的色数与抖动
🎞️ 帧率1–120 fps，默认 15；预设 6 / 10 / 15 / 20 / 30 / 60 fps「禁用自适应帧率（强制保持设定帧率）」默认关闭；录制中会用 FPS: 实际/目标 提示性能，掉帧严重时给出优化建议
🎨 GIF 高级设置⚡ 快速模式（默认，停止即刻完成）/ 🎬 标准模式（停止后处理，画质更好）/ 🎨 最佳画质（两趟调色板分析）仅选 GIF 时显示
⚙️ 编码与性能优先使用硬件编码（推荐，降低CPU占用）默认开启；🔍 检测可用编码器会显示推荐编码器（如 h264_nvenc（NVIDIA GPU加速））；硬件编码不可用时自动回落到 CPU 编码。若遇到花屏/黑屏/启动失败，可关闭硬件编码

其它与录制相关的行为：

  • 分段录制：长时间录制会自动按每段 10 分钟分段，停止时再合并；界面上没有开关，合并失败会提示「视频分段合并失败」，表现为停止后的处理时间更长。
  • 低配置模式（设置中心 → 通用设置）会限制录制帧率不超过 10fps，并关闭鼠标点击与按键叠加。
  • 首次使用录屏会提示下载视频编码组件（约 94MB，只需下载一次，之后可离线使用）。

录制结束 ​

  1. 弹出保存对话框（标题为 保存视频 或 保存GIF），默认文件名由 保存设置 里的前缀（默认 PixWit_录屏）、分隔符（默认 _）和时间戳拼成，默认目录是上次保存的目录或桌面。
  2. 保存完成弹出「录制完成」对话框，含完整路径与三个按钮：▶️ 打开（GIF 为 🖼️ 打开，同时把路径复制到剪贴板）、✂️ 编辑、📂 打开文件夹。
  3. 视频会打开「编辑音视频」窗口（✂️ 裁剪 / 🗜️ 压缩 / ⚡ 变速 / 🔄 格式转换 / 🎙️ 配音 / 🔪 音频切分），GIF 会打开「编辑 GIF 动图」窗口（裁剪 / 变速 / 调整尺寸 / 帧编辑）。
  4. 如果保存对话框里点了取消，本次录制的临时文件会被删除。

录制设置页速查 ​

分组主要设置项默认
🎯 录制模式区域录制 / 全屏录制区域录制
⚙️ 编码与性能优先使用硬件编码、检测可用编码器优先硬件编码
录制效果鼠标光标、鼠标点击位置、键盘按键、全屏快捷键提示、全屏控制工具栏除「键盘按键」外均开启
📹 摄像头（画中画）启用画中画、选择摄像头、检测/预览关闭
📸 录制时截图录制时允许截图关闭
📼 输出格式MP4 / MKV / GIFMP4
🎨 GIF 高级设置快速 / 标准 / 最佳画质快速模式
🎬 视频质量清晰 / 均衡 / 压缩均衡
🎞️ 帧率帧率数值与预设、禁用自适应帧率15 fps
🔊 录制声音静音 / 系统声音 / 麦克风 / 系统声音+麦克风系统声音
🔉 音量控制系统声音、麦克风（仅双录时显示）100% / 150%

录制设置页的改动需要点设置中心底部的 应用 或 确定 才会保存。

📷 插图占位（图 14）

录制设置页 — 展示录制模式、编码与性能、录制效果、摄像头、输出格式、帧率、声音等分组 补图：图片放到 docs/public/images/settings-recording.webp，然后删除本提示块并打开下一行注释

图片查看器 ​

打开图片 ​

  • 主界面 打开图片 按钮，或把图片/视频文件拖到主界面上；
  • 历史截图里双击卡片或点卡片上的「预览」；
  • 从命令行或文件关联打开（程序已在运行时会在现有窗口里打开）。

支持格式：PNG、JPEG、BMP、GIF、WebP、SVG、ICO；GIF / APNG / WebP 动画会自动播放。打开后窗口最大化，图片按 100% 显示。

查看操作 ​

操作效果
滚轮以鼠标位置为中心缩放（每格 1.1 / 0.9，范围 10% ~ 1000%）；接近 100% 时磁吸并提示 ✓ 100%
Ctrl + 滚轮任何模式下都强制缩放图片
Space + 滚轮缩放
中键单击跳到 100% 原始尺寸（提示 ✓ 100% 原始尺寸）
Space + 左键拖动平移画布（任何模式可用）
左键拖动（查看模式）平移画布
双击在适应窗口与 100% 原始尺寸之间切换
0 / 1适应窗口 / 原始尺寸
F切换全屏
+ / = / -放大 / 缩小
← / →上一张 / 下一张（查看、标注模式；Ctrl+←/→ 任何模式都可用）
PageUp / PageDown上一张 / 下一张（任何模式）
Delete / Backspace删除选中的标注对象（不会删图片）
Ctrl+Z撤销（最多 20 步）
Ctrl+S / Ctrl+P保存 / 打印
Esc逐级退出：退出标注模式 → 取消裁剪 → 取消矫正 → 关闭窗口
  • 画布左上角常驻一行操作提示：缩放: N% | 滚轮/Ctrl+滚轮:缩放 | 左键拖拽/Space:平移 | 双击:适应/原始 | ESC:退出。
  • 工具栏是「动则现、停则藏」：移动鼠标、滚轮、点击或按键会唤出，静止 3 秒后自动隐藏。
  • 切换图片时若当前有未保存的编辑，会先确认（保存并切换 / 不保存 / 取消 / 不再提示，直接切换）。

📷 插图占位（图 15）

图片查看器 — 展示工具栏、左上角缩放操作提示、标注对象选中态 补图：图片放到 docs/public/images/image-viewer.webp，然后删除本提示块并打开下一行注释

工具栏按钮 ​

从左到右（纯图标按钮，鼠标悬停可看到名称）：

按钮说明
裁剪进入裁剪模式
旋转图片直接逆时针旋转 90°
透视矫正四点矫正
调整图片尺寸和质量打开「调整图片」侧栏
画笔 / 直线 / 箭头 / 圆形 / 矩形 / 马赛克 / 输入文字标注工具
序号标注提示为 序号标注 [下一个: N] (再次点击重置)；再次点击序号按钮会重置为 1 并提示 序号已重置为 1
撤销等同于 Ctrl+Z
OCR识别对当前图片做文字识别
打印 / 保存等同于 Ctrl+P / Ctrl+S

裁剪 ​

裁剪模式顶部会出现一条裁剪工具栏：

  • 矩形 / 椭圆切换；椭圆裁剪的结果是透明背景。
  • 「应用裁剪」「取消」。
  • 比例下拉：不限比例、1:1 (正方形/头像)，以及证件照分组（1寸照、2寸照、小1寸、身份证照、护照照）。
  • 固定尺寸下拉：不限尺寸，以及证件照分组（1寸照 295×413、2寸照 413×626、小1寸 260×378、身份证照 358×441、护照照 390×567）。固定尺寸与限定比例互斥；固定尺寸模式下裁剪框只能整体移动。
  • 旋转按钮：逆时针旋转90°、顺时针旋转90°。
  • 裁剪框旁显示 800 x 600 形式的尺寸数字，最小 10px，且不会超出图片范围；没画框就点「应用裁剪」会提示「请先绘制裁剪区域」。

📷 插图占位（图 16）

裁剪工具栏 — 展示矩形/椭圆切换、比例与固定尺寸下拉（证件照）、旋转按钮、尺寸数字 补图：图片放到 docs/public/images/crop-toolbar.webp，然后删除本提示块并打开下一行注释

透视矫正 ​

点「透视矫正」后按提示依次点击图片的四个角点（任意顺序，程序会自动识别位置），侧栏显示 进度: N/4；选满四点后可以拖动圆点微调，点「应用矫正」完成（成功提示「图片矫正完成」），或点「取消」退出。不足 4 点会提示「需要选择4个角点」。

调整图片 ​

侧栏「调整图片」用于改尺寸与压缩：

设置项说明
保持宽高比默认勾选
宽度 / 高度1 ~ 10000 px
缩放0.01 ~ 10 倍
质量压缩 JPEG1 ~ 100，默认 85（越低文件越小）

下方会预览 新尺寸: 宽 × 高 / 预估大小。按钮有三个：💾 压缩保存（按当前设置压缩并保存为 JPEG）、应用（只改当前图片，不写盘）、取消。

标注 ​

  • 工具与截图编辑窗口一致：画笔、直线、箭头、圆形、矩形、马赛克、文字、序号。
  • 矩形/圆形在这里是固定描边（没有填充入口）；矩形圆角取「标注设置 → 默认圆角半径」。
  • 样式弹窗提供：8 个预设色 + 自定义颜色...、粗细（滚轮调整）、透明度（Shift + 滚轮，10~100 步进 5）、箭头样式（经典箭头 / 锥形箭头）、马赛克形状（画笔形状 / 矩形形状 / 启用文本抹除）、序号样式（空心圆 / 无圆 / 实心圆，与截图编辑窗口一致）。
  • 松开鼠标即生成可选中对象；之后随时可以用滚轮调整它的粗细，没有「绘制后 3 秒内」的时间限制。
  • 调整时会提示 粗细: N px、大小: N（序号）、透明度: N%，1 秒后自动消失。

保存、格式转换与打印 ​

  • 保存对话框标题为 保存图片 (支持格式转换)，可选 PNG / JPEG / BMP / GIF / WebP / PDF / ICO（不支持导出 SVG）。默认文件名按 保存设置 里的格式、前缀、分隔符与日期格式生成。
  • JPEG / WebP 使用保存设置里的「图片质量」（默认 90）。如果保存时改变了格式，会提示 图片已保存！格式转换: 原格式 → 新格式。
  • 打印：Ctrl+P 或工具栏打印按钮，程序会按图片比例自动选择横向/纵向，成功后提示「打印任务已发送到打印机」。
  • OCR：点工具栏「OCR识别」，识别中按钮变为「识别中...」；结果窗口是否弹出取决于「AI 服务配置 → OCR 设置」，勾选了「不显示窗口，自动复制到剪贴板」时会静默复制并用托盘气泡提示 OCR 识别完成（再勾选「不显示「OCR 识别完成」托盘提示」可连这个右下角通知一起去掉）。

历史截图 ​

入口只在托盘菜单：历史截图 → 🖼️ 快速浏览 / 📂 打开历史文件夹 / 📁 更改保存路径... / 🗑️ 清空历史记录（也可以在通用设置里把托盘某个键的单击行为设为「快速浏览历史」）。

「历史截图浏览」窗口：

  • 纵向卡片列表，按 今天 / 昨天 / 本周 / 更早 分组；卡片上显示时间、尺寸、大小、文件名，以及 ★ 收藏、预览、复制、删除。
  • 单击卡片没有效果：双击卡片或点「预览」才会打开图片查看器；鼠标悬停在缩略图上会弹出放大预览。
  • 卡片右键菜单：🖼️ 打开预览、📂 在文件夹中显示、📋 复制路径、🗑️ 删除（删除只能一张一张来，没有回收站，确认后会同时删除文件和记录）。
  • 搜索：按截图里的文字搜索，需要先在 截图设置 里开启「启用 OCR 索引」；输入关键词后按回车或点「搜索」，结果提示「🔍 找到 N 张包含 "关键词" 的截图」。
  • 筛选：全部 / 今天 / 昨天 / 本周 / 本月 / 更早；勾选「精选」只看收藏的截图。
  • 列表默认显示最近 100 张，点底部「📥 加载更多」每次再加载 100 张。
  • 「更改保存路径...」可以选择把旧截图迁移到新位置（迁移是复制，不会删除原文件）。
  • 「清空历史记录」会删除历史目录里的图片（不可恢复），并顺带清理缩略图缓存与临时文件。
  • 保留策略在 保存设置 → 历史截图管理：不保留 / 永久保留 / 保留一周 / 保留一个月 / 保留三个月。打开历史浏览窗口时会按策略在后台清理超期截图（已收藏的不会被清理）。

📷 插图占位（图 17）

历史截图浏览窗口 — 展示今天/昨天/本周分组卡片、★ 收藏、筛选与搜索框 补图：图片放到 docs/public/images/history-window.webp，然后删除本提示块并打开下一行注释

视频处理 ​

打开视频 ​

  • 主界面 打开图片 按钮选择视频，或把视频文件拖到主界面；
  • 录制完成后在「录制完成」对话框点 ✂️ 编辑。

支持格式：mp4、avi、mov、mkv、flv、wmv、webm、m4v；音频文件 mp3、wav、flac、aac、ogg、m4a、wma 也可以打开处理。

打开后是「编辑音视频」窗口，共 6 个页签：✂️ 裁剪 / 🗜️ 压缩 / ⚡ 变速 / 🔄 格式转换 / 🎙️ 配音 / 🔪 音频切分。导出完成后窗口不会自动关闭；关闭窗口即退出（没有单独的「取消」按钮），也不会提示未保存的改动。

✂️ 裁剪 ​

时间轴操作：

  • Ctrl + 滚轮 缩放时间轴（10% ~ 1000%）；放大后普通滚轮可水平滚动。
  • 拖动左右手柄调整起止点（手柄中心左右各 16px 内都能抓住）；拖动选区内部整体平移；选区最短 0.5 秒。
  • 双击选区内部：从该点播放到选区终点。

键盘微调有两套，哪一套生效取决于焦点是否在时间轴上（点过时间轴就是第一套）：

时间轴获得焦点时功能
← / →起点 ∓0.1 秒（Shift 为 1 秒）
↑ / ↓终点 ±0.1 秒（Shift 为 1 秒）
Ctrl + 方向键整体平移选区
, / .移动预览位置 0.1 秒（不改选区）
Ctrl + 滚轮缩放时间轴
时间轴未获得焦点时功能
← / →起点 ∓0.1 秒（Ctrl 为 0.5 秒）
↑ / ↓终点 ±0.1 秒（Ctrl 为 0.5 秒）
Ctrl+Enter执行裁剪
Esc全屏时退出全屏，否则关闭窗口

其它：

  • 「播放选区」按钮可预览选区（播放时变为「停止播放」）；选区不足 0.5 秒会提示「所选范围太短，至少 0.5 秒」。
  • 删除中间段：✂️ 删除中间段 分组里用 ➕ 添加 / ➖ 移除 / 🗑️ 清空 维护要删掉的区间（会校验开始必须小于结束、每段至少 0.1 秒、区间不能重叠）。
  • 底部的导出按钮实际显示为 裁剪...。单段裁剪走无损复制（不重新编码，速度快）；多段会先提取片段再合并，过程中显示「正在提取片段 N/M...」「正在合并片段...」。完成后提示「✅ 已保存裁剪」。
  • 默认文件名：单段 <原名>_trim_<起>-<止>_<时间戳>.<扩展名>；多段 <原名>_multiCut_<时间戳>.<扩展名>。

📷 插图占位（图 18）

视频裁剪时间轴 — 展示左右手柄、选区、波形/缩略图轨道、删除中间段与「裁剪...」按钮 补图：图片放到 docs/public/images/video-trim.webp，然后删除本提示块并打开下一行注释

🗜️ 压缩 ​

设置项选项
压缩质量高质量 (CRF 23, 体积约压缩30%) / 均衡质量 (CRF 28, 体积约压缩50%)（默认） / 高压缩 (CRF 32, 体积约压缩70%)
输出分辨率保持原分辨率（默认） / 480p / 720p / 1080p / 4K
输出格式MP4 (推荐)（默认） / AVI / MOV / MKV

点「导出压缩视频」，进度框显示百分比与已处理时长/总时长，完成后显示原始大小、压缩后大小与压缩率。默认文件名 <原名>_compressed_<原视频时间戳>.<格式>。

视频压缩只有这一个入口，没有独立的菜单项或快捷键。

⚡ 变速 ​

播放速度可选 0.5倍速 (慢速)、0.75倍速、1.0倍速 (正常)（默认）、1.5倍速、2.0倍速 (快速)、3.0倍速 (极速)；提示「变速通过调整帧间隔实现，不改变帧内容」。先「预览」确认效果，再点「应用变速」。

🔄 格式转换 ​

选好目标格式后点「导出转换文件」。转换为 GIF 时会多出「🎨 GIF 设置」：

设置项选项
帧率10 FPS (小文件) / 15 FPS (推荐)（默认） / 20 FPS (流畅) / 30 FPS (高质量)
尺寸原始尺寸 / 720p / 480p（默认） / 360p

提示为「💡 提示：GIF 文件较大，建议降低帧率和分辨率。推荐用于短视频（<10秒）」。音频格式（MP3 / WAV / FLAC / AAC / OGG）也在这里转换。

🎙️ 配音 ​

  • 「⚙️ 配音设置」包含：🎤 录音设备、🔊 监控、⚙️ 模式、📊 音量（原声与录音两路可分别调节）。
  • 勾选 配音时静音播放（防回音） 后，配音时视频静音播放，避免麦克风把扬声器的声音也录进去。
  • 点「开始配音」边播放边录制，完成后保存为「配音视频」，程序会把新录音与原视频合成。
  • 失败提示举例：未检测到麦克风设备 / 麦克风设备不可用 / 请选择麦克风设备 / 未找到 FFmpeg。

🔪 音频切分 ​

  • 「✂️ 切分设置」包含 每段时长 与 输出格式（保持原格式（默认）/ 🎵 MP3 / 🎼 WAV / 🎧 FLAC / 🔊 AAC / 🎶 OGG）。
  • 点「开始切分」，按设定时长把音频切成多个文件，进度框会提示「正在切分音频... 将生成 N 个文件」，完成后提示「🎉 音频切分完成！」。
  • 参数非法时提示「切分时长必须大于 0 秒！」或「无法获取音频时长，请检查文件是否有效！」。

编辑 GIF 动图（与「格式转换 → GIF」不是同一个功能） ​

打开 .gif / .apng 文件会进入「编辑 GIF 动图」窗口，4 个页签：裁剪 / 变速 / 调整尺寸 / 帧编辑。

  • 裁剪、变速、调整尺寸三页与视频页类似，每页都有「预览」与对应的应用按钮（「应用裁剪」「应用变速」「应用尺寸」）。
  • 帧编辑页：帧列表显示缩略图与 #帧号 延时ms，信息栏显示「共 N 帧 (M 选中) | 总时长: ...」；支持点击选中、Ctrl 多选、Shift 范围选、Delete 删除选中帧、拖动缩略图重排帧、以及去重检测（查找相邻的重复帧，阈值可调，确认后批量删除）。
  • 提示行：提示：点击帧选中（Ctrl 多选，Shift 范围选）| Delete 删除 | 编辑后点「应用帧编辑」保存。
  • 只能输出 .gif；点各页的「应用裁剪」「应用变速」「应用尺寸」「应用帧编辑」会保存并关闭窗口，关闭窗口会丢弃未应用的改动。

📷 插图占位（图 19）

GIF 帧编辑页 — 展示帧缩略图列表、#帧号 延时ms、Ctrl 多选与 Shift 范围选、去重检测 补图：图片放到 docs/public/images/gif-frame-edit.webp，然后删除本提示块并打开下一行注释

AI 能力 ​

通用入口与快捷键 ​

截图、或打开图片后，用工具栏按钮或快捷键触发。默认快捷键都可以在 设置中心 → 快捷键设置 里改，清空即禁用：

功能默认快捷键配置项名称
文字识别 (OCR)Ctrl+O📝 文字识别 (OCR)
提取表格Ctrl+E📊 提取表格
提取公式Ctrl+M📐 提取公式
翻译Ctrl+T🌐 翻译
智能解读Ctrl+I💡 智能解读
AI 对话框Ctrl+D💬 AI 对话框

触发时的行为：

  • 编辑窗口已打开：直接对当前这张图执行对应功能。
  • 没有编辑窗口：先进入截图选区，选完区域后立即执行该功能，不会先跳到编辑窗口。也正因如此，这 6 个快捷键本身就是「截图 → 直接 OCR / 表格 / 公式 / 翻译 / 解读 / 对话」的快捷用法（没有单独的设置项，快捷键可改、可禁用）。
  • 选区里如果另外选了标注工具，则不会执行 AI 动作。

工具栏上的 AI 按钮可以折叠进 AI 下拉菜单：左键点主按钮执行当前「默认操作」，左键点 ▼ 打开菜单选择其它功能，菜单里的「⚙ 设为默认操作」可以换主按钮的默认功能。

OCR 文字识别 ​

  • 入口：快捷键 Ctrl+O、工具栏「文字识别」。
  • 服务优先级（三项可多选）：仅本地OCR > 自定义 AI / 百度 OCR > Pixwit AI。一个都没启用时提示「OCR 不可用 / 请勾选「仅本地OCR」或启用云端 AI 服务」。
  • 本地 OCR 模型（设置中心 → AI 服务配置 → 本地 OCR 模型）：
选项说明
自动（推荐）已下载 small 时用 small，否则用内置 tiny（默认）
tiny（内置，快速）随安装包内置，约 6MB
small（高精度）约 31MB，需点「下载 small」下载一次，之后可离线使用

模型切换需要重启程序后生效。首次使用本地 OCR 若还没有模型，会提示下载「OCR 模型（约 31MB）」。

OCR 结果窗口（没有按钮栏，所有操作都在右键菜单里）：

菜单项说明
📋 复制选中 / 📄 复制全部复制选中的文字 / 全部文字
📋 复制全部文本复制纯文本
💾 保存图片保存当前图片
📝 切换到纯文本（可编辑）/ 🌐 切换到HTML（保留格式）切换文本视图
📌 窗口置顶切换置顶（默认按设置里的「OCR结果窗口默认置顶」）
📐 排版清理行首行尾空格 / 清理多余空行 / 合并为段落 / 按标点换行 / 中文标点修正 / 删除空格
↺ 重置布局恢复默认布局
✕ 隐藏图片 / 📷 显示图片、≡ 隐藏文本面板 / ☰ 显示文本面板在图片区右键可折叠左右两栏
  • 点图复制：直接点击图片上的某一行文字，该行文本会被复制到剪贴板，并出现绿色高亮框与 ✅ 已复制（窗口首次打开时会提示一次「💡 点击图上任意一行即可复制该行文本」）。
  • 识别完成后会自动把整段结果写入剪贴板，并提示 ✓ 已复制 N 行到剪贴板。
  • 快捷键：Ctrl+C 复制（随后自动关窗）、Ctrl+T 切换置顶、Esc 关窗。
  • 识别过程中屏幕原位会显示进度浮层（正在识别...）；按 Esc 或点击浮层即可取消。上一轮没结束就再触发，会提示「OCR 正在处理中」。
  • 勾选「不显示窗口，自动复制到剪贴板」后，从截图编辑窗口和图片查看器触发的 OCR 不再弹结果窗口（快捷键直连的 OCR 路径不受该选项影响）。此时默认会在右下角弹一个 OCR 识别完成 系统通知；不想要可以在同一处勾选「不显示「OCR 识别完成」托盘提示」（识别失败的通知不受影响，仍会弹出）。

📷 插图占位（图 20）

AI 下拉菜单与 OCR 结果窗口 — 建议同框展示：AI 下拉菜单展开态 + OCR 结果窗口的「点图复制」绿色高亮 补图：图片放到 docs/public/images/ai-menu-and-ocr.webp，然后删除本提示块并打开下一行注释

翻译 ​

  • 入口：快捷键 Ctrl+T、工具栏「翻译」。
  • 设置（设置中心 → AI 服务配置 → 翻译设置）：
设置项选项默认
目标语言中文、English、日本語、한국어、Русский、Français、Deutsch、Español、Português、Italiano中文
翻译风格直译 / 意译（推荐） / 本地化意译
翻译模式文本翻译（译文显示在文本面板） / 图片翻译（译文直接叠加到原图）文本翻译
抹除原文背景图片翻译模式下，用背景色填充原文区域关闭
译文偏移图片翻译模式下译文整体下移的像素数（0~200 px）0

翻译结果窗口：

  • 左栏是图片，右栏上方是 【原文】、下方是 【译文】，两个文本框都可以直接编辑。
  • 右上角图标按钮依次是：🔁 重新翻译、复制原文、复制译文、显示图片区域（图片隐藏时出现）、显示原文区域。
  • 译文标题行带目标语种下拉和当前风格；在窗口里改语种会立即重新翻译（从设置页或工具栏改语言不会触发已打开窗口重译）。
  • 翻译中标题会显示进度，如 翻译中... (N字)；完成后为 翻译结果。
  • 右键菜单（图片区）：隐藏/显示图片、隐藏/显示文本面板、译 显示译文叠加、💾 保存图片、↺ 重置布局；原文/译文框右键可复制选中内容或全部内容。
  • 快捷键只有 Esc 关窗；窗口没有置顶功能。
  • 图片翻译时译文会叠加在原图上，每条译文框都可以拖动、拖边缘改大小、滚轮缩放，点击某条译文即可复制该条（提示 ✅ 已复制译文）；右键菜单里的 译 显示译文叠加 可以开关叠加显示。保存图片时会把叠加的译文一并渲染进图片，文件名形如 Translation_Screenshot<时间戳>.<格式>。
  • 没有可用的翻译服务时会提示「翻译服务不可用 / 没有配置可用的翻译服务」。

📷 插图占位（图 21）

图片翻译叠加效果 — 展示译文直接叠加到原图、可拖动/缩放的译文框与「✅ 已复制译文」 补图：图片放到 docs/public/images/translation-picture.webp，然后删除本提示块并打开下一行注释

表格提取 ​

  • 入口：快捷键 Ctrl+E、工具栏「提取表格」。
  • 前置条件：需要启用 PixWit AI，或启用「自定义 AI 服务」并配置好百度表格识别；否则会提示「功能不可用 / 表格识别服务未配置或未启用」。
  • 服务路由：自定义服务 + 百度表格已配置时优先用百度表格识别，否则用 PixWit AI。仅本地OCR 不参与表格识别。
  • 流程：显示「正在提取表格...」进度浮层（Esc 或点击可取消）→ 结果窗口 → 关闭截图编辑窗口。

表格结果窗口（同样没有按钮栏，全部走右键菜单）：

菜单项说明
📄 复制全部内容复制整张表格
📋 复制选中内容复制选中的部分（表格区有选中内容时出现）
💾 保存图片保存原图
✕ 隐藏图片 / 📷 显示图片折叠图片栏，让表格更宽
↺ 恢复默认显示（图片 + 表格）恢复布局
📌 窗口置顶切换置顶

把表格粘到 Excel：点「📄 复制全部内容」后，程序会同时写入纯文本与 HTML 两种剪贴板格式，到 Excel 里直接 Ctrl+V 即可保留行列与合并单元格（成功只有 ✓ 已复制 的浮动提示，界面上不会写「可粘贴到 Excel」）。不要使用「选择性粘贴」。

识别失败时窗口会显示 😕「表格识别失败」以及一段友好说明（例如「认证失败，请检查 API Key、Secret Key 或 Token URL 配置」「网络连接失败，请检查网络或 URL 配置」「未能识别到表格内容，请确保图片中包含清晰的表格」）。

LaTeX 公式 ​

  • 入口：快捷键 Ctrl+M、工具栏「提取LaTeX公式」。
  • 仅 PixWit AI 支持；未启用时提示「LaTeX公式识别功能需要启用 PixWit AI 服务」。
  • 识别由多模态视觉模型完成，提示词要求只输出 LaTeX 源码（不带 Markdown 围栏、不带 $ 定界符），多个公式每行一个；没有公式时提示「未能识别到公式」。
  • 结果复用 OCR 结果窗口显示，标题为 LaTeX公式提取，复制方式与 OCR 相同（识别完成也会自动写入剪贴板）。

智能解读 ​

  • 入口：快捷键 Ctrl+I、工具栏「LLM解读」。
  • 先用 OCR 取出文字，再交给大语言模型生成结构化解读（摘要、要点、建议）。服务路由：自定义 LLM 服务 > PixWit AI；仅本地OCR 只负责识别步骤。
  • 结果复用翻译结果窗口，小标题变为 【识别内容】 与 【解读结果】，窗口标题为 解读结果；解读模式下不显示「重新翻译」按钮与语种下拉。
  • 云端额度用完时会提示「⚠ 云端解读配额已用完，已显示本地 OCR 识别结果，明日重置」。

AI 对话框 ​

  • 入口：快捷键 Ctrl+D、工具栏「AI对话」。窗口始终置顶，没有置顶开关。
  • 顶部可选择 AI 模型（自定义服务里只有「支持图片识别」的多模态模型会出现），旁边是 🗑️ 新对话（清空对话历史，无二次确认；切换模型也会重置对话）。
  • 隐式带图：截图会在第一轮随问题一起发给模型，界面没有「带图/不带图」开关，也不能中途换图。
  • 快捷键：Enter 发送、Shift+Enter 换行、Esc 关闭窗口。
  • 输入区按钮：📤 发送、⏹ 停止（生成中替换发送按钮，停止后该轮内容不写入历史）、🔄 清空（只清输入框内容）。
  • 复制结果：窗口没有复制按钮，在对话区右键选择「📋 复制选中内容」或「📄 复制全部内容」（复制的是整个对话的纯文本，含 👤 您：、🤖 AI： 等前缀）。
  • 对话历史只保存在内存里，关闭窗口即丢失；只有窗口大小/位置/最后使用的模型与模板会被记住。
  • 提示词模板（就在 AI 对话框里，不在设置中心）：输入区上方的 📋 模板: 下拉可选择常用提问模板，保存 把当前输入框内容存成模板；管理 打开「管理提示词模板」窗口——非模态（打开时仍可继续截图该窗口），左侧列表可勾选、右侧直接编辑，支持新建、删除、批量删除，最多保存 20 条。
  • 出错时以 ❌ 错误：... 气泡呈现（如「API 配额已用完」「API Key 无效」「请求超时」「网络连接失败」「找不到服务器」）。

📷 插图占位（图 22）

AI 对话框 — 展示模型选择、🗑️ 新对话、提示词模板下拉、发送/停止/清空按钮 补图：图片放到 docs/public/images/ai-dialog.webp，然后删除本提示块并打开下一行注释

二维码 / 条形码 ​

  • 入口：工具栏「识别二维码/条形码」（没有可配置的快捷键）。
  • 识别是即时的，不显示进度浮层。没有识别到内容时提示「未检测到二维码或条形码」。
  • 识别到内容后会：在 OCR 结果窗口里显示（多条结果带 [1]、[2] 序号）→ 自动把第一条复制到剪贴板 → 关闭截图编辑窗口。

各服务能力对照 ​

功能仅本地 OCRPixWit AI自定义服务
文字识别✅✅✅（百度 OCR，或自定义 LLM 的多模态能力）
翻译仅作为识别步骤✅✅（需配置自定义 LLM 服务）
表格提取❌✅✅（百度表格识别优先）
LaTeX 公式❌✅（唯一支持）❌
智能解读仅作为识别步骤✅✅（需配置自定义 LLM 服务）
AI 对话框❌✅需「多模态模型」

AI 服务配置 ​

入口：托盘右键 → 设置中心... → 左侧导航 🤖 AI 服务配置。

注意：程序里有些旧提示文案仍在引导用户去「系统托盘菜单」找 AI 服务配置（例如「翻译服务不可用」的弹窗），实际入口是设置中心。

AI 服务来源 ​

三个复选框可以多选，优先级固定为 本地 > 自定义 > Pixwit：

选项说明默认
自定义 AI 服务（使用自己的 API Key）配置自己的大语言模型和特定服务关闭
Pixwit AI（推荐，开箱即用）云端 AI 服务，功能完整，无需配置开启
仅本地OCR（离线识别，无需联网）勾选后文字识别只走本地 OCR（优先级最高）开启

下方会实时显示「当前 OCR 通道」（如 本地OCR（模型：tiny）、自定义 AI / 百度 OCR、Pixwit AI 云服务）。

OCR 设置 ​

设置项说明默认
不显示窗口，自动复制到剪贴板从编辑窗口/图片查看器触发的 OCR 不再弹结果窗口不勾选
不显示「OCR 识别完成」托盘提示静默复制完成时不再弹右下角系统通知（失败提示仍会弹）；需先勾选上一项不勾选
OCR结果窗口默认置顶新打开的 OCR 结果窗口自动置顶勾选

本地 OCR 模型 ​

模型变体下拉（自动（推荐） / tiny（内置，快速） / small（高精度））、下载 small 按钮，以及显示 tiny/small 安装与生效情况的状态行。切换模型需要重启后生效。

翻译设置 ​

目标语言、翻译风格、翻译模式，以及图片翻译模式下的「抹除原文背景」与「译文偏移」。详见上文「AI 能力 → 翻译」。

大语言模型（勾选「自定义 AI 服务」后显示） ​

每个服务是一张可展开的卡片：

项目说明
启用勾选勾选后在「自定义 AI 服务」通道中参与翻译与解读
名称 / API Key / Base URL / ModelModel 是可编辑下拉框，内置 DeepSeek、通义千问、GPT-4o、Claude、Gemini 等常用模型名
图片处理能力🖼️ 多模态模型（支持图片识别）（默认）或 📝 纯文本模型（不支持图片）；纯文本模型会先 OCR 再交给模型
测试连接 / 删除测试连接会返回成功信息或具体失败原因；删除没有二次确认

「+ 添加服务」可新增一个服务条目。自定义翻译/解读要求服务已启用，且 API Key 与 Base URL 都不为空。

百度 OCR / 百度表格识别（勾选「自定义 AI 服务」后显示） ​

两组结构相同：启用百度 OCR 服务 / 启用百度表格识别服务 复选框，加 API Key、Secret Key、Token URL、OCR URL（表格组为 表格识别 URL）四个输入框与 测试连接 按钮。URL 留空时使用百度官方默认地址；凭证保存在程序的 ai_credentials.json 中。

测试连接的反馈：成功时提示连接成功与关键配置；缺少必填项、超时、HTTP 状态码异常、网络错误都会给出对应说明。

📷 插图占位（图 23）

AI 服务配置页 — 展示服务来源三个复选框、当前 OCR 通道、本地 OCR 模型、自定义服务卡片 补图：图片放到 docs/public/images/ai-service.webp，然后删除本提示块并打开下一行注释

设置中心 ​

入口：托盘右键 → 设置中心...（也可以在通用设置里把托盘单击行为设为「打开设置中心」）。

左侧是导航栏，共 7 页：

页面职责
⚙️ 通用设置托盘图标、托盘点击行为、性能兼容、启动行为、主窗口贴边自动隐藏
📸 截图设置选区、交互行为、提示显示、贴图、图像处理
🖊️ 标注设置标注工具默认值、水印、截图工具栏按钮的显隐与排序
🎥 录制设置录制模式、编码、录制效果、摄像头、输出格式、GIF、帧率、声音
⌨️ 快捷键设置16 项可自定义的全局快捷键
💾 保存设置图片/视频命名规则、图片默认格式与质量、历史保留策略
🤖 AI 服务配置AI 服务来源、本地 OCR 模型、翻译设置、自定义服务与百度凭证

底部只有 应用 / 确定 / 取消 三个按钮：改动需要点「应用」或「确定」才会保存。

📷 插图占位（图 24）

设置中心总览 — 展示左侧 7 页导航与底部 应用/确定/取消 补图：图片放到 docs/public/images/settings-center.webp，然后删除本提示块并打开下一行注释

⚙️ 通用设置 ​

分组设置项
系统托盘图标当前图标预览、选择图标...（支持 ico / png / jpg / svg）、恢复默认
系统托盘点击行为托盘菜单按键（左键 / 中键 / 右键，被选中的那个键固定为「显示托盘菜单」）、左键/中键/右键单击的动作
性能兼容低配置模式（减少截图卡顿）
启动行为每次启动显示主界面
主窗口主窗口贴边自动隐藏 + 隐藏延时（1 / 2 / 3 / 5 / 10 秒）
  • 单击动作有 7 种可选：显示/隐藏主窗口、区域截图、显示托盘菜单、开始/停止录制、打开设置中心、快速浏览历史、无操作。默认是左键=显示/隐藏主窗口、中键=区域截图、右键=显示托盘菜单；界面上的说明原文是「双击系统托盘图标始终与左键单击行为一致。」（「显示/隐藏主窗口」动作内部有 300ms 去抖，双击不会来回切换两次）。
  • 低配置模式适用于低核/低性能设备：会降低后台检测频率、限制并发任务，UI 元素高亮的响应会略微变慢。

📸 截图设置 ​

包含 5 组：选区设置（遮罩透明度、窗口检测、全屏截图、允许跨屏截图、选区模式 + 比例/尺寸）、交互行为（启用拾色器、复制后关闭窗口、双击复制截图且关闭窗口、拖拽选区后自动完成截图）、提示与显示（截图保存提示窗口、显示操作提示信息框、显示直线长度标签、HDR曝光补偿）、贴图设置（隐藏贴图边框）、图像处理（启用 OCR 索引、裁剪容差、裁剪边距）。

每一项的默认值与作用见 截图功能 章节末尾的「截图设置页速查」。

🖊️ 标注设置 ​

分组设置项默认
标注工具默认圆角半径（0~50，步进 2）0（直角）
文字标注字体默认（跟随系统）
按工具类型过滤选中标注关闭
水印设置水印文字、字号、颜色、字体、位置、边距、平铺间距、同时添加日期时间、时间格式见 截图功能 → 水印
工具栏按钮左栏「未显示的按钮」、右栏「工具栏上显示的按钮」、恢复默认顺序—
  • 按工具类型过滤选中标注：开启后，选中某个标注工具时画布上只能点选该类型的标注，其它类型视为空白（避免重叠误选）；关闭后恢复全部可选。只在标注设置里切换。
  • 工具栏按钮的用法：右侧一栏就是工具栏从左到右的顺序。选中一行后点中间的箭头按钮——→ 添加到工具栏（显示）、← 从工具栏移除（隐藏）、↑ ↓ 调整顺序；双击一行也可以直接在两栏之间搬运。点「恢复默认顺序」恢复出厂排列（只改界面，仍需点「应用」才写盘）。两栏都清空后工具栏上不会显示任何按钮，此时按 Esc 退出截图。

📷 插图占位（图 25）

标注设置 → 工具栏按钮 — 展示左栏「未显示的按钮」、右栏「工具栏上显示的按钮」与 → ← ↑ ↓ 搬运按钮 补图：图片放到 docs/public/images/settings-toolbar-buttons.webp，然后删除本提示块并打开下一行注释

🎥 录制设置 ​

内容与默认值见 录屏功能 章节末尾的「录制设置页速查」。注意录制设置页的改动同样需要点「应用」或「确定」才保存。

⌨️ 快捷键设置 ​

分三组共 16 项：⌨️ 快捷键详细设置（截图/贴图、录制、暂停/恢复、剪贴板贴图、保存到文件夹）、🎨 录屏标注快捷键（画线条/箭头/圆形/矩形、退出标注）、🤖 AI功能快捷键（OCR、提取表格、提取公式、翻译、智能解读、AI 对话框）。

每项都可以点右侧的 × 清除（等于禁用该快捷键），也可以用页面里的「恢复默认」按钮一键还原。全部默认值见 快捷键汇总。

  • 只支持字母、数字、F1-F12 和常用功能键（Space、Enter、Esc、Tab、方向键等）的组合，不支持的按键会提示「该按键当前不支持作为全局快捷键」并要求换一个。
  • 这里的页面不做重复检测：两个功能设成同一组合不会即时报错，直到注册失败时才在托盘弹出「快捷键冲突」提示。
  • 如果被占用的是录制相关快捷键，会弹出「录制功能已禁用 - 快捷键冲突」的提示框。

📷 插图占位（图 26）

快捷键设置页 — 展示三组 16 项、每项的 × 清除按钮与「恢复默认」 补图：图片放到 docs/public/images/settings-shortcuts.webp，然后删除本提示块并打开下一行注释

💾 保存设置 ​

分组设置项默认
图片保存设置默认保存格式（PNG / JPEG / WebP / BMP / GIF 图片）PNG
图片质量（1~100，仅对 JPEG/WebP 有效，双击滑块恢复 90）90
文件名前缀（留空则使用各功能的默认前缀，如 PixWit_screenshot）空
分隔符（下划线 / 短横线 / 点号 / 空格 / 无分隔符）下划线
日期格式（6 种，下拉里就是当前时间按该格式渲染的样例）yyyyMMdd_HHmmss
📁 视频保存设置文件名前缀（默认 PixWit_录屏）、分隔符、日期格式下划线、yyyyMMdd_HHmmss
历史截图管理历史保留策略：不保留 / 永久保留 / 保留一周 / 保留一个月 / 保留三个月永久保留
  • 「不保留」表示截图不再写入历史记录；其它档位会在打开历史截图浏览时后台清理超期截图（收藏的不会被清理）。
  • 历史截图的保存位置不在这里改，而在托盘菜单：历史截图 → 📁 更改保存路径...。

🤖 AI 服务配置 ​

分组与默认值见 AI 服务配置 章节。

快捷键汇总 ​

本手册把快捷键分成两类：可自定义（设置中心 → 快捷键设置）与系统内置（固定用法，不可修改）。

一、可自定义的全局快捷键（默认值） ​

分组名称默认快捷键
⌨️ 快捷键详细设置📷 截图/贴图F1
🎥 录制（开始/停止）F3
⏸️ 暂停/恢复录制F4（仅录制中生效）
🖼️ 剪贴板贴图Ctrl+Shift+V
📁 保存到文件夹Ctrl+Alt+S
🎨 录屏标注快捷键📏 画线条Alt+I
➡️ 画箭头Alt+J
⭕ 画圆形Alt+O
🟦 画矩形Alt+K
❌ 退出标注Alt+Esc
🤖 AI功能快捷键📝 文字识别 (OCR)Ctrl+O
📊 提取表格Ctrl+E
📐 提取公式Ctrl+M
🌐 翻译Ctrl+T
💡 智能解读Ctrl+I
💬 AI 对话框Ctrl+D

提示：

  • 每一项都可以点右侧的 × 清除（= 禁用该快捷键）；「恢复默认」按钮可一键还原。
  • 只支持字母、数字、F1-F12 与常用功能键（Space、Enter、Esc、Tab、方向键等）的组合；不支持时会提示「该按键当前不支持作为全局快捷键」。
  • 如果快捷键被其它程序占用，托盘会弹出「快捷键冲突」气泡并提示到设置里改；若冲突的是录制相关快捷键，会弹出「录制功能已禁用」提示框。
  • 截图/录制走键盘快捷键，早期版本里 Win + 鼠标键 的触发方式已移除。

二、系统级硬编码（不可自定义） ​

快捷键功能
Shift+Esc紧急重置：强制中止所有正在进行的操作并恢复状态（始终注册）

此外程序内部还有一套按需注册的 Esc 逻辑：只在截图、录制、滚动截图等场景生效——录制中按 Esc 只会退出标注工具，不会停止录制。

三、截图选区 ​

快捷键功能
Tab循环切换 UI 检测模式
Enter / 小键盘 Enter / Space确认检测到的窗口 / 控件为选区
Enter / 小键盘 Enter快速确认（复制 + 保存 + 关闭）
Ctrl+C复制选区并进入编辑窗口
Ctrl+X复制选区并关闭
Ctrl+S保存选区并关闭
Esc取消截图 / 取消选区
方向键选中后微调选区单边：默认外扩 1px，Shift 内缩 1px，Ctrl 步进 10px
滚轮检测开启时循环切换窗口层级
C拾色器：复制当前颜色并退出
Shift（单按）拾色器：切换颜色格式（RGB / #HEX / HEX）
R拾色器：重置取色偏移
方向键 / Shift+方向键拾色器：微调 1px / 快移 10px

四、截图编辑窗口 ​

快捷键功能
Ctrl+S保存（随后自动关闭）
Ctrl+C复制（窗口保持打开）
Ctrl+X复制并关闭
Enter复制并关闭
Ctrl+Z撤销
Delete / Backspace删除选中的标注
Tab循环选中重叠的标注对象
Space（按住）抓手移动窗口
Esc取消编辑 → 取消工具选择 → 关闭窗口
鼠标滚轮调整线条粗细 / 填充透明度
Shift + 滚轮调整不透明度
Shift + 拖拽直线/箭头吸附 15°，圆形/矩形约束为正圆/正方形
折线：Enter / 双击 / 右键完成折线
折线：Esc取消折线
折线：Backspace / Delete删除上一个折线点
序号：0-9 / Backspace / Enter / Esc输入数字 / 退位 / 确认 / 取消
文字：Ctrl+Enter确认文字
文字：Esc取消文字
文字：Ctrl+Z取消文字编辑
文字：滚轮 / Shift+滚轮调字号 / 调「有边」底框不透明度

右键在编辑窗口是「直接退出、不保存不复制」，双击在无其它含义时是「复制并关闭」。

五、贴图窗口 ​

快捷键功能
空格进入编辑模式（裁剪模式下不响应）
Esc关闭贴图 / 退出裁剪
Enter裁剪模式下确认裁剪
Ctrl+S / Ctrl+C / Ctrl+X保存 / 复制 / 复制并关闭
Ctrl+0 / Ctrl+= / Ctrl+-重置缩放 / 放大 / 缩小
Ctrl+Z撤销裁剪
Ctrl + 滚轮调整透明度
滚轮缩放

六、图片查看器 ​

快捷键功能
Space（按住）临时抓手平移（配合左键拖动）
Space + 滚轮缩放
Ctrl + 滚轮强制缩放（任何模式）
滚轮以鼠标位置为中心缩放（查看模式）
双击在适应窗口与 100% 原始尺寸之间切换
0 / 1适应窗口 / 实际大小
F切换全屏
+ / =放大
-缩小
← / →上一张 / 下一张（查看、标注模式；Ctrl+←/→ 任何模式都可用）
PageUp / PageDown上一张 / 下一张（任何模式）
Ctrl+Z撤销
Ctrl+S保存
Ctrl+P打印
Delete / Backspace删除选中的标注对象（不会删图片）
鼠标中键单击跳到 100% 原始尺寸
Esc逐级退出：标注模式 → 裁剪 → 透视矫正 → 关闭窗口

七、视频裁剪 ​

视频时间轴的键盘有两套，哪一套生效取决于焦点是否在时间轴上：

时间轴未获得焦点时功能
← / →开始时间 −/+ 0.1 秒（Ctrl 为 0.5 秒）
↑ / ↓结束时间 +/− 0.1 秒（Ctrl 为 0.5 秒）
Ctrl+Enter执行裁剪
Esc退出全屏；未全屏时关闭窗口
时间轴获得焦点时功能
← / →开始时间 ∓0.1 秒（Shift 为 1 秒）
↑ / ↓结束时间 ±0.1 秒（Shift 为 1 秒）
Ctrl + 方向键整体平移选区
, / .移动预览位置 0.1 秒（不改选区）
Ctrl + 滚轮缩放时间轴

八、录制标注 ​

快捷键功能
Esc取消当前标注工具，恢复鼠标穿透
Shift + 拖拽约束为正圆 / 正方形

九、AI 对话框 ​

快捷键功能
Enter发送消息
Shift+Enter换行
Esc关闭窗口

十、文本标注编辑框 ​

快捷键功能
Ctrl+Enter确认
Esc取消编辑
Ctrl+Z取消编辑
Ctrl+C / Ctrl+X有选中文字时=复制/剪切文字；没有选中时=先确认文字，再执行复制截图 / 复制并关闭

十一、滚动截图 ​

快捷键功能
Enter停止滚动截图并出图
Esc取消滚动截图
↓ / Shift+↓手动调整时向下扩展 5px / 50px
↑ / Shift+↑手动调整时向上收 5px / 50px

十二、结果窗口 ​

窗口快捷键功能
OCR 结果Ctrl+C复制识别文本
OCR 结果Ctrl+T切换置顶
OCR 结果 / 翻译结果Esc关闭窗口
GIF 编辑Delete删除选中帧
GIF 编辑Ctrl+A帧编辑页全选帧

常见问题 ​

Q：截图快捷键没反应？

  • 到 设置中心 → 快捷键设置 确认快捷键没有被清空；若托盘弹出过「快捷键冲突」提示，说明组合被其它软件占用，换一个组合即可。
  • 处于截图状态时再按一次截图键是取消；编辑窗口打开时再按一次则是把当前图转成贴图，别误判为失效。

Q：主界面不见了？

  • 主界面可能贴边收起了（鼠标移到屏幕对应边缘的细边会自动弹出），也可能被 × 隐藏了。右键托盘图标勾选 显示主界面 即可。

Q：截图编辑窗口里中键点了没反应？

  • 当前版本编辑窗口的中键没有功能；切换填充/描边请用 矩形/圆形按钮的右键菜单 或样式弹窗。中键跳到 100% 只作用于图片查看器。

Q：贴图挡住了内容？

  • 拖动贴图边缘可以缩放，Ctrl + 滚轮 调透明度，选中后可右键「👁 透明度」快速选档；不需要了直接双击（复制并关闭）或按 Esc 关闭。有多张时用右键「🚫 关闭所有贴图」一次性清理。

Q：Ctrl+Shift+V 贴出来的是卡片，不是文字？

  • 这是设计行为：文本剪贴板会先渲染成便签卡片再贴出，方便当参考图使用。需要文本本身请直接从剪贴板粘贴到目标程序。

Q：连按 Ctrl+Shift+V 贴出来好几张，怎么停？

  • 连按是在翻剪贴板图片历史（一轮最多 10 张）。停手 5 秒后再按会重新从最新一张开始。

Q：OCR 识别不准 / 无法下载模型？

  • 本地 OCR 首次使用需要下载模型；可在 设置中心 → AI 服务配置 → 本地 OCR 模型 里切换 tiny（内置、快）与 small（更准），或下载 small 模型。
  • 也可以改用 PixWit AI 或百度 OCR 云服务。

Q：翻译 / 识别报错？

  • 到 设置中心 → AI 服务配置 测试连接，检查 API Key、余额与网络。

Q：表格粘贴到 Excel 格式不对？

  • 在结果窗口的右键菜单里点「📄 复制全部内容」（会同时写入纯文本与 HTML 两种格式），然后在 Excel 里直接 Ctrl+V（不要用「选择性粘贴」）。

Q：表格识别失败？

  • 尽量使用清晰、正对、无遮挡的高分辨率截图；识别失败时程序会尝试其他引擎，仍失败请缩小范围重试。

Q：录屏文件太大？

  • 在 设置中心 → 录制设置 里降低「视频质量」档位、降低帧率，或改用 GIF；也可以在录制完成后用视频压缩功能处理。

Q：录屏没有声音？

  • 检查「录制声音」是否选了「静音」；使用系统声音+麦克风时可以在「音量控制」里分别调节两路音量。

Q：更新下载后 Windows 提示「无权限」或被安全软件拦截？

  • 见下方「更新与反馈」里的三种解决方法（解除文件锁定 / 使用安装版 / 联系 IT 加白名单）。

Q：Windows 7 能用吗？

  • 不支持，仅支持 Windows 10 / 11。

更新与反馈 ​

检查更新 ​

  • 自动检查：程序启动约 1 分钟后检查一次，之后每 24 小时一次；可以在 帮助 → 停止检查更新 里关闭（勾选即停止）。
  • 手动检查：帮助 → 检查更新。
  • 发现新版本时会弹出「🎉 发现新版本」对话框，里面包含当前版本、更新内容和两条下载源：GitHub 与 Gitee（国内推荐），并提供 📦 便携版、💿 安装版 与 🔗 查看发布页面 三个按钮；下载通过系统浏览器打开对应链接完成，程序本身不做静默安装。
  • 若所有更新源都无法访问，会提示「所有更新源均无法访问」并给出最后一次的错误信息。

更新下载后被系统拦截怎么办 ​

更新对话框里有一段可折叠的说明（⚠️ 下载后 Windows 提示「无权限」或被安全软件拦截？），给出三种解决办法：

  1. 方法 1 — 解除文件的「网络标记」：右键下载的文件 → 属性 → 勾选「解除锁定」→ 确定。
  2. 方法 2 — 使用安装版：安装到 %LocalAppData%\PixWit，不需要管理员权限。
  3. 方法 3 — 联系 IT 管理员把 PixWit 加入白名单：对话框里提供可一键复制的软件名称、发布者与下载地址。

反馈与排查 ​

入口用途
帮助 → 反馈与建议复制 QQ 群号 133125470 并弹出提示
帮助 → 打开日志文件打开日志目录（%LocalAppData% 下的 PixWit logs 目录），反馈问题时把日志一并提供
帮助 → 🌐 官方网站pixwit.cn
帮助 → 关于 PixWit版本号与联系方式

获取帮助 ​

感谢使用 PixWit！

© 2025 PixWit|粤ICP备2025481742号-2