@liustack/modlens 2.7.10 → 2.7.11

package/README.md

@@ -11,7 +11,7 @@
 
 DeepSeek-V4-Flash gives you a lot of model for very little money: fast, cheap, capable, and blind. It is not just DeepSeek either. Any text-only model running inside Codex, Claude Code, Pi, or OpenCode hits the same wall: you throw it a screenshot of an error and it sees nothing.
 
-ModLens gives it sight, and **you just paste**. Every other bridge makes you save the image to a file and then mention the path in the chat. ModLens pulls the pasted image back out of session storage instead. What comes back is not "this is a screenshot of an error", it is structured evidence: full OCR text, layout regions in reading order, semantic entities, visual clues, all of it quotable.
+ModLens gives it sight, and **you just paste**. Every other bridge makes you save the image to a file and then mention the path in the chat. ModLens pulls the pasted image back out of session storage instead. What comes back is not "this is a screenshot of an error", it is evidence you can quote: every word in the image transcribed, the layout cut into regions in reading order, and the entities and relations on screen listed separately.
 
 No model swap, no prompt surgery, no local proxy. It starts with no key at all.
 
@@ -52,7 +52,7 @@ All four harnesses are verified on real machines: Claude Code pinpoints the exac
 | :-- | :-- | :-- | :-- |
 | Your chosen model | has to change | stays | stays |
 | An image pasted into the chat | visible if the model supports it | out of reach, save a file and report the path | handled directly |
-| What you get back | the model's own reading | usually a description | OCR text, layout regions, semantics, visual clues |
+| What you get back | the model's own reading | usually a description | full transcription, layout regions, entities and relations, visual clues |
 | Where it cannot read | may invent | may invent | says so in `uncertainty` |
 | Cost | multimodal model pricing | usually per API call | agy's free quota, or a free Gemini key |
 | Setup | change config, change model | install a server, edit config | one CLI or one skill |
@@ -193,7 +193,7 @@ Pointing OpenCode at DeepSeek takes two lines of setup: `opencode auth login`, p
 ## Why a bridge instead of a multimodal model?
 
 - **Keep your model.** You picked DeepSeek-V4-Flash (or gpt-oss, or whatever else) for its price and its reasoning, not its eyesight. ModLens adds sight without touching that choice.
-- **Evidence beats pixels.** Text models reason best over structured text, not raw pixels. ModLens hands them OCR plus layout plus semantics, already decoded, not a base64 blob.
+- **Evidence beats pixels.** Text models reason best over structured text, not raw pixels. ModLens hands them the transcribed words, the segmented layout, and the extracted meaning, not a base64 blob.
 - **Engines die, the bridge survives.** v1 ran on Gemini CLI's free tier until Google shut it down in June 2026. v2 moved to its successor, Antigravity CLI, behind the same provider interface, so the next engine swap costs one file, not a rewrite.
 
 ModSearch, ModLens's sibling project, plays the same trick for web search and page fetching: [liustack/modsearch](https://github.com/liustack/modsearch).

package/README.zh-CN.md

@@ -11,7 +11,7 @@
 
 DeepSeek-V4-Flash 碗大又好吃，速度快、便宜、能打，唯独没有多模态。不止它，任何纯文本模型跑在 Codex、Claude Code、Pi、OpenCode 里，都撞同一堵墙：你甩过去一张报错截图，它看不见。
 
-ModLens 给它装上视力，而且**你直接粘贴就行**。别的方案都要你先把图存成文件、再在对话里报一句路径，ModLens 直接从会话存储里把粘贴的图捞回来。回来的不是一句「这是一张报错截图」，是结构化证据：OCR 全文、按阅读顺序排好的版面区块、语义实体、视觉线索，模型能引用具体内容。
+ModLens 给它装上视力，而且**你直接粘贴就行**。别的方案都要你先把图存成文件、再在对话里报一句路径，ModLens 直接从会话存储里把粘贴的图捞回来。回来的不是一句「这是一张报错截图」，是能引用的证据：图里的字一句不落地抄下来，版面按阅读顺序切成区块，画面里的实体和关系单列一份。
 
 模型不用换，提示词不用改，本地不装代理。零 key 就能开跑。
 
@@ -52,7 +52,7 @@ ModLens 走的是另一条路。图片字节在发给模型之前，早被 harne
 | :-- | :-- | :-- | :-- |
 | 你选的模型 | 得换掉 | 不用换 | 不用换 |
 | 粘贴进对话的图 | 模型支持就能看 | 接不住，得先存文件报路径 | 直接接住 |
-| 拿到手的是什么 | 模型自己的理解 | 通常一段描述 | OCR 全文、版面区块、语义、视觉线索 |
+| 拿到手的是什么 | 模型自己的理解 | 通常一段描述 | 全文转录、版面区块、实体关系、视觉线索 |
 | 读不准的地方 | 可能编 | 可能编 | 进 `uncertainty`，明说读不准 |
 | 花费 | 多模态模型的价格 | 多数按 API 计费 | agy 免费额度，或免费 Gemini key |
 | 上手 | 改配置换模型 | 装 server、改配置 | 一个 CLI 或一个 skill |
@@ -193,7 +193,7 @@ OpenCode 接 DeepSeek 只要两步：`opencode auth login` 选 DeepSeek 贴上 k
 ## 为什么外挂，而不是换多模态模型？
 
 - **模型不用换。** 你选 DeepSeek-V4-Flash（或 gpt-oss，或别的什么）图的是价格和推理能力，不是视力。ModLens 只加视力，不碰这个选择。
-- **证据强过像素。** 文本模型最会在结构化文本上推理，不是盯着原始像素。ModLens 递过去的是 OCR 加版面加语义，都是解好码的证据，不是一坨 base64。
+- **证据强过像素。** 文本模型最擅长在结构化文本上推理，不是盯着原始像素。ModLens 递过去的是转录好的文字、切好的版面、拆好的语义，不是一坨 base64。
 - **引擎会死，桥不会死。** v1 跑在 Gemini CLI 免费档上，2026 年 6 月被 Google 一刀切停掉。v2 换到继任者 Antigravity CLI，还是同一个 provider 接口，下次再换引擎，改一个文件就行，不用重写。
 
 姊妹项目 ModSearch 用同一招补上联网搜索和网页抓取：[liustack/modsearch](https://github.com/liustack/modsearch)。

package/dist/main.js

@@ -1478,7 +1478,7 @@ function recoverPastedImages(options = {}) {
   return result;
 }
 const program = new Command();
-program.name("modlens").description("Plug-in vision for text-only LLMs: image in, structured JSON evidence out").version("2.7.10");
+program.name("modlens").description("Plug-in vision for text-only LLMs: image in, structured JSON evidence out").version("2.7.11");
 program.command("analyze", { isDefault: true }).description("Analyze an image into structured JSON evidence (default command)").requiredOption("-i, --input <path|url>", "Input image path or https URL").option("-o, --output <path>", "Write result JSON to a file").option("-m, --model <name>", "Provider model name").option("-p, --provider <name>", `Vision provider (${listProviders().join(", ")})`).option("--prompt <text>", "Extra focus for this image").option("--timeout <ms>", "Provider timeout in milliseconds", "180000").option("--provider-bin <path>", "Provider binary path (default: agy)").option("--workdir <path>", "Working directory for the provider").action(async (options) => {
   try {
     const timeoutMs = Number.parseInt(options.timeout, 10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liustack/modlens",
-  "version": "2.7.10",
+  "version": "2.7.11",
   "description": "Plug-in vision for text-only LLMs, powered by the free Antigravity CLI",
   "type": "module",
   "bin": {

package/skills/modlens/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: modlens
-description: "Plug-in vision for text-only models. Use whenever the user shares an image (local path, screenshot, photo, chart, document scan, or image URL) and the active model cannot see images or has no vision tool. Runs the modlens CLI to convert the image into structured JSON evidence: OCR text, layout, semantics, visual clues. Also use when the user asks how to install, configure, or switch modlens providers (Gemini API key, OpenAI-compatible endpoints, Claude API or Claude Code CLI)."
+description: "Plug-in vision for text-only models. Use whenever the user shares an image (local path, screenshot, photo, chart, document scan, or image URL) and the active model cannot see images or has no vision tool. Runs the modlens CLI to convert the image into structured JSON evidence: every word transcribed, layout regions, semantics, visual clues. Also use when the user asks how to install, configure, or switch modlens providers (Gemini API key, OpenAI-compatible endpoints, Claude API or Claude Code CLI)."
 allowed-tools:
   - Bash
 ---
@@ -11,7 +11,7 @@ Use this skill when:
 
 - The user provides an image path or image URL and asks anything about it
 - The active model has no native vision (text-only model in a coding agent)
-- You need OCR text, layout, or chart/document structure as evidence before reasoning
+- You need the text inside an image, its layout, or a chart's structure as evidence before reasoning
 - The user asks how to configure modlens, get an API key for it, or switch its provider: follow `references/configure.md` and run the commands for them
 
 Do not use this skill for:
@@ -91,7 +91,7 @@ Harnesses rarely hand you a clean path. First identify which harness you are in,
 Top level: `{ image, provider, result, meta }`. Inside `result`:
 
 - `summary`: one-paragraph description of the image
-- `ocr.full_text` + `ocr.lines[]`: transcribed text evidence
+- `ocr.full_text` + `ocr.lines[]`: every word in the image, transcribed (the field keeps the familiar `ocr` name, though a vision model does the reading, not an OCR engine)
 - `layout.regions[]`: typed blocks (`title`, `paragraph`, `table`, `chart`, `code`, ...) in reading order
 - `semantics`: scene, intent, entities, relations
 - `visual`: colors and style clues