centralized logging function for all agents args: agent_name: name of the agent (e.g., "parser", "color_agent") level: l

Ensure mask is boolean and matches target (H, W).

Parse StrategyGenAgent/StrategyReviewAgent JSON output to extract strategy, todo_list, and draft_response Returns: Tuple of (strategy

从 LLM 返回中提取 refine subtitle/cursor 文本，兼容历史 key。

统一封装 SAM 实例的后处理流程（过滤 + NMS + Top-K）。 典型用法： items = run_sam_auto(...) items = postprocess_sam_items( items,

Robust image reader: - supports non-ascii paths (np.fromfile + imdecode) - returns BGR uint8 HxWx3

读取文件内容 Args: file_path: 文件路径（相对于项目根目录或绝对路径） start_line: 起始行号（从1开始，可选） end_line: 结束行号（包含，可选） encoding: 文件

reset conversation

开始记录轨迹 Args: inputs: 初始输入数据 metadata: 额外元数据

停止记录并生成轨迹 Args: state: Workflow 执行后的最终状态 workflow_name: Workflow 名称 user_id: 用户 ID

收集模板并记录来源，检测重复 Parameters ---------- mapping : dict 包含模板的字典（通常是 vars(cls) 或 vars(mod)）

Convert local output paths inside pagecontent to browser-accessible URLs.

遍历 OPERATOR_REGISTRY，构建完整字典并写入 ops.json。 额外添加 "Default" → 所有算子全集。

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

ast.literal_eval 的宽松版本，失败就返回反编译字符串

Always fetch the CURRENT step as a pandas DataFrame. (Reuses the .read() logic in the parent class.)

convert rgb to hsv

Save session summary containing final strategies and interaction stats for all questions

kb_data/{email}/{notebook_name}/vector_store/

批量添加条件边

构建 LLM 输入消息列表 根据系统提示词模板和任务提示词模板生成完整的消息列表， 包括格式说明（如果使用解析器）。 Args: state (MainState): 当前状

Create a Markdown file containing basic paper information

从任意字符串中提取最长连续 Base64 串

执行 pdf2ppt 的业务逻辑，返回生成的 PPTX 文件路径