Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions crates/argus-core/src/startup.rs
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,13 @@

mod packaged;

use std::path::Path;
use std::{io::ErrorKind, os::windows::fs::OpenOptionsExt, path::Path};

use serde::Serialize;
use windows::Win32::Foundation::{
ERROR_FILE_NOT_FOUND, ERROR_SUCCESS, FILETIME, MAX_PATH, WIN32_ERROR,
};
use windows::Win32::Storage::FileSystem::{DELETE, FILE_FLAG_OPEN_REPARSE_POINT};
use windows::Win32::System::Com::{
CLSCTX_INPROC_SERVER, COINIT_MULTITHREADED, CoCreateInstance, CoInitializeEx, IPersistFile,
STGM_READ,
Expand Down Expand Up @@ -508,6 +509,20 @@ fn remove_file(folder: &Path, name: &str, recycle: bool) -> Result<(), ActionErr
if !path.is_file() {
return Err(ActionError::NotFound);
}
// Check the caller's delete access on the directory entry itself before
// handing it to the Shell. Release the handle before the recycle operation.
if let Err(error) = std::fs::File::options()
.access_mode(DELETE.0)
.custom_flags(FILE_FLAG_OPEN_REPARSE_POINT.0)
.open(&path)
{
crate::diagnostics::file_failure("startup open for deletion", &path, &error);
return Err(match error.kind() {
ErrorKind::PermissionDenied => ActionError::AccessDenied,
ErrorKind::NotFound => ActionError::NotFound,
_ => ActionError::Os(error.to_string()),
});
}
// The paths, each ended by a NUL, and the list by another.
let mut from = wide(&path.to_string_lossy());
from.push(0);
Expand Down Expand Up @@ -727,10 +742,11 @@ mod tests {
.expect("icacls");
assert!(status.success());
}
assert!(matches!(
remove_file(&folder.0, "Locked.lnk", true),
Err(ActionError::AccessDenied)
));
let result = remove_file(&folder.0, "Locked.lnk", true);
assert!(
matches!(result, Err(ActionError::AccessDenied)),
"{result:?}"
);
assert!(folder.0.join("Locked.lnk").exists());
}

Expand Down
2 changes: 1 addition & 1 deletion docs/architecture/frontend.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

`process_icons` 按当前快照保留程序及 WebView2 宿主的图标,表格、详情窗格和规则界面共用同一份图像。快照替换后,过期图标同时从 GPUI 解码缓存和窗口纹理图集中移除,GPU 页面可随之回收;暂停时继续持有原快照的 PNG。

界面偏好在内存中立即生效,由后台线程写入磁盘,退出前完成写入。`tableSort.<表>` 保存各表排序,`tableWidths.<表>` 保存服务表与启动项表中拖动过的列宽,`services.filter` 和 `connections.filter` 分别保存服务与连接按状态的筛选条件,`connections.protocolFilter` 保存连接按协议的筛选条件。
界面偏好在内存中立即生效,由后台线程写入磁盘,退出前完成写入。`tableSort.<表>` 保存各表排序,`tableWidths.<表>` 保存服务表与启动项表中拖动过的列宽,`services.filter` 和 `connections.filter` 分别保存服务与连接按状态的筛选条件,`connections.protocolFilter` 保存连接按协议的筛选条件,`connectionView` 保存连接页的视图(`list` 或按应用分组的 `apps`),`openedConnectionApps` 保存按应用视图中展开的分组(规范化的可执行文件路径,路径缺失时使用小写文件名)。

性能页的 `cpuKernelTime` 保存 CPU 图表是否叠加内核时间,默认开启。`perfHiddenDevices` 保存设备列表中已隐藏设备的标识(`performance/rail.rs` 的 `stable_key`):磁盘为总线、型号与容量,网络适配器为适配器型号与连接名称,显卡为名称,电池为名称与序列号;标识相同的设备按列表顺序追加序号。磁盘编号和适配器 LUID 随插拔顺序与重启变化,不用作标识。列表至少显示一项:保存的选择隐藏了当前全部设备时显示第一项。

Expand Down
1 change: 1 addition & 0 deletions docs/development/gpui.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,7 @@ Windows 触摸屏的 `WM_POINTER` 消息转换为 GPUI `TouchEvent`,坐标按
| `page` | 切换页面:`processes`、`performance`、`services`、`startup`、`network`、`history`、`components`、`settings`、`about` |
| `theme`、`language` | 经设置命令切换主题、界面语言;模拟快照下同样执行,只改变测试实例自身的设置 |
| `view` | 进程页的视图:`apps`、`tree`、`list` |
| `connectionView` | 连接页的视图:`apps`(按应用)或 `list`(列表) |
| `device`、`deviceKind` | 选中性能页的设备并切到性能页。`device` 为设备标识(`cpu`、`memory`、`gpu:<标识>`、`disk:<编号>`、`nic:<标识>`、`npu:<标识>`);`deviceKind` 为 `cpu`、`memory`、`gpu`、`npu`、`disk` 或 `network`,取快照中该类的第一个设备 |
| `cpuMode` | `overall`、`logical`:CPU 概览的整体与多核视图;`details`:CPU 详情页 |
| `details`、`detailsWidth` | 详情窗格:`"auto"` 为自动,`"closed"` 或 `false` 为关闭,其他值为打开;`detailsWidth` 设置其宽度,如同拖动边缘 |
Expand Down
12 changes: 10 additions & 2 deletions docs/guide/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,12 +36,20 @@ Argus 的窗口顶部是标题栏,下方是导航栏、当前页面和状态
| 性能 | Ctrl+2 | CPU(整体或多核视图,多核视图为每个逻辑处理器一张小图,优先排成没有空位的整齐行列,逻辑处理器的数量在当前窗口大小下排不满时才留出空位;小图保持接近原生任务管理器的比例,空间不足时上方的文字先省去频率、再整行隐藏,省去的内容在悬停提示中显示;窗口较小时小图优先,实时数字与规格移至下方,详见[硬件数据](hardware-data.md);混合架构处理器的性能核、能效核与低功耗能效核各用一种颜色并标注 P、E、LP;两种视图都在利用率曲线下叠加内核时间。在 CPU 图表上单击右键可切换“整体视图”与“多核视图”;混合架构处理器在多核视图下另可选择“全部核心”或仅显示某一类核心(如“仅性能核”);同一菜单可取消或重新勾选“显示内核时间”。所选视图、核心类型与内核时间在重启后保留;频率、温度、功耗)、内存、各个磁盘、网络适配器、GPU(引擎利用率默认“智能显示”,仅列出曲线时间范围内有占用的引擎,引擎空闲满一个时间范围后才收起;也可改为固定数量,并选择每张小图显示的引擎,按显卡型号保存。小图可排成网格、焦点(第一个引擎放大,其余排在旁边或围成 L 形)或列表(每个引擎一行),始终铺满、不留空位;除放大的第一个引擎外,其余小图大小一致;网格在引擎数不能排成整齐的行列时,由第一个引擎多占一格;拖动引擎图与显存图之间的分隔条可调整两者的高度比例,双击恢复默认。显卡按驱动支持情况显示温度、频率、电压与功耗瓦数)、NPU(Windows 识别的硬件 NPU,显示利用率与曲线)、电池。曲线随窗口大小伸缩,填满实时数字以外的空间,窗口较矮时压扁曲线以显示实时数字。实时数字与规格在较宽的窗口中左右并排;窗口较窄时(含默认尺寸)规格排在实时数字下方并分为两列,实时数字按能占最少行数的列数排列。CPU 标题旁的“概览 / 详情”切换两页:概览显示曲线、实时数据与规格,详情以卡片列出处理器信息(含指令集)、温度与功耗曲线、内部传感器、每核读数、主板传感器、封装限制与空闲状态,标题行显示摘要,所选页面在重启后保留。磁盘标题旁同样可切换概览与详情,详情页显示健康状况、设备信息与 SMART 属性,见[磁盘详情](#磁盘详情)。磁盘与网络曲线按峰值选择预设量程档位,最低分别为 100 KB/s 和 100 Kbps(字节单位为 100 KB/s),各级档位见[速率量程](../design/charts.md#速率量程);功耗等其他动态量程保持整数或整十数取整。上限变化时曲线平滑过渡、上限标签淡入,随“曲线动画”设置,关闭时直接切换。网络适配器的 IPv4、IPv6 地址超过 3 个时,单击“展开全部”查看其余地址。拖动设备列表右侧的分隔条可调整列表宽度,双击恢复默认。在设备列表的某一项上单击右键可隐藏该项(例如不常用的可移动磁盘或虚拟网络适配器),其余各项随之上移;“显示的设备”子菜单可逐项勾选,“恢复默认显示”恢复全部。隐藏的设备按型号、容量、连接名称等信息记录,重新插拔或重启后仍保持隐藏;列表至少保留一项,隐藏当前选中的项时改为选中其后一项。从概况带或详细信息面板打开已隐藏的设备时,该项回到列表。上下拖动设备列表中的某一项可调整顺序:该项浮起并跟随指针,其余各项实时让位,松开后滑入新位置。右键菜单的“磁盘排序”可选“按磁盘编号”(即 Windows 磁盘管理中的磁盘编号,默认)、“按盘符”(有多个盘符的磁盘按首个盘符,没有盘符的磁盘排在后面)或“自定义(拖动调整)”;拖动打乱了所选的磁盘顺序时自动改为“自定义”,只调整其他设备的位置时保持原选择。“恢复默认顺序”恢复全部设备的初始顺序。顺序按设备的记录信息保存,暂时拔出的设备重新接入后回到原位置,新接入的设备排在原顺序中与其相邻的设备之后。记录信息完全相同的设备(如同型号、同容量的两块磁盘)按采集顺序区分,其中一台拔出或磁盘编号改变后,隐藏状态与顺序可能转到另一台 |
| 服务 | Ctrl+3 | 启动、停止服务,修改启动类型,确认后删除服务;进程页里的 svchost 会显示它承载的服务;可[添加备注与置顶](#备注与置顶) |
| 启动 | Ctrl+4 | 启用、禁用登录时启动的程序,确认后删除启动项,标出已失效的项目;与系统任务管理器使用同一个开关;可[添加备注与置顶](#备注与置顶) |
| 连接 | Ctrl+5 | 页面可见时每 2 秒刷新 TCP / UDP 端点及所属进程。可按端口精确搜索,双击连接可转到所属进程。支持断开 IPv4 TCP 连接及[添加备注与置顶](#备注与置顶) |
| 连接 | Ctrl+5 | 页面可见时每 2 秒刷新 TCP / UDP 端点及所属进程。可按端口精确搜索,双击连接可转到所属进程。支持断开 IPv4 TCP 连接及[添加备注与置顶](#备注与置顶)。支持[按应用分组](#连接按应用分组) |
| 历史 | Ctrl+6 | 记录的处理器、内存、磁盘、网络、显卡与电池读数,可分轨道显示、叠加第二个读数,以及任一时刻或区间的进程,见[历史](#历史) |
| 组件 | Ctrl+7 | 托盘图标、悬停卡片、快捷面板与常驻行为,[桌面监控](resident-mode.md#桌面监控)与[任务栏监控](resident-mode.md#任务栏监控)的设置,见[组件页](resident-mode.md#组件页) |
| 设置 | Ctrl+8 | 见[设置](settings.md) |
| 关于 | Ctrl+9 | 版本、权限、更新内容、项目主页、许可证与日志,见[关于](#关于) |

### 连接按应用分组

连接页默认显示“列表”。切换到“按应用”后,同一可执行文件路径的连接归入一组。路径缺失时按文件名分组。无所属进程和所属进程已退出的连接分别归组。

分组行显示应用名称与连接数。单击箭头、双击分组行或按 Enter 可展开或折叠,也可用左右方向键操作。只有一条连接时直接显示该连接。筛选和排序先于分组生效,搜索时自动展开匹配结果。视图与手动展开的分组在重启后保留。

分组内的连接由同一进程持有时,可从分组行的右键菜单转到或结束该进程。备注与置顶作用于单条连接。

## 导出当前页为 CSV

在进程、服务、启动或连接页,单击右上角“更多操作”(…),选择“导出当前页为 CSV…”,再选择保存位置。文件保留单击导出时的筛选、排序、列顺序、显示单位和分组展开状态,包含滚动区域外的行。筛选结果为空时,文件仅含表头。
Expand Down Expand Up @@ -77,7 +85,7 @@ CSV 使用带 BOM 的 UTF-8 编码,可在 Excel 中打开。名称、描述或
- **概况带**:CPU、内存、最忙的磁盘、网络和 GPU。大号数字下方是辅助读数:CPU 为频率、温度与功耗,GPU 为温度与功耗(取自当前最忙的显卡),内存为占用比例,磁盘为活动时间,网络为接收与发送速率。缺失的读数不显示;卡片较窄时,数字与辅助读数随之缩小字号。曲线铺满卡片,在文字下方渐隐;顶部细线标出量程上限,右上角注明上限数值(使用率为 100%,内存为总容量,磁盘与网络为当前档位)。CPU 温度与功耗的来源可悬停查看;GPU 功耗优先显示瓦数,仅有相对读数时显示 `% TDP`。单击卡片转到“性能”页的对应设备。
- **导航栏**:默认以标签形式排列在标题栏下方,标签右侧是页面栏。在“设置 → 语言与外观”或首次启动引导中可改为侧边导航栏:位于窗口左侧,“设置”与“关于”位于底部;默认仅显示图标(指针悬停可看到页面名称与快捷键),单击顶部的 ☰ 按钮展开显示页面名称,再次单击收起。展开后可拖动侧边栏的右边缘调整宽度(150–320 px),双击右边缘恢复默认宽度。位置、展开状态与宽度在重启后保留。
- **标题栏**:空白处可拖动窗口、双击最大化,最右端是最小化、最大化与关闭按钮(指针停在最大化按钮上时,Windows 11 显示贴靠布局)。最小化按钮左侧的图钉按钮切换“置顶显示”:开启后窗口始终显示在其他窗口之上,图钉以强调色填充,再次单击恢复;该状态在重启后保留。左侧是 Argus 的图标与名称,中间是当前页面的搜索框,宽度约为窗口宽度的 30%(不窄于占位文字,不超过 480 px),空间足够且未输入时右端显示快捷键 Ctrl+F。两侧空间足够时搜索框位于窗口正中,否则紧随左侧的名称。
- **页面栏**:顶部导航时位于标签右侧;侧边导航时位于页面顶部,左侧显示页面名称。依次是当前页面的控件和“更多”按钮:进程页为视图切换(按应用、进程树、列表,仅显示图标)、隐藏系统进程与详细信息面板按钮,服务页为针对所选服务的启动、停止、重新启动,连接页为隐藏系统进程,历史页为“实时”或“回到最新”。服务页与连接页的筛选位于列表“状态”列的表头:单击表头右端的 ⌄ 选择全部、正在运行、已停止(连接页为全部、监听、已连接);连接页的“协议”列另有协议筛选,可选全部、TCP、TCPv6、UDP、UDPv6,与状态筛选同时生效。筛选生效时该按钮显示为强调色的漏斗图标;单击表头其余部分仍按该列排序。“更多”在每个页面都位于最右端,其中有“运行新任务”(Ctrl+N)、“查找占用文件的进程”、服务页的“打开 Windows 服务管理器”和快捷键说明。标签(或页面名称)与控件之间的空白同样可拖动窗口、双击最大化。窗口较窄时,页面控件移到下方单独一行;指针悬停仍可看到按钮名称。
- **页面栏**:顶部导航时位于标签右侧;侧边导航时位于页面顶部,左侧显示页面名称。依次是当前页面的控件和“更多”按钮:进程页为视图切换(按应用、进程树、列表,仅显示图标)、隐藏系统进程与详细信息面板按钮,服务页为针对所选服务的启动、停止、重新启动,连接页为视图切换(按应用、列表,仅显示图标)与隐藏系统进程,历史页为“实时”或“回到最新”。服务页与连接页的筛选位于列表“状态”列的表头:单击表头右端的 ⌄ 选择全部、正在运行、已停止(连接页为全部、监听、已连接);连接页的“协议”列另有协议筛选,可选全部、TCP、TCPv6、UDP、UDPv6,与状态筛选同时生效。筛选生效时该按钮显示为强调色的漏斗图标;单击表头其余部分仍按该列排序。“更多”在每个页面都位于最右端,其中有“运行新任务”(Ctrl+N)、“查找占用文件的进程”、服务页的“打开 Windows 服务管理器”和快捷键说明。标签(或页面名称)与控件之间的空白同样可拖动窗口、双击最大化。窗口较窄时,页面控件移到下方单独一行;指针悬停仍可看到按钮名称。
- **状态栏**:最左端是版本号,测试构建在版本号后附带提交数(悬停可看到完整版本与更新通道),单击打开本版本的更新内容,右键复制版本号,有新版本时改为更新标记(见[设置 → 更新](settings.md#更新));其后是线程数、句柄数、缓存、分页缓冲池与系统已运行时间,窗口较窄时从最后一项起依次隐藏;右端是刷新控件和权限标记。刷新控件左侧显示刷新状态(例如“每 1 秒刷新”“已暂停刷新”),单击可选择刷新频率,再次单击收起;右端的按钮单击暂停或继续刷新,对所有页面生效,位置不随状态文字变化。权限标记显示“管理员”时,Argus 以管理员身份运行;显示“特权服务”时,Argus 以标准权限运行,需要管理员权限的操作由已连接的特权服务执行;显示“标准权限”时两者都不具备。指针悬停可看到说明。

暂停刷新只冻结界面上的数据,历史记录和规则照常进行(这期间每 5 秒采样一次)。
Expand Down
7 changes: 7 additions & 0 deletions src-gpui/src/commands.rs
Original file line number Diff line number Diff line change
Expand Up @@ -1015,6 +1015,13 @@ pub fn history_move(
Ok(settings_view(&app))
}

pub fn history_reset_dir(
app: crate::native_runtime::Host,
move_records: bool,
) -> Result<SettingsView, String> {
history_move(app, String::new(), move_records)
}

pub fn history_open_dir(dir: State<'_, HistoryDir>) -> Result<(), String> {
open_folder(&dir.read()).map_err(|_| tr!("history.error.open"))
}
Expand Down
Loading