kongdeqiang
2026-10-14 9f9e043849b6f497e00399900ff234cf097eba82
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
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 中文字体文件路径,留空时按内置候选列表自动探测。
     *
     * <p><b>为什么需要它</b>:PDF 里的中文必须靠**嵌入字体**才能保证任何阅读器
     * 都能正确显示。PDF 内置的 14 个标准字体(Helvetica 等)只覆盖 Latin-1,
     * 中文写进去会直接抛 {@code IllegalArgumentException: No glyph for U+4E2D};
     * 而使用不嵌入的「标准 CJK 字体」(如 STSong-Light + UniGB-UCS2-H)
     * 虽然不用带字体文件,但 macOS 预览等阅读器未必装了对应字体,
     * 打开就是一片空白或乱码 —— 导出的文件是给用户长期保存的,
     * 不能赌对方机器上装了什么。
     *
     * <p>所以默认自动探测系统里现成的中文字体(macOS 的 Arial Unicode、
     * Linux 的 Noto CJK、Windows 的微软雅黑等)。探测失败不会让程序起不来,
     * 只是 PDF 导出会返回一条带操作指引的错误,TXT / JSON 导出不受影响。
     */
    private String pdfFontPath = "";
 
    /**
     * 单次导出最多包含的消息条数。
     *
     * <p>防止一条超长对话生成几十兆的 PDF 把内存和响应时间拖垮;
     * 超出时会截断并在文件末尾写明「已截断」。
     */
    private int maxMessages = 2000;
 
    /**
     * 单条消息正文进入导出文件的字符上限。
     *
     * <p>比 maxMessages 更常见的失控来源其实是**单条**超长消息
     * (比如把一整篇文档粘进对话)。
     */
    private int maxCharsPerMessage = 20000;
}