ClickSay Self-Help Support Guide

Language: English Last updated: March 2026 Extension version: v1.1.0

---

Table of Contents

1. Getting Started
2. How to Use ClickSay
3. Output Formats
4. Side Panel
5. Settings
6. Free vs Pro
7. Keyboard Shortcuts
8. Troubleshooting
9. Privacy & Security
10. FAQ

---

1. Getting Started

What is ClickSay?

ClickSay is a Chrome extension that turns UI feedback into structured, AI-ready prompts. Instead of typing long descriptions to explain what you want changed on a web page, you simply click an element, speak your feedback, and paste the result into any AI coding tool. What used to take a minute of typing takes about 8 seconds with ClickSay.

Installing ClickSay

1. Visit the ClickSay listing on the Chrome Web Store.
2. Click Add to Chrome.
3. Confirm the permissions when prompted.
4. The ClickSay icon appears in the Chrome toolbar.

Pinning the Icon

If you do not see the ClickSay icon in your toolbar:

1. Click the puzzle piece icon (Extensions) in the Chrome toolbar.
2. Find "ClickSay - AI Feedback Copilot" in the list.
3. Click the pin icon next to it to keep it visible.

Your First Capture - A Walkthrough

Follow these steps to make your first capture:

1. Open any web page (for example, your own project running on localhost, or any public website).
2. Press Cmd+Shift+K (Mac) or Ctrl+Shift+K (Windows/Linux) to activate capture mode. You will see an orange outline appear as you hover over elements.
3. Click any element on the page. A popup will appear near the element, and the microphone starts automatically.
4. Speak your feedback naturally - for example, "make this button bigger and change the color to blue."
5. Press Enter or wait 2 seconds after you stop speaking. The structured prompt is copied to your clipboard.
6. Open your AI tool (Claude Code, Cursor, Lovable, Replit, Bolt.new, etc.) and paste with Cmd+V / Ctrl+V.

That is it. The AI now has the full context - the element's selector, styles, HTML, and your feedback - and can make the change accurately.

---

2. How to Use ClickSay

The Click-Speak-Paste Workflow

ClickSay follows a simple three-step workflow:

Step 1: Click

Activate capture mode using any of these methods:

• Press Cmd+Shift+K (Mac) or Ctrl+Shift+K (Windows/Linux)
• Click the ClickSay icon in the toolbar, then click "Capture" in the side panel
• Right-click any element on the page and select "ClickSay this element"

Once capture mode is active, elements highlight with an orange outline as you hover over them. Click the element you want to give feedback on.

Step 2: Speak (or Type)

After you click an element, a popup appears near it. The microphone starts automatically and you will see "Listening..." in the popup.

• Speak your feedback naturally: "fix the padding," "make this bigger," "change the font to sans-serif."
• Type in the popup textarea instead if you prefer not to use voice.
• Combine both - you can speak and then edit or add to the text by typing.
• Tap a suggestion chip - context-aware quick-feedback buttons appear based on the element you clicked. Tap one to insert that text instantly.

Step 3: Paste

When you are done with your feedback:

• Press Enter in the popup to stop recording and copy the prompt to your clipboard.
• Or simply stop speaking - after 2 seconds of silence, ClickSay automatically copies the prompt (auto-copy on silence).
• Paste the result into your AI tool with Cmd+V / Ctrl+V.

Sweep Mode (Multiple Elements)

Sweep mode lets you select multiple elements and give a single piece of feedback for all of them. This is a Pro feature.

1. Activate capture mode (Cmd+Shift+K).
2. Hold Shift and click each element you want to include. Each clicked element gets a numbered badge.
3. When you are done selecting, click the final element without holding Shift.
4. The popup appears. Speak your feedback - it applies to all selected elements.
5. Press Enter. A single structured prompt covering all elements is copied to your clipboard.

Suggestion Chips

When the popup appears, you will see small clickable buttons with common feedback phrases. These are called suggestion chips, and they change based on what kind of element you clicked:

• Buttons/links: "Change the text," "Fix hover state," "Make more prominent," "Change color"
• Images: "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• Form inputs: "Change placeholder," "Fix validation," "Resize this field," "Add label"
• Headings: "Change text," "Adjust size," "Change font weight," "Fix spacing"
• And more for navigation, lists, tables, flex containers, and grid containers.

Tap a chip to insert its text into your feedback. You can then edit or add to it.

Auto-Copy on Silence

After you stop speaking, ClickSay waits 2 seconds of silence and then automatically copies the structured prompt to your clipboard. You do not need to press Enter - just stop talking and the prompt is ready to paste.

If background noise is being picked up as speech, the silence timer will not start. In noisy environments, press Enter manually or type your feedback instead.

Draggable Popup

If the feedback popup is covering the element you want to look at, just drag it out of the way. Click and drag the handle bar at the top of the popup to reposition it anywhere on screen.

Inline Flow

You can complete the entire capture-to-clipboard workflow right in the popup without ever opening the side panel. Click an element, give feedback, and the prompt is copied - all inline. The side panel is still there when you need history, settings, or output format changes.

---

3. Output Formats

Presets

ClickSay offers four output presets that control how much detail is included in the generated prompt.

Simple (Free)

A single-line, terminal-friendly format. Includes only the page URL.

Example:

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

A structured markdown format. Includes the URL, CSS selector, and element text.

Example:

## Feedback
Make this heading smaller and dark blue

**URL:** https://myapp.com/dashboard

**Element:** `<h1>` `#page-title`

**Selector:** `h1.page-title`

**Text:** "Dashboard Overview"

Detailed (Pro)

Full structured markdown. Includes URL, selector, text, HTML, computed CSS styles, file path, and component name.

Full (Pro)

Everything ClickSay captures. Includes all data from Detailed plus parent context HTML, screenshot, and accessibility audit results.

Pills (Individual Toggles)

Each piece of captured data corresponds to a toggleable "pill" in the side panel. You can turn individual data fields on or off to customize your output.

How to Customize Output

1. Open the side panel by clicking the ClickSay icon.
2. In the Output Format section, click a preset button to start with a base configuration.
3. Toggle individual pills on or off to fine-tune what data is included.
4. Your selections are saved automatically and persist across sessions.

When you toggle pills manually, the active preset highlight updates to show whether your configuration matches any preset exactly.

---

4. Side Panel

The side panel is ClickSay's main control surface. Open it by clicking the ClickSay icon in the toolbar.

What Everything Does (Top to Bottom)

Header

• ClickSay brand name with a plan badge (PRO or Free).
• Upgrade link (visible for free users) - opens the pricing page.
• Capture button - activates feedback mode on the current tab.
• Clear button - removes all history.

Output Format Section

• Preset row: Four buttons - Simple, Standard, Detailed, Full. Detailed and Full show lock icons for free users.
• Pill toggles: Ten checkboxes for individual data fields. Pro-only pills (Screenshot, Component, A11y) show lock icons for free users.

Relay Section

• Shows whether the optional Claude Code relay server is connected.
• Green dot = connected. Red dot = not detected.
• Auto-send toggle appears when the relay is connected.

Capture View

After you capture an element, this section shows:

• Element card: Tag name, CSS selector, and a preview of the element's text.
• Screenshot card: The captured screenshot with an orange highlight on the element (if a screenshot was taken).
• Feedback card: A textarea showing your voice-transcribed or typed feedback. Includes a mic button to start/stop recording.
• Target file card: The auto-detected or manually entered file path. An "Auto-detected" label appears when the path was resolved from mapping rules.
• Copy to Clipboard button with Cmd+Return shortcut hint.

Account / Plan Section

• Shows your current plan (Free or Pro).
• For free users: displays voice and screenshot usage counters (e.g., "3/20 this month").
• Upgrade or Manage link.

History Section

• History items grouped by date (Today, Yesterday, or specific dates).
• Each item shows the timestamp, element tag, page hostname, and truncated feedback text.
• Click an item to reload it into the capture view.
• Each item has a copy button (to re-copy the prompt) and a delete button.
• Batch actions: "Copy Selected" and "Select All" buttons appear when items are selected.

Storage Management

• Storage used: Shows how much local storage ClickSay is using (e.g., "2.3 MB").
• Auto-purge dropdown: Choose how long to keep history - 7 days, 30 days, 60 days, 90 days, or Never. Free users are limited to 7 days.
• Purge Images Now: Removes all stored screenshots while keeping your text history.

Version Display

The current extension version is shown at the bottom of the side panel.

---

5. Settings

Accessing the Options Page

Right-click the ClickSay icon in the toolbar and select Options. Or navigate to your Chrome extensions page, find ClickSay, and click "Details" then "Extension options."

Project Root

The base directory of your project on your local machine. For example:

/Users/you/projects/my-app

This is used to resolve file paths in the output. When ClickSay detects a component or maps a URL to a file, the project root is prepended to create a full path.

URL-to-File Mapping

Regex-based rules that map URL patterns to source file paths. This is useful when automatic framework detection does not find the right file.

ClickSay includes presets for common setups:

• Static Site - maps URLs directly to file paths
• Next.js - maps routes to app/ directory structure
• SvelteKit - maps routes to src/routes/ structure
• React (CRA) - maps to src/ directory structure

To add a custom rule:

1. Enter a URL regex pattern (e.g., /dashboard/(.*))
2. Enter the file path template (e.g., src/pages/dashboard/$1.tsx)
3. Click Save Settings

License Key

If you have purchased ClickSay Pro:

1. After payment, you receive a license key via email.
2. Enter the license key in the Pro License field on the Options page.
3. Click Validate.
4. If valid, your plan immediately upgrades to Pro.

The license key is also automatically sent to the extension after purchase via the ClickSay website - you may not need to enter it manually.

---

6. Free vs Pro

What is Included in Free

What is Included in Pro

Pricing

• Free: $0
• Pro Monthly: $9/month
• Pro Yearly: $49/year (55% savings)

How to Upgrade

1. Click the Upgrade link in the side panel header or Account section.
2. This opens the pricing page at https://clicksay.net/#pricing.
3. Click Go Pro to start a Stripe checkout.
4. After payment, a license key is generated. It is automatically sent to your extension.
5. If automatic activation does not work, copy the license key from your email and enter it in the Options page.

Usage Limits and Resets

• Voice and screenshot usage counters reset at the start of each calendar month.
• Usage is displayed in the Account section of the side panel.
• You can still capture elements and type feedback even when voice limits are reached.

---

7. Keyboard Shortcuts

Context Menu

Right-click any element on a web page and select ClickSay this element to activate capture mode for that element.

Customizing the Shortcut

If Cmd+Shift+K / Ctrl+Shift+K does not work or conflicts with another extension:

1. Navigate to chrome://extensions/shortcuts in your browser.
2. Find "ClickSay - AI Feedback Copilot."
3. Click the pencil icon next to "Activate ClickSay feedback mode."
4. Record your preferred shortcut.

---

8. Troubleshooting

Keyboard shortcut not working

Problem: Pressing Cmd+Shift+K / Ctrl+Shift+K does nothing.

Solution:

1. Go to chrome://extensions/shortcuts.
2. Find "ClickSay - AI Feedback Copilot."
3. Check if the shortcut is assigned. If it shows "Not set," click the pencil icon and record Cmd+Shift+K.
4. If another extension uses the same shortcut, change one of them.
5. As an alternative, use the toolbar icon or right-click context menu.

Microphone not working

Problem: The mic does not activate, or speech is not being recognized.

Solution:

1. Click the lock icon in the Chrome address bar for the current site.
2. Make sure "Microphone" is set to "Allow."
3. On macOS, check System Preferences > Privacy & Security > Microphone and ensure Chrome is allowed.
4. Make sure no other app is using the microphone.
5. Refresh the page after granting permission.

Cannot capture on a page

Problem: Capture mode activates but clicking elements does nothing, or capture mode will not activate at all.

Solution:

1. ClickSay does not work on chrome:// pages, the Chrome Web Store, or other restricted browser URLs. Try a regular website.
2. Refresh the page and try again.
3. Some pages with strict Content Security Policies may block script injection. Check the browser console for errors.

Side panel not opening

Problem: Clicking the ClickSay icon does nothing.

Solution:

1. Click the puzzle piece icon in the toolbar and pin ClickSay.
2. Then click the ClickSay icon to open the side panel.
3. If it still does not work, try restarting Chrome.

Output not copying to clipboard

Problem: You pressed Enter or clicked Copy, but nothing is on your clipboard.

Solution:

1. Try pressing Enter from the in-page popup (this has the best success rate because it runs within a user gesture context).
2. Try pressing Cmd+Return from the side panel with the panel focused.
3. Make sure no other extension is intercepting clipboard writes.
4. ClickSay tries three clipboard methods in sequence. If all fail, there may be a browser-level restriction.

Voice limit reached

Problem: You see a message that your voice limit has been reached.

Solution:

1. The free plan allows 20 voice feedbacks per month.
2. Usage resets at the start of each calendar month.
3. You can still type your feedback - only voice is limited.
4. Upgrade to Pro for unlimited voice.

Screenshot limit reached

Problem: Captures work but screenshots are not being taken.

Solution:

1. The free plan allows 5 screenshots per month. Check the Account section in the side panel.
2. Usage resets at the start of each calendar month.
3. Upgrade to Pro for unlimited screenshots.

Popup is covering the element

Problem: The feedback popup appears on top of the element you want to see.

Solution: Drag the popup out of the way. Click and drag the handle bar at the top of the popup to reposition it anywhere on screen.

Enter or Escape keys not responding

Problem: Pressing Enter or Escape in the popup does nothing.

Solution: This was a known issue in v1.0 where page modals could intercept keyboard events. Update to v1.1.0 or later to fix this. Check the side panel footer for your current version.

Suggestion chips not appearing

Problem: No suggestion chips show up in the popup after clicking an element.

Solution: Chips are context-aware and only appear for certain element types (buttons, images, inputs, links, headings, navigation, lists, tables, flex/grid containers). If you clicked a generic container like a plain <div>, chips may not appear.

Page styles looking broken after capture

Problem: The page layout or styles seem affected after using ClickSay.

Solution: ClickSay's UI is isolated from the page's styles using a closed Shadow DOM. If you see visual issues, make sure you are on v1.1.0 or later. Update from the Chrome Web Store.

Auto-copy not working

Problem: You stopped speaking but the prompt was not automatically copied.

Solution: Auto-copy triggers after 2 seconds of silence. If background noise is being picked up as speech, the silence timer will not start. Try moving to a quieter spot or type your feedback instead. You can always press Enter manually.

Framework/component name not showing

Problem: The Component pill is enabled but no component name appears.

Solution:

1. Component detection is a Pro feature - make sure you have Pro.
2. Framework detection works best on development builds (localhost, dev mode). Production builds often strip debugging data.
3. If detection fails, use URL-to-File mapping rules in the Options page as an alternative.

File path says "Not configured"

Problem: The file path field shows "Not configured" instead of a source file.

Solution:

1. Open the Options page (right-click ClickSay icon > Options).
2. Set the Project Root (e.g., /Users/you/projects/my-app).
3. Add mapping rules or use a preset (Next.js, SvelteKit, React, Static Site).
4. Click Save Settings.

Relay not detected

Problem: The side panel shows "Relay not detected" with a red dot.

Solution:

1. The relay is optional. You only need it if you want to send prompts directly to Claude Code.
2. To start the relay, open a terminal and run npx clicksay-relay.
3. The status in the side panel updates within 30 seconds, or close and reopen the side panel.
4. Make sure no firewall is blocking localhost port 19876.

Which version am I on?

Open the side panel - the version number is displayed at the bottom.

---

9. Privacy & Security

All Data Stays Local

ClickSay operates entirely within your browser. All processing - DOM capture, speech recognition, prompt formatting, screenshot capture - happens on your machine. There is no ClickSay server processing your data.

What Stays in Your Browser

• All captured element data (selectors, HTML, styles, etc.)
• All voice feedback text
• All screenshots
• Feedback history
• Your settings (output preferences, mapping rules, relay preference)

What Leaves the Browser

Data only leaves your browser in these situations, all of which you initiate:

1. Clipboard copy - When you copy a prompt, it goes to your system clipboard.
2. Optional relay - If you enable the relay and it is running, prompts are sent to 127.0.0.1:19876 (localhost only - never leaves your machine).
3. License validation - If you have a Pro license key, the extension checks it against https://clicksay.net/api/license/validate. This request contains only the license key - no feedback, no screenshots, no user data.

No Tracking

• No analytics or telemetry of any kind.
• No cookies or tracking scripts.
• No user accounts or authentication (Pro uses a license key, not a user account).
• The extension does not know who installed it or how it is being used.

Permissions Explained

No Blanket Host Permissions

ClickSay uses the activeTab permission, which only grants access to the tab you are actively interacting with, and only when you explicitly trigger the extension. The only sites where ClickSay runs a content script automatically are clicksay.net and www.clicksay.net - this is solely for receiving your license key after purchase.

---

10. FAQ

Can I use ClickSay on any website?

Yes. As of v1.1.0, ClickSay works on any URL - not just localhost. The only exceptions are Chrome internal pages (chrome://), the Chrome Web Store, and other restricted browser URLs.

Do I need to use voice? Can I just type?

Yes, you can type your feedback instead of speaking. After clicking an element, simply type in the popup textarea. You can also combine voice and typing - speak first, then edit or add text by typing.

Which AI tools work with ClickSay?

ClickSay copies a structured prompt to your clipboard. You can paste it into any AI tool that accepts text input: Claude Code, Codex, Cursor, Lovable, Replit, Bolt.new, ChatGPT, or any other AI assistant.

Does ClickSay send my data to a server?

No. All processing happens in your browser. The only network requests are license key validation (Pro users only) and the optional local relay (localhost only). See the Privacy & Security section for full details.

What frameworks does ClickSay detect?

React, Vue (2 and 3), Angular, Svelte, Next.js, and SvelteKit. Detection works best on development builds. Production builds may strip the debugging data that ClickSay uses for detection.

Can I capture multiple elements at once?

Yes, using Sweep Mode (Pro only). Hold Shift and click each element you want to include, then release Shift and click the last element. Speak your feedback once and it applies to all selected elements.

What happens when my free tier limits reset?

Voice and screenshot usage counters reset at the start of each calendar month. There is nothing you need to do - the counters reset automatically.

Can I re-copy a previous capture?

Yes. Open the side panel and find the capture in your history. Click the copy button (clipboard icon) on the history item to re-copy its prompt. The prompt is regenerated with your current pill settings.

How do I cancel a capture mid-way?

Press Escape at any point during capture mode to cancel. This dismisses the popup and deactivates capture mode.

What is the relay feature?

The relay is an optional local server that lets you send prompts directly to Claude Code running in a terminal, instead of using the clipboard. Start it with npx clicksay-relay. It runs entirely on your machine (localhost).

How do I check for extension updates?

Chrome updates extensions automatically. You can also go to chrome://extensions, enable "Developer mode," and click "Update" to force-check for updates. Check the version number at the bottom of the side panel.

Where can I get more help?

• Visit https://clicksay.net for the latest information
• Use the chat widget on clicksay.net for live support
• Check the What's New section at https://clicksay.net/#changelog for release notes

---

This guide covers ClickSay v1.1.0. For the latest updates, visit https://clicksay.net.

Guia de Soporte y Autoayuda de ClickSay

Idioma: Espanol Ultima actualizacion: Marzo 2026 Version de la extension: v1.1.0

Este documento es una traduccion de en.md. Para la version mas actualizada, consulta el original en ingles.

---

Tabla de Contenidos

1. Primeros Pasos
2. Como Usar ClickSay
3. Formatos de Salida
4. Panel Lateral
5. Configuracion
6. Free vs Pro
7. Atajos de Teclado
8. Solucion de Problemas
9. Privacidad y Seguridad
10. Preguntas Frecuentes

---

1. Primeros Pasos

Que es ClickSay?

ClickSay es una extension de Chrome que convierte los comentarios sobre interfaces de usuario en prompts estructurados y listos para usar con IA. En vez de escribir largas descripciones para explicar que quieres cambiar en una pagina web, simplemente haces clic en un elemento, dices tu comentario con la voz y pegas el resultado en cualquier herramienta de programacion con IA. Lo que antes tomaba un minuto escribiendo, toma unos 8 segundos con ClickSay.

Instalar ClickSay

1. Visita la pagina de ClickSay en la Chrome Web Store.
2. Haz clic en Anadir a Chrome.
3. Confirma los permisos cuando se te solicite.
4. El icono de ClickSay aparecera en la barra de herramientas de Chrome.

Fijar el Icono

Si no ves el icono de ClickSay en tu barra de herramientas:

1. Haz clic en el icono de pieza de puzzle (Extensiones) en la barra de herramientas de Chrome.
2. Busca "ClickSay - AI Feedback Copilot" en la lista.
3. Haz clic en el icono de pin para mantenerlo visible.

Tu Primera Captura - Paso a Paso

Sigue estos pasos para hacer tu primera captura:

1. Abre cualquier pagina web (por ejemplo, tu proyecto en localhost o cualquier sitio publico).
2. Presiona Cmd+Shift+K (Mac) o Ctrl+Shift+K (Windows/Linux) para activar el modo de captura. Veras un contorno naranja al pasar el cursor sobre los elementos.
3. Haz clic en cualquier elemento de la pagina. Aparecera un popup cerca del elemento y el microfono se activara automaticamente.
4. Di tu comentario de forma natural - por ejemplo, "haz este boton mas grande y cambia el color a azul."
5. Presiona Enter o espera 2 segundos despues de dejar de hablar. El prompt estructurado se copia a tu portapapeles.
6. Abre tu herramienta de IA (Claude Code, Cursor, Lovable, Replit, Bolt.new, etc.) y pega con Cmd+V / Ctrl+V.

Eso es todo. La IA ahora tiene el contexto completo - el selector del elemento, estilos, HTML y tu comentario - y puede hacer el cambio con precision.

---

2. Como Usar ClickSay

El Flujo Clic-Habla-Pega

ClickSay sigue un flujo de trabajo simple de tres pasos:

Paso 1: Clic

Activa el modo de captura usando cualquiera de estos metodos:

• Presiona Cmd+Shift+K (Mac) o Ctrl+Shift+K (Windows/Linux)
• Haz clic en el icono de ClickSay en la barra de herramientas y luego en "Capture" en el panel lateral
• Haz clic derecho en cualquier elemento de la pagina y selecciona "ClickSay this element"

Una vez activo el modo de captura, los elementos se resaltan con un contorno naranja al pasar el cursor sobre ellos. Haz clic en el elemento sobre el que quieres dar tu opinion.

Paso 2: Habla (o Escribe)

Despues de hacer clic en un elemento, aparece un popup cerca de el. El microfono se activa automaticamente y veras "Listening..." en el popup.

• Habla tu comentario de forma natural: "arregla el padding," "haz esto mas grande," "cambia la fuente a sans-serif."
• Escribe en el area de texto del popup si prefieres no usar la voz.
• Combina ambos - puedes hablar y luego editar o agregar texto escribiendo.
• Toca un chip de sugerencia - botones rapidos de feedback aparecen segun el elemento que seleccionaste. Toca uno para insertar ese texto al instante.

Paso 3: Pega

Cuando hayas terminado con tu comentario:

• Presiona Enter en el popup para detener la grabacion y copiar el prompt al portapapeles.
• O simplemente deja de hablar - despues de 2 segundos de silencio, ClickSay copia el prompt automaticamente (auto-copia por silencio).
• Pega el resultado en tu herramienta de IA con Cmd+V / Ctrl+V.

Modo Sweep (Multiples Elementos)

El modo Sweep te permite seleccionar multiples elementos y dar un solo comentario para todos ellos. Esta es una funcion Pro.

1. Activa el modo de captura (Cmd+Shift+K).
2. Manten presionado Shift y haz clic en cada elemento que quieras incluir. Cada elemento recibe un numero.
3. Cuando hayas terminado de seleccionar, haz clic en el ultimo elemento sin mantener Shift.
4. Aparece el popup. Di tu comentario - se aplica a todos los elementos seleccionados.
5. Presiona Enter. Un prompt estructurado que cubre todos los elementos se copia al portapapeles.

Chips de Sugerencia

Cuando aparece el popup, veras pequenos botones con frases de feedback comunes. Estos se llaman chips de sugerencia y cambian segun el tipo de elemento que hayas seleccionado:

• Botones/enlaces: "Change the text," "Fix hover state," "Make more prominent," "Change color"
• Imagenes: "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• Campos de formulario: "Change placeholder," "Fix validation," "Resize this field," "Add label"
• Encabezados: "Change text," "Adjust size," "Change font weight," "Fix spacing"
• Y mas para navegacion, listas, tablas, contenedores flex y grid.

Toca un chip para insertar su texto en tu feedback. Luego puedes editarlo o complementarlo.

Auto-Copia por Silencio

Despues de que dejas de hablar, ClickSay espera 2 segundos de silencio y luego copia automaticamente el prompt estructurado al portapapeles. No necesitas presionar Enter - simplemente deja de hablar y el prompt esta listo para pegar.

Si el ruido de fondo se detecta como voz, el temporizador de silencio no se iniciara. En entornos ruidosos, presiona Enter manualmente o escribe tu feedback.

Popup Arrastrable

Si el popup de feedback esta cubriendo el elemento que quieres ver, simplemente arrastralo fuera del camino. Haz clic y arrastra la barra superior del popup para reposicionarlo en cualquier lugar de la pantalla.

Flujo en Linea

Puedes completar todo el flujo de captura-a-portapapeles directamente en el popup sin abrir el panel lateral. Haz clic en un elemento, da tu feedback y el prompt se copia - todo en linea. El panel lateral sigue disponible cuando necesites el historial, configuraciones o cambios de formato.

---

3. Formatos de Salida

Presets

ClickSay ofrece cuatro presets de salida que controlan cuanto detalle se incluye en el prompt generado.

Simple (Free)

Un formato de una sola linea, amigable para terminal. Solo incluye la URL de la pagina.

Ejemplo:

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

Un formato markdown estructurado. Incluye la URL, selector CSS y texto del elemento.

Detailed (Pro)

Markdown estructurado completo. Incluye URL, selector, texto, HTML, estilos CSS calculados, ruta del archivo y nombre del componente.

Full (Pro)

Todo lo que ClickSay captura. Incluye todo lo de Detailed mas HTML del contexto padre, captura de pantalla y resultados de auditoria de accesibilidad.

Pills (Controles Individuales)

Cada dato capturado corresponde a un "pill" (boton de activacion) en el panel lateral. Puedes activar o desactivar campos de datos individuales para personalizar tu salida.

Como Personalizar la Salida

1. Abre el panel lateral haciendo clic en el icono de ClickSay.
2. En la seccion Output Format, haz clic en un boton de preset para empezar con una configuracion base.
3. Activa o desactiva pills individuales para ajustar los datos incluidos.
4. Tus selecciones se guardan automaticamente y persisten entre sesiones.

---

4. Panel Lateral

El panel lateral es la superficie de control principal de ClickSay. Abrelo haciendo clic en el icono de ClickSay en la barra de herramientas.

Que Hace Cada Cosa (De Arriba a Abajo)

Encabezado

• Nombre de marca ClickSay con insignia de plan (PRO o Free).
• Enlace Upgrade (visible para usuarios free) - abre la pagina de precios.
• Boton Capture - activa el modo de feedback en la pestana actual.
• Boton Clear - elimina todo el historial.

Seccion de Formato de Salida

• Fila de presets: Cuatro botones - Simple, Standard, Detailed, Full. Detailed y Full muestran iconos de candado para usuarios free.
• Pills: Diez casillas para campos de datos individuales. Las pills exclusivas de Pro (Screenshot, Component, A11y) muestran iconos de candado para usuarios free.

Seccion de Relay

• Muestra si el servidor relay opcional de Claude Code esta conectado.
• Punto verde = conectado. Punto rojo = no detectado.
• El interruptor de envio automatico aparece cuando el relay esta conectado.

Vista de Captura

Despues de capturar un elemento, esta seccion muestra:

• Tarjeta de elemento: Nombre de etiqueta, selector CSS y una vista previa del texto del elemento.
• Tarjeta de captura de pantalla: La captura con un resaltado naranja sobre el elemento (si se tomo una captura).
• Tarjeta de feedback: Un area de texto con tu feedback transcrito por voz o escrito. Incluye un boton de microfono.
• Tarjeta de archivo destino: La ruta del archivo auto-detectada o ingresada manualmente.
• Boton Copy to Clipboard con indicacion del atajo Cmd+Return.

Seccion de Cuenta / Plan

• Muestra tu plan actual (Free o Pro).
• Para usuarios free: muestra contadores de uso de voz y capturas de pantalla (ej., "3/20 este mes").
• Enlace de Upgrade o Manage.

Seccion de Historial

• Elementos del historial agrupados por fecha (Hoy, Ayer o fechas especificas).
• Cada elemento muestra la hora, etiqueta del elemento, hostname de la pagina y texto de feedback truncado.
• Haz clic en un elemento para recargarlo en la vista de captura.
• Cada elemento tiene un boton de copiar (para re-copiar el prompt) y un boton de eliminar.
• Acciones en lote: Los botones "Copy Selected" y "Select All" aparecen cuando hay elementos seleccionados.

Gestion de Almacenamiento

• Storage used: Muestra cuanto almacenamiento local usa ClickSay (ej., "2.3 MB").
• Auto-purge: Elige cuanto tiempo conservar el historial - 7 dias, 30 dias, 60 dias, 90 dias o Nunca. Los usuarios free estan limitados a 7 dias.
• Purge Images Now: Elimina todas las capturas de pantalla almacenadas manteniendo el historial de texto.

Visualizacion de Version

La version actual de la extension se muestra en la parte inferior del panel lateral.

---

5. Configuracion

Acceder a la Pagina de Opciones

Haz clic derecho en el icono de ClickSay en la barra de herramientas y selecciona Options. O navega a tu pagina de extensiones de Chrome, busca ClickSay y haz clic en "Detalles" y luego "Opciones de extension."

Project Root

El directorio base de tu proyecto en tu maquina local. Por ejemplo:

/Users/tu/projects/mi-app

Se usa para resolver rutas de archivos en la salida. Cuando ClickSay detecta un componente o mapea una URL a un archivo, el project root se antepone para crear una ruta completa.

URL-to-File Mapping

Reglas basadas en regex que mapean patrones de URL a rutas de archivos fuente. Esto es util cuando la deteccion automatica de framework no encuentra el archivo correcto.

ClickSay incluye presets para configuraciones comunes:

• Static Site - mapea URLs directamente a rutas de archivos
• Next.js - mapea rutas a la estructura del directorio app/
• SvelteKit - mapea rutas a la estructura src/routes/
• React (CRA) - mapea a la estructura del directorio src/

Para agregar una regla personalizada:

1. Ingresa un patron regex de URL (ej., /dashboard/(.*))
2. Ingresa la plantilla de ruta del archivo (ej., src/pages/dashboard/$1.tsx)
3. Haz clic en Save Settings

Clave de Licencia

Si has comprado ClickSay Pro:

1. Despues del pago, recibes una clave de licencia por correo electronico.
2. Ingresa la clave en el campo Pro License en la pagina de Opciones.
3. Haz clic en Validate.
4. Si es valida, tu plan se actualiza inmediatamente a Pro.

La clave de licencia tambien se envia automaticamente a la extension despues de la compra a traves del sitio web de ClickSay - puede que no necesites ingresarla manualmente.

---

6. Free vs Pro

Que Incluye Free

Que Incluye Pro

Precios

• Free: $0
• Pro Monthly: $9/mes
• Pro Yearly: $49/ano (55% de ahorro)

Como Actualizar a Pro

1. Haz clic en el enlace Upgrade en el encabezado del panel lateral o en la seccion de Cuenta.
2. Esto abre la pagina de precios en https://clicksay.net/#pricing.
3. Haz clic en Go Pro para iniciar el pago con Stripe.
4. Despues del pago, se genera una clave de licencia. Se envia automaticamente a tu extension.
5. Si la activacion automatica no funciona, copia la clave de tu correo e ingresala en la pagina de Opciones.

Limites de Uso y Reinicios

• Los contadores de voz y capturas de pantalla se reinician al inicio de cada mes calendario.
• El uso se muestra en la seccion de Cuenta del panel lateral.
• Puedes seguir capturando elementos y escribiendo feedback incluso cuando se alcanza el limite de voz.

---

7. Atajos de Teclado

Menu Contextual

Haz clic derecho en cualquier elemento de una pagina web y selecciona ClickSay this element para activar el modo de captura para ese elemento.

Personalizar el Atajo

Si Cmd+Shift+K / Ctrl+Shift+K no funciona o entra en conflicto con otra extension:

1. Navega a chrome://extensions/shortcuts en tu navegador.
2. Busca "ClickSay - AI Feedback Copilot."
3. Haz clic en el icono de lapiz junto a "Activate ClickSay feedback mode."
4. Graba tu atajo preferido.

---

8. Solucion de Problemas

El atajo de teclado no funciona

Problema: Presionar Cmd+Shift+K / Ctrl+Shift+K no hace nada.

Solucion:

1. Ve a chrome://extensions/shortcuts.
2. Busca "ClickSay - AI Feedback Copilot."
3. Verifica si el atajo esta asignado. Si dice "Not set," haz clic en el icono de lapiz y graba Cmd+Shift+K.
4. Si otra extension usa el mismo atajo, cambia uno de ellos.
5. Como alternativa, usa el icono de la barra de herramientas o el menu contextual.

El microfono no funciona

Problema: El microfono no se activa o la voz no se reconoce.

Solucion:

1. Haz clic en el icono de candado en la barra de direcciones de Chrome para el sitio actual.
2. Asegurate de que "Microfono" este en "Permitir."
3. En macOS, revisa Preferencias del Sistema > Privacidad y Seguridad > Microfono y asegurate de que Chrome este permitido.
4. Asegurate de que ninguna otra aplicacion este usando el microfono.
5. Actualiza la pagina despues de conceder el permiso.

No se puede capturar en una pagina

Problema: El modo de captura se activa pero hacer clic en elementos no hace nada, o el modo de captura no se activa.

Solucion:

1. ClickSay no funciona en paginas chrome://, la Chrome Web Store u otras URLs restringidas del navegador. Prueba con un sitio web normal.
2. Actualiza la pagina e intenta de nuevo.
3. Algunas paginas con politicas de seguridad de contenido estrictas pueden bloquear la inyeccion de scripts.

El panel lateral no se abre

Problema: Hacer clic en el icono de ClickSay no hace nada.

Solucion:

1. Haz clic en el icono de pieza de puzzle en la barra de herramientas y fija ClickSay.
2. Luego haz clic en el icono de ClickSay para abrir el panel lateral.
3. Si aun no funciona, intenta reiniciar Chrome.

La salida no se copia al portapapeles

Problema: Presionaste Enter o hiciste clic en Copiar, pero no hay nada en el portapapeles.

Solucion:

1. Intenta presionar Enter desde el popup de la pagina (tiene la mejor tasa de exito).
2. Intenta presionar Cmd+Return desde el panel lateral con el panel enfocado.
3. Asegurate de que ninguna otra extension este interceptando las escrituras del portapapeles.

Limite de voz alcanzado

Problema: Ves un mensaje de que tu limite de voz ha sido alcanzado.

Solucion:

1. El plan free permite 20 feedbacks de voz por mes.
2. El uso se reinicia al inicio de cada mes calendario.
3. Puedes seguir escribiendo tu feedback - solo la voz esta limitada.
4. Actualiza a Pro para voz ilimitada.

Limite de capturas de pantalla alcanzado

Problema: Las capturas funcionan pero no se toman capturas de pantalla.

Solucion:

1. El plan free permite 5 capturas de pantalla por mes. Revisa la seccion de Cuenta en el panel lateral.
2. El uso se reinicia al inicio de cada mes calendario.
3. Actualiza a Pro para capturas de pantalla ilimitadas.

El popup cubre el elemento

Problema: El popup de feedback aparece encima del elemento que quieres ver.

Solucion: Arrastra el popup fuera del camino. Haz clic y arrastra la barra superior del popup para reposicionarlo en cualquier lugar de la pantalla.

Las teclas Enter o Escape no responden

Problema: Presionar Enter o Escape en el popup no hace nada.

Solucion: Este era un problema conocido en v1.0 donde los modales de la pagina podian interceptar eventos del teclado. Actualiza a v1.1.0 o posterior para solucionarlo.

Los chips de sugerencia no aparecen

Problema: No aparecen chips de sugerencia en el popup despues de hacer clic en un elemento.

Solucion: Los chips son contextuales y solo aparecen para ciertos tipos de elementos (botones, imagenes, inputs, enlaces, encabezados, navegacion, listas, tablas, contenedores flex/grid). Si hiciste clic en un contenedor generico como un <div> simple, puede que no aparezcan chips.

La auto-copia no funciona

Problema: Dejaste de hablar pero el prompt no se copio automaticamente.

Solucion: La auto-copia se activa despues de 2 segundos de silencio. Si el ruido de fondo se detecta como voz, el temporizador no se iniciara. Intenta moverte a un lugar mas tranquilo o escribe tu feedback. Siempre puedes presionar Enter manualmente.

El nombre del framework/componente no aparece

Problema: El pill Component esta activado pero no aparece ningun nombre de componente.

Solucion:

1. La deteccion de componentes es una funcion Pro - asegurate de tener Pro.
2. La deteccion de framework funciona mejor en builds de desarrollo (localhost, modo dev). Los builds de produccion suelen eliminar datos de depuracion.
3. Si la deteccion falla, usa las reglas de URL-to-File mapping en la pagina de Opciones.

La ruta del archivo dice "Not configured"

Problema: El campo de ruta del archivo muestra "Not configured" en vez de un archivo fuente.

Solucion:

1. Abre la pagina de Opciones (clic derecho en el icono de ClickSay > Options).
2. Configura el Project Root (ej., /Users/tu/projects/mi-app).
3. Agrega reglas de mapeo o usa un preset (Next.js, SvelteKit, React, Static Site).
4. Haz clic en Save Settings.

Relay no detectado

Problema: El panel lateral muestra "Relay not detected" con un punto rojo.

Solucion:

1. El relay es opcional. Solo lo necesitas si quieres enviar prompts directamente a Claude Code.
2. Para iniciar el relay, abre una terminal y ejecuta npx clicksay-relay.
3. El estado se actualiza dentro de 30 segundos, o cierra y reabre el panel lateral.
4. Asegurate de que ningun firewall este bloqueando el puerto 19876 de localhost.

En que version estoy?

Abre el panel lateral - el numero de version se muestra en la parte inferior.

---

9. Privacidad y Seguridad

Todos los Datos se Quedan Locales

ClickSay opera completamente dentro de tu navegador. Todo el procesamiento - captura de DOM, reconocimiento de voz, formateo de prompts, captura de pantalla - ocurre en tu maquina. No hay un servidor de ClickSay procesando tus datos.

Que Se Queda en Tu Navegador

• Todos los datos de elementos capturados (selectores, HTML, estilos, etc.)
• Todo el texto de feedback de voz
• Todas las capturas de pantalla
• Historial de feedback
• Tu configuracion (preferencias de salida, reglas de mapeo, preferencia de relay)

Que Sale del Navegador

Los datos solo salen de tu navegador en estas situaciones, todas iniciadas por ti:

1. Copia al portapapeles - Cuando copias un prompt, va al portapapeles del sistema.
2. Relay opcional - Si activas el relay y esta funcionando, los prompts se envian a 127.0.0.1:19876 (solo localhost - nunca sale de tu maquina).
3. Validacion de licencia - Si tienes una clave Pro, la extension la verifica contra https://clicksay.net/api/license/validate. Esta solicitud contiene solo la clave de licencia - ningun feedback, captura de pantalla ni datos de usuario.

Sin Rastreo

• Sin analitica ni telemetria de ningun tipo.
• Sin cookies ni scripts de rastreo.
• Sin cuentas de usuario ni autenticacion (Pro usa una clave de licencia, no una cuenta).
• La extension no sabe quien la instalo ni como se usa.

Permisos Explicados

Sin Permisos Generales de Host

ClickSay usa el permiso activeTab, que solo da acceso a la pestana con la que estas interactuando activamente, y solo cuando activas la extension explicitamente. Los unicos sitios donde ClickSay ejecuta un content script automaticamente son clicksay.net y www.clicksay.net - esto es exclusivamente para recibir tu clave de licencia despues de la compra.

---

10. Preguntas Frecuentes

Puedo usar ClickSay en cualquier sitio web?

Si. Desde la v1.1.0, ClickSay funciona en cualquier URL - no solo en localhost. Las unicas excepciones son las paginas internas de Chrome (chrome://), la Chrome Web Store y otras URLs restringidas del navegador.

Necesito usar voz? Puedo solo escribir?

Si, puedes escribir tu feedback en vez de hablar. Despues de hacer clic en un elemento, simplemente escribe en el textarea del popup. Tambien puedes combinar voz y escritura - habla primero, luego edita o agrega texto escribiendo.

Con que herramientas de IA funciona ClickSay?

ClickSay copia un prompt estructurado al portapapeles. Puedes pegarlo en cualquier herramienta de IA que acepte texto: Claude Code, Codex, Cursor, Lovable, Replit, Bolt.new, ChatGPT, o cualquier otro asistente de IA.

ClickSay envia mis datos a un servidor?

No. Todo el procesamiento ocurre en tu navegador. Las unicas solicitudes de red son la validacion de clave de licencia (solo usuarios Pro) y el relay local opcional (solo localhost). Consulta la seccion Privacidad y Seguridad para mas detalles.

Que frameworks detecta ClickSay?

React, Vue (2 y 3), Angular, Svelte, Next.js y SvelteKit. La deteccion funciona mejor en builds de desarrollo. Los builds de produccion pueden eliminar los datos de depuracion que ClickSay usa para la deteccion.

Puedo capturar multiples elementos a la vez?

Si, usando el Modo Sweep (solo Pro). Manten Shift y haz clic en cada elemento que quieras incluir, luego suelta Shift y haz clic en el ultimo elemento. Di tu feedback una vez y se aplica a todos los elementos seleccionados.

Que pasa cuando se reinician los limites del plan free?

Los contadores de voz y capturas de pantalla se reinician al inicio de cada mes calendario. No necesitas hacer nada - los contadores se reinician automaticamente.

Puedo re-copiar una captura anterior?

Si. Abre el panel lateral y busca la captura en tu historial. Haz clic en el boton de copiar (icono de portapapeles) en el elemento del historial para re-copiar su prompt. El prompt se regenera con tu configuracion actual de pills.

Como cancelo una captura a mitad de camino?

Presiona Escape en cualquier momento durante el modo de captura para cancelar. Esto cierra el popup y desactiva el modo de captura.

Que es la funcion relay?

El relay es un servidor local opcional que te permite enviar prompts directamente a Claude Code ejecutandose en una terminal, en vez de usar el portapapeles. Inicialo con npx clicksay-relay. Se ejecuta completamente en tu maquina (localhost).

Como verifico actualizaciones de la extension?

Chrome actualiza las extensiones automaticamente. Tambien puedes ir a chrome://extensions, activar "Modo de desarrollador" y hacer clic en "Actualizar" para verificar manualmente. Comprueba el numero de version en la parte inferior del panel lateral.

Donde puedo obtener mas ayuda?

• Visita https://clicksay.net para la informacion mas reciente
• Usa el widget de chat en clicksay.net para soporte en vivo
• Consulta la seccion What's New en https://clicksay.net/#changelog para notas de version

---

Esta guia cubre ClickSay v1.1.0. Para las ultimas actualizaciones, visita https://clicksay.net.

Guide d'Aide et Support ClickSay

Langue : Francais Derniere mise a jour : Mars 2026 Version de l'extension : v1.1.0

Ce document est une traduction de en.md. Pour la version la plus a jour, consultez l'original en anglais.

---

Table des Matieres

1. Pour Commencer
2. Comment Utiliser ClickSay
3. Formats de Sortie
4. Panneau Lateral
5. Parametres
6. Free vs Pro
7. Raccourcis Clavier
8. Depannage
9. Confidentialite et Securite
10. FAQ

---

1. Pour Commencer

Qu'est-ce que ClickSay ?

ClickSay est une extension Chrome qui transforme les retours sur l'interface utilisateur en prompts structures, prets pour l'IA. Au lieu de taper de longues descriptions pour expliquer ce que vous voulez modifier sur une page web, vous cliquez simplement sur un element, enoncez votre retour a voix haute, et collez le resultat dans n'importe quel outil de programmation IA. Ce qui prenait une minute a taper prend environ 8 secondes avec ClickSay.

Installer ClickSay

1. Rendez-vous sur la page ClickSay du Chrome Web Store.
2. Cliquez sur Ajouter a Chrome.
3. Confirmez les autorisations lorsqu'on vous le demande.
4. L'icone ClickSay apparait dans la barre d'outils de Chrome.

Epingler l'Icone

Si vous ne voyez pas l'icone ClickSay dans votre barre d'outils :

1. Cliquez sur l'icone en forme de puzzle (Extensions) dans la barre d'outils de Chrome.
2. Trouvez "ClickSay - AI Feedback Copilot" dans la liste.
3. Cliquez sur l'icone d'epingle pour la garder visible.

Votre Premiere Capture - Guide Pas a Pas

Suivez ces etapes pour realiser votre premiere capture :

1. Ouvrez n'importe quelle page web (par exemple, votre projet sur localhost ou n'importe quel site public).
2. Appuyez sur Cmd+Shift+K (Mac) ou Ctrl+Shift+K (Windows/Linux) pour activer le mode capture. Un contour orange apparait lorsque vous survolez les elements.
3. Cliquez sur n'importe quel element de la page. Un popup apparait pres de l'element et le microphone se lance automatiquement.
4. Enoncez votre retour naturellement - par exemple, "agrandis ce bouton et change la couleur en bleu."
5. Appuyez sur Enter ou attendez 2 secondes apres avoir arrete de parler. Le prompt structure est copie dans votre presse-papiers.
6. Ouvrez votre outil IA (Claude Code, Cursor, Lovable, Replit, Bolt.new, etc.) et collez avec Cmd+V / Ctrl+V.

C'est tout. L'IA dispose maintenant du contexte complet - le selecteur de l'element, les styles, le HTML et votre retour - et peut effectuer la modification avec precision.

---

2. Comment Utiliser ClickSay

Le Flux Clic-Parle-Colle

ClickSay suit un flux de travail simple en trois etapes :

Etape 1 : Clic

Activez le mode capture avec l'une de ces methodes :

• Appuyez sur Cmd+Shift+K (Mac) ou Ctrl+Shift+K (Windows/Linux)
• Cliquez sur l'icone ClickSay dans la barre d'outils, puis sur "Capture" dans le panneau lateral
• Faites un clic droit sur n'importe quel element et selectionnez "ClickSay this element"

Une fois le mode capture actif, les elements se surlignent avec un contour orange au survol. Cliquez sur l'element pour lequel vous voulez donner votre avis.

Etape 2 : Parle (ou Ecrivez)

Apres avoir clique sur un element, un popup apparait a proximite. Le microphone s'active automatiquement et vous verrez "Listening..." dans le popup.

• Parlez naturellement : "corrige le padding," "agrandis ceci," "change la police en sans-serif."
• Ecrivez dans la zone de texte du popup si vous preferez ne pas utiliser la voix.
• Combinez les deux - vous pouvez parler puis modifier ou completer le texte en tapant.
• Touchez un chip de suggestion - des boutons rapides de feedback apparaissent selon l'element selectionne. Touchez-en un pour inserer instantanement ce texte.

Etape 3 : Colle

Quand vous avez termine votre retour :

• Appuyez sur Enter dans le popup pour arreter l'enregistrement et copier le prompt dans le presse-papiers.
• Ou arretez simplement de parler - apres 2 secondes de silence, ClickSay copie automatiquement le prompt (copie automatique au silence).
• Collez le resultat dans votre outil IA avec Cmd+V / Ctrl+V.

Mode Sweep (Elements Multiples)

Le mode Sweep vous permet de selectionner plusieurs elements et de donner un seul retour pour tous. C'est une fonctionnalite Pro.

1. Activez le mode capture (Cmd+Shift+K).
2. Maintenez Shift et cliquez sur chaque element que vous souhaitez inclure. Chaque element reçoit un badge numerote.
3. Quand vous avez fini de selectionner, cliquez sur le dernier element sans maintenir Shift.
4. Le popup apparait. Enoncez votre retour - il s'applique a tous les elements selectionnes.
5. Appuyez sur Enter. Un prompt structure couvrant tous les elements est copie dans le presse-papiers.

Chips de Suggestion

Quand le popup apparait, vous verrez de petits boutons cliquables avec des phrases de feedback courantes. Ils changent selon le type d'element clique :

• Boutons/liens : "Change the text," "Fix hover state," "Make more prominent," "Change color"
• Images : "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• Champs de formulaire : "Change placeholder," "Fix validation," "Resize this field," "Add label"
• Titres : "Change text," "Adjust size," "Change font weight," "Fix spacing"
• Et plus pour la navigation, les listes, les tableaux, les conteneurs flex et grid.

Touchez un chip pour inserer son texte dans votre feedback. Vous pouvez ensuite l'editer ou le completer.

Copie Automatique au Silence

Apres que vous arretez de parler, ClickSay attend 2 secondes de silence puis copie automatiquement le prompt structure dans votre presse-papiers. Pas besoin d'appuyer sur Enter - arretez simplement de parler et le prompt est pret a coller.

Si le bruit de fond est detecte comme de la parole, le minuteur de silence ne demarrera pas. Dans les environnements bruyants, appuyez sur Enter manuellement ou tapez votre feedback.

Popup Deplaçable

Si le popup de feedback couvre l'element que vous voulez observer, deplacez-le simplement. Cliquez et faites glisser la barre de poignee en haut du popup pour le repositionner n'importe ou sur l'ecran.

Flux en Ligne

Vous pouvez effectuer tout le processus de capture-vers-presse-papiers directement dans le popup sans ouvrir le panneau lateral. Cliquez sur un element, donnez votre retour, et le prompt est copie - tout en ligne. Le panneau lateral reste disponible quand vous avez besoin de l'historique, des parametres ou des changements de format.

---

3. Formats de Sortie

Presets

ClickSay propose quatre presets de sortie qui controlent le niveau de detail inclus dans le prompt genere.

Simple (Free)

Un format sur une seule ligne, adapte au terminal. Inclut uniquement l'URL de la page.

Exemple :

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

Un format markdown structure. Inclut l'URL, le selecteur CSS et le texte de l'element.

Detailed (Pro)

Markdown structure complet. Inclut l'URL, le selecteur, le texte, le HTML, les styles CSS calcules, le chemin du fichier et le nom du composant.

Full (Pro)

Tout ce que ClickSay capture. Inclut tout ce qui est dans Detailed plus le HTML du contexte parent, la capture d'ecran et les resultats d'audit d'accessibilite.

Pills (Controles Individuels)

Chaque donnee capturee correspond a un "pill" (bouton a bascule) dans le panneau lateral. Vous pouvez activer ou desactiver chaque champ de donnees pour personnaliser votre sortie.

Comment Personnaliser la Sortie

1. Ouvrez le panneau lateral en cliquant sur l'icone ClickSay.
2. Dans la section Output Format, cliquez sur un bouton de preset pour commencer avec une configuration de base.
3. Activez ou desactivez les pills individuels pour ajuster les donnees incluses.
4. Vos selections sont sauvegardees automatiquement et persistent entre les sessions.

---

4. Panneau Lateral

Le panneau lateral est la surface de controle principale de ClickSay. Ouvrez-le en cliquant sur l'icone ClickSay dans la barre d'outils.

A Quoi Sert Chaque Element (De Haut en Bas)

En-tete

• Nom de marque ClickSay avec badge de plan (PRO ou Free).
• Lien Upgrade (visible pour les utilisateurs free) - ouvre la page de tarification.
• Bouton Capture - active le mode feedback sur l'onglet actuel.
• Bouton Clear - supprime tout l'historique.

Section Format de Sortie

• Rangee de presets : Quatre boutons - Simple, Standard, Detailed, Full. Detailed et Full affichent des icones de cadenas pour les utilisateurs free.
• Pills : Dix cases a cocher pour les champs de donnees. Les pills exclusifs a Pro (Screenshot, Component, A11y) affichent des icones de cadenas pour les utilisateurs free.

Section Relay

• Indique si le serveur relay optionnel Claude Code est connecte.
• Point vert = connecte. Point rouge = non detecte.
• L'option d'envoi automatique apparait quand le relay est connecte.

Vue de Capture

Apres avoir capture un element, cette section affiche :

• Carte element : Nom de balise, selecteur CSS et aperçu du texte de l'element.
• Carte capture d'ecran : La capture avec un surlignage orange sur l'element (si une capture a ete prise).
• Carte feedback : Une zone de texte avec votre feedback transcrit ou tape. Inclut un bouton micro.
• Carte fichier cible : Le chemin du fichier auto-detecte ou saisi manuellement.
• Bouton Copy to Clipboard avec indication du raccourci Cmd+Return.

Section Compte / Plan

• Affiche votre plan actuel (Free ou Pro).
• Pour les utilisateurs free : affiche les compteurs d'utilisation voix et captures d'ecran (ex. "3/20 ce mois").
• Lien Upgrade ou Manage.

Section Historique

• Elements d'historique groupes par date (Aujourd'hui, Hier ou dates specifiques).
• Chaque element affiche l'heure, la balise de l'element, le hostname de la page et le texte de feedback tronque.
• Cliquez sur un element pour le recharger dans la vue de capture.
• Chaque element a un bouton copier (pour re-copier le prompt) et un bouton supprimer.
• Actions groupees : Les boutons "Copy Selected" et "Select All" apparaissent quand des elements sont selectionnes.

Gestion du Stockage

• Storage used : Affiche combien de stockage local ClickSay utilise (ex. "2.3 MB").
• Auto-purge : Choisissez combien de temps conserver l'historique - 7 jours, 30 jours, 60 jours, 90 jours ou Jamais. Les utilisateurs free sont limites a 7 jours.
• Purge Images Now : Supprime toutes les captures d'ecran stockees tout en conservant l'historique texte.

Affichage de la Version

La version actuelle de l'extension est affichee en bas du panneau lateral.

---

5. Parametres

Acceder a la Page d'Options

Faites un clic droit sur l'icone ClickSay dans la barre d'outils et selectionnez Options. Ou naviguez vers votre page d'extensions Chrome, trouvez ClickSay et cliquez sur "Details" puis "Options de l'extension."

Project Root

Le repertoire de base de votre projet sur votre machine locale. Par exemple :

/Users/vous/projects/mon-app

Utilise pour resoudre les chemins de fichiers dans la sortie. Quand ClickSay detecte un composant ou mappe une URL a un fichier, le project root est ajoute en prefixe pour creer un chemin complet.

URL-to-File Mapping

Regles basees sur des regex qui mappent des patterns d'URL vers des chemins de fichiers source. Utile quand la detection automatique de framework ne trouve pas le bon fichier.

ClickSay inclut des presets pour les configurations courantes :

• Static Site - mappe les URLs directement vers des chemins de fichiers
• Next.js - mappe les routes vers la structure du repertoire app/
• SvelteKit - mappe les routes vers la structure src/routes/
• React (CRA) - mappe vers la structure du repertoire src/

Pour ajouter une regle personnalisee :

1. Entrez un pattern regex d'URL (ex. /dashboard/(.*))
2. Entrez le modele de chemin de fichier (ex. src/pages/dashboard/$1.tsx)
3. Cliquez sur Save Settings

Cle de Licence

Si vous avez achete ClickSay Pro :

1. Apres le paiement, vous recevez une cle de licence par email.
2. Entrez la cle dans le champ Pro License sur la page d'Options.
3. Cliquez sur Validate.
4. Si elle est valide, votre plan passe immediatement a Pro.

La cle de licence est aussi envoyee automatiquement a l'extension apres l'achat via le site ClickSay - vous n'avez peut-etre pas besoin de la saisir manuellement.

---

6. Free vs Pro

Ce Qui Est Inclus dans Free

Ce Qui Est Inclus dans Pro

Tarifs

• Free : 0 $
• Pro Mensuel : 9 $/mois
• Pro Annuel : 49 $/an (55 % d'economie)

Comment Passer a Pro

1. Cliquez sur le lien Upgrade dans l'en-tete du panneau lateral ou la section Compte.
2. Cela ouvre la page de tarification a https://clicksay.net/#pricing.
3. Cliquez sur Go Pro pour demarrer le paiement via Stripe.
4. Apres le paiement, une cle de licence est generee. Elle est automatiquement envoyee a votre extension.
5. Si l'activation automatique ne fonctionne pas, copiez la cle de votre email et entrez-la dans la page d'Options.

Limites d'Utilisation et Reinitialisations

• Les compteurs de voix et captures d'ecran se reinitialisent au debut de chaque mois calendaire.
• L'utilisation est affichee dans la section Compte du panneau lateral.
• Vous pouvez toujours capturer des elements et taper du feedback meme quand les limites vocales sont atteintes.

---

7. Raccourcis Clavier

Menu Contextuel

Faites un clic droit sur n'importe quel element d'une page web et selectionnez ClickSay this element pour activer le mode capture pour cet element.

Personnaliser le Raccourci

Si Cmd+Shift+K / Ctrl+Shift+K ne fonctionne pas ou entre en conflit avec une autre extension :

1. Naviguez vers chrome://extensions/shortcuts dans votre navigateur.
2. Trouvez "ClickSay - AI Feedback Copilot."
3. Cliquez sur l'icone de crayon a cote de "Activate ClickSay feedback mode."
4. Enregistrez votre raccourci prefere.

---

8. Depannage

Le raccourci clavier ne fonctionne pas

Probleme : Appuyer sur Cmd+Shift+K / Ctrl+Shift+K ne fait rien.

Solution :

1. Allez a chrome://extensions/shortcuts.
2. Trouvez "ClickSay - AI Feedback Copilot."
3. Verifiez si le raccourci est assigne. S'il indique "Not set," cliquez sur l'icone de crayon et enregistrez Cmd+Shift+K.
4. Si une autre extension utilise le meme raccourci, changez l'un d'entre eux.
5. Comme alternative, utilisez l'icone de la barre d'outils ou le menu contextuel.

Le microphone ne fonctionne pas

Probleme : Le micro ne s'active pas, ou la voix n'est pas reconnue.

Solution :

1. Cliquez sur l'icone de cadenas dans la barre d'adresse de Chrome pour le site actuel.
2. Assurez-vous que "Microphone" est regle sur "Autoriser."
3. Sur macOS, verifiez Preferences Systeme > Confidentialite et Securite > Microphone et assurez-vous que Chrome est autorise.
4. Assurez-vous qu'aucune autre application n'utilise le microphone.
5. Actualisez la page apres avoir accorde l'autorisation.

Impossible de capturer sur une page

Probleme : Le mode capture s'active mais cliquer sur les elements ne fait rien, ou le mode capture ne s'active pas du tout.

Solution :

1. ClickSay ne fonctionne pas sur les pages chrome://, le Chrome Web Store ou d'autres URLs restreintes du navigateur. Essayez un site web normal.
2. Actualisez la page et reessayez.
3. Certaines pages avec des politiques de securite de contenu strictes peuvent bloquer l'injection de scripts.

Le panneau lateral ne s'ouvre pas

Probleme : Cliquer sur l'icone ClickSay ne fait rien.

Solution :

1. Cliquez sur l'icone puzzle dans la barre d'outils et epinglez ClickSay.
2. Puis cliquez sur l'icone ClickSay pour ouvrir le panneau lateral.
3. Si cela ne fonctionne toujours pas, essayez de redemarrer Chrome.

La sortie ne se copie pas dans le presse-papiers

Probleme : Vous avez appuye sur Enter ou clique sur Copier, mais rien n'est dans le presse-papiers.

Solution :

1. Essayez d'appuyer sur Enter depuis le popup de la page (c'est ce qui a le meilleur taux de reussite).
2. Essayez d'appuyer sur Cmd+Return depuis le panneau lateral avec le panneau au premier plan.
3. Assurez-vous qu'aucune autre extension n'intercepte les ecritures du presse-papiers.

Limite vocale atteinte

Probleme : Vous voyez un message indiquant que votre limite vocale a ete atteinte.

Solution :

1. Le plan free autorise 20 feedbacks vocaux par mois.
2. L'utilisation se reinitialise au debut de chaque mois calendaire.
3. Vous pouvez toujours taper votre feedback - seule la voix est limitee.
4. Passez a Pro pour une utilisation vocale illimitee.

Limite de captures d'ecran atteinte

Probleme : Les captures fonctionnent mais les captures d'ecran ne sont pas prises.

Solution :

1. Le plan free autorise 5 captures d'ecran par mois. Verifiez la section Compte dans le panneau lateral.
2. L'utilisation se reinitialise au debut de chaque mois calendaire.
3. Passez a Pro pour des captures d'ecran illimitees.

Le popup couvre l'element

Probleme : Le popup de feedback apparait au-dessus de l'element que vous voulez voir.

Solution : Deplacez le popup. Cliquez et faites glisser la barre de poignee en haut du popup pour le repositionner n'importe ou sur l'ecran.

Les touches Enter ou Escape ne repondent pas

Probleme : Appuyer sur Enter ou Escape dans le popup ne fait rien.

Solution : C'etait un probleme connu dans la v1.0 ou les modales de la page pouvaient intercepter les evenements clavier. Mettez a jour vers la v1.1.0 ou ulterieure pour corriger cela.

Les chips de suggestion n'apparaissent pas

Probleme : Aucun chip de suggestion ne s'affiche dans le popup apres avoir clique sur un element.

Solution : Les chips sont contextuels et n'apparaissent que pour certains types d'elements (boutons, images, inputs, liens, titres, navigation, listes, tableaux, conteneurs flex/grid). Si vous avez clique sur un conteneur generique comme un simple <div>, les chips peuvent ne pas apparaitre.

La copie automatique ne fonctionne pas

Probleme : Vous avez arrete de parler mais le prompt n'a pas ete copie automatiquement.

Solution : La copie automatique se declenche apres 2 secondes de silence. Si le bruit de fond est detecte comme de la parole, le minuteur ne demarrera pas. Essayez de vous deplacer dans un endroit plus calme ou tapez votre feedback. Vous pouvez toujours appuyer sur Enter manuellement.

Le nom du framework/composant n'apparait pas

Probleme : Le pill Component est active mais aucun nom de composant n'apparait.

Solution :

1. La detection de composants est une fonctionnalite Pro - assurez-vous d'avoir Pro.
2. La detection de framework fonctionne mieux sur les builds de developpement (localhost, mode dev). Les builds de production suppriment souvent les donnees de debogage.
3. Si la detection echoue, utilisez les regles URL-to-File mapping dans la page d'Options.

Le chemin du fichier indique "Not configured"

Probleme : Le champ du chemin du fichier affiche "Not configured" au lieu d'un fichier source.

Solution :

1. Ouvrez la page d'Options (clic droit sur l'icone ClickSay > Options).
2. Definissez le Project Root (ex. /Users/vous/projects/mon-app).
3. Ajoutez des regles de mappage ou utilisez un preset (Next.js, SvelteKit, React, Static Site).
4. Cliquez sur Save Settings.

Relay non detecte

Probleme : Le panneau lateral affiche "Relay not detected" avec un point rouge.

Solution :

1. Le relay est optionnel. Vous n'en avez besoin que si vous voulez envoyer des prompts directement a Claude Code.
2. Pour demarrer le relay, ouvrez un terminal et executez npx clicksay-relay.
3. Le statut se met a jour dans les 30 secondes, ou fermez et rouvrez le panneau lateral.
4. Assurez-vous qu'aucun pare-feu ne bloque le port 19876 de localhost.

Quelle version ai-je ?

Ouvrez le panneau lateral - le numero de version est affiche en bas.

---

9. Confidentialite et Securite

Toutes les Donnees Restent Locales

ClickSay fonctionne entierement dans votre navigateur. Tout le traitement - capture du DOM, reconnaissance vocale, formatage des prompts, capture d'ecran - se fait sur votre machine. Il n'y a pas de serveur ClickSay qui traite vos donnees.

Ce Qui Reste dans Votre Navigateur

• Toutes les donnees d'elements captures (selecteurs, HTML, styles, etc.)
• Tout le texte de feedback vocal
• Toutes les captures d'ecran
• L'historique des feedbacks
• Vos parametres (preferences de sortie, regles de mappage, preference de relay)

Ce Qui Sort du Navigateur

Les donnees ne quittent votre navigateur que dans ces situations, toutes initiees par vous :

1. Copie dans le presse-papiers - Quand vous copiez un prompt, il va dans le presse-papiers du systeme.
2. Relay optionnel - Si vous activez le relay et qu'il est en marche, les prompts sont envoyes a 127.0.0.1:19876 (localhost uniquement - ne quitte jamais votre machine).
3. Validation de licence - Si vous avez une cle Pro, l'extension la verifie aupres de https://clicksay.net/api/license/validate. Cette requete ne contient que la cle de licence - aucun feedback, capture d'ecran ou donnee utilisateur.

Aucun Suivi

• Aucune analytique ni telemetrie d'aucune sorte.
• Aucun cookie ni script de suivi.
• Aucun compte utilisateur ni authentification (Pro utilise une cle de licence, pas un compte).
• L'extension ne sait pas qui l'a installee ni comment elle est utilisee.

Autorisations Expliquees

Pas d'Autorisations de Host Globales

ClickSay utilise l'autorisation activeTab, qui ne donne acces qu'a l'onglet avec lequel vous interagissez activement, et seulement quand vous declenchez l'extension explicitement. Les seuls sites ou ClickSay execute un content script automatiquement sont clicksay.net et www.clicksay.net - c'est uniquement pour recevoir votre cle de licence apres l'achat.

---

10. FAQ

Puis-je utiliser ClickSay sur n'importe quel site web ?

Oui. Depuis la v1.1.0, ClickSay fonctionne sur n'importe quelle URL - pas seulement localhost. Les seules exceptions sont les pages internes de Chrome (chrome://), le Chrome Web Store et d'autres URLs restreintes du navigateur.

Dois-je utiliser la voix ? Puis-je simplement taper ?

Oui, vous pouvez taper votre feedback au lieu de parler. Apres avoir clique sur un element, tapez simplement dans la zone de texte du popup. Vous pouvez aussi combiner voix et frappe - parlez d'abord, puis editez ou ajoutez du texte en tapant.

Quels outils IA fonctionnent avec ClickSay ?

ClickSay copie un prompt structure dans le presse-papiers. Vous pouvez le coller dans n'importe quel outil IA qui accepte du texte : Claude Code, Codex, Cursor, Lovable, Replit, Bolt.new, ChatGPT, ou tout autre assistant IA.

ClickSay envoie-t-il mes donnees a un serveur ?

Non. Tout le traitement se fait dans votre navigateur. Les seules requetes reseau sont la validation de cle de licence (utilisateurs Pro uniquement) et le relay local optionnel (localhost uniquement). Consultez la section Confidentialite et Securite pour tous les details.

Quels frameworks ClickSay detecte-t-il ?

React, Vue (2 et 3), Angular, Svelte, Next.js et SvelteKit. La detection fonctionne mieux sur les builds de developpement. Les builds de production peuvent supprimer les donnees de debogage que ClickSay utilise pour la detection.

Puis-je capturer plusieurs elements a la fois ?

Oui, en utilisant le Mode Sweep (Pro uniquement). Maintenez Shift et cliquez sur chaque element a inclure, puis relâchez Shift et cliquez sur le dernier element. Enoncez votre feedback une fois et il s'applique a tous les elements selectionnes.

Que se passe-t-il quand les limites du plan free se reinitialisent ?

Les compteurs de voix et captures d'ecran se reinitialisent au debut de chaque mois calendaire. Vous n'avez rien a faire - les compteurs se reinitialisent automatiquement.

Puis-je re-copier une capture precedente ?

Oui. Ouvrez le panneau lateral et trouvez la capture dans votre historique. Cliquez sur le bouton copier (icone presse-papiers) sur l'element de l'historique pour re-copier son prompt. Le prompt est regenere avec vos parametres de pills actuels.

Comment annuler une capture en cours ?

Appuyez sur Escape a tout moment pendant le mode capture pour annuler. Cela ferme le popup et desactive le mode capture.

Qu'est-ce que la fonctionnalite relay ?

Le relay est un serveur local optionnel qui vous permet d'envoyer des prompts directement a Claude Code executant dans un terminal, au lieu d'utiliser le presse-papiers. Demarrez-le avec npx clicksay-relay. Il fonctionne entierement sur votre machine (localhost).

Comment verifier les mises a jour de l'extension ?

Chrome met a jour les extensions automatiquement. Vous pouvez aussi aller a chrome://extensions, activer le "Mode developpeur" et cliquer sur "Mettre a jour" pour forcer la verification. Verifiez le numero de version en bas du panneau lateral.

Ou puis-je obtenir plus d'aide ?

• Visitez https://clicksay.net pour les informations les plus recentes
• Utilisez le widget de chat sur clicksay.net pour un support en direct
• Consultez la section What's New a https://clicksay.net/#changelog pour les notes de version

---

Ce guide couvre ClickSay v1.1.0. Pour les dernieres mises a jour, visitez https://clicksay.net.

ClickSay 自助支持指南

语言： 简体中文 最后更新： 2026年3月 扩展版本： v1.1.0

本文档是 en.md 的翻译版本。如需最新内容，请参阅英文原版。

---

目录

1. 入门指南
2. 如何使用 ClickSay
3. 输出格式
4. 侧边面板
5. 设置
6. Free vs Pro
7. 键盘快捷键
8. 故障排除
9. 隐私与安全
10. 常见问题

---

1. 入门指南

什么是 ClickSay？

ClickSay 是一款 Chrome 扩展，能将 UI 反馈转化为结构化的、AI 就绪的提示词。您不再需要打字输入冗长的描述来解释想在网页上修改什么，只需点击一个元素、用语音说出您的反馈，然后将结果粘贴到任何 AI 编码工具中即可。以前需要一分钟打字的内容，使用 ClickSay 大约 8 秒即可完成。

安装 ClickSay

1. 访问 Chrome Web Store 上的 ClickSay 页面。
2. 点击添加至 Chrome。
3. 出现提示时确认权限。
4. ClickSay 图标将出现在 Chrome 工具栏中。

固定图标

如果您在工具栏中看不到 ClickSay 图标：

1. 点击 Chrome 工具栏中的拼图图标（扩展程序）。
2. 在列表中找到"ClickSay - AI Feedback Copilot"。
3. 点击旁边的固定图标使其保持可见。

第一次捕获 - 操作演示

按照以下步骤进行第一次捕获：

1. 打开任意网页（例如您在 localhost 上运行的项目，或任何公开网站）。
2. 按 Cmd+Shift+K（Mac）或 Ctrl+Shift+K（Windows/Linux）激活捕获模式。鼠标悬停在元素上时会出现橙色轮廓。
3. 点击页面上的任意元素。元素附近会出现一个弹出窗口，麦克风自动开始录音。
4. 自然地说出您的反馈 - 例如，"把这个按钮变大，颜色改成蓝色。"
5. 按 Enter 或在停止说话后等待 2 秒。结构化提示词将被复制到剪贴板。
6. 打开您的 AI 工具（Claude Code、Cursor、Lovable、Replit、Bolt.new 等），使用 Cmd+V / Ctrl+V 粘贴。

就是这样。AI 现在拥有完整的上下文 - 元素的选择器、样式、HTML 和您的反馈 - 可以准确地进行修改。

---

2. 如何使用 ClickSay

点击-说话-粘贴工作流

ClickSay 遵循简单的三步工作流：

第一步：点击

使用以下任一方法激活捕获模式：

• 按 Cmd+Shift+K（Mac）或 Ctrl+Shift+K（Windows/Linux）
• 点击工具栏中的 ClickSay 图标，然后点击侧边面板中的"Capture"
• 右键点击页面上的任意元素，选择"ClickSay this element"

捕获模式激活后，鼠标悬停时元素会以橙色轮廓高亮显示。点击您想要提供反馈的元素。

第二步：说话（或打字）

点击元素后，附近会出现一个弹出窗口。麦克风自动激活，您会在弹出窗口中看到"Listening..."。

• 说出您的反馈："修正 padding，""把这个变大，""把字体改成 sans-serif。"
• 如果您不想使用语音，可以在弹出窗口的文本框中打字输入。
• 两者结合 - 您可以先说话，然后通过打字编辑或补充文本。
• 点击建议标签 - 根据您点击的元素会出现相应的快速反馈按钮。点击一个即可立即插入该文本。

第三步：粘贴

完成反馈后：

• 在弹出窗口中按 Enter 停止录音并将提示词复制到剪贴板。
• 或者直接停止说话 - 沉默 2 秒后，ClickSay 会自动复制提示词（静默自动复制）。
• 使用 Cmd+V / Ctrl+V 将结果粘贴到您的 AI 工具中。

Sweep 模式（多元素选择）

Sweep 模式让您可以选择多个元素并为所有元素提供一条反馈。这是 Pro 功能。

1. 激活捕获模式（Cmd+Shift+K）。
2. 按住 Shift 并点击每个要包含的元素。每个被点击的元素会获得一个编号标记。
3. 选择完毕后，不按 Shift 点击最后一个元素。
4. 弹出窗口出现。说出您的反馈 - 它适用于所有选中的元素。
5. 按 Enter。一个涵盖所有元素的结构化提示词被复制到剪贴板。

建议标签

弹出窗口出现时，您会看到带有常见反馈短语的小可点击按钮。这些是建议标签，它们会根据您点击的元素类型而变化：

• 按钮/链接： "Change the text," "Fix hover state," "Make more prominent," "Change color"
• 图片： "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• 表单输入框： "Change placeholder," "Fix validation," "Resize this field," "Add label"
• 标题： "Change text," "Adjust size," "Change font weight," "Fix spacing"
• 以及更多 - 适用于导航、列表、表格、flex 容器和 grid 容器。

点击标签可将其文本插入到您的反馈中。然后您可以编辑或补充内容。

静默自动复制

在您停止说话后，ClickSay 等待 2 秒的静默，然后自动将结构化提示词复制到剪贴板。您不需要按 Enter - 只要停止说话，提示词就准备好可以粘贴了。

如果背景噪音被识别为语音，静默计时器将不会启动。在嘈杂的环境中，请手动按 Enter 或改为打字输入。

可拖动弹出窗口

如果反馈弹出窗口遮住了您想查看的元素，只需将其拖开。点击并拖动弹出窗口顶部的手柄栏，将其重新定位到屏幕上的任意位置。

内联流程

您可以完全在弹出窗口中完成从捕获到剪贴板的整个工作流程，无需打开侧边面板。点击元素、提供反馈，提示词就被复制了 - 全部内联完成。当您需要查看历史记录、设置或更改输出格式时，侧边面板仍然可用。

---

3. 输出格式

预设

ClickSay 提供四种输出预设，控制生成的提示词中包含多少细节。

Simple（Free）

单行、终端友好的格式。仅包含页面 URL。

示例：

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard（Free）

结构化 markdown 格式。包含 URL、CSS 选择器和元素文本。

Detailed（Pro）

完整的结构化 markdown。包含 URL、选择器、文本、HTML、计算后的 CSS 样式、文件路径和组件名称。

Full（Pro）

ClickSay 捕获的所有内容。包含 Detailed 中的所有数据以及父级上下文 HTML、截图和无障碍审核结果。

Pills（单独控制开关）

每项捕获数据对应侧边面板中一个可切换的"pill"（开关按钮）。您可以开启或关闭单个数据字段来自定义输出。

如何自定义输出

1. 点击 ClickSay 图标打开侧边面板。
2. 在 Output Format 部分，点击一个预设按钮作为基础配置。
3. 开启或关闭单独的 pills 来微调包含的数据。
4. 您的选择会自动保存并在会话之间保持。

---

4. 侧边面板

侧边面板是 ClickSay 的主要控制界面。点击工具栏中的 ClickSay 图标打开它。

各部分功能说明（从上到下）

头部

• ClickSay 品牌名称，带有计划徽章（PRO 或 Free）。
• Upgrade 链接（仅对 Free 用户可见）- 打开定价页面。
• Capture 按钮 - 在当前标签页激活反馈模式。
• Clear 按钮 - 删除所有历史记录。

输出格式部分

• 预设行： 四个按钮 - Simple、Standard、Detailed、Full。Detailed 和 Full 对 Free 用户显示锁定图标。
• Pills： 十个复选框用于各个数据字段。Pro 专属的 pills（Screenshot、Component、A11y）对 Free 用户显示锁定图标。

Relay 部分

• 显示可选的 Claude Code relay 服务器是否已连接。
• 绿点 = 已连接。红点 = 未检测到。
• 连接 relay 后会显示自动发送切换开关。

捕获视图

捕获元素后，此部分显示：

• 元素卡片： 标签名、CSS 选择器和元素文本预览。
• 截图卡片： 带有橙色高亮的捕获截图（如果已截图）。
• 反馈卡片： 显示您语音转录或输入文字的文本框。包含一个麦克风按钮。
• 目标文件卡片： 自动检测或手动输入的文件路径。
• Copy to Clipboard 按钮，带有 Cmd+Return 快捷键提示。

账户/计划部分

• 显示当前计划（Free 或 Pro）。
• 对 Free 用户：显示语音和截图使用计数（如"3/20 本月"）。
• Upgrade 或 Manage 链接。

历史记录部分

• 按日期分组的历史记录项（今天、昨天或具体日期）。
• 每个项目显示时间戳、元素标签、页面主机名和截断的反馈文本。
• 点击项目可将其重新加载到捕获视图中。
• 每个项目有一个复制按钮（重新复制提示词）和一个删除按钮。
• 批量操作： 选中项目后会出现"Copy Selected"和"Select All"按钮。

存储管理

• Storage used： 显示 ClickSay 使用了多少本地存储（如"2.3 MB"）。
• Auto-purge： 选择保留历史记录的时间 - 7 天、30 天、60 天、90 天或永不清除。Free 用户限制为 7 天。
• Purge Images Now： 删除所有存储的截图，但保留文本历史记录。

版本显示

扩展的当前版本显示在侧边面板底部。

---

5. 设置

访问选项页面

右键点击工具栏中的 ClickSay 图标，选择 Options。或者导航到 Chrome 扩展页面，找到 ClickSay，点击"详情"然后"扩展选项"。

Project Root

您本地机器上的项目基本目录。例如：

/Users/you/projects/my-app

用于在输出中解析文件路径。当 ClickSay 检测到组件或将 URL 映射到文件时，会将 project root 作为前缀创建完整路径。

URL-to-File Mapping

基于正则表达式的规则，将 URL 模式映射到源文件路径。当自动框架检测找不到正确的文件时非常有用。

ClickSay 包含常见配置的预设：

• Static Site - 直接将 URL 映射到文件路径
• Next.js - 将路由映射到 app/ 目录结构
• SvelteKit - 将路由映射到 src/routes/ 结构
• React (CRA) - 映射到 src/ 目录结构

添加自定义规则：

1. 输入 URL 正则表达式模式（如 /dashboard/(.*)）
2. 输入文件路径模板（如 src/pages/dashboard/$1.tsx）
3. 点击 Save Settings

许可证密钥

如果您已购买 ClickSay Pro：

1. 付款后，您会通过邮件收到一个许可证密钥。
2. 在选项页面的 Pro License 字段中输入密钥。
3. 点击 Validate。
4. 如果有效，您的计划将立即升级为 Pro。

许可证密钥也会在购买后通过 ClickSay 网站自动发送到扩展 - 您可能不需要手动输入。

---

6. Free vs Pro

Free 包含什么

Pro 包含什么

价格

• Free： $0
• Pro Monthly： $9/月
• Pro Yearly： $49/年（节省 55%）

如何升级

1. 点击侧边面板头部或账户部分的 Upgrade 链接。
2. 这将打开 https://clicksay.net/#pricing 的定价页面。
3. 点击 Go Pro 开始通过 Stripe 支付。
4. 付款后会生成许可证密钥，自动发送到您的扩展。
5. 如果自动激活不起作用，请从邮件中复制密钥并在选项页面输入。

使用限制和重置

• 语音和截图使用计数在每个自然月初重置。
• 使用情况显示在侧边面板的账户部分。
• 即使达到语音限制，您仍然可以捕获元素和输入文字反馈。

---

7. 键盘快捷键

右键菜单

在网页上右键点击任意元素，选择 ClickSay this element 可为该元素激活捕获模式。

自定义快捷键

如果 Cmd+Shift+K / Ctrl+Shift+K 不起作用或与其他扩展冲突：

1. 在浏览器中导航到 chrome://extensions/shortcuts。
2. 找到"ClickSay - AI Feedback Copilot"。
3. 点击"Activate ClickSay feedback mode"旁边的铅笔图标。
4. 录制您首选的快捷键。

---

8. 故障排除

键盘快捷键不起作用

问题： 按 Cmd+Shift+K / Ctrl+Shift+K 没有反应。

解决方案：

1. 前往 chrome://extensions/shortcuts。
2. 找到"ClickSay - AI Feedback Copilot"。
3. 检查快捷键是否已分配。如果显示"Not set"，点击铅笔图标并录制 Cmd+Shift+K。
4. 如果另一个扩展使用相同的快捷键，请更改其中一个。
5. 替代方案：使用工具栏图标或右键菜单。

麦克风不起作用

问题： 麦克风未激活，或语音未被识别。

解决方案：

1. 点击 Chrome 地址栏中当前网站的锁定图标。
2. 确保"麦克风"设置为"允许"。
3. 在 macOS 上，检查系统偏好设置 > 隐私与安全 > 麦克风，确保 Chrome 已被允许。
4. 确保没有其他应用正在使用麦克风。
5. 授予权限后刷新页面。

无法在页面上捕获

问题： 捕获模式激活但点击元素没有反应，或捕获模式根本无法激活。

解决方案：

1. ClickSay 不适用于 chrome:// 页面、Chrome Web Store 或其他受限的浏览器 URL。请尝试普通网站。
2. 刷新页面并重试。
3. 某些具有严格内容安全策略的页面可能会阻止脚本注入。

侧边面板不打开

问题： 点击 ClickSay 图标没有反应。

解决方案：

1. 点击工具栏中的拼图图标并固定 ClickSay。
2. 然后点击 ClickSay 图标打开侧边面板。
3. 如果仍然不起作用，尝试重启 Chrome。

输出未复制到剪贴板

问题： 您按了 Enter 或点击了复制，但剪贴板中没有内容。

解决方案：

1. 尝试在页面内弹出窗口中按 Enter（成功率最高）。
2. 尝试在侧边面板中按 Cmd+Return，确保面板处于焦点状态。
3. 确保没有其他扩展拦截剪贴板写入。

语音限制已达到

问题： 您看到消息提示语音限制已达到。

解决方案：

1. Free 计划每月允许 20 次语音反馈。
2. 使用量在每个自然月初重置。
3. 您仍然可以打字输入反馈 - 只有语音受限。
4. 升级到 Pro 获得无限语音。

截图限制已达到

问题： 捕获正常但未截图。

解决方案：

1. Free 计划每月允许 5 次截图。请在侧边面板的账户部分查看。
2. 使用量在每个自然月初重置。
3. 升级到 Pro 获得无限截图。

弹出窗口遮住了元素

问题： 反馈弹出窗口出现在您想查看的元素上方。

解决方案： 将弹出窗口拖开。点击并拖动弹出窗口顶部的手柄栏，将其重新定位到屏幕上的任意位置。

Enter 或 Escape 键无响应

问题： 在弹出窗口中按 Enter 或 Escape 没有反应。

解决方案： 这是 v1.0 中的一个已知问题，页面模态框可能会拦截键盘事件。请更新到 v1.1.0 或更高版本来修复此问题。

建议标签不出现

问题： 点击元素后弹出窗口中没有出现建议标签。

解决方案： 标签是上下文相关的，仅对某些元素类型出现（按钮、图片、输入框、链接、标题、导航、列表、表格、flex/grid 容器）。如果您点击的是一个普通的 <div> 等通用容器，标签可能不会出现。

自动复制不起作用

问题： 您停止说话后提示词没有自动复制。

解决方案： 自动复制在 2 秒静默后触发。如果背景噪音被识别为语音，计时器将不会启动。尝试移到更安静的地方或改为打字输入。您始终可以手动按 Enter。

框架/组件名称未显示

问题： Component pill 已启用但没有显示组件名称。

解决方案：

1. 组件检测是 Pro 功能 - 确保您拥有 Pro。
2. 框架检测在开发构建（localhost、开发模式）下效果最佳。生产构建通常会去除调试数据。
3. 如果检测失败，请使用选项页面中的 URL-to-File mapping 规则作为替代。

文件路径显示"Not configured"

问题： 文件路径字段显示"Not configured"而不是源文件。

解决方案：

1. 打开选项页面（右键点击 ClickSay 图标 > Options）。
2. 设置 Project Root（如 /Users/you/projects/my-app）。
3. 添加映射规则或使用预设（Next.js、SvelteKit、React、Static Site）。
4. 点击 Save Settings。

Relay 未检测到

问题： 侧边面板显示"Relay not detected"并带有红点。

解决方案：

1. Relay 是可选的。只有当您想直接向 Claude Code 发送提示词时才需要它。
2. 要启动 relay，打开终端并运行 npx clicksay-relay。
3. 状态将在 30 秒内更新，或关闭并重新打开侧边面板。
4. 确保没有防火墙阻止 localhost 的 19876 端口。

我使用的是什么版本？

打开侧边面板 - 版本号显示在底部。

---

9. 隐私与安全

所有数据保留在本地

ClickSay 完全在您的浏览器内运行。所有处理 - DOM 捕获、语音识别、提示词格式化、截图捕获 - 都在您的机器上完成。没有 ClickSay 服务器处理您的数据。

留在浏览器中的数据

• 所有捕获的元素数据（选择器、HTML、样式等）
• 所有语音反馈文本
• 所有截图
• 反馈历史记录
• 您的设置（输出偏好、映射规则、relay 偏好）

离开浏览器的数据

数据仅在以下情况下离开您的浏览器，且全部由您主动发起：

1. 剪贴板复制 - 当您复制提示词时，它进入系统剪贴板。
2. 可选 relay - 如果您启用了 relay 且它正在运行，提示词会发送到 127.0.0.1:19876（仅 localhost - 永远不会离开您的机器）。
3. 许可证验证 - 如果您有 Pro 许可证密钥，扩展会向 https://clicksay.net/api/license/validate 验证。此请求仅包含许可证密钥 - 没有反馈、截图或用户数据。

无追踪

• 没有任何形式的分析或遥测。
• 没有 cookie 或追踪脚本。
• 没有用户账户或认证（Pro 使用许可证密钥，而非用户账户）。
• 扩展不知道谁安装了它或它被如何使用。

权限说明

无全局主机权限

ClickSay 使用 activeTab 权限，该权限仅允许访问您正在活跃交互的标签页，且仅在您明确触发扩展时。ClickSay 自动运行 content script 的唯一站点是 clicksay.net 和 www.clicksay.net - 这仅用于在购买后接收您的许可证密钥。

---

10. 常见问题

我可以在任何网站上使用 ClickSay 吗？

可以。从 v1.1.0 开始，ClickSay 可以在任何 URL 上工作 - 不仅仅是 localhost。唯一的例外是 Chrome 内部页面（chrome://）、Chrome Web Store 和其他受限的浏览器 URL。

我必须使用语音吗？可以只打字吗？

可以，您可以打字输入反馈而不使用语音。点击元素后，直接在弹出窗口的文本框中打字即可。您也可以将语音和打字结合使用 - 先说话，然后通过打字编辑或添加文本。

哪些 AI 工具可以配合 ClickSay 使用？

ClickSay 将结构化提示词复制到剪贴板。您可以将其粘贴到任何接受文本输入的 AI 工具中：Claude Code、Codex、Cursor、Lovable、Replit、Bolt.new、ChatGPT 或任何其他 AI 助手。

ClickSay 会将我的数据发送到服务器吗？

不会。所有处理都在您的浏览器中进行。唯一的网络请求是许可证密钥验证（仅 Pro 用户）和可选的本地 relay（仅 localhost）。详见隐私与安全部分。

ClickSay 检测哪些框架？

React、Vue（2 和 3）、Angular、Svelte、Next.js 和 SvelteKit。检测在开发构建上效果最佳。生产构建可能会去除 ClickSay 用于检测的调试数据。

我可以一次捕获多个元素吗？

可以，使用 Sweep 模式（仅 Pro）。按住 Shift 并点击要包含的每个元素，然后松开 Shift 点击最后一个元素。只需说一次反馈，它就适用于所有选中的元素。

Free 计划的限制什么时候重置？

语音和截图使用计数在每个自然月初重置。您不需要做任何事 - 计数器自动重置。

我可以重新复制之前的捕获吗？

可以。打开侧边面板，在历史记录中找到该捕获。点击历史记录项上的复制按钮（剪贴板图标）重新复制其提示词。提示词会根据您当前的 pills 设置重新生成。

如何中途取消捕获？

在捕获模式中随时按 Escape 取消。这会关闭弹出窗口并停用捕获模式。

Relay 功能是什么？

Relay 是一个可选的本地服务器，让您可以将提示词直接发送到终端中运行的 Claude Code，而不是使用剪贴板。使用 npx clicksay-relay 启动它。它完全在您的机器上运行（localhost）。

如何检查扩展更新？

Chrome 会自动更新扩展。您也可以前往 chrome://extensions，启用"开发者模式"，然后点击"更新"强制检查。在侧边面板底部查看版本号。

在哪里可以获得更多帮助？

• 访问 https://clicksay.net 获取最新信息
• 使用 clicksay.net 上的聊天小工具获得即时支持
• 查看 https://clicksay.net/#changelog 的 What's New 部分了解版本说明

---

本指南涵盖 ClickSay v1.1.0。如需最新更新，请访问 https://clicksay.net。

ClickSay स्व-सहायता समर्थन गाइड

भाषा: हिन्दी अंतिम अपडेट: मार्च 2026 एक्सटेंशन संस्करण: v1.1.0

यह दस्तावेज़ en.md का अनुवाद है। सबसे नवीनतम संस्करण के लिए, कृपया अंग्रेज़ी मूल देखें।

---

विषय सूची

1. शुरुआत कैसे करें
2. ClickSay कैसे उपयोग करें
3. आउटपुट फॉर्मेट
4. साइड पैनल
5. सेटिंग्स
6. Free vs Pro
7. कीबोर्ड शॉर्टकट
8. समस्या निवारण
9. गोपनीयता एवं सुरक्षा
10. अक्सर पूछे जाने वाले प्रश्न

---

1. शुरुआत कैसे करें

ClickSay क्या है?

ClickSay एक Chrome एक्सटेंशन है जो UI फीडबैक को संरचित, AI-तैयार प्रॉम्प्ट में बदल देता है। वेब पेज पर क्या बदलना है, यह समझाने के लिए लंबी-लंबी विवरण टाइप करने की बजाय, आप बस किसी एलिमेंट पर क्लिक करते हैं, अपना फीडबैक बोलते हैं, और परिणाम किसी भी AI कोडिंग टूल में पेस्ट कर देते हैं। जो काम पहले एक मिनट टाइपिंग में लगता था, वो ClickSay के साथ लगभग 8 सेकंड में हो जाता है।

ClickSay इंस्टॉल करें

1. Chrome Web Store पर ClickSay का पेज खोलें।
2. Add to Chrome पर क्लिक करें।
3. जब कहा जाए तो अनुमतियों की पुष्टि करें।
4. Chrome टूलबार में ClickSay आइकन दिखाई देगा।

आइकन पिन करें

अगर आपको टूलबार में ClickSay आइकन दिखाई नहीं दे रहा:

1. Chrome टूलबार में पज़ल पीस आइकन (एक्सटेंशन) पर क्लिक करें।
2. सूची में "ClickSay - AI Feedback Copilot" खोजें।
3. इसे दृश्यमान रखने के लिए पिन आइकन पर क्लिक करें।

आपकी पहली कैप्चर - चरण-दर-चरण

अपनी पहली कैप्चर करने के लिए इन चरणों का पालन करें:

1. कोई भी वेब पेज खोलें (जैसे localhost पर आपका प्रोजेक्ट, या कोई सार्वजनिक वेबसाइट)।
2. कैप्चर मोड सक्रिय करने के लिए Cmd+Shift+K (Mac) या Ctrl+Shift+K (Windows/Linux) दबाएं। एलिमेंट पर होवर करने पर नारंगी बॉर्डर दिखाई देगा।
3. पेज पर किसी भी एलिमेंट पर क्लिक करें। एलिमेंट के पास एक पॉपअप दिखाई देगा और माइक्रोफ़ोन स्वचालित रूप से शुरू हो जाएगा।
4. अपना फीडबैक स्वाभाविक रूप से बोलें - जैसे, "इस बटन को बड़ा करो और रंग नीला कर दो।"
5. Enter दबाएं या बोलना बंद करने के 2 सेकंड बाद प्रतीक्षा करें। संरचित प्रॉम्प्ट आपके क्लिपबोर्ड पर कॉपी हो जाएगा।
6. अपना AI टूल खोलें (Claude Code, Cursor, Lovable, Replit, Bolt.new, आदि) और Cmd+V / Ctrl+V से पेस्ट करें।

बस इतना ही। AI के पास अब पूरा संदर्भ है - एलिमेंट का सेलेक्टर, स्टाइल, HTML और आपका फीडबैक - और वह सटीक बदलाव कर सकता है।

---

2. ClickSay कैसे उपयोग करें

क्लिक-बोलो-पेस्ट वर्कफ़्लो

ClickSay एक सरल तीन-चरणीय वर्कफ़्लो का पालन करता है:

चरण 1: क्लिक

इनमें से किसी भी तरीके से कैप्चर मोड सक्रिय करें:

• Cmd+Shift+K (Mac) या Ctrl+Shift+K (Windows/Linux) दबाएं
• टूलबार में ClickSay आइकन पर क्लिक करें, फिर साइड पैनल में "Capture" पर क्लिक करें
• पेज पर किसी भी एलिमेंट पर राइट-क्लिक करें और "ClickSay this element" चुनें

कैप्चर मोड सक्रिय होने पर, होवर करने पर एलिमेंट नारंगी बॉर्डर से हाइलाइट होते हैं। जिस एलिमेंट पर फीडबैक देना चाहते हैं उस पर क्लिक करें।

चरण 2: बोलें (या टाइप करें)

एलिमेंट पर क्लिक करने के बाद, उसके पास एक पॉपअप दिखाई देता है। माइक्रोफ़ोन स्वचालित रूप से सक्रिय हो जाता है और आपको पॉपअप में "Listening..." दिखाई देगा।

• अपना फीडबैक स्वाभाविक रूप से बोलें: "padding ठीक करो," "इसे बड़ा करो," "फ़ॉन्ट sans-serif में बदलो।"
• अगर आप वॉइस का उपयोग नहीं करना चाहते तो पॉपअप के टेक्स्ट एरिया में टाइप करें।
• दोनों मिलाएं - आप बोल सकते हैं और फिर टाइप करके संपादित या जोड़ सकते हैं।
• सजेशन चिप टैप करें - आपने जिस एलिमेंट पर क्लिक किया उसके अनुसार त्वरित फीडबैक बटन दिखाई देते हैं। तुरंत टेक्स्ट डालने के लिए एक चिप टैप करें।

चरण 3: पेस्ट

जब आपका फीडबैक पूरा हो जाए:

• रिकॉर्डिंग बंद करने और प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करने के लिए पॉपअप में Enter दबाएं।
• या बस बोलना बंद कर दें - 2 सेकंड की चुप्पी के बाद, ClickSay स्वचालित रूप से प्रॉम्प्ट कॉपी कर देता है (ऑटो-कॉपी)।
• Cmd+V / Ctrl+V से अपने AI टूल में परिणाम पेस्ट करें।

Sweep मोड (एकाधिक एलिमेंट)

Sweep मोड आपको कई एलिमेंट चुनने और सभी के लिए एक ही फीडबैक देने की सुविधा देता है। यह एक Pro फ़ीचर है।

1. कैप्चर मोड सक्रिय करें (Cmd+Shift+K)।
2. Shift दबाकर रखें और प्रत्येक एलिमेंट पर क्लिक करें जिसे शामिल करना चाहते हैं। प्रत्येक क्लिक किए गए एलिमेंट को एक नंबर बैज मिलता है।
3. चयन पूरा होने पर, अंतिम एलिमेंट पर बिना Shift दबाए क्लिक करें।
4. पॉपअप दिखाई देता है। अपना फीडबैक बोलें - यह सभी चयनित एलिमेंट पर लागू होता है।
5. Enter दबाएं। सभी एलिमेंट को कवर करने वाला एक संरचित प्रॉम्प्ट क्लिपबोर्ड पर कॉपी हो जाता है।

सजेशन चिप्स

जब पॉपअप दिखाई देता है, तो आपको आम फीडबैक वाक्यांशों वाले छोटे क्लिक करने योग्य बटन दिखाई देंगे। ये सजेशन चिप्स कहलाते हैं और आपने जिस प्रकार के एलिमेंट पर क्लिक किया उसके अनुसार बदलते हैं:

• बटन/लिंक: "Change the text," "Fix hover state," "Make more prominent," "Change color"
• इमेज: "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• फॉर्म इनपुट: "Change placeholder," "Fix validation," "Resize this field," "Add label"
• हेडिंग: "Change text," "Adjust size," "Change font weight," "Fix spacing"
• और भी नेविगेशन, लिस्ट, टेबल, flex कंटेनर और grid कंटेनर के लिए।

टेक्स्ट डालने के लिए चिप टैप करें। फिर आप इसे संपादित या पूरक कर सकते हैं।

साइलेंस पर ऑटो-कॉपी

बोलना बंद करने के बाद, ClickSay 2 सेकंड की चुप्पी का इंतज़ार करता है और फिर स्वचालित रूप से संरचित प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी कर देता है। Enter दबाने की ज़रूरत नहीं - बस बोलना बंद करें और प्रॉम्प्ट पेस्ट करने के लिए तैयार है।

अगर बैकग्राउंड शोर को स्पीच के रूप में पहचाना जा रहा है, तो साइलेंस टाइमर शुरू नहीं होगा। शोरगुल वाले वातावरण में, मैन्युअली Enter दबाएं या टाइप करें।

खींचने योग्य पॉपअप

अगर फीडबैक पॉपअप उस एलिमेंट को ढक रहा है जिसे आप देखना चाहते हैं, तो बस इसे हटा दें। पॉपअप के शीर्ष पर हैंडल बार को क्लिक करके स्क्रीन पर कहीं भी खींचें।

इनलाइन फ़्लो

आप साइड पैनल खोले बिना सीधे पॉपअप में कैप्चर-से-क्लिपबोर्ड पूरा वर्कफ़्लो पूरा कर सकते हैं। एलिमेंट पर क्लिक करें, फीडबैक दें, और प्रॉम्प्ट कॉपी हो जाता है - सब इनलाइन। जब आपको इतिहास, सेटिंग्स या फॉर्मेट बदलने की ज़रूरत हो तब साइड पैनल उपलब्ध है।

---

3. आउटपुट फॉर्मेट

प्रीसेट

ClickSay चार आउटपुट प्रीसेट प्रदान करता है जो नियंत्रित करते हैं कि जनरेट किए गए प्रॉम्प्ट में कितना विवरण शामिल किया जाए।

Simple (Free)

एक सिंगल-लाइन, टर्मिनल-फ्रेंडली फॉर्मेट। केवल पेज URL शामिल है।

उदाहरण:

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

एक संरचित markdown फॉर्मेट। URL, CSS सेलेक्टर और एलिमेंट टेक्स्ट शामिल है।

Detailed (Pro)

पूर्ण संरचित markdown। URL, सेलेक्टर, टेक्स्ट, HTML, कंप्यूटेड CSS स्टाइल, फ़ाइल पाथ और कंपोनेंट नाम शामिल है।

Full (Pro)

ClickSay जो कुछ भी कैप्चर करता है वो सब। Detailed की सब चीज़ों के साथ पैरेंट कॉन्टेक्स्ट HTML, स्क्रीनशॉट और एक्सेसिबिलिटी ऑडिट परिणाम शामिल हैं।

Pills (व्यक्तिगत टॉगल)

प्रत्येक कैप्चर किया गया डेटा साइड पैनल में एक टॉगल करने योग्य "pill" से मेल खाता है। आप आउटपुट को कस्टमाइज़ करने के लिए अलग-अलग डेटा फ़ील्ड को चालू या बंद कर सकते हैं।

आउटपुट कैसे कस्टमाइज़ करें

1. ClickSay आइकन पर क्लिक करके साइड पैनल खोलें।
2. Output Format सेक्शन में, बेस कॉन्फ़िगरेशन से शुरू करने के लिए एक प्रीसेट बटन पर क्लिक करें।
3. शामिल डेटा को फ़ाइन-ट्यून करने के लिए अलग-अलग pills को चालू या बंद करें।
4. आपके चयन स्वचालित रूप से सहेजे जाते हैं और सत्रों के बीच बने रहते हैं।

---

4. साइड पैनल

साइड पैनल ClickSay का मुख्य नियंत्रण इंटरफ़ेस है। टूलबार में ClickSay आइकन पर क्लिक करके इसे खोलें।

हर चीज़ क्या करती है (ऊपर से नीचे)

हेडर

• ClickSay ब्रांड नाम, प्लान बैज (PRO या Free) के साथ।
• Upgrade लिंक (Free यूज़र्स के लिए दिखाई देता है) - प्राइसिंग पेज खोलता है।
• Capture बटन - मौजूदा टैब पर फीडबैक मोड सक्रिय करता है।
• Clear बटन - सारा इतिहास हटाता है।

आउटपुट फॉर्मेट सेक्शन

• प्रीसेट पंक्ति: चार बटन - Simple, Standard, Detailed, Full। Free यूज़र्स के लिए Detailed और Full पर लॉक आइकन दिखता है।
• Pills: दस चेकबॉक्स व्यक्तिगत डेटा फ़ील्ड के लिए। Pro-ओनली pills (Screenshot, Component, A11y) Free यूज़र्स के लिए लॉक आइकन दिखाते हैं।

Relay सेक्शन

• दिखाता है कि वैकल्पिक Claude Code relay सर्वर कनेक्ट है या नहीं।
• हरा बिंदु = कनेक्ट। लाल बिंदु = नहीं मिला।
• Relay कनेक्ट होने पर ऑटो-सेंड टॉगल दिखाई देता है।

कैप्चर व्यू

एलिमेंट कैप्चर करने के बाद, यह सेक्शन दिखाता है:

• एलिमेंट कार्ड: टैग नाम, CSS सेलेक्टर और एलिमेंट के टेक्स्ट का प्रीव्यू।
• स्क्रीनशॉट कार्ड: एलिमेंट पर नारंगी हाइलाइट के साथ कैप्चर किया गया स्क्रीनशॉट (अगर स्क्रीनशॉट लिया गया)।
• फीडबैक कार्ड: आपके वॉइस ट्रांसक्राइब या टाइप किए गए फीडबैक दिखाने वाला टेक्स्ट एरिया। माइक बटन शामिल है।
• टारगेट फ़ाइल कार्ड: ऑटो-डिटेक्ट या मैन्युअली दर्ज किया गया फ़ाइल पाथ।
• Copy to Clipboard बटन, Cmd+Return शॉर्टकट संकेत के साथ।

अकाउंट / प्लान सेक्शन

• मौजूदा प्लान दिखाता है (Free या Pro)।
• Free यूज़र्स के लिए: वॉइस और स्क्रीनशॉट उपयोग काउंटर दिखाता है (जैसे "3/20 इस महीने")।
• Upgrade या Manage लिंक।

इतिहास सेक्शन

• तारीख के अनुसार ग्रुप किए गए इतिहास आइटम (आज, कल, या विशिष्ट तारीखें)।
• प्रत्येक आइटम टाइमस्टैंप, एलिमेंट टैग, पेज होस्टनेम और काटा गया फीडबैक टेक्स्ट दिखाता है।
• कैप्चर व्यू में फिर से लोड करने के लिए आइटम पर क्लिक करें।
• प्रत्येक आइटम में कॉपी बटन (प्रॉम्प्ट फिर से कॉपी करने के लिए) और डिलीट बटन है।
• बैच एक्शन: आइटम चुने जाने पर "Copy Selected" और "Select All" बटन दिखाई देते हैं।

स्टोरेज प्रबंधन

• Storage used: दिखाता है कि ClickSay कितना लोकल स्टोरेज उपयोग कर रहा है (जैसे "2.3 MB")।
• Auto-purge: इतिहास कितने समय तक रखना है चुनें - 7 दिन, 30 दिन, 60 दिन, 90 दिन, या कभी नहीं। Free यूज़र्स 7 दिन तक सीमित हैं।
• Purge Images Now: सभी स्टोर किए गए स्क्रीनशॉट हटाता है लेकिन टेक्स्ट इतिहास रखता है।

संस्करण प्रदर्शन

एक्सटेंशन का मौजूदा संस्करण साइड पैनल के नीचे दिखाया जाता है।

---

5. सेटिंग्स

ऑप्शन पेज तक पहुंचें

टूलबार में ClickSay आइकन पर राइट-क्लिक करें और Options चुनें। या Chrome एक्सटेंशन पेज पर जाएं, ClickSay खोजें और "Details" फिर "Extension options" पर क्लिक करें।

Project Root

आपकी लोकल मशीन पर आपके प्रोजेक्ट की बेस डायरेक्टरी। उदाहरण:

/Users/you/projects/my-app

आउटपुट में फ़ाइल पाथ हल करने के लिए उपयोग किया जाता है। जब ClickSay कोई कंपोनेंट डिटेक्ट करता है या URL को फ़ाइल से मैप करता है, तो पूरा पाथ बनाने के लिए project root जोड़ा जाता है।

URL-to-File Mapping

Regex-आधारित नियम जो URL पैटर्न को सोर्स फ़ाइल पाथ से मैप करते हैं। जब ऑटोमैटिक फ्रेमवर्क डिटेक्शन सही फ़ाइल नहीं ढूंढ पाता तब यह उपयोगी है।

ClickSay सामान्य सेटअप के लिए प्रीसेट शामिल करता है:

• Static Site - URLs को सीधे फ़ाइल पाथ से मैप करता है
• Next.js - रूट को app/ डायरेक्टरी स्ट्रक्चर से मैप करता है
• SvelteKit - रूट को src/routes/ स्ट्रक्चर से मैप करता है
• React (CRA) - src/ डायरेक्टरी स्ट्रक्चर से मैप करता है

कस्टम नियम जोड़ने के लिए:

1. एक URL regex पैटर्न दर्ज करें (जैसे /dashboard/(.*))
2. फ़ाइल पाथ टेम्पलेट दर्ज करें (जैसे src/pages/dashboard/$1.tsx)
3. Save Settings पर क्लिक करें

लाइसेंस की

अगर आपने ClickSay Pro खरीदा है:

1. भुगतान के बाद, आपको ईमेल द्वारा एक लाइसेंस की प्राप्त होती है।
2. ऑप्शन पेज पर Pro License फ़ील्ड में की दर्ज करें।
3. Validate पर क्लिक करें।
4. अगर वैध है, तो आपका प्लान तुरंत Pro में अपग्रेड हो जाता है।

लाइसेंस की ClickSay वेबसाइट के माध्यम से खरीद के बाद एक्सटेंशन को स्वचालित रूप से भी भेजी जाती है - आपको मैन्युअली दर्ज करने की ज़रूरत नहीं पड़ सकती।

---

6. Free vs Pro

Free में क्या शामिल है

Pro में क्या शामिल है

मूल्य

• Free: $0
• Pro Monthly: $9/महीना
• Pro Yearly: $49/वर्ष (55% बचत)

कैसे अपग्रेड करें

1. साइड पैनल हेडर या अकाउंट सेक्शन में Upgrade लिंक पर क्लिक करें।
2. यह https://clicksay.net/#pricing पर प्राइसिंग पेज खोलता है।
3. Stripe भुगतान शुरू करने के लिए Go Pro पर क्लिक करें।
4. भुगतान के बाद, एक लाइसेंस की जनरेट होती है। यह स्वचालित रूप से आपके एक्सटेंशन को भेजी जाती है।
5. अगर ऑटोमैटिक एक्टिवेशन काम नहीं करता, तो अपने ईमेल से की कॉपी करें और ऑप्शन पेज में दर्ज करें।

उपयोग सीमाएं और रीसेट

• वॉइस और स्क्रीनशॉट उपयोग काउंटर प्रत्येक कैलेंडर माह की शुरुआत में रीसेट होते हैं।
• उपयोग साइड पैनल के अकाउंट सेक्शन में दिखाया जाता है।
• वॉइस सीमा पूरी होने पर भी आप एलिमेंट कैप्चर कर सकते हैं और टेक्स्ट फीडबैक टाइप कर सकते हैं।

---

7. कीबोर्ड शॉर्टकट

कॉन्टेक्स्ट मेन्यू

वेब पेज पर किसी भी एलिमेंट पर राइट-क्लिक करें और उस एलिमेंट के लिए कैप्चर मोड सक्रिय करने के लिए ClickSay this element चुनें।

शॉर्टकट कस्टमाइज़ करें

अगर Cmd+Shift+K / Ctrl+Shift+K काम नहीं कर रहा या किसी अन्य एक्सटेंशन से टकरा रहा है:

1. अपने ब्राउज़र में chrome://extensions/shortcuts पर जाएं।
2. "ClickSay - AI Feedback Copilot" खोजें।
3. "Activate ClickSay feedback mode" के बगल में पेंसिल आइकन पर क्लिक करें।
4. अपना पसंदीदा शॉर्टकट रिकॉर्ड करें।

---

8. समस्या निवारण

कीबोर्ड शॉर्टकट काम नहीं कर रहा

समस्या: Cmd+Shift+K / Ctrl+Shift+K दबाने पर कुछ नहीं होता।

समाधान:

1. chrome://extensions/shortcuts पर जाएं।
2. "ClickSay - AI Feedback Copilot" खोजें।
3. शॉर्टकट असाइन है या नहीं जांचें। अगर "Not set" दिखता है, तो पेंसिल आइकन पर क्लिक करें और Cmd+Shift+K रिकॉर्ड करें।
4. अगर कोई अन्य एक्सटेंशन वही शॉर्टकट उपयोग करता है, तो उनमें से एक बदलें।
5. वैकल्पिक: टूलबार आइकन या राइट-क्लिक मेन्यू उपयोग करें।

माइक्रोफ़ोन काम नहीं कर रहा

समस्या: माइक सक्रिय नहीं होता, या वॉइस पहचानी नहीं जाती।

समाधान:

1. मौजूदा साइट के लिए Chrome एड्रेस बार में लॉक आइकन पर क्लिक करें।
2. सुनिश्चित करें कि "माइक्रोफ़ोन" "अनुमति दें" पर सेट है।
3. macOS पर, सिस्टम प्रेफरेंसेस > प्राइवेसी एंड सिक्योरिटी > माइक्रोफ़ोन जांचें और सुनिश्चित करें कि Chrome को अनुमति दी गई है।
4. सुनिश्चित करें कि कोई अन्य ऐप माइक्रोफ़ोन का उपयोग नहीं कर रहा।
5. अनुमति देने के बाद पेज रीफ्रेश करें।

पेज पर कैप्चर नहीं हो रहा

समस्या: कैप्चर मोड सक्रिय होता है लेकिन एलिमेंट पर क्लिक करने पर कुछ नहीं होता, या कैप्चर मोड सक्रिय ही नहीं होता।

समाधान:

1. ClickSay chrome:// पेज, Chrome Web Store या अन्य प्रतिबंधित ब्राउज़र URLs पर काम नहीं करता। सामान्य वेबसाइट आज़माएं।
2. पेज रीफ्रेश करें और दोबारा प्रयास करें।
3. कुछ सख्त Content Security Policy वाले पेज स्क्रिप्ट इंजेक्शन को ब्लॉक कर सकते हैं।

साइड पैनल नहीं खुल रहा

समस्या: ClickSay आइकन पर क्लिक करने पर कुछ नहीं होता।

समाधान:

1. टूलबार में पज़ल आइकन पर क्लिक करें और ClickSay पिन करें।
2. फिर साइड पैनल खोलने के लिए ClickSay आइकन पर क्लिक करें।
3. अगर फिर भी काम नहीं करता, Chrome रीस्टार्ट करें।

आउटपुट क्लिपबोर्ड पर कॉपी नहीं हो रहा

समस्या: आपने Enter दबाया या Copy पर क्लिक किया, लेकिन क्लिपबोर्ड में कुछ नहीं है।

समाधान:

1. पेज के पॉपअप से Enter दबाकर देखें (इसकी सफलता दर सबसे अधिक है)।
2. साइड पैनल में Cmd+Return दबाकर देखें, पैनल फोकस में होना चाहिए।
3. सुनिश्चित करें कि कोई अन्य एक्सटेंशन क्लिपबोर्ड राइट को इंटरसेप्ट नहीं कर रहा।

वॉइस सीमा पूरी हो गई

समस्या: आपको संदेश दिखता है कि वॉइस सीमा पूरी हो गई।

समाधान:

1. Free प्लान प्रति माह 20 वॉइस फीडबैक की अनुमति देता है।
2. उपयोग प्रत्येक कैलेंडर माह की शुरुआत में रीसेट होता है।
3. आप अभी भी फीडबैक टाइप कर सकते हैं - केवल वॉइस सीमित है।
4. असीमित वॉइस के लिए Pro में अपग्रेड करें।

स्क्रीनशॉट सीमा पूरी हो गई

समस्या: कैप्चर काम करता है लेकिन स्क्रीनशॉट नहीं लिए जा रहे।

समाधान:

1. Free प्लान प्रति माह 5 स्क्रीनशॉट की अनुमति देता है। साइड पैनल में अकाउंट सेक्शन जांचें।
2. उपयोग प्रत्येक कैलेंडर माह की शुरुआत में रीसेट होता है।
3. असीमित स्क्रीनशॉट के लिए Pro में अपग्रेड करें।

पॉपअप एलिमेंट को ढक रहा है

समस्या: फीडबैक पॉपअप उस एलिमेंट के ऊपर दिखाई देता है जिसे आप देखना चाहते हैं।

समाधान: पॉपअप को हटा दें। पॉपअप के शीर्ष पर हैंडल बार को क्लिक करके स्क्रीन पर कहीं भी खींचें।

Enter या Escape की प्रतिक्रिया नहीं दे रहे

समस्या: पॉपअप में Enter या Escape दबाने पर कुछ नहीं होता।

समाधान: यह v1.0 में एक ज्ञात समस्या थी जहां पेज मोडल कीबोर्ड इवेंट को इंटरसेप्ट कर सकते थे। इसे ठीक करने के लिए v1.1.0 या बाद के संस्करण में अपडेट करें।

सजेशन चिप्स दिखाई नहीं दे रहे

समस्या: एलिमेंट पर क्लिक करने के बाद पॉपअप में कोई सजेशन चिप नहीं दिखता।

समाधान: चिप्स संदर्भ-जागरूक हैं और केवल कुछ एलिमेंट प्रकारों के लिए दिखाई देते हैं (बटन, इमेज, इनपुट, लिंक, हेडिंग, नेविगेशन, लिस्ट, टेबल, flex/grid कंटेनर)। अगर आपने किसी सामान्य <div> जैसे जेनेरिक कंटेनर पर क्लिक किया, तो चिप्स नहीं दिख सकते।

ऑटो-कॉपी काम नहीं कर रहा

समस्या: आपने बोलना बंद किया लेकिन प्रॉम्प्ट स्वचालित रूप से कॉपी नहीं हुआ।

समाधान: ऑटो-कॉपी 2 सेकंड की चुप्पी के बाद ट्रिगर होता है। अगर बैकग्राउंड शोर को स्पीच के रूप में पहचाना जा रहा है, तो टाइमर शुरू नहीं होगा। शांत जगह पर जाएं या टाइप करें। आप हमेशा मैन्युअली Enter दबा सकते हैं।

फ्रेमवर्क/कंपोनेंट नाम नहीं दिख रहा

समस्या: Component pill सक्षम है लेकिन कोई कंपोनेंट नाम नहीं दिखता।

समाधान:

1. कंपोनेंट डिटेक्शन Pro फ़ीचर है - सुनिश्चित करें कि आपके पास Pro है।
2. फ्रेमवर्क डिटेक्शन डेवलपमेंट बिल्ड (localhost, dev मोड) पर सबसे अच्छा काम करता है। प्रोडक्शन बिल्ड अक्सर डिबगिंग डेटा हटा देते हैं।
3. अगर डिटेक्शन विफल होता है, तो ऑप्शन पेज में URL-to-File mapping नियम उपयोग करें।

फ़ाइल पाथ "Not configured" दिखाता है

समस्या: फ़ाइल पाथ फ़ील्ड सोर्स फ़ाइल के बजाय "Not configured" दिखाता है।

समाधान:

1. ऑप्शन पेज खोलें (ClickSay आइकन पर राइट-क्लिक > Options)।
2. Project Root सेट करें (जैसे /Users/you/projects/my-app)।
3. मैपिंग नियम जोड़ें या प्रीसेट उपयोग करें (Next.js, SvelteKit, React, Static Site)।
4. Save Settings पर क्लिक करें।

Relay नहीं मिल रहा

समस्या: साइड पैनल लाल बिंदु के साथ "Relay not detected" दिखाता है।

समाधान:

1. Relay वैकल्पिक है। आपको इसकी ज़रूरत तभी है जब आप सीधे Claude Code को प्रॉम्प्ट भेजना चाहते हैं।
2. Relay शुरू करने के लिए, टर्मिनल खोलें और npx clicksay-relay चलाएं।
3. स्थिति 30 सेकंड में अपडेट होती है, या साइड पैनल बंद करके फिर से खोलें।
4. सुनिश्चित करें कि कोई फ़ायरवॉल localhost पोर्ट 19876 को ब्लॉक नहीं कर रहा।

मैं किस संस्करण पर हूं?

साइड पैनल खोलें - संस्करण संख्या नीचे दिखाई जाती है।

---

9. गोपनीयता एवं सुरक्षा

सारा डेटा स्थानीय रहता है

ClickSay पूरी तरह से आपके ब्राउज़र के भीतर काम करता है। सभी प्रोसेसिंग - DOM कैप्चर, वॉइस रिकॉग्निशन, प्रॉम्प्ट फॉर्मेटिंग, स्क्रीनशॉट कैप्चर - आपकी मशीन पर होती है। आपके डेटा को प्रोसेस करने वाला कोई ClickSay सर्वर नहीं है।

ब्राउज़र में क्या रहता है

• सभी कैप्चर किए गए एलिमेंट डेटा (सेलेक्टर, HTML, स्टाइल, आदि)
• सभी वॉइस फीडबैक टेक्स्ट
• सभी स्क्रीनशॉट
• फीडबैक इतिहास
• आपकी सेटिंग्स (आउटपुट प्रेफरेंस, मैपिंग नियम, relay प्रेफरेंस)

ब्राउज़र से क्या बाहर जाता है

डेटा केवल इन स्थितियों में आपके ब्राउज़र से बाहर जाता है, और ये सभी आपके द्वारा शुरू की जाती हैं:

1. क्लिपबोर्ड कॉपी - जब आप प्रॉम्प्ट कॉपी करते हैं, तो यह सिस्टम क्लिपबोर्ड पर जाता है।
2. वैकल्पिक relay - अगर आप relay सक्षम करते हैं और यह चल रहा है, तो प्रॉम्प्ट 127.0.0.1:19876 पर भेजे जाते हैं (केवल localhost - कभी आपकी मशीन से बाहर नहीं जाता)।
3. लाइसेंस सत्यापन - अगर आपके पास Pro लाइसेंस की है, तो एक्सटेंशन इसे https://clicksay.net/api/license/validate पर सत्यापित करता है। इस अनुरोध में केवल लाइसेंस की होती है - कोई फीडबैक, स्क्रीनशॉट या उपयोगकर्ता डेटा नहीं।

कोई ट्रैकिंग नहीं

• किसी भी प्रकार की एनालिटिक्स या टेलीमेट्री नहीं।
• कोई कुकी या ट्रैकिंग स्क्रिप्ट नहीं।
• कोई उपयोगकर्ता खाता या प्रमाणीकरण नहीं (Pro लाइसेंस की का उपयोग करता है, खाते का नहीं)।
• एक्सटेंशन नहीं जानता कि इसे किसने इंस्टॉल किया या इसका उपयोग कैसे हो रहा है।

अनुमतियां समझाई गईं

कोई व्यापक होस्ट अनुमतियां नहीं

ClickSay activeTab अनुमति का उपयोग करता है, जो केवल उस टैब तक पहुंच देती है जिसके साथ आप सक्रिय रूप से इंटरैक्ट कर रहे हैं, और केवल तभी जब आप स्पष्ट रूप से एक्सटेंशन ट्रिगर करते हैं। ClickSay स्वचालित रूप से content script चलाने वाली एकमात्र साइटें clicksay.net और www.clicksay.net हैं - यह केवल खरीद के बाद आपकी लाइसेंस की प्राप्त करने के लिए है।

---

10. अक्सर पूछे जाने वाले प्रश्न

क्या मैं किसी भी वेबसाइट पर ClickSay का उपयोग कर सकता/सकती हूं?

हां। v1.1.0 से, ClickSay किसी भी URL पर काम करता है - केवल localhost पर नहीं। एकमात्र अपवाद Chrome आंतरिक पेज (chrome://), Chrome Web Store और अन्य प्रतिबंधित ब्राउज़र URLs हैं।

क्या मुझे वॉइस का उपयोग करना ज़रूरी है? क्या मैं बस टाइप कर सकता/सकती हूं?

हां, आप बोलने की बजाय अपना फीडबैक टाइप कर सकते हैं। एलिमेंट पर क्लिक करने के बाद, बस पॉपअप के टेक्स्ट एरिया में टाइप करें। आप वॉइस और टाइपिंग को मिला भी सकते हैं - पहले बोलें, फिर टाइप करके संपादित या जोड़ें।

कौन से AI टूल ClickSay के साथ काम करते हैं?

ClickSay एक संरचित प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करता है। आप इसे किसी भी AI टूल में पेस्ट कर सकते हैं जो टेक्स्ट इनपुट स्वीकार करता है: Claude Code, Codex, Cursor, Lovable, Replit, Bolt.new, ChatGPT, या कोई अन्य AI सहायक।

क्या ClickSay मेरा डेटा किसी सर्वर पर भेजता है?

नहीं। सभी प्रोसेसिंग आपके ब्राउज़र में होती है। एकमात्र नेटवर्क अनुरोध लाइसेंस की सत्यापन (केवल Pro उपयोगकर्ता) और वैकल्पिक स्थानीय relay (केवल localhost) हैं। पूर्ण विवरण के लिए गोपनीयता एवं सुरक्षा अनुभाग देखें।

ClickSay कौन से फ्रेमवर्क डिटेक्ट करता है?

React, Vue (2 और 3), Angular, Svelte, Next.js और SvelteKit। डिटेक्शन डेवलपमेंट बिल्ड पर सबसे अच्छा काम करता है। प्रोडक्शन बिल्ड उस डिबगिंग डेटा को हटा सकते हैं जिसका ClickSay डिटेक्शन के लिए उपयोग करता है।

क्या मैं एक बार में कई एलिमेंट कैप्चर कर सकता/सकती हूं?

हां, Sweep मोड (केवल Pro) का उपयोग करके। Shift दबाकर रखें और प्रत्येक एलिमेंट पर क्लिक करें जिसे शामिल करना चाहते हैं, फिर Shift छोड़ें और अंतिम एलिमेंट पर क्लिक करें। अपना फीडबैक एक बार बोलें और यह सभी चयनित एलिमेंट पर लागू होता है।

Free प्लान की सीमाएं कब रीसेट होती हैं?

वॉइस और स्क्रीनशॉट उपयोग काउंटर प्रत्येक कैलेंडर माह की शुरुआत में रीसेट होते हैं। आपको कुछ करने की ज़रूरत नहीं - काउंटर स्वचालित रूप से रीसेट होते हैं।

क्या मैं पिछली कैप्चर फिर से कॉपी कर सकता/सकती हूं?

हां। साइड पैनल खोलें और अपने इतिहास में कैप्चर खोजें। प्रॉम्प्ट फिर से कॉपी करने के लिए इतिहास आइटम पर कॉपी बटन (क्लिपबोर्ड आइकन) पर क्लिक करें। प्रॉम्प्ट आपकी मौजूदा pills सेटिंग्स के साथ पुनर्जनरेट होता है।

बीच में कैप्चर कैसे रद्द करें?

कैप्चर मोड के दौरान किसी भी समय Escape दबाकर रद्द करें। यह पॉपअप बंद कर देता है और कैप्चर मोड निष्क्रिय कर देता है।

Relay फ़ीचर क्या है?

Relay एक वैकल्पिक स्थानीय सर्वर है जो आपको क्लिपबोर्ड का उपयोग करने के बजाय सीधे टर्मिनल में चल रहे Claude Code को प्रॉम्प्ट भेजने देता है। इसे npx clicksay-relay से शुरू करें। यह पूरी तरह से आपकी मशीन (localhost) पर चलता है।

एक्सटेंशन अपडेट कैसे चेक करें?

Chrome स्वचालित रूप से एक्सटेंशन अपडेट करता है। आप chrome://extensions पर भी जा सकते हैं, "डेवलपर मोड" सक्षम करें और मैन्युअली चेक करने के लिए "अपडेट" पर क्लिक करें। साइड पैनल के नीचे संस्करण संख्या जांचें।

और मदद कहां मिलेगी?

• नवीनतम जानकारी के लिए https://clicksay.net पर जाएं
• लाइव सपोर्ट के लिए clicksay.net पर चैट विजेट का उपयोग करें
• रिलीज़ नोट्स के लिए https://clicksay.net/#changelog पर What's New सेक्शन देखें

---

यह गाइड ClickSay v1.1.0 को कवर करती है। नवीनतम अपडेट के लिए, https://clicksay.net पर जाएं।

دليل الدعم الذاتي لـ ClickSay

اللغة: العربية آخر تحديث: مارس 2026 إصدار الإضافة: v1.1.0

هذا المستند هو ترجمة لـ en.md. للحصول على أحدث نسخة، يرجى الرجوع إلى النسخة الإنجليزية الأصلية.

---

جدول المحتويات

1. البدء
2. كيفية استخدام ClickSay
3. تنسيقات الإخراج
4. اللوحة الجانبية
5. الإعدادات
6. Free مقابل Pro
7. اختصارات لوحة المفاتيح
8. استكشاف الأخطاء وإصلاحها
9. الخصوصية والأمان
10. الأسئلة الشائعة

---

1. البدء

ما هو ClickSay؟

ClickSay هو إضافة لمتصفح Chrome تحول ملاحظات واجهة المستخدم إلى أوامر منظمة جاهزة للذكاء الاصطناعي. بدلاً من كتابة أوصاف طويلة لشرح ما تريد تغييره في صفحة ويب، يمكنك ببساطة النقر على عنصر، والتحدث بملاحظتك، ولصق النتيجة في أي أداة برمجة بالذكاء الاصطناعي. ما كان يستغرق دقيقة من الكتابة يأخذ حوالي 8 ثوانٍ مع ClickSay.

تثبيت ClickSay

1. قم بزيارة صفحة ClickSay على Chrome Web Store.
2. انقر على إضافة إلى Chrome.
3. أكد الأذونات عندما يُطلب منك ذلك.
4. سيظهر رمز ClickSay في شريط أدوات Chrome.

تثبيت الرمز

إذا لم تر رمز ClickSay في شريط الأدوات:

1. انقر على رمز قطعة اللغز (الإضافات) في شريط أدوات Chrome.
2. ابحث عن "ClickSay - AI Feedback Copilot" في القائمة.
3. انقر على رمز التثبيت لإبقائه مرئياً.

أول عملية التقاط - دليل خطوة بخطوة

اتبع هذه الخطوات لإجراء أول عملية التقاط:

1. افتح أي صفحة ويب (مثلاً، مشروعك على localhost، أو أي موقع عام).
2. اضغط Cmd+Shift+K (Mac) أو Ctrl+Shift+K (Windows/Linux) لتفعيل وضع الالتقاط. سيظهر إطار برتقالي عند تحريك المؤشر فوق العناصر.
3. انقر على أي عنصر في الصفحة. ستظهر نافذة منبثقة بالقرب من العنصر وسيبدأ الميكروفون تلقائياً.
4. تحدث بملاحظتك بشكل طبيعي - مثلاً، "كبّر هذا الزر وغيّر اللون إلى الأزرق."
5. اضغط Enter أو انتظر ثانيتين بعد التوقف عن الكلام. سيتم نسخ الأمر المنظم إلى الحافظة.
6. افتح أداة الذكاء الاصطناعي (Claude Code، Cursor، Lovable، Replit، Bolt.new، إلخ) والصق بـ Cmd+V / Ctrl+V.

هذا كل شيء. الذكاء الاصطناعي لديه الآن السياق الكامل - محدد العنصر، والأنماط، وHTML، وملاحظتك - ويمكنه إجراء التغيير بدقة.

---

2. كيفية استخدام ClickSay

سير عمل انقر-تحدث-الصق

يتبع ClickSay سير عمل بسيط من ثلاث خطوات:

الخطوة 1: انقر

فعّل وضع الالتقاط باستخدام أي من هذه الطرق:

• اضغط Cmd+Shift+K (Mac) أو Ctrl+Shift+K (Windows/Linux)
• انقر على رمز ClickSay في شريط الأدوات، ثم انقر على "Capture" في اللوحة الجانبية
• انقر بزر الماوس الأيمن على أي عنصر في الصفحة واختر "ClickSay this element"

بمجرد تفعيل وضع الالتقاط، تُبرز العناصر بإطار برتقالي عند تحريك المؤشر فوقها. انقر على العنصر الذي تريد إعطاء ملاحظة عنه.

الخطوة 2: تحدث (أو اكتب)

بعد النقر على عنصر، تظهر نافذة منبثقة بالقرب منه. يتم تفعيل الميكروفون تلقائياً وسترى "Listening..." في النافذة المنبثقة.

• تحدث بملاحظتك بشكل طبيعي: "أصلح الحشوة،" "كبّر هذا،" "غيّر الخط إلى sans-serif."
• اكتب في مربع النص في النافذة المنبثقة إذا كنت تفضل عدم استخدام الصوت.
• ادمج الاثنين - يمكنك التحدث ثم تعديل أو إضافة نص بالكتابة.
• انقر على شريحة اقتراح - تظهر أزرار ملاحظات سريعة بناءً على العنصر الذي نقرت عليه. انقر على واحدة لإدراج ذلك النص فوراً.

الخطوة 3: الصق

عندما تنتهي من ملاحظتك:

• اضغط Enter في النافذة المنبثقة لإيقاف التسجيل ونسخ الأمر إلى الحافظة.
• أو توقف عن الكلام ببساطة - بعد ثانيتين من الصمت، ينسخ ClickSay الأمر تلقائياً (النسخ التلقائي عند الصمت).
• الصق النتيجة في أداة الذكاء الاصطناعي بـ Cmd+V / Ctrl+V.

وضع Sweep (عناصر متعددة)

يتيح لك وضع Sweep تحديد عناصر متعددة وإعطاء ملاحظة واحدة لجميعها. هذه ميزة Pro.

1. فعّل وضع الالتقاط (Cmd+Shift+K).
2. اضغط مع الاستمرار على Shift وانقر على كل عنصر تريد تضمينه. يحصل كل عنصر على شارة مرقمة.
3. عند الانتهاء من التحديد، انقر على العنصر الأخير بدون الضغط على Shift.
4. تظهر النافذة المنبثقة. تحدث بملاحظتك - تُطبق على جميع العناصر المحددة.
5. اضغط Enter. يتم نسخ أمر منظم واحد يغطي جميع العناصر إلى الحافظة.

شرائح الاقتراح

عندما تظهر النافذة المنبثقة، سترى أزراراً صغيرة قابلة للنقر تحتوي على عبارات ملاحظات شائعة. تسمى هذه شرائح الاقتراح وتتغير بناءً على نوع العنصر الذي نقرت عليه:

• أزرار/روابط: "Change the text," "Fix hover state," "Make more prominent," "Change color"
• صور: "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• حقول النموذج: "Change placeholder," "Fix validation," "Resize this field," "Add label"
• عناوين: "Change text," "Adjust size," "Change font weight," "Fix spacing"
• والمزيد للتنقل، والقوائم، والجداول، وحاويات flex وgrid.

انقر على شريحة لإدراج نصها في ملاحظتك. يمكنك بعد ذلك تعديلها أو إضافة المزيد إليها.

النسخ التلقائي عند الصمت

بعد أن تتوقف عن الكلام، ينتظر ClickSay ثانيتين من الصمت ثم ينسخ تلقائياً الأمر المنظم إلى الحافظة. لا تحتاج إلى الضغط على Enter - فقط توقف عن الكلام والأمر جاهز للصق.

إذا تم التقاط ضوضاء الخلفية كصوت كلام، فلن يبدأ مؤقت الصمت. في البيئات الصاخبة، اضغط Enter يدوياً أو اكتب ملاحظتك بدلاً من ذلك.

النافذة المنبثقة القابلة للسحب

إذا كانت النافذة المنبثقة تغطي العنصر الذي تريد رؤيته، فقط اسحبها بعيداً. انقر واسحب شريط المقبض في أعلى النافذة المنبثقة لتحريكها إلى أي مكان على الشاشة.

التدفق المباشر

يمكنك إكمال سير العمل بالكامل من الالتقاط إلى الحافظة مباشرة في النافذة المنبثقة دون فتح اللوحة الجانبية. انقر على عنصر، أعطِ ملاحظتك، ويتم نسخ الأمر - كل شيء مباشر. اللوحة الجانبية لا تزال متاحة عندما تحتاج إلى السجل أو الإعدادات أو تغييرات التنسيق.

---

3. تنسيقات الإخراج

الإعدادات المسبقة

يقدم ClickSay أربعة إعدادات مسبقة للإخراج تتحكم في مقدار التفاصيل المضمنة في الأمر المُنشأ.

Simple (Free)

تنسيق سطر واحد، مناسب للطرفية. يتضمن فقط عنوان URL للصفحة.

مثال:

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

تنسيق markdown منظم. يتضمن عنوان URL ومحدد CSS ونص العنصر.

Detailed (Pro)

markdown منظم كامل. يتضمن عنوان URL والمحدد والنص وHTML وأنماط CSS المحسوبة ومسار الملف واسم المكون.

Full (Pro)

كل ما يلتقطه ClickSay. يتضمن كل شيء في Detailed بالإضافة إلى HTML السياق الأصلي ولقطة الشاشة ونتائج تدقيق إمكانية الوصول.

Pills (مفاتيح تبديل فردية)

كل جزء من البيانات الملتقطة يقابله "pill" (زر تبديل) في اللوحة الجانبية. يمكنك تشغيل أو إيقاف حقول البيانات الفردية لتخصيص إخراجك.

كيفية تخصيص الإخراج

1. افتح اللوحة الجانبية بالنقر على رمز ClickSay.
2. في قسم Output Format، انقر على زر إعداد مسبق للبدء بتكوين أساسي.
3. شغّل أو أوقف pills فردية لضبط البيانات المضمنة.
4. يتم حفظ اختياراتك تلقائياً وتستمر بين الجلسات.

---

4. اللوحة الجانبية

اللوحة الجانبية هي واجهة التحكم الرئيسية لـ ClickSay. افتحها بالنقر على رمز ClickSay في شريط الأدوات.

ما يفعله كل شيء (من الأعلى إلى الأسفل)

الرأس

• اسم العلامة التجارية ClickSay مع شارة الخطة (PRO أو Free).
• رابط Upgrade (مرئي لمستخدمي Free) - يفتح صفحة التسعير.
• زر Capture - يفعّل وضع الملاحظات على التبويب الحالي.
• زر Clear - يزيل كل السجل.

قسم تنسيق الإخراج

• صف الإعدادات المسبقة: أربعة أزرار - Simple، Standard، Detailed، Full. تظهر Detailed وFull رموز قفل لمستخدمي Free.
• Pills: عشر خانات اختيار لحقول البيانات الفردية. تظهر pills الخاصة بـ Pro (Screenshot، Component، A11y) رموز قفل لمستخدمي Free.

قسم Relay

• يوضح ما إذا كان خادم relay الاختياري لـ Claude Code متصلاً.
• نقطة خضراء = متصل. نقطة حمراء = غير مكتشف.
• يظهر مفتاح الإرسال التلقائي عند اتصال relay.

عرض الالتقاط

بعد التقاط عنصر، يعرض هذا القسم:

• بطاقة العنصر: اسم الوسم ومحدد CSS ومعاينة نص العنصر.
• بطاقة لقطة الشاشة: لقطة الشاشة الملتقطة مع تمييز برتقالي على العنصر (إذا تم أخذ لقطة).
• بطاقة الملاحظات: مربع نص يعرض ملاحظتك المُحولة من الصوت أو المكتوبة. يتضمن زر ميكروفون.
• بطاقة الملف المستهدف: مسار الملف المكتشف تلقائياً أو المُدخل يدوياً.
• زر Copy to Clipboard مع تلميح اختصار Cmd+Return.

قسم الحساب / الخطة

• يعرض خطتك الحالية (Free أو Pro).
• لمستخدمي Free: يعرض عدادات استخدام الصوت ولقطات الشاشة (مثل "3/20 هذا الشهر").
• رابط Upgrade أو Manage.

قسم السجل

• عناصر السجل مجمعة حسب التاريخ (اليوم، أمس، أو تواريخ محددة).
• يعرض كل عنصر الطابع الزمني واسم وسم العنصر واسم المضيف للصفحة ونص الملاحظة المختصر.
• انقر على عنصر لإعادة تحميله في عرض الالتقاط.
• لكل عنصر زر نسخ (لإعادة نسخ الأمر) وزر حذف.
• إجراءات دفعية: تظهر أزرار "Copy Selected" و"Select All" عند تحديد العناصر.

إدارة التخزين

• Storage used: يوضح مقدار التخزين المحلي الذي يستخدمه ClickSay (مثل "2.3 MB").
• Auto-purge: اختر مدة الاحتفاظ بالسجل - 7 أيام، 30 يوماً، 60 يوماً، 90 يوماً، أو أبداً. مستخدمو Free محدودون بـ 7 أيام.
• Purge Images Now: يزيل جميع لقطات الشاشة المخزنة مع الاحتفاظ بسجل النصوص.

عرض الإصدار

يظهر إصدار الإضافة الحالي في أسفل اللوحة الجانبية.

---

5. الإعدادات

الوصول إلى صفحة الخيارات

انقر بزر الماوس الأيمن على رمز ClickSay في شريط الأدوات واختر Options. أو انتقل إلى صفحة إضافات Chrome، وابحث عن ClickSay، وانقر على "التفاصيل" ثم "خيارات الإضافة."

Project Root

المجلد الأساسي لمشروعك على جهازك المحلي. مثال:

/Users/you/projects/my-app

يُستخدم لحل مسارات الملفات في الإخراج. عندما يكتشف ClickSay مكوناً أو يربط عنوان URL بملف، يُضاف project root كبادئة لإنشاء مسار كامل.

URL-to-File Mapping

قواعد قائمة على التعبيرات المنتظمة (regex) تربط أنماط عناوين URL بمسارات الملفات المصدرية. مفيد عندما لا يجد الكشف التلقائي عن الإطار الملف الصحيح.

يتضمن ClickSay إعدادات مسبقة للتكوينات الشائعة:

• Static Site - يربط عناوين URL مباشرة بمسارات الملفات
• Next.js - يربط المسارات ببنية مجلد app/
• SvelteKit - يربط المسارات ببنية src/routes/
• React (CRA) - يربط ببنية مجلد src/

لإضافة قاعدة مخصصة:

1. أدخل نمط regex لعنوان URL (مثل /dashboard/(.*))
2. أدخل قالب مسار الملف (مثل src/pages/dashboard/$1.tsx)
3. انقر على Save Settings

مفتاح الترخيص

إذا اشتريت ClickSay Pro:

1. بعد الدفع، تتلقى مفتاح ترخيص عبر البريد الإلكتروني.
2. أدخل المفتاح في حقل Pro License في صفحة الخيارات.
3. انقر على Validate.
4. إذا كان صالحاً، تتم ترقية خطتك فوراً إلى Pro.

يتم أيضاً إرسال مفتاح الترخيص تلقائياً إلى الإضافة بعد الشراء عبر موقع ClickSay - قد لا تحتاج إلى إدخاله يدوياً.

---

6. Free مقابل Pro

ما يتضمنه Free

ما يتضمنه Pro

التسعير

• Free: $0
• Pro Monthly: $9/شهر
• Pro Yearly: $49/سنة (توفير 55%)

كيفية الترقية

1. انقر على رابط Upgrade في رأس اللوحة الجانبية أو قسم الحساب.
2. يفتح صفحة التسعير على https://clicksay.net/#pricing.
3. انقر على Go Pro لبدء الدفع عبر Stripe.
4. بعد الدفع، يتم إنشاء مفتاح ترخيص. يُرسل تلقائياً إلى إضافتك.
5. إذا لم يعمل التفعيل التلقائي، انسخ المفتاح من بريدك الإلكتروني وأدخله في صفحة الخيارات.

حدود الاستخدام وإعادة التعيين

• يتم إعادة تعيين عدادات الصوت ولقطات الشاشة في بداية كل شهر تقويمي.
• يُعرض الاستخدام في قسم الحساب في اللوحة الجانبية.
• يمكنك الاستمرار في التقاط العناصر وكتابة الملاحظات حتى عند الوصول إلى حدود الصوت.

---

7. اختصارات لوحة المفاتيح

قائمة السياق

انقر بزر الماوس الأيمن على أي عنصر في صفحة ويب واختر ClickSay this element لتفعيل وضع الالتقاط لذلك العنصر.

تخصيص الاختصار

إذا لم يعمل Cmd+Shift+K / Ctrl+Shift+K أو تعارض مع إضافة أخرى:

1. انتقل إلى chrome://extensions/shortcuts في متصفحك.
2. ابحث عن "ClickSay - AI Feedback Copilot."
3. انقر على رمز القلم بجانب "Activate ClickSay feedback mode."
4. سجّل اختصارك المفضل.

---

8. استكشاف الأخطاء وإصلاحها

اختصار لوحة المفاتيح لا يعمل

المشكلة: الضغط على Cmd+Shift+K / Ctrl+Shift+K لا يفعل شيئاً.

الحل:

1. اذهب إلى chrome://extensions/shortcuts.
2. ابحث عن "ClickSay - AI Feedback Copilot."
3. تحقق مما إذا كان الاختصار مُعيّناً. إذا ظهر "Not set"، انقر على رمز القلم وسجّل Cmd+Shift+K.
4. إذا كانت إضافة أخرى تستخدم نفس الاختصار، غيّر أحدهما.
5. كبديل، استخدم رمز شريط الأدوات أو قائمة النقر بزر الماوس الأيمن.

الميكروفون لا يعمل

المشكلة: الميكروفون لا يتفعل، أو الصوت لا يُتعرف عليه.

الحل:

1. انقر على رمز القفل في شريط عنوان Chrome للموقع الحالي.
2. تأكد من ضبط "الميكروفون" على "السماح."
3. على macOS، تحقق من تفضيلات النظام > الخصوصية والأمان > الميكروفون وتأكد من السماح لـ Chrome.
4. تأكد من عدم استخدام تطبيق آخر للميكروفون.
5. أعد تحميل الصفحة بعد منح الإذن.

لا يمكن الالتقاط على صفحة

المشكلة: وضع الالتقاط يتفعل لكن النقر على العناصر لا يفعل شيئاً، أو وضع الالتقاط لا يتفعل أصلاً.

الحل:

1. لا يعمل ClickSay على صفحات chrome:// أو Chrome Web Store أو عناوين URL المقيدة الأخرى. جرب موقعاً عادياً.
2. أعد تحميل الصفحة وحاول مرة أخرى.
3. بعض الصفحات ذات سياسات أمان المحتوى الصارمة قد تمنع حقن البرامج النصية.

اللوحة الجانبية لا تُفتح

المشكلة: النقر على رمز ClickSay لا يفعل شيئاً.

الحل:

1. انقر على رمز قطعة اللغز في شريط الأدوات وثبّت ClickSay.
2. ثم انقر على رمز ClickSay لفتح اللوحة الجانبية.
3. إذا لم يعمل بعد، حاول إعادة تشغيل Chrome.

الإخراج لا يُنسخ إلى الحافظة

المشكلة: ضغطت Enter أو نقرت على نسخ، لكن لا شيء في الحافظة.

الحل:

1. حاول الضغط على Enter من النافذة المنبثقة في الصفحة (لديها أعلى معدل نجاح).
2. حاول الضغط على Cmd+Return من اللوحة الجانبية مع التأكد من أن اللوحة في التركيز.
3. تأكد من عدم اعتراض إضافة أخرى لكتابات الحافظة.

تم الوصول إلى حد الصوت

المشكلة: ترى رسالة تفيد بأنه تم الوصول إلى حد الصوت.

الحل:

1. خطة Free تسمح بـ 20 ملاحظة صوتية في الشهر.
2. يتم إعادة تعيين الاستخدام في بداية كل شهر تقويمي.
3. لا يزال بإمكانك كتابة ملاحظاتك - فقط الصوت محدود.
4. قم بالترقية إلى Pro للحصول على صوت غير محدود.

تم الوصول إلى حد لقطات الشاشة

المشكلة: الالتقاط يعمل لكن لقطات الشاشة لا تُؤخذ.

الحل:

1. خطة Free تسمح بـ 5 لقطات شاشة في الشهر. تحقق من قسم الحساب في اللوحة الجانبية.
2. يتم إعادة تعيين الاستخدام في بداية كل شهر تقويمي.
3. قم بالترقية إلى Pro للحصول على لقطات شاشة غير محدودة.

النافذة المنبثقة تغطي العنصر

المشكلة: نافذة الملاحظات المنبثقة تظهر فوق العنصر الذي تريد رؤيته.

الحل: اسحب النافذة المنبثقة بعيداً. انقر واسحب شريط المقبض في أعلى النافذة المنبثقة لتحريكها إلى أي مكان على الشاشة.

مفاتيح Enter أو Escape لا تستجيب

المشكلة: الضغط على Enter أو Escape في النافذة المنبثقة لا يفعل شيئاً.

الحل: كانت هذه مشكلة معروفة في v1.0 حيث يمكن لنوافذ الصفحة المنبثقة اعتراض أحداث لوحة المفاتيح. قم بالتحديث إلى v1.1.0 أو أحدث لإصلاح هذا.

شرائح الاقتراح لا تظهر

المشكلة: لا تظهر شرائح اقتراح في النافذة المنبثقة بعد النقر على عنصر.

الحل: الشرائح تعتمد على السياق وتظهر فقط لأنواع معينة من العناصر (أزرار، صور، حقول إدخال، روابط، عناوين، تنقل، قوائم، جداول، حاويات flex/grid). إذا نقرت على حاوية عامة مثل <div> بسيط، قد لا تظهر الشرائح.

النسخ التلقائي لا يعمل

المشكلة: توقفت عن الكلام لكن لم يتم نسخ الأمر تلقائياً.

الحل: يتم تشغيل النسخ التلقائي بعد ثانيتين من الصمت. إذا تم التقاط ضوضاء الخلفية ككلام، فلن يبدأ المؤقت. حاول الانتقال إلى مكان أهدأ أو اكتب ملاحظتك بدلاً من ذلك. يمكنك دائماً الضغط على Enter يدوياً.

اسم الإطار/المكون لا يظهر

المشكلة: pill المكون مُفعّل لكن لا يظهر اسم مكون.

الحل:

1. كشف المكونات ميزة Pro - تأكد من أن لديك Pro.
2. كشف الإطار يعمل بشكل أفضل على بنيات التطوير (localhost، وضع التطوير). بنيات الإنتاج غالباً ما تزيل بيانات التصحيح.
3. إذا فشل الكشف، استخدم قواعد URL-to-File mapping في صفحة الخيارات كبديل.

مسار الملف يقول "Not configured"

المشكلة: حقل مسار الملف يعرض "Not configured" بدلاً من ملف مصدري.

الحل:

1. افتح صفحة الخيارات (انقر بزر الماوس الأيمن على رمز ClickSay > Options).
2. عيّن Project Root (مثل /Users/you/projects/my-app).
3. أضف قواعد ربط أو استخدم إعداداً مسبقاً (Next.js، SvelteKit، React، Static Site).
4. انقر على Save Settings.

Relay غير مكتشف

المشكلة: اللوحة الجانبية تعرض "Relay not detected" مع نقطة حمراء.

الحل:

1. Relay اختياري. تحتاجه فقط إذا أردت إرسال الأوامر مباشرة إلى Claude Code.
2. لبدء relay، افتح الطرفية وشغّل npx clicksay-relay.
3. يتم تحديث الحالة خلال 30 ثانية، أو أغلق وأعد فتح اللوحة الجانبية.
4. تأكد من عدم حظر جدار حماية لمنفذ localhost 19876.

ما الإصدار الذي أستخدمه؟

افتح اللوحة الجانبية - رقم الإصدار معروض في الأسفل.

---

9. الخصوصية والأمان

جميع البيانات تبقى محلية

يعمل ClickSay بالكامل داخل متصفحك. كل المعالجة - التقاط DOM، التعرف على الصوت، تنسيق الأوامر، التقاط الشاشة - تحدث على جهازك. لا يوجد خادم ClickSay يعالج بياناتك.

ما يبقى في متصفحك

• جميع بيانات العناصر الملتقطة (المحددات، HTML، الأنماط، إلخ)
• جميع نصوص الملاحظات الصوتية
• جميع لقطات الشاشة
• سجل الملاحظات
• إعداداتك (تفضيلات الإخراج، قواعد الربط، تفضيل relay)

ما يغادر المتصفح

تغادر البيانات متصفحك فقط في هذه الحالات، وجميعها تبدأ بمبادرتك:

1. نسخ الحافظة - عند نسخ أمر، يذهب إلى حافظة النظام.
2. Relay الاختياري - إذا فعّلت relay وكان يعمل، تُرسل الأوامر إلى 127.0.0.1:19876 (localhost فقط - لا يغادر جهازك أبداً).
3. التحقق من الترخيص - إذا كان لديك مفتاح Pro، تتحقق الإضافة منه عبر https://clicksay.net/api/license/validate. يحتوي هذا الطلب فقط على مفتاح الترخيص - لا ملاحظات، ولا لقطات شاشة، ولا بيانات مستخدم.

بدون تتبع

• لا تحليلات أو بيانات عن بعد من أي نوع.
• لا ملفات تعريف ارتباط أو نصوص تتبع.
• لا حسابات مستخدمين أو مصادقة (Pro يستخدم مفتاح ترخيص، وليس حساباً).
• الإضافة لا تعرف من ثبّتها أو كيف تُستخدم.

الأذونات موضحة

بدون أذونات مضيف شاملة

يستخدم ClickSay إذن activeTab، الذي يمنح فقط الوصول إلى التبويب الذي تتفاعل معه بنشاط، وفقط عند تشغيل الإضافة صراحةً. المواقع الوحيدة التي يشغّل فيها ClickSay content script تلقائياً هي clicksay.net وwww.clicksay.net - وهذا فقط لاستقبال مفتاح الترخيص بعد الشراء.

---

10. الأسئلة الشائعة

هل يمكنني استخدام ClickSay على أي موقع ويب؟

نعم. منذ v1.1.0، يعمل ClickSay على أي عنوان URL - ليس فقط localhost. الاستثناءات الوحيدة هي صفحات Chrome الداخلية (chrome://) وChrome Web Store وعناوين URL المقيدة الأخرى في المتصفح.

هل يجب أن أستخدم الصوت؟ هل يمكنني الكتابة فقط؟

نعم، يمكنك كتابة ملاحظتك بدلاً من التحدث. بعد النقر على عنصر، اكتب ببساطة في مربع النص في النافذة المنبثقة. يمكنك أيضاً الجمع بين الصوت والكتابة - تحدث أولاً، ثم عدّل أو أضف نصاً بالكتابة.

ما أدوات الذكاء الاصطناعي التي تعمل مع ClickSay؟

ينسخ ClickSay أمراً منظماً إلى الحافظة. يمكنك لصقه في أي أداة ذكاء اصطناعي تقبل إدخال نصي: Claude Code، Codex، Cursor، Lovable، Replit، Bolt.new، ChatGPT، أو أي مساعد ذكاء اصطناعي آخر.

هل يرسل ClickSay بياناتي إلى خادم؟

لا. كل المعالجة تحدث في متصفحك. طلبات الشبكة الوحيدة هي التحقق من مفتاح الترخيص (مستخدمو Pro فقط) وrelay المحلي الاختياري (localhost فقط). انظر قسم الخصوصية والأمان للتفاصيل الكاملة.

ما الأُطر التي يكتشفها ClickSay؟

React، Vue (2 و3)، Angular، Svelte، Next.js وSvelteKit. يعمل الكشف بشكل أفضل على بنيات التطوير. بنيات الإنتاج قد تزيل بيانات التصحيح التي يستخدمها ClickSay للكشف.

هل يمكنني التقاط عناصر متعددة مرة واحدة؟

نعم، باستخدام وضع Sweep (Pro فقط). اضغط مع الاستمرار على Shift وانقر على كل عنصر تريد تضمينه، ثم حرّر Shift وانقر على العنصر الأخير. تحدث بملاحظتك مرة واحدة وتُطبق على جميع العناصر المحددة.

متى تتم إعادة تعيين حدود خطة Free؟

يتم إعادة تعيين عدادات الصوت ولقطات الشاشة في بداية كل شهر تقويمي. لا تحتاج لفعل أي شيء - يتم إعادة تعيين العدادات تلقائياً.

هل يمكنني إعادة نسخ التقاط سابق؟

نعم. افتح اللوحة الجانبية وابحث عن الالتقاط في سجلك. انقر على زر النسخ (رمز الحافظة) على عنصر السجل لإعادة نسخ أمره. يتم إعادة إنشاء الأمر بإعدادات pills الحالية.

كيف ألغي التقاطاً في المنتصف؟

اضغط Escape في أي وقت أثناء وضع الالتقاط للإلغاء. هذا يغلق النافذة المنبثقة ويعطّل وضع الالتقاط.

ما هي ميزة relay؟

Relay هو خادم محلي اختياري يتيح لك إرسال الأوامر مباشرة إلى Claude Code العامل في الطرفية، بدلاً من استخدام الحافظة. شغّله بـ npx clicksay-relay. يعمل بالكامل على جهازك (localhost).

كيف أتحقق من تحديثات الإضافة؟

يحدّث Chrome الإضافات تلقائياً. يمكنك أيضاً الذهاب إلى chrome://extensions، تفعيل "وضع المطور"، والنقر على "تحديث" للتحقق يدوياً. تحقق من رقم الإصدار في أسفل اللوحة الجانبية.

أين يمكنني الحصول على مزيد من المساعدة؟

• قم بزيارة https://clicksay.net للحصول على أحدث المعلومات
• استخدم أداة المحادثة على clicksay.net للدعم المباشر
• تحقق من قسم What's New على https://clicksay.net/#changelog لملاحظات الإصدار

---

يغطي هذا الدليل ClickSay v1.1.0. لأحدث التحديثات، قم بزيارة https://clicksay.net.

Guia de Suporte e Autoajuda do ClickSay

Idioma: Portugues Ultima atualizacao: Marco 2026 Versao da extensao: v1.1.0

Este documento e uma traducao de en.md. Para a versao mais atualizada, consulte o original em ingles.

---

Indice

1. Primeiros Passos
2. Como Usar o ClickSay
3. Formatos de Saida
4. Painel Lateral
5. Configuracoes
6. Free vs Pro
7. Atalhos de Teclado
8. Solucao de Problemas
9. Privacidade e Seguranca
10. Perguntas Frequentes

---

1. Primeiros Passos

O que e o ClickSay?

ClickSay e uma extensao do Chrome que transforma feedback de interface em prompts estruturados e prontos para IA. Em vez de digitar longas descricoes para explicar o que voce quer mudar em uma pagina web, basta clicar em um elemento, falar seu feedback e colar o resultado em qualquer ferramenta de programacao com IA. O que antes levava um minuto digitando leva cerca de 8 segundos com o ClickSay.

Instalar o ClickSay

1. Visite a pagina do ClickSay na Chrome Web Store.
2. Clique em Adicionar ao Chrome.
3. Confirme as permissoes quando solicitado.
4. O icone do ClickSay aparecera na barra de ferramentas do Chrome.

Fixar o Icone

Se voce nao ve o icone do ClickSay na barra de ferramentas:

1. Clique no icone de peca de quebra-cabeca (Extensoes) na barra de ferramentas do Chrome.
2. Encontre "ClickSay - AI Feedback Copilot" na lista.
3. Clique no icone de fixar para mante-lo visivel.

Sua Primeira Captura - Passo a Passo

Siga estas etapas para fazer sua primeira captura:

1. Abra qualquer pagina web (por exemplo, seu projeto no localhost ou qualquer site publico).
2. Pressione Cmd+Shift+K (Mac) ou Ctrl+Shift+K (Windows/Linux) para ativar o modo de captura. Voce vera um contorno laranja ao passar o mouse sobre os elementos.
3. Clique em qualquer elemento da pagina. Um popup aparecera perto do elemento e o microfone iniciara automaticamente.
4. Fale seu feedback naturalmente - por exemplo, "torna este botao maior e muda a cor para azul."
5. Pressione Enter ou espere 2 segundos apos parar de falar. O prompt estruturado e copiado para a area de transferencia.
6. Abra sua ferramenta de IA (Claude Code, Cursor, Lovable, Replit, Bolt.new, etc.) e cole com Cmd+V / Ctrl+V.

E isso. A IA agora tem o contexto completo - o seletor do elemento, estilos, HTML e seu feedback - e pode fazer a alteracao com precisao.

---

2. Como Usar o ClickSay

O Fluxo Clica-Fala-Cola

O ClickSay segue um fluxo de trabalho simples de tres etapas:

Etapa 1: Clica

Ative o modo de captura usando qualquer um destes metodos:

• Pressione Cmd+Shift+K (Mac) ou Ctrl+Shift+K (Windows/Linux)
• Clique no icone do ClickSay na barra de ferramentas e depois em "Capture" no painel lateral
• Clique com o botao direito em qualquer elemento da pagina e selecione "ClickSay this element"

Com o modo de captura ativo, os elementos ficam destacados com um contorno laranja ao passar o mouse. Clique no elemento sobre o qual deseja dar feedback.

Etapa 2: Fala (ou Digita)

Apos clicar em um elemento, um popup aparece perto dele. O microfone e ativado automaticamente e voce vera "Listening..." no popup.

• Fale seu feedback naturalmente: "corrige o padding," "torna isto maior," "muda a fonte para sans-serif."
• Digite na area de texto do popup se preferir nao usar voz.
• Combine ambos - voce pode falar e depois editar ou adicionar texto digitando.
• Toque em um chip de sugestao - botoes de feedback rapido aparecem com base no elemento que voce clicou. Toque em um para inserir esse texto instantaneamente.

Etapa 3: Cola

Quando terminar seu feedback:

• Pressione Enter no popup para parar a gravacao e copiar o prompt para a area de transferencia.
• Ou simplesmente pare de falar - apos 2 segundos de silencio, o ClickSay copia o prompt automaticamente (copia automatica no silencio).
• Cole o resultado na sua ferramenta de IA com Cmd+V / Ctrl+V.

Modo Sweep (Multiplos Elementos)

O modo Sweep permite selecionar multiplos elementos e dar um unico feedback para todos. Esta e uma funcionalidade Pro.

1. Ative o modo de captura (Cmd+Shift+K).
2. Mantenha Shift pressionado e clique em cada elemento que deseja incluir. Cada elemento recebe um numero.
3. Quando terminar de selecionar, clique no ultimo elemento sem manter Shift pressionado.
4. O popup aparece. Fale seu feedback - ele se aplica a todos os elementos selecionados.
5. Pressione Enter. Um prompt estruturado cobrindo todos os elementos e copiado para a area de transferencia.

Chips de Sugestao

Quando o popup aparece, voce vera pequenos botoes clicaveis com frases de feedback comuns. Sao chamados de chips de sugestao e mudam conforme o tipo de elemento que voce clicou:

• Botoes/links: "Change the text," "Fix hover state," "Make more prominent," "Change color"
• Imagens: "Replace this image," "Fix aspect ratio," "Add alt text," "Make responsive"
• Campos de formulario: "Change placeholder," "Fix validation," "Resize this field," "Add label"
• Titulos: "Change text," "Adjust size," "Change font weight," "Fix spacing"
• E mais para navegacao, listas, tabelas, containers flex e grid.

Toque em um chip para inserir seu texto no feedback. Depois, voce pode editar ou complementar.

Copia Automatica no Silencio

Apos voce parar de falar, o ClickSay espera 2 segundos de silencio e entao copia automaticamente o prompt estruturado para a area de transferencia. Nao precisa pressionar Enter - basta parar de falar e o prompt esta pronto para colar.

Se o ruido de fundo estiver sendo captado como fala, o temporizador de silencio nao iniciara. Em ambientes barulhentos, pressione Enter manualmente ou digite seu feedback.

Popup Arrastavel

Se o popup de feedback estiver cobrindo o elemento que voce quer ver, basta arrasta-lo. Clique e arraste a barra de alca no topo do popup para reposiciona-lo em qualquer lugar da tela.

Fluxo Inline

Voce pode completar todo o fluxo de captura-para-area-de-transferencia diretamente no popup sem abrir o painel lateral. Clique em um elemento, de seu feedback, e o prompt e copiado - tudo inline. O painel lateral continua disponivel quando voce precisar do historico, configuracoes ou mudancas de formato.

---

3. Formatos de Saida

Presets

O ClickSay oferece quatro presets de saida que controlam quanto detalhe e incluido no prompt gerado.

Simple (Free)

Um formato de linha unica, compativel com terminal. Inclui apenas a URL da pagina.

Exemplo:

For the url: https://myapp.com/dashboard About: Dashboard Overview Make this heading smaller and dark blue

Standard (Free)

Um formato markdown estruturado. Inclui a URL, seletor CSS e texto do elemento.

Detailed (Pro)

Markdown estruturado completo. Inclui URL, seletor, texto, HTML, estilos CSS calculados, caminho do arquivo e nome do componente.

Full (Pro)

Tudo o que o ClickSay captura. Inclui tudo do Detailed mais HTML do contexto pai, captura de tela e resultados de auditoria de acessibilidade.

Pills (Controles Individuais)

Cada dado capturado corresponde a um "pill" (botao de alternancia) no painel lateral. Voce pode ligar ou desligar campos de dados individuais para personalizar sua saida.

Como Personalizar a Saida

1. Abra o painel lateral clicando no icone do ClickSay.
2. Na secao Output Format, clique em um botao de preset para comecar com uma configuracao base.
3. Ative ou desative pills individuais para ajustar os dados incluidos.
4. Suas selecoes sao salvas automaticamente e persistem entre sessoes.

---

4. Painel Lateral

O painel lateral e a interface de controle principal do ClickSay. Abra-o clicando no icone do ClickSay na barra de ferramentas.

O Que Cada Coisa Faz (De Cima para Baixo)

Cabecalho

• Nome da marca ClickSay com selo do plano (PRO ou Free).
• Link Upgrade (visivel para usuarios Free) - abre a pagina de precos.
• Botao Capture - ativa o modo de feedback na aba atual.
• Botao Clear - remove todo o historico.

Secao de Formato de Saida

• Linha de presets: Quatro botoes - Simple, Standard, Detailed, Full. Detailed e Full mostram icones de cadeado para usuarios Free.
• Pills: Dez caixas de selecao para campos de dados individuais. Pills exclusivos de Pro (Screenshot, Component, A11y) mostram icones de cadeado para usuarios Free.

Secao de Relay

• Mostra se o servidor relay opcional do Claude Code esta conectado.
• Ponto verde = conectado. Ponto vermelho = nao detectado.
• O interruptor de envio automatico aparece quando o relay esta conectado.

Visualizacao de Captura

Apos capturar um elemento, esta secao mostra:

• Cartao do elemento: Nome da tag, seletor CSS e uma previa do texto do elemento.
• Cartao de captura de tela: A captura com destaque laranja no elemento (se uma captura foi feita).
• Cartao de feedback: Uma area de texto com seu feedback transcrito por voz ou digitado. Inclui um botao de microfone.
• Cartao de arquivo alvo: O caminho do arquivo auto-detectado ou inserido manualmente.
• Botao Copy to Clipboard com indicacao do atalho Cmd+Return.

Secao de Conta / Plano

• Mostra seu plano atual (Free ou Pro).
• Para usuarios Free: mostra contadores de uso de voz e capturas de tela (ex., "3/20 este mes").
• Link de Upgrade ou Manage.

Secao de Historico

• Itens do historico agrupados por data (Hoje, Ontem ou datas especificas).
• Cada item mostra o horario, tag do elemento, hostname da pagina e texto de feedback truncado.
• Clique em um item para recarrega-lo na visualizacao de captura.
• Cada item tem um botao de copiar (para re-copiar o prompt) e um botao de excluir.
• Acoes em lote: Botoes "Copy Selected" e "Select All" aparecem quando itens estao selecionados.

Gerenciamento de Armazenamento

• Storage used: Mostra quanto armazenamento local o ClickSay esta usando (ex., "2.3 MB").
• Auto-purge: Escolha por quanto tempo manter o historico - 7 dias, 30 dias, 60 dias, 90 dias ou Nunca. Usuarios Free estao limitados a 7 dias.
• Purge Images Now: Remove todas as capturas de tela armazenadas mantendo o historico de texto.

Exibicao da Versao

A versao atual da extensao e mostrada na parte inferior do painel lateral.

---

5. Configuracoes

Acessar a Pagina de Opcoes

Clique com o botao direito no icone do ClickSay na barra de ferramentas e selecione Options. Ou navegue ate a pagina de extensoes do Chrome, encontre o ClickSay e clique em "Detalhes" e depois "Opcoes da extensao."

Project Root

O diretorio base do seu projeto na sua maquina local. Por exemplo:

/Users/voce/projects/meu-app

Usado para resolver caminhos de arquivos na saida. Quando o ClickSay detecta um componente ou mapeia uma URL para um arquivo, o project root e adicionado como prefixo para criar um caminho completo.

URL-to-File Mapping

Regras baseadas em regex que mapeiam padroes de URL para caminhos de arquivos fonte. Util quando a deteccao automatica de framework nao encontra o arquivo correto.

O ClickSay inclui presets para configuracoes comuns:

• Static Site - mapeia URLs diretamente para caminhos de arquivos
• Next.js - mapeia rotas para a estrutura do diretorio app/
• SvelteKit - mapeia rotas para a estrutura src/routes/
• React (CRA) - mapeia para a estrutura do diretorio src/

Para adicionar uma regra personalizada:

1. Insira um padrao regex de URL (ex., /dashboard/(.*))
2. Insira o template do caminho do arquivo (ex., src/pages/dashboard/$1.tsx)
3. Clique em Save Settings

Chave de Licenca

Se voce comprou o ClickSay Pro:

1. Apos o pagamento, voce recebe uma chave de licenca por email.
2. Insira a chave no campo Pro License na pagina de Opcoes.
3. Clique em Validate.
4. Se valida, seu plano e atualizado imediatamente para Pro.

A chave de licenca tambem e enviada automaticamente para a extensao apos a compra pelo site do ClickSay - voce pode nao precisar inseri-la manualmente.

---

6. Free vs Pro

O Que Esta Incluido no Free

O Que Esta Incluido no Pro

Precos

• Free: $0
• Pro Mensal: $9/mes
• Pro Anual: $49/ano (55% de economia)

Como Fazer Upgrade

1. Clique no link Upgrade no cabecalho do painel lateral ou na secao de Conta.
2. Isso abre a pagina de precos em https://clicksay.net/#pricing.
3. Clique em Go Pro para iniciar o pagamento via Stripe.
4. Apos o pagamento, uma chave de licenca e gerada. Ela e enviada automaticamente para sua extensao.
5. Se a ativacao automatica nao funcionar, copie a chave do seu email e insira na pagina de Opcoes.

Limites de Uso e Redefinicoes

• Os contadores de voz e capturas de tela sao redefinidos no inicio de cada mes calendario.
• O uso e exibido na secao de Conta do painel lateral.
• Voce pode continuar capturando elementos e digitando feedback mesmo quando os limites de voz sao atingidos.

---

7. Atalhos de Teclado

Menu de Contexto

Clique com o botao direito em qualquer elemento de uma pagina web e selecione ClickSay this element para ativar o modo de captura para esse elemento.

Personalizar o Atalho

Se Cmd+Shift+K / Ctrl+Shift+K nao funciona ou entra em conflito com outra extensao:

1. Navegue ate chrome://extensions/shortcuts no seu navegador.
2. Encontre "ClickSay - AI Feedback Copilot."
3. Clique no icone de lapis ao lado de "Activate ClickSay feedback mode."
4. Grave seu atalho preferido.

---

8. Solucao de Problemas

O atalho de teclado nao funciona

Problema: Pressionar Cmd+Shift+K / Ctrl+Shift+K nao faz nada.

Solucao:

1. Va a chrome://extensions/shortcuts.
2. Encontre "ClickSay - AI Feedback Copilot."
3. Verifique se o atalho esta atribuido. Se mostrar "Not set," clique no icone de lapis e grave Cmd+Shift+K.
4. Se outra extensao usa o mesmo atalho, mude um deles.
5. Como alternativa, use o icone da barra de ferramentas ou o menu de contexto.

O microfone nao funciona

Problema: O microfone nao ativa, ou a voz nao e reconhecida.

Solucao:

1. Clique no icone de cadeado na barra de endereco do Chrome para o site atual.
2. Certifique-se de que "Microfone" esta definido como "Permitir."
3. No macOS, verifique Preferencias do Sistema > Privacidade e Seguranca > Microfone e certifique-se de que o Chrome esta permitido.
4. Certifique-se de que nenhum outro aplicativo esta usando o microfone.
5. Atualize a pagina apos conceder a permissao.

Nao e possivel capturar em uma pagina

Problema: O modo de captura ativa mas clicar em elementos nao faz nada, ou o modo de captura nao ativa.

Solucao:

1. O ClickSay nao funciona em paginas chrome://, na Chrome Web Store ou em outras URLs restritas do navegador. Tente um site normal.
2. Atualize a pagina e tente novamente.
3. Algumas paginas com politicas de seguranca de conteudo rigorosas podem bloquear a injecao de scripts.

O painel lateral nao abre

Problema: Clicar no icone do ClickSay nao faz nada.

Solucao:

1. Clique no icone de peca de quebra-cabeca na barra de ferramentas e fixe o ClickSay.
2. Entao clique no icone do ClickSay para abrir o painel lateral.
3. Se ainda nao funcionar, tente reiniciar o Chrome.

A saida nao e copiada para a area de transferencia

Problema: Voce pressionou Enter ou clicou em Copiar, mas nao ha nada na area de transferencia.

Solucao:

1. Tente pressionar Enter no popup da pagina (tem a maior taxa de sucesso).
2. Tente pressionar Cmd+Return no painel lateral com o painel em foco.
3. Certifique-se de que nenhuma outra extensao esta interceptando escritas na area de transferencia.

Limite de voz atingido

Problema: Voce ve uma mensagem de que seu limite de voz foi atingido.

Solucao:

1. O plano Free permite 20 feedbacks de voz por mes.
2. O uso e redefinido no inicio de cada mes calendario.
3. Voce ainda pode digitar seu feedback - apenas a voz e limitada.
4. Faca upgrade para Pro para voz ilimitada.

Limite de capturas de tela atingido

Problema: As capturas funcionam mas capturas de tela nao sao feitas.

Solucao:

1. O plano Free permite 5 capturas de tela por mes. Verifique a secao de Conta no painel lateral.
2. O uso e redefinido no inicio de cada mes calendario.
3. Faca upgrade para Pro para capturas de tela ilimitadas.

O popup esta cobrindo o elemento

Problema: O popup de feedback aparece em cima do elemento que voce quer ver.

Solucao: Arraste o popup para longe. Clique e arraste a barra de alca no topo do popup para reposiciona-lo em qualquer lugar da tela.

As teclas Enter ou Escape nao respondem

Problema: Pressionar Enter ou Escape no popup nao faz nada.

Solucao: Este era um problema conhecido na v1.0 onde modais da pagina podiam interceptar eventos do teclado. Atualize para v1.1.0 ou posterior para corrigir isto.

Os chips de sugestao nao aparecem

Problema: Nenhum chip de sugestao aparece no popup apos clicar em um elemento.

Solucao: Os chips sao contextuais e so aparecem para certos tipos de elementos (botoes, imagens, inputs, links, titulos, navegacao, listas, tabelas, containers flex/grid). Se voce clicou em um container generico como um <div> simples, os chips podem nao aparecer.

A copia automatica nao funciona

Problema: Voce parou de falar mas o prompt nao foi copiado automaticamente.

Solucao: A copia automatica e acionada apos 2 segundos de silencio. Se o ruido de fundo esta sendo captado como fala, o temporizador nao iniciara. Tente ir para um local mais silencioso ou digite seu feedback. Voce sempre pode pressionar Enter manualmente.

O nome do framework/componente nao aparece

Problema: O pill Component esta ativado mas nenhum nome de componente aparece.

Solucao:

1. Deteccao de componentes e uma funcionalidade Pro - certifique-se de que tem Pro.
2. Deteccao de framework funciona melhor em builds de desenvolvimento (localhost, modo dev). Builds de producao frequentemente removem dados de depuracao.
3. Se a deteccao falhar, use as regras de URL-to-File mapping na pagina de Opcoes.

O caminho do arquivo diz "Not configured"

Problema: O campo de caminho do arquivo mostra "Not configured" em vez de um arquivo fonte.

Solucao:

1. Abra a pagina de Opcoes (clique direito no icone do ClickSay > Options).
2. Configure o Project Root (ex., /Users/voce/projects/meu-app).
3. Adicione regras de mapeamento ou use um preset (Next.js, SvelteKit, React, Static Site).
4. Clique em Save Settings.

Relay nao detectado

Problema: O painel lateral mostra "Relay not detected" com um ponto vermelho.

Solucao:

1. O relay e opcional. Voce so precisa dele se quiser enviar prompts diretamente para o Claude Code.
2. Para iniciar o relay, abra um terminal e execute npx clicksay-relay.
3. O status atualiza em 30 segundos, ou feche e reabra o painel lateral.
4. Certifique-se de que nenhum firewall esta bloqueando a porta 19876 do localhost.

Em que versao estou?

Abra o painel lateral - o numero da versao e exibido na parte inferior.

---

9. Privacidade e Seguranca

Todos os Dados Ficam Locais

O ClickSay opera inteiramente dentro do seu navegador. Todo o processamento - captura de DOM, reconhecimento de voz, formatacao de prompts, captura de tela - acontece na sua maquina. Nao ha nenhum servidor do ClickSay processando seus dados.

O Que Fica no Seu Navegador

• Todos os dados de elementos capturados (seletores, HTML, estilos, etc.)
• Todo o texto de feedback de voz
• Todas as capturas de tela
• Historico de feedback
• Suas configuracoes (preferencias de saida, regras de mapeamento, preferencia de relay)

O Que Sai do Navegador

Os dados so saem do seu navegador nestas situacoes, todas iniciadas por voce:

1. Copia para a area de transferencia - Quando voce copia um prompt, ele vai para a area de transferencia do sistema.
2. Relay opcional - Se voce ativar o relay e ele estiver funcionando, os prompts sao enviados para 127.0.0.1:19876 (apenas localhost - nunca sai da sua maquina).
3. Validacao de licenca - Se voce tem uma chave Pro, a extensao a verifica em https://clicksay.net/api/license/validate. Esta solicitacao contem apenas a chave de licenca - nenhum feedback, captura de tela ou dado de usuario.

Sem Rastreamento

• Sem analiticas ou telemetria de qualquer tipo.
• Sem cookies ou scripts de rastreamento.
• Sem contas de usuario ou autenticacao (Pro usa uma chave de licenca, nao uma conta).
• A extensao nao sabe quem a instalou ou como e usada.

Permissoes Explicadas

Sem Permissoes de Host Amplas

O ClickSay usa a permissao activeTab, que so concede acesso a aba com a qual voce esta interagindo ativamente, e apenas quando voce aciona a extensao explicitamente. Os unicos sites onde o ClickSay executa um content script automaticamente sao clicksay.net e www.clicksay.net - isso e exclusivamente para receber sua chave de licenca apos a compra.

---

10. Perguntas Frequentes

Posso usar o ClickSay em qualquer site?

Sim. Desde a v1.1.0, o ClickSay funciona em qualquer URL - nao apenas no localhost. As unicas excecoes sao paginas internas do Chrome (chrome://), a Chrome Web Store e outras URLs restritas do navegador.

Preciso usar voz? Posso apenas digitar?

Sim, voce pode digitar seu feedback em vez de falar. Apos clicar em um elemento, simplesmente digite na area de texto do popup. Voce tambem pode combinar voz e digitacao - fale primeiro, depois edite ou adicione texto digitando.

Quais ferramentas de IA funcionam com o ClickSay?

O ClickSay copia um prompt estruturado para a area de transferencia. Voce pode cola-lo em qualquer ferramenta de IA que aceite texto: Claude Code, Codex, Cursor, Lovable, Replit, Bolt.new, ChatGPT, ou qualquer outro assistente de IA.

O ClickSay envia meus dados para um servidor?

Nao. Todo o processamento acontece no seu navegador. As unicas solicitacoes de rede sao validacao de chave de licenca (apenas usuarios Pro) e o relay local opcional (apenas localhost). Veja a secao Privacidade e Seguranca para detalhes completos.

Quais frameworks o ClickSay detecta?

React, Vue (2 e 3), Angular, Svelte, Next.js e SvelteKit. A deteccao funciona melhor em builds de desenvolvimento. Builds de producao podem remover os dados de depuracao que o ClickSay usa para deteccao.

Posso capturar multiplos elementos de uma vez?

Sim, usando o Modo Sweep (apenas Pro). Mantenha Shift pressionado e clique em cada elemento que deseja incluir, depois solte Shift e clique no ultimo elemento. Fale seu feedback uma vez e ele se aplica a todos os elementos selecionados.

O que acontece quando os limites do plano Free sao redefinidos?

Os contadores de voz e capturas de tela sao redefinidos no inicio de cada mes calendario. Voce nao precisa fazer nada - os contadores sao redefinidos automaticamente.

Posso re-copiar uma captura anterior?

Sim. Abra o painel lateral e encontre a captura no seu historico. Clique no botao de copiar (icone de area de transferencia) no item do historico para re-copiar seu prompt. O prompt e regenerado com suas configuracoes atuais de pills.

Como cancelo uma captura no meio?

Pressione Escape a qualquer momento durante o modo de captura para cancelar. Isso fecha o popup e desativa o modo de captura.

O que e a funcionalidade relay?

O relay e um servidor local opcional que permite enviar prompts diretamente para o Claude Code executando em um terminal, em vez de usar a area de transferencia. Inicie-o com npx clicksay-relay. Ele roda inteiramente na sua maquina (localhost).

Como verifico atualizacoes da extensao?

O Chrome atualiza extensoes automaticamente. Voce tambem pode ir a chrome://extensions, ativar "Modo de desenvolvedor" e clicar em "Atualizar" para verificar manualmente. Verifique o numero da versao na parte inferior do painel lateral.

Onde posso obter mais ajuda?

• Visite https://clicksay.net para as informacoes mais recentes
• Use o widget de chat no clicksay.net para suporte ao vivo
• Confira a secao What's New em https://clicksay.net/#changelog para notas de versao

---

Este guia cobre o ClickSay v1.1.0. Para as ultimas atualizacoes, visite https://clicksay.net.