@omniaibot/win-x64 1.6.11 → 1.6.13

package/bin/omnibot-windows-x64/VERSION

@@ -1 +1 @@
-1.6.11 
+1.6.13 

package/bin/omnibot-windows-x64/omnibot/skills/omnibot/SKILL.md

@@ -1,11 +1,13 @@
 ---
 name: omnibot
+slug: omnibot
+displayName: omnibot-智能体浏览器自动化工具
+version: "2.4.0"
+summary: 为 AI Agent 提供浏览器基础设施，连接真实 Chromium 浏览器进行页面读取、操作、导航和调试。
+license: MIT
 description: Use when AI agents need to read, inspect, operate, navigate, debug, or verify browser state through the omnibot CLI and connected Chromium extension.
 compatibility: Requires omnibot v2 CLI daemon and the omnibot Chromium extension connected to 127.0.0.1:18765.
 allowed-tools: Bash
-metadata:
-  author: omnibot
-  version: "2.4.0"
 ---
 
 # Omnibot
@@ -214,12 +216,28 @@ Choose by intent before choosing by command name:
 | Intent | Prefer | Why |
 | --- | --- | --- |
 | Summarize or extract page content, article text, search results, feeds, or long/lazy pages | `read` | Returns clean text/Markdown for agent reasoning. |
-| Quickly observe current visible UI structure before deciding what to do next | `snapshot -i` | Returns actionable refs and page structure for routing. |
+| Quickly observe current visible UI structure before deciding what to do next | `snapshot -i` | Returns interactive refs plus visual-region refs for screenshot targeting. |
 | Find buttons, links, inputs, or refs for a later action | `find` or `snapshot -i` | Produces actionable targets; `read` does not. |
 | Verify one concrete condition | `get`, `is`, or `wait` | Narrow evidence is more reliable than dumping a page. |
 
 Do not use `read` as the first step for click/fill workflows unless the user explicitly asked for page content first.
 
+## Screenshots And Visual Regions
+
+`screenshot --tab-id <TAB_ID>` without `--ref` remains a full current-viewport screenshot.
+For a specific visual region, run `snapshot -i` and choose a ref marked `[visual=true]`, such as
+`article`, `region`, `dialog`, `listitem`, `image`, or `video`:
+
+```bash
+OMNIBOT_SESSION_TOKEN=visual omnibot snapshot -i --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=visual omnibot screenshot --ref @e146 --tab-id <TAB_ID> -o /tmp/region.png
+```
+
+Visual-region refs are intended for complete content containers, cards, posts, dialogs, media, and similar areas.
+Do not screenshot a button, link, or textbox as a standalone target unless the user explicitly asks for that control.
+The ref screenshot path re-resolves the live DOM node, scrolls it into view, waits for layout to settle, and then captures its region.
+After `read` or scrolling, refresh the snapshot before using a stale ref. Raw `get box` plus `cdp Page.captureScreenshot` is not the normal screenshot workflow.
+
 ## Dropdowns And Custom Comboboxes
 
 `snapshot -i` may auto-probe visible custom comboboxes and append their options as refs. If the output lists `@eN [option] "..."`, click that option ref directly; Omnibot will reopen the owning combobox through `openerSelector` if the dropdown closed during snapshot.

package/bin/omnibot-windows-x64/omnibot/skills/omnibot/references/command-reference.md

@@ -112,7 +112,7 @@ Fallback relation: Prefer for page content. Use `snapshot -i` when the next step
 
 ### snapshot -i
 
-Purpose: Read accessibility tree and produce actionable `@eN` refs.
+Purpose: Read accessibility tree and produce actionable `@eN` refs. With `-i`, it includes both interactive refs and visual-region refs marked `[visual=true]` for targeted screenshots.
 
 For visible custom comboboxes, `snapshot -i` may auto-probe options and append `[option]` refs under DOM Popup Controls. These refs remain actionable after the dropdown closes because they carry `openerSelector` internally.
 
@@ -563,9 +563,16 @@ Purpose: Capture visual evidence from a browser tab.
 
 ```bash
 OMNIBOT_SESSION_TOKEN=debug-checkout omnibot screenshot --tab-id <TAB_ID> -o /tmp/omni-shot.png
+OMNIBOT_SESSION_TOKEN=debug-checkout omnibot snapshot -i --tab-id <TAB_ID>
+OMNIBOT_SESSION_TOKEN=debug-checkout omnibot screenshot --ref @e146 --tab-id <TAB_ID> -o /tmp/omni-region.png
 OMNIBOT_SESSION_TOKEN=debug-checkout omnibot screenshot --annotate --tab-id <TAB_ID> -o /tmp/omni-annotated.png
 ```
 
+Without `--ref`, screenshot captures the current viewport. `--ref` accepts a visual ref marked
+`[visual=true]`, such as `[article]`, `[region]`, `[dialog]`, `[listitem]`, `[image]`, or `[video]`.
+Do not use ordinary button/link/textbox refs as standalone screenshot targets. Re-run `snapshot -i`
+after scrolling or `read` before using a ref that may be stale.
+
 Preferred pattern: See `debugging-and-evidence.md#screenshot`.
 Fallback relation: Evidence collection, not operation fallback.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omniaibot/win-x64",
-  "version": "1.6.11",
+  "version": "1.6.13",
   "description": "omnibot executable for Windows x64",
   "os": [
     "win32"