常见问题
安装与启动
Q: 首次运行被 Windows SmartScreen 拦截?
正常现象。AgileShot 暂未购买商业代码签名证书。点 "更多信息" → "仍要运行" 即可。后续不会再提示。
如果你不放心,可以从源码构建(见 安装指南)。
Q: 装上以后右下角没出现托盘图标?
托盘图标可能被 Windows 隐藏。点击任务栏右下角的 ^ 展开折叠托盘,把 AgileShot 拖出来。或在 设置 → 通知和操作 → 选择哪些图标显示在任务栏上 里固定显示。
Q: 想绿色便携使用,不写注册表?
下载 便携版 zip(AgileShot-Portable-x.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 调用失败 连接超时?
可能原因:
- 网络无法访问 Anthropic / OpenAI(需配代理或换国内兼容服务商)
- 公司防火墙拦截
- 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 里看不到工具?
检查:
- 配置文件路径对不对(
%APPDATA%\Claude\claude_desktop_config.json) - JSON 语法是否合法
- agileshot.exe 路径是否绝对路径 + 可执行
- 完全退出 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 / Linux 在 V2.0 路线图,框架层已抽象好,主要是平台特性(截屏 API / 全局热键)适配。
Q: 开源吗?能用于商用吗?
MIT 协议,完全开源,免费商用。源码在 GitHub / GitCode。
Q: 怎么反馈 bug / 提需求?
- GitHub Issues: https://github.com/bkywksj/AgileShot/issues
- 任何反馈都欢迎,即使是"觉得这个按钮配色丑"也欢迎
Q: 在哪里看到完整路线图?
见 更新日志 和仓库的 CHANGELOG.md。