diff --git a/docs/USER_GUIDE.md b/docs/USER_GUIDE.md index fb872f0..b5a1c9a 100644 --- a/docs/USER_GUIDE.md +++ b/docs/USER_GUIDE.md @@ -243,7 +243,28 @@ Right-click on files/folders in the explorer: --- -## 10. Privacy & Data +## 10. Screenshot Capture + +You can attach screenshots to your chat messages to give the AI visual context. Access capture options from the **Feature Menu** (grid icon) in the Command Center. + +### Capture Modes + +* **Capture Window**: Select a window from the picker and attach a full screenshot of it. +* **Capture Region**: Select a window, then drag to crop a specific region from it. + +### Platform Notes (Linux / X11) + +On X11-based desktops (e.g., Openbox, i3, Fluxbox), window capture has the following limitations: + +* **Current workspace only**: The window picker only shows windows on your active workspace. Windows on other virtual desktops cannot be captured because X11 does not render off-screen windows. +* **Window must be visible**: The target window must be visible and not fully obscured by another window. If a window is covered, the capture may return a black image. **Click the window to bring it to the front before capturing.** +* **Compositors help**: If you run a compositor such as `picom` or `compton`, these limitations are largely eliminated — compositors maintain off-screen buffers for all windows, enabling capture of obscured or unfocused windows. + +These limitations do not apply to **Wayland** desktops (GNOME, KDE Plasma 6) or **macOS**, which use compositing by default. + +--- + +## 11. Privacy & Data * **No Telemetry**: Zaguán Blade does not collect usage telemetry. * **Local Storage Mode**: When using local storage, your code and conversations never leave your machine. @@ -251,7 +272,7 @@ Right-click on files/folders in the explorer: --- -## 11. Support & Feedback +## 12. Support & Feedback This is an **Alpha Release**. We define "Alpha" as "Feature incomplete, but good enough to be useful." diff --git a/src/pages/docs.astro b/src/pages/docs.astro index 893a212..60b4358 100644 --- a/src/pages/docs.astro +++ b/src/pages/docs.astro @@ -365,10 +365,43 @@ import BaseLayout from '../layouts/BaseLayout.astro'; - -
+ +
-
[010] PRIVACY_&_DATA
+
[010] SCREENSHOT_CAPTURE
+

Screenshot Capture

+

Attach screenshots to your chat messages to give the AI visual context. Access capture options from the Feature Menu (grid icon) in the Command Center.

+ +
+
+
🖼
+

Capture Window

+

Select a window from the picker and attach a full screenshot of it.

+
+
+
✂
+

Capture Region

+

Select a window, then drag to crop a specific region from it.

+
+
+ +
+

Platform Notes (Linux / X11)

+

On X11-based desktops (e.g., Openbox, i3, Fluxbox), window capture has the following limitations:

+
    +
  • Current workspace only — The window picker only shows windows on your active workspace. Windows on other virtual desktops cannot be captured because X11 does not render off-screen windows.
    • +
  • Window must be visible — The target window must be visible and not fully obscured by another window. If a window is covered, the capture may return a black image. Click the window to bring it to the front before capturing.
    • +
  • Compositors help — If you run a compositor such as picom or compton, these limitations are largely eliminated — compositors maintain off-screen buffers for all windows, enabling capture of obscured or unfocused windows.
    • +
+

These limitations do not apply to Wayland desktops (GNOME, KDE Plasma 6) or macOS, which use compositing by default.

+
+
+
+ + +
+
+
[011] PRIVACY_&_DATA

Your Data, Your Control

@@ -394,7 +427,7 @@ import BaseLayout from '../layouts/BaseLayout.astro';
-
[011] LOCAL_AI_SYSTEM_PROMPTS
+
[012] LOCAL_AI_SYSTEM_PROMPTS

Custom System Prompts

@@ -461,7 +494,7 @@ import BaseLayout from '../layouts/BaseLayout.astro';
-
[012] TOOL_CALLS_REFERENCE
+
[013] TOOL_CALLS_REFERENCE

Tool Calls Reference

@@ -486,7 +519,7 @@ import BaseLayout from '../layouts/BaseLayout.astro';
-
[012] KNOWN_BUGS
+
[014] KNOWN_BUGS

Known Issues

As an alpha release, there are some known limitations and bugs we're actively working on:

@@ -525,7 +558,7 @@ import BaseLayout from '../layouts/BaseLayout.astro';
-
[013] SUPPORT_&_FEEDBACK
+
[015] SUPPORT_&_FEEDBACK

Alpha Release

@@ -1296,6 +1329,92 @@ import BaseLayout from '../layouts/BaseLayout.astro'; border-color: var(--color-accent); } + /* Screenshot Capture */ + .screenshot-grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); + gap: var(--space-lg); + margin-bottom: var(--space-xl); + } + + .screenshot-card { + background: var(--color-bg); + border: 1px solid var(--color-border); + padding: var(--space-xl); + text-align: center; + transition: all 0.3s ease; + } + + .screenshot-card:hover { + border-color: var(--color-accent); + transform: translateY(-4px); + } + + .screenshot-icon { + font-size: 2.5rem; + margin-bottom: var(--space-md); + } + + .screenshot-card h3 { + font-size: 1.125rem; + font-weight: 700; + margin-bottom: var(--space-sm); + text-transform: uppercase; + } + + .screenshot-card p { + color: var(--color-text-secondary); + font-size: 0.95rem; + line-height: 1.6; + } + + .screenshot-notes { + background: var(--color-bg); + border: 1px solid var(--color-border); + border-left: 4px solid var(--color-accent-alt); + padding: var(--space-xl); + } + + .screenshot-notes h3 { + font-size: 1.125rem; + font-weight: 700; + margin-bottom: var(--space-md); + text-transform: uppercase; + } + + .screenshot-notes p { + color: var(--color-text-secondary); + line-height: 1.7; + margin-bottom: var(--space-md); + } + + .screenshot-notes ul { + list-style: none; + margin: var(--space-md) 0; + } + + .screenshot-notes li { + padding: var(--space-sm) 0; + border-bottom: 1px solid var(--color-border); + color: var(--color-text-secondary); + font-size: 0.95rem; + line-height: 1.6; + } + + .screenshot-notes li:last-child { + border-bottom: none; + } + + .screenshot-notes strong { + color: var(--color-text); + } + + .screenshot-note-wayland { + font-style: italic; + color: var(--color-text-tertiary) !important; + margin-bottom: 0 !important; + } + /* Privacy */ .privacy-grid { display: grid;