📊 提取表格
AI 驱动的表格识别，把截图里的表格转成可编辑内容，一键粘进 Excel。
入口与触发方式
| 入口 | 说明 |
|---|---|
| 快捷键 Ctrl+E | 可在 设置中心 → 快捷键设置 → 🤖 AI功能快捷键 → 📊 提取表格 里修改，清空即禁用 |
| 工具栏「提取表格」 | 该按钮默认隐藏，需要到 设置中心 → 标注设置 → 工具栏按钮 把它添加到工具栏；也可以放进 AI 下拉菜单里调用 |
触发时的行为（与 OCR、翻译、智能解读等 AI 功能共用同一套逻辑）：
- 编辑窗口已打开：直接对当前这张图提取表格。
- 没有编辑窗口：先进入截图选区，选完区域后立即执行提取，不会先跳到编辑窗口。所以 Ctrl+E 本身就是「截图 → 直接提取表格」的快捷用法。
- 选区里如果另外选了标注工具，则不会执行 AI 动作。
📷 插图占位（图 1）
在工具栏按钮设置里添加「提取表格」 — 展示 设置中心 → 标注设置 → 工具栏按钮 的左右两栏，以及把「提取表格」从「未显示的按钮」搬到工具栏的操作 补图：图片放到 docs/public/images/table-add-button.webp，然后删除本提示块并打开下一行注释
前置条件与服务路由
需要启用 PixWit AI，或启用「自定义 AI 服务」并配置好百度表格识别；否则会提示「功能不可用 / 表格识别服务未配置或未启用」。
| 情况 | 实际使用的服务 |
|---|---|
| 勾选「自定义 AI 服务」且百度表格识别已配置 | 优先用百度表格识别 |
| 其它情况 | PixWit AI |
| 只勾选了「仅本地OCR」 | ❌ 不参与表格识别 |
「仅本地OCR」不参与表格识别
仅本地OCR 只用于文字识别，表格提取不会走本地 OCR。想用它就得让 PixWit AI 或百度表格识别可用。
使用流程
- 按 F1 截取包含表格的图片（也可以先打开图片或编辑窗口，再按 Ctrl+E）。
- 触发后屏幕原位显示「正在提取表格...」进度浮层；按 Esc 或点击浮层即可取消。
- 识别完成后弹出表格结果窗口。
- 结果窗口打开时，截图编辑窗口会自动关闭。
表格结果窗口
结果窗口没有按钮栏
表格结果窗口没有按钮栏，所有操作都要在窗口里点右键，从右键菜单里执行。
| 菜单项 | 说明 |
|---|---|
| 📄 复制全部内容 | 复制整张表格 |
| 📋 复制选中内容 | 复制选中的部分（表格区有选中内容时才出现） |
| 💾 保存图片 | 保存原图 |
| ✕ 隐藏图片 | 折叠图片栏，让表格显示得更宽 |
| 📷 显示图片 | 图片被隐藏后出现，恢复图片栏 |
| ↺ 恢复默认显示（图片 + 表格） | 恢复默认布局 |
| 📌 窗口置顶 | 切换置顶 |
📷 插图占位（图 2）
表格结果窗口右键菜单 — 展示在结果窗口里点右键后的菜单：📄 复制全部内容、📋 复制选中内容、💾 保存图片、✕ 隐藏图片、↺ 恢复默认显示、📌 窗口置顶 补图：图片放到 docs/public/images/table-result-menu.webp，然后删除本提示块并打开下一行注释
粘到 Excel
- 在表格结果窗口里点右键 → 📄 复制全部内容。程序会同时写入纯文本与 HTML 两种剪贴板格式。
- 切到 Excel，直接按 Ctrl+V，行列与合并单元格都能保留。
用普通粘贴，不要用「选择性粘贴」
粘贴时请在 Excel 里直接 Ctrl+V，不要使用「选择性粘贴」——那样会丢掉 HTML 格式，只剩纯文本。
- 复制成功后只有
✓ 已复制的浮动提示，界面上不会出现「可粘贴到 Excel」之类的文字，没看到提示不代表复制失败。 - 复制的是「📄 复制全部内容」的结果；只想复制一部分时，先在表格区选中内容，再用「📋 复制选中内容」。
📷 插图占位（图 3）
复制表格后粘到 Excel — 展示结果窗口里「📄 复制全部内容」触发的 ✓ 已复制 浮动提示，以及 Excel 中 Ctrl+V 后保留行列与合并单元格的效果 补图：图片放到 docs/public/images/table-excel-paste.webp，然后删除本提示块并打开下一行注释
服务配置
入口：托盘右键 → 设置中心... → 左侧导航 🤖 AI 服务配置（不是托盘菜单里的「AI 服务配置」）。
- AI 服务来源：勾选 Pixwit AI，或勾选 自定义 AI 服务（使用自己的 API Key）——三个复选框可以多选，优先级固定为 本地 > 自定义 > Pixwit。
- 百度 OCR / 百度表格识别（勾选「自定义 AI 服务」后显示）：勾选
启用百度表格识别服务，填写API Key、Secret Key、Token URL、表格识别 URL四个输入框（URL 留空时使用百度官方默认地址），再点 测试连接 验证。 - 测试连接成功会提示连接成功与关键配置；缺少必填项、超时、HTTP 状态码异常、网络错误都会给出对应说明。
- 凭证保存在程序的
ai_credentials.json中。
识别失败
识别失败时窗口会显示 😕「表格识别失败」以及一段友好说明，例如：
| 提示 | 说明 |
|---|---|
| 认证失败，请检查 API Key、Secret Key 或 Token URL 配置 | 百度表格识别的凭证或地址需要检查 |
| 网络连接失败，请检查网络或 URL 配置 | 网络不通，或 表格识别 URL 不可达 |
| 未能识别到表格内容，请确保图片中包含清晰的表格 | 图里没有可识别的表格内容 |
提高识别率
- 截取清晰、正对、无遮挡的高分辨率图片，避免倾斜变形。
- 表格边框完整，背景简洁，文字清晰可辨。
- 一次只截一张表格，多张表格建议分别截取，避免混淆。
- 识别失败时程序会尝试其他引擎；仍然失败就缩小范围重试。
常见问题
Q：粘贴到 Excel 后格式不对？
- 在结果窗口的右键菜单里点「📄 复制全部内容」（会同时写入纯文本与 HTML 两种格式），然后在 Excel 里直接
Ctrl+V，不要用「选择性粘贴」。
Q：提示「表格识别服务未配置或未启用」？
- 到 设置中心 → 🤖 AI 服务配置 启用 Pixwit AI，或勾选「自定义 AI 服务」并配置好百度表格识别（记得点测试连接验证）。
Q：粘贴出来只有纯文本，没有行列和合并单元格？
- 说明 HTML 格式没有一起写入：确认用的是「📄 复制全部内容」，并且粘贴时用的是普通粘贴而不是「选择性粘贴」。