Tauri 宿主
src-tauri/ 是 Tauri 2 应用本体：启动采样线程，管理窗口、托盘和全局快捷键，并向前端提供 IPC 命令。
模块
preferences.rs 将界面偏好与窗口位置原子保存到配置目录的 preferences.json，旧版 localStorage 仅补充尚未保存的键。文件独立于 WebView 缓存，同一配置目录下的启动入口共享偏好。window_state.rs 保存 WINDOWPLACEMENT 的普通窗口矩形与最大化标记，移动或缩放结束后保存，关闭和退出前补写；隐藏启动延迟到首次显示时恢复最大化，不恢复最小化状态。
| 模块 | 职责 |
|---|---|
installer.rs |
安装器检查并复制主程序的内部入口，在单实例和 WebView 初始化前处理。记录占用查询与复制阶段的原始错误码、进程身份及实际路径；仅将路径和创建时间均匹配的 Argus 实例注册到独立的进程关闭会话，其他占用进程交由用户处理。交互模式提供重试和取消，静默模式返回错误码；临时目录中的独立日志在弹窗等待期间可读取 |
webview_policy.rs |
所有主窗口创建路径共用的导航边界：发布版仅接受应用自身来源，开发版另接受配置中的开发服务器来源；拦截日志不记录 URL 或查询参数。配合 CSP 禁止嵌入网页、插件对象、基址修改与表单提交，外部链接由原生入口交给系统浏览器 |
diagnostics.rs |
运行环境与功能可用性摘要、前端错误接收。首次采样记录 CPU 与显卡型号及 CPU family/model/stepping，型号限长并转义，不包含设备序列号。错误保留操作来源、失败阶段、数值错误码及应用脚本行列位置；文件操作失败另记录实际路径。后台反复出现的同一故障每分钟最多记录一次，并附上被抑制的重复次数；argus.log 按 1 MiB 轮换，保留最近 3 份旧文件 |
window_motion.rs |
主窗口在原位置淡入淡出，禁用该窗口的 DWM 缩放过渡；标题栏最小化、系统恢复及托盘显隐共用状态，反向操作从当前透明度继续。仅动画期间使用分层窗口和短时计时线程，完成后移除；set_window_motion 接收界面动画偏好，minimize_main 供标题栏调用，实际可见性仍由 shell.rs 跟踪；样式重建中的临时显隐合并为一次状态变化 |
admin.rs |
管理员启动策略与权限交接，在单实例及 WebView 创建前路由；设置中立即切换，引导中延后应用，详见管理员启动 |
instance.rs |
在采样和 WebView 初始化前取得具备所有权的互斥锁，仅请求同步权限，以便标准权限实例连接管理员实例；专用隐藏消息窗口仅为受限的 WM_COPYDATA 交接协议设置跨完整性级别例外，主窗口和其他消息不受影响。并发启动等待窗口就绪，异常退出后接管废弃锁；转交失败时保留 API 与原始错误码，不启动第二个主实例 |
lib.rs |
启动流程：注册插件（单实例、日志、开机启动、对话框、更新）、托盘、采样线程与主窗口；历史记录写在 %LOCALAPPDATA%\<标识>\history，启动时删掉过期的天（关闭记录时也会过期）；处理关闭窗口（留在托盘或退出）；退出时停止每进程网络的 ETW 会话（会话名开发版与正式版不同） |
sampler.rs |
采样线程：采集器在这个线程里创建（初始化与 WebView 启动并行）；窗口可见时按设定节拍采样，最小化时按“最小化时的刷新间隔”、隐藏到托盘时按“后台常驻时的刷新间隔”（均默认 5 秒），暂停刷新时每 5 秒一次（暂停时不推送给界面，操作后的立即刷新除外）。窗口状态由探针给出（IsWindowVisible、IsIconic），每次采样后在当前状态的节拍上排下一次，节拍变慢不靠跳过前台的节拍（那样后台 5 秒实为 6 秒，间隔 5 秒时偶尔 10 秒）；按需采样（例如窗口回到前台）会把排得更晚的下一拍提前，距上次采样不足 250 毫秒而不另行采样时也一样；合入已完成的服务网络计数和磁盘计数（是否过期按本次与上一次采样中较长的节拍判断，回到前台的第一拍照常使用上一个后台拍取得的结果），每进程磁盘计数取不到时（本地或服务的查询、解析失败，服务没有返回快照，请求失败）每种原因在日志里记一次，只含类别与错误码；把进程身份交给后台规则线程，再写入历史（关闭记录时停掉录制；清除历史也由这个线程执行）；经 Tauri Channel 推送快照，全程不等待服务 RPC |
shell.rs |
常驻：窗口显隐、托盘；WebView2 跟随窗口是否可见（子类化主窗口，在每次 WM_WINDOWPOSCHANGED 后判断，隐藏或最小化时停止渲染、降低内存目标，以任何方式显示后恢复；以 --hidden 启动时等页面画出第一帧再休眠，休眠后保留这一帧，第一次显示时立即有内容）；同一个子类过程按窗口状态的变化记下窗口何时、以何种方式离开前台（最小化或托盘，从托盘启动也算），回到前台时（任何方式，包括不激活的恢复和其他程序的 SetWindowPos）立即采样一次，并发出一次 argus-restored（from、awayMs），界面据此提示期间的刷新间隔；由任务管理器替换启动、页面就绪即显示的窗口不算离开，第一次显示时 awayMs 为 0；切换语言后重建托盘菜单和窗口标题；托盘的更新菜单项与角标在主线程上按当时的状态重绘；窗口背景（Mica 延伸到客户区）；调整大小时的斜线防护，见窗口外观 |
hotkey.rs |
显示或隐藏窗口的全局快捷键：在主窗口上调用 RegisterHotKey（子类化接收 WM_HOTKEY，只在主线程注册）；按与设置页共用的 ui/src/lib/hotkey-table.json 解析与校验组合，已保存的旧值照常注册；停用时只注销、保留组合（旧版本以空字符串表示停用，读取时迁移为默认组合加停用）；更改时先注册新组合、保存成功后再注销旧组合；录制期间暂停，窗口隐藏或 60 秒后自动恢复，并以 argus-hotkey-changed 事件通知页面；启动时被占用的快捷键在窗口显示时重试。错误以结构化形式交给页面翻译，日志只记类别。见全局快捷键 |
caption.rs |
自绘标题栏的原生部分：窗口不带系统标题栏（decorations: false，保留阴影、圆角、贴靠和边缘缩放），去掉 DWM 边框（含强调色边框）；在页面的最大化按钮上放一个透明子窗口，命中测试返回 HTMAXBUTTON，让 Windows 11 显示贴靠布局，单击时最大化或还原，悬停与按下以 argus-caption-maximize 事件交给页面绘制。见窗口外观 |
leftovers.rs |
启动时、创建窗口之前，结束上一个 Argus 遗留的 WebView2 进程：Argus 崩溃、被结束或开发运行被停止后，WebView2 进程可能继续存在几分钟到几小时并占用数据文件夹，这时新的 WebView 无法创建（0x800700AA，“请求的资源正在使用中”），Argus 不显示窗口就退出。只处理本构建数据文件夹的浏览器进程（父进程已不在）及其子进程：先提高到高优先级再结束，最多等待 3 秒（繁忙的电脑上，低优先级的残留进程被结束后约 30 秒才退出完，提高优先级后约 0.1 秒）；日志只记录结束的个数。安装程序与卸载程序以 argus.exe --argus-close-copies 运行（不检查单实例、不创建窗口）：结束任务管理器替换与管理员启动目录中正在运行的界面副本（Restart Manager 只关闭安装目录的 argus.exe，留下的副本占着单实例并保留内存中的设置：升级后的启动都会转交给旧版本，删除数据后重新安装的首次启动也会转交给它），再结束它们与刚被关闭的 Argus 遗留的 WebView2 进程 |
diagnostics.rs |
日志中的诊断信息：启动时的系统与 WebView2 版本、令牌类型和界面语言；在后台计算一次正在运行文件的 SHA-256，以区分同版本测试构建及替换副本；首次采样后的传感器可用性；特权服务与任务管理器替换的状态（服务发布版本号是否与 Argus 一致，状态带错误时记固定类别，例如 incompatible protocol、os error 109）；页面异常仅保留固定事件和异常类别，每次运行最多 20 条，不传输错误原文或堆栈 |
settings.rs |
界面加载前原生侧就要用到的设置（语言、主题、快捷键、关闭行为、最小化与后台常驻时的刷新间隔、开机启动、规则、是否记录历史、更新通道与线路、更新后是否显示更新内容、已完成的首次启动引导版本、已处理过首次启动的版本），以 JSON 存在 %APPDATA%\dev.argus.taskmanager\settings.json，保存时先写入临时文件并落盘、再替换原文件，断电或强制重启不会留下空文件或写了一半的文件；启动时在日志里记下读取结果（没有文件、读取失败、空文件、全为零字节、无法解析，或读到的引导版本），无法解析的文件改名为 settings.json.bad 保留，不被下一次修改覆盖；语言保存为标签（system、zh-CN、en-US），主题保存为 system、light 或 dark，无法识别的值都按 system 处理；主题通过 set_theme 设到主窗口，Tauri 再把它传给 WebView2 的首选配色，页面的 prefers-color-scheme 随之变化 |
updater.rs |
应用内更新：后台线程在启动 1 分钟后、之后每天检查一次；按通道读取最新稳定版 Release 上的 latest.json 或 beta.json，按线路直连 GitHub 或在地址前加代理前缀，失败时换下一个来源；发现新版本立即下载（插件校验签名和签名中的版本号）。清单中的更新内容（argus.releaseNotes，CHANGELOG.md 条目及其 CHANGELOG.en.md 英文译文）以同一公钥验签并核对版本号后才交给界面。下载的安装包连同版本、签名与更新内容存入 %LOCALAPPDATA%\<标识>\updates，启动时重新验签后直接恢复为可安装，版本已安装、换了通道或验签失败时删除；已有可安装的更新时，后台检查不改变其状态。检查进行中切换通道时，已下载的更新随即删除，这次检查的结果作废，结束后按新通道重新检查；安装程序启动期间（等待管理员授权时）检查与切换通道都不改变状态。安装由用户触发：在只读共享锁定文件的状态下再验签一次，由 Argus 自己以 /P /UPDATE /R /ARGS --updated 启动安装程序后退出（插件只能安装本次运行检查到的更新），管理员授权被取消时返回 cancelled。状态通过 update-status 事件推给界面；可安装时托盘图标加强调色圆点、悬停提示与菜单增加对应项，菜单项发出 argus-show-update 打开更新对话框 |
commands.rs |
IPC 命令；标准权限下将手动进程操作、服务控制和断开连接交给已授权且运行中的特权服务，未安装、未授权或停止时按本地权限执行；服务协议版本不兼容、请求在执行前被拒绝时同样按本地权限执行，权限不足时返回 ActionError::ServiceOutdated（不是 AccessDenied），界面据此提示更新服务；服务已接受请求后出错不自动重试。开机启动项（commands/autostart.rs）：已有管理员启动记录时使用受保护的稳定启动器，否则以任务管理器替换的界面副本运行时写入已安装的 argus.exe（找不到时拒绝并说明），已安装的 Argus 或界面副本首次读取设置时，以及再次启动、转交给已在运行的实例后，把指向界面副本的启动项改回已安装的 argus.exe，保留参数和“启动应用”中的启用状态；argus:// 协议提供进程图标 |
tasks.rs 在专用 STA 线程中通过 ShellExecuteExW 运行用户输入的任务，保留参数原文，使用系统文件关联及 UAC。管理员实例的普通权限启动由受限令牌助手完成，不依赖 Explorer 或特权服务；助手在 Tauri、单实例和设置初始化前退出。日志只记录失败阶段和错误码。
explorer.rs 按桌面窗口、系统映像路径、会话、PID 与创建时间核对资源管理器。关闭前先创建主线程挂起的新 Explorer，以旧桌面进程为父进程继承原账户的普通令牌，并校验新进程的账户、会话与权限。进程和线程对象的访问控制与完整性级别也取自桌面令牌，避免管理员创建的对象阻止普通账户继续管理资源管理器。准备失败时保留原桌面并清理未启动的替代进程。
随后向任务栏发送 Explorer 自身的退出请求，先等待正常退出；五秒后仍未完成时，使用操作前取得的进程句柄结束已确认的旧实例，并等待最多五秒确认退出，避免退出清理或错误报告卡住后丢弃替代进程。结束权限在关闭桌面前检查，未确认旧进程退出时不启动替代进程；Windows 已恢复新桌面时复用该实例，避免重复启动。不发送 Restart Manager 的会话结束通知，也不依赖以普通权限重新运行 Argus 助手。新桌面与任务栏连续一秒能够响应消息后才报告完成。普通结束进程与结束进程树入口在调用特权服务前拦截当前桌面 Explorer，文件占用对话框对该进程提供重新启动操作。
WebView2 的账户与数据目录
普通权限和同账户提权启动使用原有浏览器目录。以其他管理员账户启动时，WebView2 降权后的账户与宿主不同；webview_profile.rs 查询当前桌面账户，在其 LocalAppData 下为该构建、启动账户、会话和桌面准备独立浏览器目录。目录以桌面账户的权限创建，最终目录不得为重解析点；解析实际路径后持有目录读取句柄，防止路径在使用期间被替换。WebView2 保留自动降权；设置、历史和日志仍使用宿主账户的目录。
跨账户窗口在日志和界面语言就绪后创建。目录准备失败时显示本地化提示，日志记录启动环境、失败阶段、原始错误码及失败目录的实际路径；不会为失败的启动建立进程网络采集会话。异常退出后的清理和安装维护命令均识别该浏览器目录，维护命令只检查已有目录。
资源管理器已退出时，WebView2 的管理员界面初始化会返回 0x80070490。webview_recovery.rs 先询问是否恢复桌面，确认后按窗口站的登录 SID 和当前会话查找普通权限令牌，以原桌面账户启动系统 Explorer，并核对恢复后的身份；取消时结束本次启动。此路径只用于交互式默认桌面，不修改 WebView2 的降权行为。
IPC 命令
| 用途 | 命令 |
|---|---|
| 应用与快照 | app_info（含解析后的界面语言、系统是否支持 Mica、是否由更新安装程序重新启动、是否由任务管理器替换启动）、subscribe、set_interval、set_paused、refresh |
| 进程 | process_details、kill_process、kill_process_tree、set_priority、set_efficiency_mode、reveal_in_explorer |
| 任务启动与桌面 | run_task、desktop_shell（按需查询当前桌面实例）、restart_explorer（核对 PID 与创建时间后重启） |
| 设置与窗口 | get_settings、set_language、set_theme、complete_onboarding、set_whats_new（更新后是否显示更新内容）、note_version_seen（记下当前版本的首次启动已处理，更新内容不再显示）、set_close_to_tray、set_background_intervals（最小化与后台常驻时的刷新间隔，只接受设置页提供的几档，立即生效）、set_hotkey（同时开启快捷键）、set_hotkey_enabled（开关，保留组合）、suspend_hotkey / resume_hotkey（录制快捷键期间暂停，结束或重试时重新注册）、set_autostart、set_kernel_sensors、open_sensor_driver_page（固定官方地址）、open_log_dir、quit、set_caption_button（页面最大化按钮的位置）、page_painted（页面画出了第一份数据，隐藏的窗口此后可以让 WebView 休眠）、log_ui_error |
| 特权服务 | privileged_service_status、manage_privileged_service（install / start / update / uninstall，显式操作才请求管理员授权） |
| 更新 | update_status、check_update（在后台检查并下载，立即返回）、install_update（启动安装程序后 Argus 退出；未启动时返回 { cancelled, message }）、set_update_settings、open_release_page（免安装版及更新对话框的“在 GitHub 上查看”） |
| 规则 | set_rules、rule_stats |
| 服务 | list_services、control_service、set_service_start_type、open_services_console |
| 启动项 | list_startup、set_startup_enabled |
| 连接 | list_connections、close_connection |
| 文件占用 | find_lockers、pick_path |
| 历史 | history_range、history_series（分桶数上限 4096）、history_moment、history_usage、set_history_enabled、clear_history |
配置
find_lockers 合并 Restart Manager 与句柄查询，按 PID 和启动时间去重。句柄查询优先交给已授权的服务；没有服务或只读请求失败时，使用当前账户的独立辅助进程。Restart Manager 无权访问、但句柄查询有结果时仍返回结果，并保留降级说明。扫描统计包括来源、已查询数量、权限不足、跳过和超时；文件占用窗口的结束操作使用查询时的启动时间。
启动时按设置调用 argus_core::i18n::set_locale，此后托盘、窗口标题与宿主返回的错误信息使用该语言（见多语言）。
进入 lib.rs::run 后先检查特权服务与安装助手模式，命中时直接运行并退出，不初始化 Tauri、单实例插件、采样器或 WebView。安装和协议边界见特权服务。这些操作在后台命令线程执行，不阻塞采样线程。
tauri.conf.json：标识dev.argus.taskmanager；主窗口 1240×800（最小 860×540），启动时隐藏、由 setup 显示（带--hidden启动时保持隐藏）；创建时不取得焦点（focus: false），否则 wry 建好 WebView 就把焦点移进去，隐藏的窗口也会被激活、抢走前台，显示时窗口获得焦点后再由 wry 交给页面；Windows 11 使用 Mica，WebView 背景透明（#00000000），Windows 10 由页面绘制实色背景；打包目标为 NSIS，为所有用户安装到 Program Files：提权助手和复制成特权服务的程序都取自安装目录，这个目录只有管理员能写入，标准权限的程序无法替换其中的文件；英文与简体中文界面（按 Windows 显示语言选择，卸载钩子的提示按$LANGUAGE选择文字），不允许降级安装；安装与卸载页面由installer-template.nsi（Tauri 模板，只替换页面列表）与installer-ui.nsh绘制，卸载钩子在installer-hooks.nsh，见安装程序。plugins.updater保存更新签名公钥并开启requireSignedVersion；updater.rs以同样的规则校验存盘的安装包与更新内容，更新以 passive 模式安装。安装后钩子先退出运行中的界面副本，并更新管理员启动记录，再以argus.exe --argus-service-refresh在同一次管理员授权中更新已安装的特权服务；启用了替换时，其界面副本、启动器和恢复程序同步更新，替换保持开启。- 更新安装类型由 Tauri 写入程序的打包标记决定，NSIS 安装版的管理员副本和任务管理器替换副本仍可应用内更新，不依赖副本目录中存在卸载程序。免安装下载不带安装标记，其目录中出现卸载程序也不会改变类型。只读助手
--argus-updater-check在窗口、单实例和权限路由之前返回类型，供安装包检查使用。 - 更新安装程序重新打开 Argus 时只传
--updated，不沿用原来的启动参数（其中可能带有一次性的任务管理器握手参数）。从隐藏状态开始的更新在应用数据目录留下relaunch-hidden标记，重新打开时据此留在托盘。 tauri.dev.conf.json：开发版覆盖产品名与标识（dev.argus.taskmanager.devbuild），见开发版与已安装版互不干扰。