# 字回 ZiHui · CorelDRAW 插件

把**已经转曲（转成曲线）的文字**，一键认回原来的文字，并按原来的**位置、字号、字距、旋转**重建为可编辑的艺术文本对象。

流程：选中转曲文字 → 识别文字（Windows 内置 OCR）→ 逐字比对字体（本机全部已装字体）→ 按行确认字体 → 一键还原成文字对象。

界面分三个页签：**转曲恢复**（识别 + 还原）、**文字提取**（只提取文字内容，不改画布）、**合并拆分**（多段合并成一段 / 一段拆成单字）。

恢复页主要选项：
- **识别范围**：选中的对象 / 当前页面 / 整篇文档（逐页）——不是单选时也可以整页批量识别。
- **竖排文字（从右到左逐列识别）**：竖排排版自动识别失败时手动勾上。
- **整段使用同一字体（更快）**：整段统一成多数派字体，不再逐字挑。
- **字间距**：用字距还原（逐字按原位摆放）/ 用空格填充（整段做成一个文字对象，间隔用空格补）。
- **保留识别到的空格**、**中英文相邻时加空格**。
- **更多选项**：语言（中文 + English / 仅中文 / 仅英文）、恢复后隐藏原转曲对象（原路径保留）、刷新本机字体 / 检查更新 / 官方网站。

识别结果按行显示：每行可以直接改字，点候选字体（带百分比）就整行换字体；也可以点「对照 / 更换字体」手动输入字体名；上方「全部统一为…」可以把整篇统一成一款字体；勾「合成段落」会把行距一致、左对齐的多行合成一个段落文本。

---

## 一、安装

1. **先关闭 CorelDRAW**（它会占用插件文件）。
2. 双击 `安装.bat`，按提示点「是」给管理员权限。
3. 安装程序会自动从注册表找到 CorelDRAW 的安装目录，把插件复制到：
   `…\CorelDRAW Graphics Suite\27\Programs64\Addons\ZiHui\`
4. 打开 CorelDRAW，菜单 **窗口 → 泊坞窗 → 字回**。

卸载：双击 `卸载.bat`（同样要先关闭 CorelDRAW）。

> 支持 CorelDRAW 2019 及以后版本（本机实测 CorelDRAW Graphics Suite 2026 / 27.0.0.121）。
> 需要 Windows 10 / 11 自带的中文 OCR：设置 → 时间和语言 → 语言 → 中文(简体) → 可选功能 → 光学字符识别。中文系统一般默认已装。

## 二、授权（试用 + 激活码）

- **试用**：首次打开泊坞窗起算 **3 天**，顶部授权条显示「免费试用剩 N 天」。试用记录存在 `%LOCALAPPDATA%\ZiHui\trial.dat`（带 HMAC 签名，删掉或改日期会重新计 3 天）。
- **激活**：客户点「输入激活码」，把卖家给的码直接粘进去就行——**不需要机器码、不绑电脑**。卖家在 `_卖家工具\生成激活码.bat`（或服务器后台）填一个 4 位「码段」或留空自动随机，选永久或填天数，得到
  `ZH-20271231-K7M2-XXXX-XXXX-XXXX-XXXX`（7 段 = 日期 + 码段 + 16 位 HMAC 校验）。
- **校验规则**：码只由「码段 + 到期日」签名，改任何一位都失效；带到期日的过期即不可用；永久授权用 `99991231`。同一张码在任何电脑上都能验过，授权文件存 `%LOCALAPPDATA%\ZiHui\license.dat`，换机重装照样能用。
- **购买入口**：`ZiHui\授权配置.txt` 里填 `购买链接=` 与 `客服=`，「立即购买」会打开链接（没填链接则弹窗显示客服信息）。
- 试用到期后点「识别」「还原」会弹激活窗口，激活成功后才能继续用。

### 联网校验（可选，填了才启用）

`ZiHui\授权配置.txt` 里填 `校验地址=` 指向自己的授权服务器（服务器程序在 `_服务器\`，PHP 单文件或 Python 单文件，两天内就能部署完，见 `_服务器\部署说明.md`）：

- 激活时把「激活码」发给服务器（顺带的本机标识只作记录，**不参与校验**），服务器记下到期日、最近联网时间；
- 激活后 **7 天内可离线使用**（`License.GRACE_DAYS`），超过 7 天点识别/还原时自动复核，连不上就提示网络问题；
- 卖家后台可以随时**停用**某张码（客户端下次复核即失效，最迟 7 天），也能看到每张码最近一次联网时间；
- **一码一用**：服务器端 `ONE_USE` 默认开启，一张码只能激活一次（不管换不换电脑），客户重装/换机由店主后台「重置」放行；
- 填了校验地址但服务器连不上、或客户没网，会退回本机离线码校验，不会把已付费客户锁死。

> 取消机器码后，「一码一用」只能靠联网校验记账：不填 `校验地址=` 时，离线码谁拿到都能激活。

> 说明：离线码是 HMAC 对称签名（防改码），密钥在 DLL 里可被反编译，属于轻量防护；接了联网校验后，真正管用的是服务器那边的停用 / 有效期记账 / 一码一用。

## 三、用

1. 在 CorelDRAW 画布上**选中**已经转曲的文字（可以是整个组，也可以只选几个字）。
2. 泊坞窗里点 **识别选中文字**（首次识别要建字体索引，约 10 秒；之后很快）。
3. 看「识别结果」框：OCR 出的文字可以直接改（个别字认错时手改，比如「国」被认成「口」）。
4. 下面「逐字识别」列出每个字配到的字体和相似度（绿色 ≥72%，橙色偏低）。
5. 点 **还原为文字**。默认会删掉原来的曲线；勾选「保留原曲线」可保留原件做对比。

## 三、实现要点（给后续维护看）

| 环节 | 做法 |
| --- | --- |
| 连接 CorelDRAW | `Type.GetTypeFromProgID("CorelDRAW.Application.27")` + `Activator.CreateInstance`（`Marshal.GetActiveObject` 在本机取不到，CDR 不在 ROT） |
| 读曲线 | 递归拆组 → 每个叶子对象 `Curve.SubPaths → Segments`，贝塞尔按 12 段展平成多边形点集 |
| 字形切分 | 把所有轮廓渲染成一张黑白条图（按整体高度归一到 110px）→ Windows OCR 拿到逐字`BoundingRect` → 按每个轮廓的重心最近归属到某个字框。比"按间隙猜切分"稳得多 |
| 文字识别 | `ocr\ocr.ps1`（WinRT `Windows.Media.Ocr`，`zh-Hans-CN`），由插件用全路径 powershell.exe 调用，结果走 JSON |
| 字体匹配 | 先用 WPF `GlyphTypeface.CharacterToGlyphMap` 过滤"根本不含这个字"的字体（否则 GDI 缺字回退会让所有拉丁字体都像宋体）；再 18px 粗筛 IoU + 56px 精筛前 18 名；最后**整段投票**统一成一款字体（同一段文字通常同字体） |
| 字体名 | `Microsoft YaHei UI → 微软雅黑`、`SimSun/NSimSun → 宋体` 等做归一，界面上显示设计师熟悉的名字 |
| 字号 | 文字对象的「外框」含字体上下留白，不等于字形墨迹。所以用**同字体同字号的临时字转曲量墨迹高**，反推字号；整段取中位数字号（否则「：」这种矮标点会被算成超大字号） |
| 位置/旋转 | 同样按**墨迹外框**对齐：`LeftX = 字形墨迹左 - 文字外框到墨迹的横向差`，`BottomY = 字形墨迹底 - 纵向差`；差值按字号等比缩放。顺序仍是先定字号 → 再 `Rotate` → 最后定位 |
| 字数不一致 | OCR 偶尔丢标点（如「：」），导致「识别文字」比字形少一个。此时改为**每个字形用自己的识别结果**逐个还原，保证位置不错位（个别字事后在文本框里改） |
| 填色 | 优先 `Fill.ApplyUniformFill(源.Fill.UniformColor)`；`app.CreateColor()` 在本机报"颜色无效" |

## 四、目录结构

```
字回插件\
├─ package\                 ← 出货内容（拷给别人就用这个文件夹）
│  ├─ 安装.bat              ← 安装（自动提权 + 自动定位 CDR）
│  ├─ 卸载.bat              ← 卸载
│  ├─ _tools\findcdr.ps1    ← 从注册表找 CorelDRAW 安装目录
│  └─ ZiHui\                ← 直接对应 CDR 的 Addons\ZiHui 目录
│     ├─ CorelDrw.addon     ← 0 字节标记文件，CDR 靠它识别插件
│     ├─ AppUI.xslt         ← 定义泊坞窗 + wpfhost 宿主
│     ├─ UserUI.xslt        ← 把「字回」挂到「窗口 → 泊坞窗」菜单
│     ├─ ZiHuiDocker.dll    ← 插件本体（WPF 界面 + 识别/还原逻辑）
│     └─ ocr\ocr.ps1        ← Windows OCR 调用脚本
├─ src\                     ← 源码
│  ├─ Core\CdrInterop.cs    ← COM 连接、曲线读取与展平
│  ├─ Core\FontMatcher.cs   ← 字体枚举、栅格化 IoU 比对、整段投票
│  ├─ Core\OcrClient.cs     ← OCR 调用与 JSON 解析
│  ├─ Core\Job.cs           ← 一次任务：读选区 → 识别 → 还原
│  └─ Ui\DockerUI.cs        ← 泊坞窗界面（纯代码构建，无 XAML）
├─ build.ps1                ← 编译（csc.exe，产出 build\ZiHuiDocker.dll）
├─ _test\selftest.ps1       ← 端到端自测：在 CDR 里造字→转曲→识别→还原→校验
└─ _test\render-ui.ps1      ← 把泊坞窗界面渲染成 PNG（截图验收用）
```

## 五、改代码后怎么重新发布

```
powershell -ExecutionPolicy Bypass -File build.ps1
```
然后把 `build\ZiHuiDocker.dll` 覆盖到 `package\ZiHui\ZiHuiDocker.dll` 和
`…\Programs64\Addons\ZiHui\ZiHuiDocker.dll`，重开 CorelDRAW。

自测（会临时新建一个文档，跑完自动关闭，不影响已打开的文档）：
```
powershell -ExecutionPolicy Bypass -File _test\selftest.ps1 -FontName 微软雅黑 -Sample 秋季新品发布
```

## 六、已知限制

- OCR 对特别夸张的美术字（描边、变形、叠字）识别率会下降，认错时在「识别结果」框里直接改字即可，位置和字号仍然是按原字形来的。
- 中文艺术字若被设计软件做了自由变形（信封变形/透视），还原出的是标准字体文本，不会保留变形效果。
- 加粗/斜体：中文多为独立字族（如「微软雅黑 Bold」），插件按字族处理；对没有独立 Bold 字族的字体，`Story.Bold` 在部分版本不生效。
- 一段文字里混排多种字体时，采用「多数派字体」为主，个别字保留自己的最佳匹配。
