常见问题

安装与启动

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

正常现象。AgileMedic 暂未购买商业代码签名证书(EV 签名在路线图中)。点 "更多信息" → "仍要运行" 即可。后续不会再提示。

Q: 为什么杀软报告 AgileMedic?

系统工具会调用 Restart Manager、结束进程、读写系统目录等敏感 API,无签名的新程序容易被启发式引擎误报。AgileMedic 开源、不自建病毒库、不做任何隐蔽行为。你可以:

• 在杀软里把 AgileMedic 加白名单
• 用 VirusTotal 自行扫描安装包核对
• 等待后续 EV 签名 + 信誉积累消除误报

Q: 一定要管理员权限吗?

不是启动就要。 AgileMedic 采用按需提权:日常查看监控、扫描大文件等只读操作用普通权限即可。只有执行高权限操作(强制结束受保护进程、改动 Windows 服务、清理系统目录残留)时才弹一次 UAC。

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

下载 便携版 zip(AgileMedic-portable-vx.x.x.zip),解压到任意目录运行。删除整个目录即彻底移除。注意:便携版仍需在执行提权操作时弹 UAC(这是 Windows 机制,与是否便携无关)。

文件解锁

Q: 解锁时"温和关闭"和"强制结束"有什么区别?

• 温和关闭句柄 — 调用 Restart Manager 的 RmShutdown,请求占用程序优雅地释放文件(相当于礼貌地请它松手),数据不易丢失,推荐优先用。
• 强制结束进程 — 直接 TerminateProcess,立即杀掉占用进程,可能丢失未保存数据,仅在温和方式无效时使用。
• 重启后删除 — 用 MoveFileEx(MOVEFILE_DELAY_UNTIL_REBOOT),把删除动作排到下次开机、文件还没被锁定时执行,适合系统级顽固占用。

详见 文件解锁。

Q: 有些进程解锁失败,提示权限不足?

被 系统 / 其他用户 / 受保护进程 占用时,需要管理员权限才能操作。AgileMedic 会提示提权,同意后以管理员身份重试。个别 Windows 核心进程(如正在使用中的系统 DLL)无法在运行时解锁,只能用"重启后删除"。

监控与进程

Q: 监控数据准吗?会不会自己就很吃资源?

监控基于 Windows 原生 PDH(性能计数器),与任务管理器同源,数据一致。AgileMedic 本身轻量常驻,采样间隔可调,不会明显占用资源。

Q: 能不能像 360 那样"一键加速"?

不能,这是我们的红线。 详见 反 placebo 红线。我们会告诉你哪个进程吃了多少资源、建议怎么处理,但不会给你一个假的"已加速"按钮。要不要关某个程序,由你决定。

AI 功能

Q: 一定要配 AI Key 吗?

不。不配 AI 完全可以正常使用文件解锁 / 监控 / 进程管理 / 大文件扫描等所有本地功能。AI 是可选增强,只在你点"AI 解释 / AI 诊断"时才调用。

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

可以,只要本地服务暴露 OpenAI 兼容端点。在 设置 → AI 选"自定义",填本地 URL(如 http://localhost:11434/v1)和模型名。好处是数据不出本机。

Q: AI 会把我的系统信息发到哪里?

只发到你自己配置的 AI 服务商,仅此一处。AgileMedic 不收集 / 不转发 / 不上传任何数据,所有调用都是直连你配的端点。API Key 经 Windows DPAPI 加密后存于 %APPDATA%\AgileMedic\ 下的 AI 配置中(绑定当前用户账户,明文永不落盘)。详见 隐私与数据。

MCP Server

Q: 反向 MCP 是什么意思?

普通 MCP 是"让 AI 用某个工具"。AgileMedic 的反向 MCP 是把你的电脑状态做成工具暴露给 AI —— 接入后,Claude Desktop / Cursor 可以直接调用 list_processes / get_system_metrics 等工具读取你的电脑信息,自己诊断。详见 什么是 MCP。

Q: 接入 MCP 后 AI 能对我电脑做什么?

默认只读。读取类工具(查进程 / 查资源 / 查启动项)可直接调用;任何写操作 / 危险操作(结束进程、清理文件)都走本机 consent(确认)机制,需要你在界面上批准,AI 不能背着你动手。详见 工具参考。

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

检查:

1. 配置文件路径对不对(%APPDATA%\Claude\claude_desktop_config.json)
2. JSON 语法是否合法
3. agilemedic-mcp.exe 路径是否为绝对路径且存在(它是随安装包附带的独立 sidecar)
4. 完全退出 Claude Desktop 后重启(在托盘退出,不是关窗口)

详见 接入 Claude Desktop 故障排查。

数据与隐私

Q: 配置和日志存哪?

• 应用设置: 注册表 HKCU\Software\AgileMedic(QSettings 原生格式)
• 操作日志: %APPDATA%\AgileMedic\logs\operations.log
• AI 配置 + API Key: %APPDATA%\AgileMedic\ 下的配置文件(API Key 经 DPAPI 加密)

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

卸载后手动删:

• %APPDATA%\AgileMedic\(日志 + AI 配置,含加密的 API Key)
• 注册表 HKCU\Software\AgileMedic(用 regedit 删除该项,或直接忽略,卸载不留后台进程)

便携版数据在程序同目录,删除解压目录即可。

其他

Q: 支持 macOS / Linux 吗?

当前仅 Windows 10 / 11 x64。核心能力(文件解锁 / 监控 / 进程管理)直接依赖 Win32 API(Restart Manager / PDH / WMI / ETW),跨平台需重写整个平台层,属远期方向。

Q: 可以商用吗?

免费,MIT 协议,可商用。

Q: 和 AgileShot 是什么关系?

同门。两者都基于自研 Agile-Qt(Qt 6 + C++20)框架,由抓蛙师开发。AgileShot 做截图标注,AgileMedic 做系统工具。见 更多产品。

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

应用内「设置 → 关于」查看联系方式。任何反馈都欢迎。