返回预配置的 httpx.Client。

构造标准化的搜索结果条目。

将 JATS XML 元素递归转为可读文本。 处理规则： - <p>: 段落，末尾加换行 - <title>: 跳过（章节标题在上层已处理） - <sec>: 子章节，递归（用缩进区分层级） - <list>/<list-item>: 转为 bul

过滤掉无信息量的内部 tag。

将嵌套章节扁平化，便于搜索。

Best-effort JSON parse — strip fences and try to find an outer {...}.

Run a list of (func, args, kwargs, label) tuples in a ThreadPoolExecutor. Returns a list of result dicts in submission order, each with keys:

Atomically re-read asset_plan.json, patch the target slot, write it back. Holds _PLAN_LOCK so concurrent gen-image workers can't clobber each oth

Release async resources owned by this adapter. Must be called when the adapter is no longer needed. Adapters that were given an exte

去掉 '1 ' / '1. ' 等数字前缀。

Ensure the parent directory of the given path exists. Args: path (Path): The file path whose parent directory should be creat

从 arXiv HTML 提取所有章节（含摘要）。 返回列表，每项： name - 章节标题（含编号，如 "1 Introduction"） level - 层级（0=摘要, 1=h2, 2=h3, 3=h4） text - 本章节正

从 arXiv HTML 提取论文标题。

获取 arXiv HTML 版本，不存在时抛出有意义的错误。

* Per-series color (from itemStyle.color or color property). * Returns 6-hex without '#' or null.

* 返回 { color, alpha }。alpha < 1 时调用方应设置 transparency。

返回预配置的 httpx.Client。

返回预配置的 httpx.Client。

返回预配置的 httpx.Client。

读取 API key：CLI 参数 > 环境变量。

读取 API key：CLI 参数 > 环境变量。

Check httpx response status code and raise appropriate exceptions. Args: response: The httpx response object. verbose: Whether to

* 检测元素是否使用了 -webkit-background-clip: text（渐变文字效果）

构造标准化的搜索结果条目。

Accept raw arXiv IDs, arXiv-prefixed IDs, abs URLs, and pdf URLs.

Call the VLM chat endpoint with one or more image paths. Returns assistant text.

Build endpoint URL and instantiate the matching adapter.

将 HTML 元素转为可读文本。 - math 元素：优先用 LaTeX 注解，否则用 alttext，再降级为 [MATH] - 图表标题：保留 - 跳过 .ltx_note（脚注编号）等噪音节点

Three-level discovery for sn_agent_runner.py. Level 1: SN_IMAGE_BASE env var → <path>/scripts/sn_agent_runner.py If the var is set

Three-level discovery for sn_agent_runner.py. Level 1: SN_IMAGE_BASE env var -> <path>/scripts/sn_agent_runner.py If the var is set

Import and return Configs from sn-image-base, or None on failure.

Human-readable progress line to stderr so the agent can tail it.

Return `{w, h, aspect}` for a local image file, or None if unreadable. Decodes only the dimensions (no full pixel buffer), so it's fine to call

Resolve the target language from params.language set by the entry-skill LLM. Falls back to 'zh-Hans' when not explicitly set.

Resolve and validate model runtime settings for a text or vision command. Returns: tuple[str, str, str, str]: (interface_type

Return the index of the close that balances the opener at ``start``. Tracks string literals and escapes so brackets inside strings don't count.