package com.custom.webui.config.props; import lombok.Data; import org.springframework.boot.context.properties.ConfigurationProperties; /** * 会话导出配置,前缀 {@code webui.export}。 */ @Data @ConfigurationProperties(prefix = "webui.export") public class ExportProperties { /** * PDF 中文字体文件路径,留空时按内置候选列表自动探测。 * *
为什么需要它:PDF 里的中文必须靠**嵌入字体**才能保证任何阅读器 * 都能正确显示。PDF 内置的 14 个标准字体(Helvetica 等)只覆盖 Latin-1, * 中文写进去会直接抛 {@code IllegalArgumentException: No glyph for U+4E2D}; * 而使用不嵌入的「标准 CJK 字体」(如 STSong-Light + UniGB-UCS2-H) * 虽然不用带字体文件,但 macOS 预览等阅读器未必装了对应字体, * 打开就是一片空白或乱码 —— 导出的文件是给用户长期保存的, * 不能赌对方机器上装了什么。 * *
所以默认自动探测系统里现成的中文字体(macOS 的 Arial Unicode、 * Linux 的 Noto CJK、Windows 的微软雅黑等)。探测失败不会让程序起不来, * 只是 PDF 导出会返回一条带操作指引的错误,TXT / JSON 导出不受影响。 */ private String pdfFontPath = ""; /** * 单次导出最多包含的消息条数。 * *
防止一条超长对话生成几十兆的 PDF 把内存和响应时间拖垮; * 超出时会截断并在文件末尾写明「已截断」。 */ private int maxMessages = 2000; /** * 单条消息正文进入导出文件的字符上限。 * *
比 maxMessages 更常见的失控来源其实是**单条**超长消息 * (比如把一整篇文档粘进对话)。 */ private int maxCharsPerMessage = 20000; }