快速上手

一次生成完整的流程

1. 输入文字 —— 在中间的文字框里直接输入，或者点「选择文件」上传一份文档。
2. 选字体 —— 左侧「字体文件」里挑一个服务器上已有的字体，或者点「选择文件」上传自己的 .ttf。
3. 定纸张 —— 要么给出宽度和高度（会自动生成带横线的稿纸），要么上传一张背景图片。
4. 调参数 —— 想省事就用默认值；要细调看参数详解。
5. 点「预览手写图像」 —— 右侧会显示渲染结果，多页时可以用「上一页 / 下一页」翻。
6. 导出 —— 「生成完整手写图片」得到整页 PNG 的 zip 包，「生成pdf」得到合并好的 PDF。

先预览再导出

预览只渲染第一页，用来快速试参数；导出才会把全部页面渲染出来。文字很长时先预览能省不少时间。

界面是三个区

新版界面把工作区分成三栏，从左到右是：

• 左栏 · 参数设置 —— 字体、纸张、字号行距边距、「更多内容」里的随机扰动。
• 中栏 · 文字 —— 输入框、文档上传、书信排版按钮。
• 右栏 · 预览 —— 渲染结果的预览图和翻页控件。

左栏和右栏的宽度可以拖动分隔条调整，双击分隔条恢复默认宽度。拖动出来的宽度会记住， 下次打开还是你调过的那样。

想用回老版式的话，点顶栏的「旧版界面」切换 —— 两种界面改的是同一份内容，随时切回来。

输入文字

.doc 不支持

上传文档的格式是 .docx、.pdf、.txt、.rtf。老式的 .doc 虽然出现在文件选择框里， 但服务端不认识它，会返回「doc文件暂不支持」。请先另存为 .docx。

• 文字框里的内容和上传的文档都会记住，刷新页面不会丢。
• 上传文档只是把正文填进文字框，填完之后仍然可以手动编辑。
• 长文本的页数估算显示在文字区下方。在 handwrite.14790897.xyz 上单次最多渲染 10 页， 超出部分会被截断，估算提示会提前告诉你。

选字体

两种方式二选一：

• 用服务器已有的字体 —— 在下拉框里选。这些是部署时放进 ttf_files/ 的字体。
• 上传自己的字体 —— 点「选择文件」选一个 .ttf。只有上传的文件名和下拉框里选中的名字一致时， 才会真的把文件发到后端；换句话说，上传后记得在下拉框里选中它。

定纸张

宽度和高度、背景图片这两组是互斥的：

• 给了宽度和高度 → 后端生成一张白底带横线的稿纸（要不要横线由「增加下划线」决定）。
• 上传了背景图片 → 用你的图当底，此时宽度和高度会置灰。

上传背景图片后会弹窗问你要不要自动检测边距 —— 选「是」的话，程序会分析图片里的横线， 把上/下/左/右边距和行间距自动填好。自己画的横线稿纸用这个功能很省事。

记住你的参数

顶栏三个按钮管的是参数快照（存在浏览器本地）：

• 保存设置 —— 把当前所有参数存下来。
• 载入设置 —— 把存过的参数读回来。
• 重置设置 —— 恢复默认值。

「内置预设」下拉框是另一回事，它是一组预置好的参数组合， 目前有「小字加下划线（云烟体）」。这个预设需要 云烟体.ttf， 并且要求当前没有背景图片 —— 条件不满足时会提示你。

排队与等待

后端同一时间只处理有限个任务。人多了会看到：

• 文字区显示「正在生成中」和冷却倒计时。
• 队列已满时顶栏会弹出等待倒计时，告诉你大概还要多久。

生成中的进度通过 WebSocket 实时推给你；连接不上时自动退回轮询，界面上没有区别。