# SpotAsk Documentation

> SpotAsk is a native macOS menu-bar AI assistant for quick questions and actions on selected text. These links provide the official user documentation as clean Markdown.

Use the English or Simplified Chinese section that matches the user. Start with Getting Started, then fetch only the guide needed for the current question. The complete combined corpus is available in [llms-full.txt](https://shiquda.github.io/SpotAsk/llms-full.txt).

## English documentation

- [Explore SpotAsk](https://shiquda.github.io/SpotAsk/markdown/explore.md): A capability map for the questions, selection, model, attachment, prompt, shortcut, and system workflows in SpotAsk.
- [Getting Started](https://shiquda.github.io/SpotAsk/markdown/getting-started.md): Install SpotAsk, connect an AI service, and ask your first question.
- [Appearance & Behavior](https://shiquda.github.io/SpotAsk/markdown/guides/appearance.md): Change appearance, reading size, language, launch behavior, conversation retention, and local data options.
- [Images & Files](https://shiquda.github.io/SpotAsk/markdown/guides/attachments.md): Attach images, screenshots, text, and code files to a SpotAsk conversation.
- [Connect Anthropic](https://shiquda.github.io/SpotAsk/markdown/guides/connect-anthropic.md): Add Anthropic as a SpotAsk service and verify the connection.
- [Connect an OpenAI-Compatible Service](https://shiquda.github.io/SpotAsk/markdown/guides/connect-openai-compatible.md): Add an OpenAI-compatible provider, choose an address mode, save the access key, and add a model.
- [Spotlight, Siri & Shortcuts](https://shiquda.github.io/SpotAsk/markdown/guides/macos-integration.md): Use SpotAsk actions from Spotlight, Siri, and the Shortcuts app.
- [Prompts](https://shiquda.github.io/SpotAsk/markdown/guides/prompts.md): Use built-in prompts, create custom prompts, and set custom instructions for repeated workflows.
- [Providers & Models](https://shiquda.github.io/SpotAsk/markdown/guides/providers-and-models.md): Manage AI services and models, refresh model lists, and switch models for the current conversation.
- [Proxy](https://shiquda.github.io/SpotAsk/markdown/guides/proxy.md): Configure an HTTP or SOCKS5 proxy for SpotAsk requests and model updates.
- [Selection Assistant](https://shiquda.github.io/SpotAsk/markdown/guides/selection-assistant.md): Use SpotAsk on selected text in other apps with quick actions, direct mode, app scope, and automatic display.
- [Service Root vs Full Request Address](https://shiquda.github.io/SpotAsk/markdown/guides/service-addresses.md): Understand the two SpotAsk address modes and when to use each one.
- [SpotAsk Documentation](https://shiquda.github.io/SpotAsk/markdown/index.md): SpotAsk user manual, setup guides, feature documentation, and troubleshooting.
- [Privacy & Local Data](https://shiquda.github.io/SpotAsk/markdown/privacy.md): Where SpotAsk stores access keys, conversations, settings, and diagnostics data.
- [Settings & Shortcuts Reference](https://shiquda.github.io/SpotAsk/markdown/reference.md): A compact reference for SpotAsk settings sections, default shortcuts, and supported file types.
- [Troubleshooting](https://shiquda.github.io/SpotAsk/markdown/troubleshooting.md): Common SpotAsk connection, model, selection, permission, and shortcut problems and their fixes.

## 简体中文文档

- [探索 SpotAsk](https://shiquda.github.io/SpotAsk/markdown/zh-CN/explore.md): SpotAsk 的能力地图：提问、划词、模型、附件、提示词、快捷键和系统联动。
- [快速开始](https://shiquda.github.io/SpotAsk/markdown/zh-CN/getting-started.md): 安装 SpotAsk、连接 AI 服务并完成第一次提问。
- [外观与行为](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/appearance.md): 调整外观、阅读尺寸、语言、启动行为、对话保留和本地数据选项。
- [图片与文件](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/attachments.md): 在 SpotAsk 对话中附加图片、截图、文本和代码文件。
- [连接 Anthropic](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/connect-anthropic.md): 将 Anthropic 添加为 SpotAsk 服务并验证连接。
- [连接 OpenAI 兼容服务](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/connect-openai-compatible.md): 添加 OpenAI 兼容服务，选择地址类型，保存访问密钥并添加模型。
- [Spotlight、Siri 与快捷指令](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/macos-integration.md): 通过 Spotlight、Siri 和快捷指令使用 SpotAsk 操作。
- [提示词](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/prompts.md): 使用内置提示词、创建自定义提示词，并为重复工作设置自定义指令。
- [服务与模型](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/providers-and-models.md): 管理 AI 服务和模型、刷新模型列表，以及切换当前对话使用的模型。
- [代理](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/proxy.md): 为 SpotAsk 请求和模型更新配置 HTTP 或 SOCKS5 代理。
- [划词助手](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/selection-assistant.md): 在其他应用中使用 SpotAsk 处理选中文字，包括快捷操作、直接模式、应用范围和自动显示。
- [服务根地址与完整请求地址](https://shiquda.github.io/SpotAsk/markdown/zh-CN/guides/service-addresses.md): 理解 SpotAsk 的两种地址类型，以及什么时候使用哪一种。
- [SpotAsk 文档](https://shiquda.github.io/SpotAsk/markdown/zh-CN/index.md): SpotAsk 用户手册、配置指南、功能说明与故障排查。
- [隐私与本地数据](https://shiquda.github.io/SpotAsk/markdown/zh-CN/privacy.md): SpotAsk 的访问密钥、对话、设置和诊断数据保存在哪里。
- [设置与快捷键参考](https://shiquda.github.io/SpotAsk/markdown/zh-CN/reference.md): SpotAsk 设置分区、默认快捷键和受支持附件类型的速查表。
- [故障排查](https://shiquda.github.io/SpotAsk/markdown/zh-CN/troubleshooting.md): SpotAsk 连接、模型、划词、权限和快捷键的常见问题及处理方法。

## Optional

- [GitHub repository](https://github.com/shiquda/SpotAsk): Source code, releases, issue tracking, and contribution history.
- [Latest release](https://github.com/shiquda/SpotAsk/releases/latest): Current downloadable macOS packages.