Communitygithub.com

sid732/LocalContextRouter

本地預檢路由器,決定文件的每一頁應以文字、裝置端 OCR 或圖片形式送達多模態模型,進而節省視覺 token 費用。支援 macOS。

LocalContextRouter 是什麼?

LocalContextRouter 是一個本地執行的預檢工具,用於智慧型路由文件頁面,以減少多模態 AI 模型的 token 消耗。當 LLM 處理 PDF 時,通常會同時提取文字和渲染每一頁為圖片,造成不必要的成本浪費。此技能透過分析頁面內容,將純文字頁面直接以文字傳遞、對僅含圖片的頁面進行裝置端 OCR、並將含有表格、圖表或圖形的頁面保留為圖片模式。支援 macOS 平台,透過 pip 套件 `localcontextrouter` 安裝,並提供 `localctx` 命令列工具。產生的 JSON 包含節省的 token 數與各頁面的來源類型、文字、token 數及可選的圖片路徑,讓開發者能靈活組合輸入給後續模型。所有處理都在本地離線完成,確保文件不會離開使用者的機器。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add sid732/LocalContextRouter

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Local Context Router

一個多模態模型在讀取 PDF 時,會同時提取文字並將每一頁渲染成圖片,然後為兩者付費。對於大多為純文字的頁面,圖片就是浪費的開銷。請先執行此預檢工具,只傳送每頁真正需要的內容給模型。

使用時機

在使用者分享的 PDF、掃描檔或螢幕截圖進行讀取、摘要或提取之前。

需求

必須安裝 localcontextrouter 套件(pip install localcontextrouter,macOS)。它會提供下文使用的 localctx 指令。

執行

路由文件並讀取 JSON,將任何視覺頁面渲染到資料夾中:

localctx <path-to-document> --json --vision-dir ./lcr-pages

如果 localctx 指令不可用,請使用已安裝 localcontextrouter 的 Python 執行隨附的腳本(腳本會匯入相同的套件):

python scripts/preflight.py <path-to-document> --json --vision-dir ./lcr-pages

使用結果

JSON 包含 tokens_saved 和一個 pages 陣列。每個頁面帶有 source、text、text_tokens、image_tokens 和 image:

  • source: "text":直接使用 text;不要附加圖片。
  • source: "ocr":該頁面僅包含圖片,已在裝置端完成 OCR;使用 text。
  • source: "vision":該頁面是表格、圖表或圖形;附加 image 中的圖片,以便模型能讀取。text 僅為粗略的備用方案。

按閱讀順序組合文字和 OCR 頁面,僅為視覺頁面附加圖片,如果使用者關心成本,可提及 tokens_saved。

備註

所有處理皆在本地離線執行;文件不會離開機器。

相關技能