常见问题

安装与启动

Q: 首次运行被 Windows SmartScreen 拦截?

正常现象。AgileShot 暂未购买商业代码签名证书。点 "更多信息" → "仍要运行" 即可。后续不会再提示。

Q: 装上以后右下角没出现托盘图标?

托盘图标可能被 Windows 隐藏。点击任务栏右下角的 ^ 展开折叠托盘,把 AgileShot 拖出来。或在 设置 → 通知和操作 → 选择哪些图标显示在任务栏上 里固定显示。

Q: 想绿色便携使用,不写注册表?

下载 便携版 zip(AgileShot-portable-vx.x.x.zip),解压到任意目录运行。配置和数据都生成在程序同目录的 data/ 下,删除整个目录即彻底卸载。

截图与标注

Q: 全局热键 F6 不响应?

最常见的原因是其他程序占用了 F6。比如:

• IDE / 编辑器(如 PyCharm 把 F6 绑给重命名)
• 输入法工具栏
• 某些游戏 / 直播软件

解决方案: 设置 → 快捷键 改成不冲突的组合。注意别选 Ctrl+Alt+A —— 那个正是被微信占用的组合,换过去照样抢不到。

Q: 多屏的时候选区跑偏?

如果你的多个显示器有不同的 DPI 缩放(主屏 100% / 副屏 125%),早期版本可能错位。 请确保升级到 V1.1 以上,已彻底重写为 widget-local 单坐标系,任意 DPI 组合都对齐。

Q: 截图很慢,有 200ms+ 延迟?

确认:

• 显卡驱动是否最新
• 是否启用了第三方截图工具(如 ShareX / PicPick 同时跑,会冲突)
• 是否在远程桌面 / 虚拟机里运行(D3D11 截屏无法用,会 fallback 到 BitBlt 较慢)

Q: 标注画到一半想换工具怎么办?

直接按工具的快捷键(R 矩形 / A 箭头 / T 文字 / ...),或点工具栏图标。之前画的内容不会丢失,撤销栈保留所有操作。

AI 智能标注

Q: 一定要配 AI Key 吗?

不。不配 AI 完全可以正常使用截图 / 标注 / 钉图 / 历史。AI 是可选增强,只在你点 ✨ 按钮时调用。

Q: AI 调用失败 连接超时?

可能原因:

1. 网络无法访问 Anthropic / OpenAI(需配代理或换国内兼容服务商)
2. 公司防火墙拦截
3. API Key 所在地区不可用

解决: 在 设置 → 网络 配代理,或在 设置 → AI 切到国内兼容服务商(如 DeepSeek / 智谱 / 通义千问的 OpenAI 兼容端点)。

Q: AI 能不能用本地模型 (Ollama / LM Studio)?

可以,只要本地服务暴露 OpenAI 兼容端点。在 设置 → AI 选 "自定义",填本地 URL(如 http://localhost:11434/v1),模型名填本地模型名(如 llava:13b)。

注意:本地视觉模型质量参差,OCR 效果可能不如云端模型。

Q: AI 会把我截图发送到哪里?

发到你配置的服务商,仅此一处。AgileShot 不收集 / 转发 / 上传任何截图或 Key,所有调用都是直连。 详见 配置 AI 隐私说明。

MCP Server

Q: MCP Server 启用后会泄露屏幕吗?

只有已经接入的 AI 客户端才能调用。AgileShot 不主动外推。 但请注意: 一旦接入 Claude Desktop,Claude 可以在任何时刻自主截屏(不需要你点确认)。所以:

• 只接入你信任的客户端
• 敏感操作时托盘菜单 → MCP Server → 停止

Q: 同时开着 GUI 和 MCP 会冲突吗?

不会。两个进程共享 SQLite 历史库,AI 截的图你在历史面板里也能看到,反之亦然。

Q: 在 Claude Desktop 里看不到工具?

检查:

1. 配置文件路径对不对(%APPDATA%\Claude\claude_desktop_config.json)
2. JSON 语法是否合法
3. agile-shot.exe 路径是否绝对路径 + 可执行
4. 完全退出 Claude Desktop 后重启(不是关窗口,要在托盘退出)

详见 接入 Claude Desktop 故障排查。

数据与隐私

Q: 历史截图存哪?能搬到别的电脑吗?

存在 SQLite 数据库:

• 安装版: %APPDATA%\AgileShot\history.db
• 便携版: <解压目录>\data\history.db

直接复制 .db 文件到新电脑同样路径即可迁移。

Q: 怎么彻底清理 AgileShot 数据?

卸载后手动删:

• %APPDATA%\AgileShot\ (历史 + 配置)
• %LOCALAPPDATA%\AgileShot\ (缓存)
• Windows 凭据管理器里搜 "AgileShot",删凭据(API Key)

便携版只需删除解压目录。

Q: 截图会上传到云吗?

默认完全本地。除非:

• 你主动调用 AI 功能(发给你配的 AI 服务商)
• 你在 V2.1+ 启用 "图床上传" 功能(明确 opt-in)
• 你启用 Sentry 崩溃上报(只发崩溃堆栈,不发截图)

其他

Q: 支持 macOS / Linux 吗?

Windows 10 / 11 x64 是主力平台(安装版 + 便携版)。macOS Apple Silicon 已有 beta 版 (arm64 .dmg,实验性 —— 首用需在系统设置授予屏幕录制 / 辅助功能权限,DMG 未签名请右键 → 打开); Linux x86_64 在 v1.2.0 提供过 .tar.gz,最新版未随版发布;Intel Mac 仍在路线图上。 框架层已抽象好,主要是平台特性(截屏 API / 全局热键)适配。

Q: 可以商用吗?

免费,可商用。

Q: 怎么反馈 bug / 提需求?

• 应用内「设置 → 关于」查看联系方式
• 任何反馈都欢迎,即使是"觉得这个按钮配色丑"也欢迎

Q: 在哪里看到完整路线图?

见 更新日志 和仓库的 CHANGELOG.md。