## 1. 简介

uTools 平台截图工具，支持三种模式：

- **单张截图**：快速截取屏幕区域，自动复制到剪贴板后退出
- **长截图**：多帧拼接截取超长内容，智能对齐，支持手动拖拽修正
- **发给 AI**：单张截图后自动打开 Kimi，填入提示词并粘贴图片

主要特性：多显示器支持、标注功能（箭头+文字）、智能对齐（行哈希+SAD兜底）、七牛云上传（Markdown链接）、设置云同步。

---

## 2. 选区界面

拖动鼠标选择截图区域后，工具栏提供以下操作：

| 按钮 | 说明 |
| -------- | ------------------------------------------- |
| 重选 | 重新拖动选区 |
| 取消 | 取消截图，退出插件 |
| 截图 ✓ | 单张截图模式，截取后自动复制到剪贴板并退出 |
| 长截图 L | 长截图模式，打开预览窗口进行多帧拼接 |
| 箭头 | 箭头标注工具（微信风格细线 + 大三角箭头头） |
| 文字 | 文字标注工具，点击选区内位置输入文字 |
| AI | 单张截图后发给 Kimi AI，自动填入提示词 |
| 设置 | 打开设置窗口 |

### 标注功能

- **箭头**：微信截图风格 — 细线（2px）+ 大实心三角箭头头（60° 张角）
- **文字**：点击位置输入，自带半透明背景衬底
- **颜色**：5 种预设（红、橙、绿、蓝、白）
- **撤销 / 清除**：逐步撤销或一次清空

标注会渲染到最终导出的 PNG 图片中。

---

## 3. 长截图模式

### 3.1 手动拼接流程

1. 选择区域后点击「长截图 L」，打开预览窗口（自动截取第一帧）
2. 在目标窗口中**手动滚动**内容
3. 点击「+」按钮截取下一帧
4. 重复步骤 2-3，直到所有内容截完
5. 点击「完成 ✓」按钮导出长截图

### 3.2 智能对齐

开启设置中「自动滚动」开关后，帧间对齐采用两阶段算法：

| 阶段 | 算法 | 适用场景 |
| ------- | --------------------- | ----------------------- |
| Phase 1 | FNV-1a 行哈希精确匹配 | 文本/UI 像素级精确重叠 |
| Phase 2 | SAD 像素差枚举兜底 | 弱纹理/平滑滚动近似重叠 |

两阶段均失败则退回固定偏移拼接（零回归）。

### 3.3 手动调整偏移

预览区域支持拖拽调整帧对齐：

- 鼠标悬停在帧上，该帧及后续帧显示绿色高亮
- 拖动时帧半透明显示，垂直移动调整偏移

---

## 4. 预览窗口工具栏

| 按钮 | 说明 |
| ---------- | -------------------------------------- |
| 移动 | 拖动移动预览窗口位置 |
| 撤销 | 撤销最后一帧 |
| 清空 | 清空所有帧和偏移 |
| 截取一帧 + | 手动截取当前屏幕内容为新帧 |
| 完成 ✓ | 导出并执行后续操作（剪贴板/保存/上传） |
| AI | 将长截图发送给 Kimi AI |
| 设置 | 打开设置窗口 |

---

## 5. 设置

| 设置项 | 说明 |
| ------------ | ------------------------------------------------------------ |
| 复制到剪贴板 | 完成时自动复制图片到系统剪贴板（默认开） |
| 自动保存 | 开启后设置保存路径，完成时自动保存到指定目录 |
| 通知 | 完成时显示系统通知（默认开） |
| 七牛云上传 | 配置 AK/SK/Bucket/域名/区域后，完成时自动上传并复制 Markdown 链接 |
| AI 提示词 | 发给 AI 时自动填入的提示词内容 |
| 自动滚动 | 开启后激活智能对齐算法（默认关） |

设置通过 `utools.db` 持久化，登录 uTools 会员后支持跨设备同步。

---

## 6. 导出与分享

点击「完成 ✓」后，按设置执行：

- **复制到剪贴板**：将合并后的 PNG 图片写入系统剪贴板
- **自动保存**：保存到指定目录，文件名格式 `截图_YYYYMMDD_HHmmss.png`
- **七牛云上传**：上传到七牛云 Kodo 存储，自动复制 Markdown 格式图片链接到剪贴板

---

## 7. 快捷键

| 快捷键 | 说明 |
| ------ | ------------------------------ |
| Esc | 关闭当前窗口（选区/预览/设置） |

---

## 8. 技术架构

- **框架**：electron-vite + React + TypeScript + Tailwind CSS
- **多窗口**：select（选区）+ capture（预览）+ overlay（框线）+ settings（设置）
- **对齐算法**：FNV-1a 行哈希精确匹配 + SAD 像素差兜底
- **设置存储**：utools.db（支持云同步）+ 自动从 dbStorage 迁移

---

## 9. 常见问题

**对齐不准确？** 开启设置中「自动滚动」后会自动对齐；关闭状态下可在预览区拖动帧调整偏移。

**七牛云上传失败？** 检查 AK/SK/Bucket/域名/区域是否配置正确，可查看 `.temp/qiniu_upload.log` 定位问题。

**多显示器截图坐标偏移？** 插件自动识别当前鼠标所在显示器，坐标已处理显示原点偏移。若仍有问题，确保截图前鼠标在目标显示器上。

**Markdown 链接未复制？** 确认七牛云上传成功后会自动复制到剪贴板，格式为 ``。