下载与安装

想直接下载?

本页是完整的装机指南(从下载到首次启动的每一步)。 如果你只想看一眼最新版本号 + 一键下载,请去 下载页。

平台限制

AgileMedic 仅支持 Windows 10 / 11 x64。核心功能依赖 Windows 专有 API(Restart Manager / PDH / WMI / ETW),不提供 macOS / Linux 版本(属路线图)。请勿在虚拟机的非 Windows 环境或 32 位系统上尝试运行。

下载

最新版下载链接和系统要求请看 下载页。下面是安装包格式总览:

平台	安装包	适合谁
Windows 10 / 11 x64	AgileMedic-Setup-v{ver}.exe	推荐 —— NSIS 安装包,带卸载程序,写开始菜单项
Windows 10 / 11 x64	AgileMedic-portable-v{ver}.zip	便携版,解压即用,不写注册表,适合 U 盘 / 沙盒

{ver} 是具体版本号,例如 AgileMedic-Setup-v0.5.0.exe。以 下载页 显示的最新版为准。

下载源:

• 主源: Cloudflare R2 CDN(全球加速,在 下载页 自动调用)

安装

方式一:NSIS 安装包(推荐)

1. 下载 AgileMedic-Setup-v{ver}.exe
2. 双击运行,按向导一路下一步
3. 安装完成后从开始菜单或桌面快捷方式启动 AgileMedic

Windows SmartScreen 拦截

首次运行可能弹出 "Windows 已保护你的电脑"。这是因为安装包未购买商业代码签名证书,并非软件本身有问题。 点 "更多信息" → "仍要运行" 即可。后续启动不再提示。

方式二:便携版

1. 下载 AgileMedic-portable-v{ver}.zip
2. 解压到任意目录(如 D:\Tools\AgileMedic\)
3. 双击 agile-medic.exe 启动

便携版不写注册表 / 不创建开始菜单项,适合不想污染系统或需要放在 U 盘随身携带的场景。

两个可执行文件

解压后你会看到两个 exe:agile-medic.exe 是主程序;agilemedic-mcp.exe 是给 AI 编辑器用的反向 MCP sidecar(独立进程)。日常使用只需运行 agile-medic.exe,MCP sidecar 会在你配置 MCP 接入 时由 AI 客户端按需拉起。

按需 UAC 提权

AgileMedic 不是启动就要管理员权限。它以普通用户权限启动,只在需要高权限的操作时,才临时弹一次 UAC 提权对话框。

需要提权的典型场景:

操作	为什么需要
强制结束高权限进程	终止以管理员 / 系统身份运行的进程需要更高权限
修改系统服务(启动 / 停止 / 启用 / 禁用)	服务控制受系统保护
清理系统目录下的文件	C:\Windows 等受保护路径的写入需要管理员
重启后删除文件(MoveFileEx)	标记文件在下次重启删除需要管理员权限

为什么这样设计

一直用管理员权限跑一个常驻托盘程序是不必要的风险面。AgileMedic 遵循最小权限原则:平时普通权限就够用,只在你确实要做危险动作时才提权,让你清楚地知道"这一步真的需要管理员"。

如果某个高权限操作提示失败,可以右键 agile-medic.exe → 以管理员身份运行,再重试该操作。

首次启动

启动后会自动:

1. 打开主窗口,默认停在文件解锁面板
2. 注册全局热键 —— Ctrl+Alt+U 随时唤回主窗口(见 快捷键速查表)
3. 在系统托盘添加图标 —— 右键查看菜单,双击唤回窗口
4. 后台建立系统采样基线(状态栏会显示 CPU / RAM / IO / NET 实时数值)

关闭窗口 ≠ 退出程序

点窗口右上角的 × 默认是最小化到系统托盘,程序继续在后台运行(全局热键仍然有效)。想彻底退出,请右键托盘图标 → 退出。

AI 是可选增强。不配置 API Key 也能用全部本地功能;想开启 AI 诊断,去 配置 API Key。

数据目录

AgileMedic 的配置和日志统一存放在:

%APPDATA%\AgileMedic\

其中:

• logs\operations.log —— 文件解锁等操作的历史日志(文本)
• AI 配置文件 —— 含经 DPAPI 加密的 API Key,仅绑定当前 Windows 用户帐号,明文永不落盘(详见 配置 API Key)
• 界面主题、监控频率、告警上限等应用设置存在注册表 HKCU\Software\AgileMedic(不在本目录)

自动更新

AgileMedic 内置轻量的更新检查:

• 启动后会在后台静默检查一次是否有新版本(带节流,不会频繁打服务器)
• 有更新时,主窗口右上角的版本胶囊会以转圈 / 进度 / 呼吸动画提示状态
• 你可以据提示下载并安装新版本

便携版更新

便携版不带内建的自动替换机制。收到更新提示后,从 下载页 下载新版 zip 覆盖解压即可,你的数据(在 %APPDATA%\AgileMedic\)不受影响。

卸载

NSIS 安装包

通过 控制面板 → 程序和功能 → AgileMedic → 卸载,或运行安装目录下的卸载程序。

卸载程序会删除程序文件和开始菜单项,但不会删除你的数据(日志 / AI 配置)。如需彻底清理,手动删除 %APPDATA%\AgileMedic\,并用 regedit 删除注册表项 HKCU\Software\AgileMedic(含加密的 API Key)。

便携版

直接删除解压目录即可。数据仍在 %APPDATA%\AgileMedic\,如需彻底清理请一并手动删除该目录。

系统要求

项	最低	推荐
操作系统	Windows 10 x64(1809+)	Windows 11 x64
CPU	x64 双核	x64 四核+
内存	2 GB	4 GB+
磁盘	200 MB	500 MB+
权限	普通用户(高权限操作按需 UAC 提权)	同左

不支持 32 位 / ARM

AgileMedic 只提供 x64 版本,不支持 32 位 Windows,也未提供 Windows on ARM 原生版本。

下一步

• 第一次解锁文件 —— 5 分钟跑通核心流程
• 快捷键速查表 —— 全局热键 + 常用操作
• 配置 AI —— 开启 AI 诊断(可选)