深色模式
通用设置
AgileMedic 的设置内嵌在主窗口内容区,不是弹出的模态对话框。点侧栏底部的「设置」、右上角浮动齿轮 ⚙,或按 Ctrl+,,都会切到设置页面。
修改即时生效,没有"保存"按钮
设置页借鉴 reeve 的分区卡片风格,采用 live-apply(即改即生效):每个控件一改动就立刻写回,不存在 OK / Cancel / Apply 三连。切换到别的面板就等价于"关闭设置"。
设置页当前分为四个分区:实时监控、异常告警、AI 配置、外观。下面按分区说明。
实时监控
对应 实时监控 面板的运行时参数。
| 设置项 | 范围 / 默认 | 说明 |
|---|---|---|
| 采样间隔 | 500 – 5000 ms,默认 1000 ms | PDH 性能计数器的周期采样间隔。调小更灵敏但更占 CPU,调大更省电。修改立即生效。 |
| CPU 阈值告警 | 0 或 50 – 100 %,默认 80 % | CPU 占用达到该百分比时,托盘弹系统通知。设为 0 = 关闭。同一指标有 60 秒冷却,不会连环轰炸。 |
| 内存阈值告警 | 0 或 50 – 100 %,默认 90 % | 内存占用达到该百分比时托盘弹通知。设为 0 = 关闭。小于 50% 的阈值没有意义,会被自动归 0。 |
阈值告警靠托盘通知
阈值触发时是通过系统托盘气泡提示的。如果你把主窗口关掉(最小化到托盘)让 AgileMedic 后台跑,阈值告警依然有效。托盘行为见下方「托盘与后台运行」。
异常告警
| 设置项 | 范围 / 默认 | 说明 |
|---|---|---|
| 保留事件数 | 100 – 10000 条,默认 1000 条 | 内存中保留的最近告警事件数量(环形缓冲)。下次启动 AgileMedic 后才生效,不是即时生效。 |
这一项要重启才生效
「保留事件数」影响的是启动时分配的环形缓冲区大小,改完需要重启 AgileMedic 才应用。其余各项都是即时生效的。
AI 配置
这里只展示当前使用中的 AI 配置摘要,真正的编辑在独立对话框里。
摘要卡显示:
- 状态徽章 — 绿色「● 已配置」或灰色「○ 未配置」
- 提供商 — Anthropic (Claude) 或 OpenAI 兼容
- 模型 — 当前使用的模型名
- 端点 — 生效的 API Base URL(可选中复制)
- 密钥 — 只显示状态(「已配置 · DPAPI 加密」或「尚未设置」),永不回显明文
点「打开 AI 配置...」按钮进入独立对话框,在那里管理提供商 / API Key / 模型。保存后上方摘要会即时刷新。详细步骤见 AI 接入。
API Key 加密存储
API Key 经 Windows DPAPI 加密(绑定当前用户账号)后存入 AppData,内存中的明文也不会显示到界面上。数据流向与隐私细节见 隐私与数据。
外观
| 设置项 | 选项 | 说明 |
|---|---|---|
| 主题模式 | 亮色 / 暗色 / 跟随系统 | 默认亮色。切换立即生效,全局暗色化已实现(侧栏 / 业务面板 / 菜单 / tooltip 全部跟随)。 |
切主题会重载面板
主题切换是即时生效的,但当前面板会重载,搜索框内容、表格选中等临时状态会被重置。这是设计上的取舍,不是 bug。主题细节见 主题与语言。
托盘与后台运行
AgileMedic 的后台运行体验由系统托盘承载,这部分行为是内置约定,不在设置页里提供开关:
| 行为 | 说明 |
|---|---|
| 点窗口 × 按钮 | 不退出进程,而是最小化到系统托盘继续后台运行。首次会弹一次「AgileMedic 已最小化到托盘」气泡提示,之后静默。 |
| 双击托盘图标 | 快速唤回主窗口。 |
| 托盘右键菜单 | 提供「显示主窗口」和「退出 AgileMedic」两项。只有点「退出」才是真正退出进程。 |
全局热键 Ctrl+Alt+U | 任意位置一键显示 / 唤回主窗口(与托盘双击复用同一动作)。 |
想彻底退出,请走托盘菜单
点 × 只是最小化到托盘。要真正结束进程,请右键托盘图标 → 退出 AgileMedic,或在命令面板里执行退出。
完整快捷键说明见 快捷键。
自动更新
AgileMedic 的更新入口是右上角的版本胶囊(UpdateBadge),不是设置页里的一个开关。
- 启动约 5 秒后自动做一次静默检查,并有 24 小时节流(一天内只自动查一次)。
- 点击版本胶囊可手动检查,手动检查不节流。
- 更新元数据(
update.json)托管在 Cloudflare R2 公开桶,匿名读取即可,不携带任何身份信息。 - 有新版本时胶囊会变色 / 转圈 / 呼吸,点击可后台下载并在确认后重启安装(Windows 用 NSIS 静默安装,装完自动拉起新版本)。
更新检查只读一个公开清单
更新检查只是匿名 GET 一个公开的 update.json,AgileMedic 不会因此上传你的任何信息。这与"隐私优先"是一致的,详见 隐私与数据。
按需 UAC 提权
AgileMedic 不是一启动就要管理员权限,而是按需提权:只有当某个操作确实需要更高权限时(例如禁用 HKLM 下的开机启动项、操作系统级服务)才会触发 Windows UAC 提示。
如果某个写操作因权限不足失败,AgileMedic 会给出「请以管理员身份运行 AgileMedic 后重试」之类的友好提示,而不是静默失败。
这不是一个可切换的设置
按需提权是内置行为,不需要也没有对应的开关。日常只读的监控 / 扫描不需要管理员权限。