根据页数和语言类型计算目标字符数 英文：约 3000 chars/page 中文：约 800 chars/page

为本次 pdf2ppt_with_sam workflow 创建统一的输出目录： - 如果 state.result_path 已存在，直接使用； - 否则使用项目根目录下 outputs/pdf2ppt_with_sam/<timestamp>。

为本次 pdf2ppt_with_sam workflow 创建统一的输出目录： - 如果 state.result_path 已存在，直接使用； - 否则使用项目根目录下 outputs/pdf2ppt_with_sam/<timestamp>。

parse color string to RGBColor

根据 api_url 粗略识别服务商

获取消息历史 Args: thread_id: 线程ID，如果为None则使用默认线程 limit: 限制返回的消息数量 before: 获取指定 checkpoint_id

获取后置工具列表 从工具管理器获取当前角色的后置工具，并去重。 Returns: List[Tool]: 去重后的后置工具列表

根据工作流名称获取 create_pipeline_graph 工厂方法。 Args: name (str): 工作流名称（注册名） Returns: Callable: 用于构建该工作流图的工厂函数

是否为 Gemini 3.1 Flash 系列 (Nano Banana 2)

load prompt template from file

使用 BRIA-RMBG 2.0 模型进行背景抠图的统一接口。 参数 ---- req: 配置字典，支持字段： - ``image_path``: str，必需，输入图片路径。 - ``model_path``: s

节点执行结束 Args: output: 节点输出 error: 错误信息

Convert PDF to Markdown. Uses a global lock to protect docling calls, ensuring only one PDF is converted at a time. Returns the generated fil

简单模式处理 - 单次 LLM 调用 最基础的执行模式，直接调用 LLM 并解析结果。 Args: state (MainState): 当前状态对象 pre_too

尽量从 LLM / 日志 / jsonl / Markdown 片段中提取合法 JSON。 参数 ---- text : str 输入原始文本 merge_dicts : bool, default False 提取到多个对

使用 MinerU HTTP 接口提取 PDF 内容（HTTP-only 路径）： PDF -> 按页转图片 -> batch two_step_extract -> blocks 转 markdown 输出目录结构与 CLI 模式对齐： <output_

统一 paper2ppt workflow 的根输出目录： - 若 state.result_path 已存在（通常由调用方传入），直接使用； - 否则：使用 get_project_root()/outputs/paper2ppt/<timestamp> 初始化，并写回

kb_data/{email}/{notebook_name}/generated/{output_type}/{next_seq}/ Auto-increments the sequence number.

生成消息唯一 ID

从 Paper2PPTRequest 初始化 Paper2FigureState，兼容三种场景： - full pipeline: 需要根据 input_type / input_content 设置 paper_file / text_content 等； - pagec

检查 URL 是否是 Data URI

kb_data/{email}/{notebook_dir_name}/ Falls back to old path (using notebook_id) if new path doesn't exist.

跟踪模板来源，检测重复并发出警告

调用通用图像理解模型

创建 FastAPI 应用实例。 这里只做基础框架搭建： - CORS 配置 - 路由挂载 - 静态文件服务

导出轨迹 Args: trajectory: 要导出的轨迹，如果为 None 则使用当前轨迹 format: 导出格式（json/jsonl/sft/dpo） filepath

显式释放 RMBG-2.0 模型占用的显存。 - model_path 为 None 时：释放所有已缓存的抠图模型； - 否则：仅释放对应 model_path 的实例。