org.noear.solon.ai.skills.pdf

类 PdfSkill

java.lang.Object

org.noear.solon.ai.chat.skill.AbsSkill

org.noear.solon.ai.skills.pdf.PdfSkill

所有已实现的接口:

Skill

@Preview(value="3.9.1")
public class PdfSkill
extends AbsSkill

PDF 专家技能：提供 PDF 文档的结构化读取与精美排版生成能力。

核心职责：

• 双向转换：支持将 PDF 提取为纯文本（Parse），以及将 Markdown/HTML 渲染为 PDF（Create）。
• 字体引擎解耦：通过 Supplier<InputStream> 支持灵活的字体注入，完美解决中文字体渲染及跨环境（如容器）部署问题。
• 排版支持：内置基础 CSS 样式，确保生成的文档具备良好的可读性（支持表格、代码块及行高优化）。

从以下版本开始:

3.9.1

字段概要

从类继承的字段 org.noear.solon.ai.chat.skill.AbsSkill

tools

构造器概要

构造器

构造器和说明
PdfSkill(java.lang.String workDir) 基础构造：不强制要求字体（默认西文）
PdfSkill(java.lang.String workDir, java.util.function.Supplier<java.io.InputStream> fontSupplier) 高级构造：允许传入自定义字体流（如来自 resources 或外部文件）

方法概要

限定符和类型	方法和说明
java.lang.String	create(java.lang.String fileName, java.lang.String content, java.lang.String format)
java.lang.String	description() 获取技能描述
boolean	isSupported(Prompt prompt) 准入检查：决定该技能在当前对话上下文中是否被激活
java.lang.String	name() 获取技能名称（默认类名）
java.lang.String	parse(java.lang.String fileName) 解析功能（保持不变）

从类继承的方法 org.noear.solon.ai.chat.skill.AbsSkill

getTools, metadata

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.skill.Skill

getInstruction, onAttach

构造器详细资料

PdfSkill

public PdfSkill(java.lang.String workDir)

基础构造：不强制要求字体（默认西文）

PdfSkill

public PdfSkill(java.lang.String workDir,
                java.util.function.Supplier<java.io.InputStream> fontSupplier)

高级构造：允许传入自定义字体流（如来自 resources 或外部文件）

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

isSupported

public boolean isSupported(Prompt prompt)

从接口复制的说明: Skill

准入检查：决定该技能在当前对话上下文中是否被激活

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

create

@ToolMapping(name="pdf_create",
             description="\u751f\u6210 PDF\u3002format: \'markdown\', \'html\', \'text\'\u3002")
public java.lang.String create(@Param(value="fileName")
                                                                                                                                                                java.lang.String fileName,
                                                                                                                                                                @Param(value="content")
                                                                                                                                                                java.lang.String content,
                                                                                                                                                                @Param(value="format")
                                                                                                                                                                java.lang.String format)

parse

@ToolMapping(name="pdf_parse",
             description="\u8bfb\u53d6\u672c\u5730 PDF \u6587\u4ef6\u7684\u6587\u672c\u3002")
public java.lang.String parse(@Param(value="fileName")
                                                                                                                                                           java.lang.String fileName)

解析功能（保持不变）