# 从图片里取代码

把**照片里的代码**转成纯文本，直接插到光标处 —— 拍电脑屏幕、拍书、拍别人的手机都可以。

> 入口：编辑器工具栏的 **📷 图片代码**（也可能是 ☰ 菜单里的同名项）。

## 一次完整的流程

1. 在编辑器里把**光标放到要插入的位置**（有选区时会替换选区）
2. 点 **📷 图片代码**，选图片来源：**拍照** 或 **相册**
3. 选好图后会先进入**框选**：用手指圈住只有代码的那一块，点确定
4. 应用把框里的图交给模型识别（屏幕上会提示「正在识别图片里的代码…」）
5. 识别完按结果自动处理（见下面三种情况）

**先框选，再识别**是有意的：拍到桌面、手指、背景时，只有框里的内容会参与识别，
多框一点背景就可能把书名、页码、水印一起转进来。

## 三种结果

| 情况 | 会发生什么 |
|---|---|
| **全部认出来了** | 直接插入，只弹一条「已插入 N 行」 |
| **有认不出来的字** | 弹框给你看识别结果，**你决定插不插**；插入后请核对 `□` 的位置 |
| **图里没有代码** | 只提示「没有识别到代码」，**一个字都不会插入** |

第三种情况之所以要单独拦一道：模型在图里找不到代码时往往回一句人话
（"抱歉，图片里没有代码"），直接插进去等于往你的源文件里塞垃圾。

## 那个 `□` 是什么

**看不清的字符一律用 `□` 占位，不让模型猜。**

代码里最容易混的就是这几对：`0/O`、`1/l/I`、`{/}`、`(/()`、`;/:`。
猜错一个字符，编译报错位置可能差好几行 —— 用 `□` 标出来，你一眼就知道该核对哪里。

## 需要能看图的模型

拍照识别走的是**当前模型的视觉能力**。模型目录里标了 **Vision** 的那些才稳定；
不支持的模型会直接把服务端的报错原文弹出来（比如 `model does not support image input`），
而不是笼统一句「识别失败」。

识别最长等 **120 秒**，超时会提示「识别超时」。

## 几个常见问题

- **只读文件插不进去**：大文件与只读模式下会提示「只读文件不能插入」。
  先在编辑器里进入编辑态（点一下要插入的那一行）。
- **拍出来糊**：靠近一点、**正对**屏幕、避开反光和手指印；屏幕亮度调高、把字号放大再拍。
- **框得太松**：把编辑器的行号、缩略图、滚动条一起框进去，模型会尽量忽略，
  但框得越准越省事。
- **识别出的缩进不对**：模型会保留原图的缩进结构；如果原图本身缩进不统一，
  插进来后按你项目的习惯整块调一次即可（插入整体算一步，可以一次撤销）。
