截图与标注

截图与标注是 CodeExpander 内的一体化截屏与编辑流程：区域/窗口/全屏/滚动与 Pin 浮窗，截完即进编辑器做标注（箭头、高亮、马赛克、文字）、美化、OCR、复制或保存。托盘或快捷键（如 Cmd+Shift+A）唤起；多屏时按当前光标所在显示器截屏。

支持哪些截图方式？

多显示器：截图时自动针对光标所在的显示器。

快捷键配置（设置 → 截图）：

还可为全屏、窗口、滚动截图、延迟截图分配独立快捷键。

标注与美化

标注工具

编辑操作：撤销（Cmd/Ctrl+Z）、重做（Cmd/Ctrl+Shift+Z）、清除全部。

背景美化

• 背景类型：渐变预设 / 纯色 / 图案
• 圆角：调节截图圆角半径
• 阴影：添加阴影效果
• 边距：四周留白
• 设备框架：macOS 暗色/亮色、浏览器暗色/亮色、终端等预设
• 水印：文字或图片水印，支持位置设置
• 预设：保存当前样式组合，下次一键应用

取色器

截图过程中按快捷键唤起取色器，支持：

• 颜色格式：HEX、RGB、HSL、OKLCH
• 实时预览屏幕像素颜色
• 可复制颜色值到剪贴板

OCR 文字识别

• 对截图或选区做 OCR，识别结果可复制或插入文档；支持多语言。
• 引擎选择（设置 → 截图）：默认自动选择最优引擎，也可手动切换以满足特定识别精度需求。
• 结果展示方式：弹窗显示 / Toast 复制 / Pin 窗口展示
• 全部本地处理，不经过我们服务器。

典型场景：

• 阅读外文文档：截取英文或日文界面文字，提取后直接翻译。
• 处理发票/合同：截图文档，OCR 提取关键信息，粘贴到表格。
• 代码截图转文本：截图中的代码提取为文字，直接粘贴到编辑器。

GIF 录屏 ᴾᴿᴼ

• 选区录制 GIF：支持暂停/继续，录制中按全局快捷键停止并保存
• 录制配置：可调节帧率、质量、最大帧数、光标显示和输出尺寸，在流畅度和文件大小之间按需平衡。
• 后期编辑：时间轴裁剪、增删帧、文字/图片水印、效果（灰度/倒放）
• 全部本地处理，不经过我们服务器。

典型场景：

• 教程作者：录制 UI 操作 GIF 用于文档或 README。
• Bug 反馈：用轻量 GIF 录下复现步骤，替代体积大的视频。
• 远程协作：在聊天工具中分享快速演示，无需上传到外部服务。

保存与输出

• 复制 — 编辑器中按 Enter 或点复制，截图/GIF 进剪贴板，直接粘贴到文档或聊天
• 保存 — Cmd/Ctrl+S 或「另存为」选路径；格式支持 PNG、JPG、WebP
• 快速保存（设置中配置）：截图后直接保存到指定文件夹，无需弹窗确认
• 自动保存（设置中配置）：复制到剪贴板或 Pin 时，同时自动写入指定文件夹

文件名模板

支持时间占位符，例如：

APSDAL_${yyyy-MM-dd_HH-mm-ss}.png

常用占位符：

• ${yyyy} — 年（4位）
• ${MM} — 月（2位）
• ${dd} — 日（2位）
• ${HH} — 时（24小时制）
• ${mm} — 分
• ${ss} — 秒

截图设置

在 设置 → 截图 中可配置：

工作流

• 截图历史 — 近期截图可在编辑器或历史入口中再次查看、复制或编辑。
• 多显示器 — 按当前光标所在显示器截屏，多屏时自动针对该屏。

典型工作流

1. 教程配图：区域截图 → 箭头/编号标注 → 背景美化（圆角+阴影）→ 复制到文档
2. 报错反馈：窗口截图 → 马赛克/模糊敏感信息 → 复制发给同事或贴 Issue
3. Code Review：区域截图 → 编号圆圈标出问题 → 导出或复制
4. 设计稿取色：区域截图 → 取色器提取颜色值 → 复制 HEX 到设计工具