# SaManagement **Repository Path**: cherishron/SaManagement ## Basic Information - **Project Name**: SaManagement - **Description**: SaManagement test - **Primary Language**: Rust - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-18 - **Last Updated**: 2026-07-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: Rust ## README # SaManagement > 🛠️ 基于 Tauri 2.0 的跨平台开发工具箱 [![License](https://img.shields.io/badge/license-MulanPSL--2.0-blue.svg)](LICENSE) [![Tauri](https://img.shields.io/badge/Tauri-2.x-green.svg)](https://tauri.app) [![Vue](https://img.shields.io/badge/Vue-3.4-brightgreen.svg)](https://vuejs.org) [![Rust](https://img.shields.io/badge/Rust-stable-orange.svg)](https://rust-lang.org) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://gitcode.com/STAND-ALONE/SaManagement) --- ## 📖 项目简介 SaManagement 是一款轻量级、高性能的跨平台桌面工具箱应用，集成多种实用工具，帮助你更高效地管理系统资源。支持 Windows、macOS 和 Linux 操作系统。 ### ✨ 核心功能 | 功能模块 | 描述 | 平台支持 | |---------|------|---------| | 🔌 **端口管理** | 查看系统端口占用情况，快速终止占用进程 | 全平台 | | 🗑️ **文件粉碎** | 安全删除文件和文件夹，支持顽固文件处理 | 全平台 | | 📦 **环境管理** | 多语言 SDK 版本管理（Node.js、Python、Java 等） | 全平台 | | 🗜️ **文件压缩** | 将文件或文件夹压缩为 ZIP 格式 | 全平台 | | 📝 **JSON 工具** | JSON 格式化、可视化编辑、树形结构操作 | 全平台 | | 📄 **文本/代码编辑器** | 编辑文本/代码文件，支持 Markdown 语法提示和实时预览 | 全平台 | | 🌐 **网络工具** | Ping 测试、路由追踪、DNS 查询 | 全平台 | | 🧹 **系统清理** | 磁盘垃圾清理、注册表清理 | 全平台 | | 📋 **剪贴板历史** | 自动捕获、搜索、复用剪贴板内容 | 全平台 | | ⌨️ **快捷键管理** | 全局快捷启动应用和系统操作 | 全平台 | | 📊 **系统监控** | 实时查看 CPU、内存、磁盘使用率、网络流量 | 全平台 | | ⚙️ **系统设置** | 开机自启、主题切换等配置 | 全平台 | | 🖱️ **右键菜单** | Windows 右键菜单集成 | 仅 Windows | --- ## 🖼️ 功能截图 | 主页 | 端口管理 | 文件粉碎 | |------|---------|---------| | ![主页](docs/images/win-toolkit-home.jpg) | ![端口管理](docs/images/win-toolkit-port.jpg) | ![文件粉碎](docs/images/win-toolkit-shredder.jpg) | --- ## 🚀 快速开始 ### 环境要求 - **Node.js** 20 LTS+ - **pnpm** 9+ - **Rust** stable (通过 [rustup](https://rustup.rs) 安装) - **操作系统**: Windows 10/11, macOS 10.15+, Linux (Ubuntu 20.04+/Debian 10+/Fedora 32+) ### 安装依赖 ```bash pnpm install ``` ### 开发模式 ```bash # 启动开发服务器（前端 + Tauri） pnpm tauri dev # 仅启动前端开发服务器 pnpm dev ``` ### 生产构建 ```bash # 构建安装包（根据平台生成对应格式） # Windows: msi, nsis # macOS: dmg, app # Linux: appimage, deb, rpm pnpm tauri build # 构建产物位于 src-tauri/target/release/bundle/ ``` --- ## 📦 技术栈 ### 前端 | 技术 | 版本 | 用途 | |------|------|------| | [Vue 3](https://vuejs.org) | 3.4.21 | 前端框架 (Composition API) | | [TypeScript](https://typescriptlang.org) | 5.4.2 | 类型系统 | | [Vite](https://vitejs.dev) | 5.1.6 | 构建工具 | | [Vue Router](https://router.vuejs.org) | 4.3.0 | 路由管理 | | [Pinia](https://pinia.vuejs.org) | 2.1.7 | 状态管理 | | [OpenTiny Vue](https://opentiny.org) | ^3 | UI 组件库 | | [OpenTiny Icons](https://opentiny.org) | ^0.1.4 | 图标库 | | [vue-sonner](https://vue-sonner.vercel.app) | ^2.0.9 | Toast 通知 | | [@tauri-apps/api](https://tauri.app) | ^2.0.0 | Tauri API | | [@tauri-apps/plugin-os](https://tauri.app) | ^2.0.0 | 操作系统检测 | | [@tauri-apps/plugin-autostart](https://tauri.app) | ^2.0.0 | 开机自启 | | [@tauri-apps/plugin-dialog](https://tauri.app) | ^2.6.0 | 文件对话框 | | [@tauri-apps/plugin-shell](https://tauri.app) | ^2.0.0 | Shell 执行 | | [@tauri-apps/plugin-global-shortcut](https://tauri.app) | ^2.0.0 | 全局快捷键 | | [Monaco Editor](https://microsoft.github.io/monaco-editor) | ^0.55.1 | VS Code 核心编辑器 | | [vuedraggable](https://github.com/SortableJS/vue.draggable.next) | ^4.1.0 | Vue 3 拖拽库 | | [chart.js](https://www.chartjs.org) | ^4.x | 图表库 | | [vue-chartjs](https://vue-chartjs.org) | ^5.x | Vue Chart.js 封装 | | [marked](https://marked.js.org) | ^15.x | Markdown 解析器 | ### 后端 | 技术 | 版本 | 用途 | 平台 | |------|------|------|------| | [Tauri](https://tauri.app) | 2.x | 桌面应用框架 | 全平台 | | [Rust](https://rust-lang.org) | 2021 edition | 系统编程语言 | 全平台 | | [tokio](https://tokio.rs) | 1.x | 异步运行时 | 全平台 | | [serde](https://docs.rs/serde) | 1.x | 序列化/反序列化 | 全平台 | | [serde_json](https://docs.rs/serde_json) | 1.x | JSON 处理 | 全平台 | | [winapi](https://docs.rs/winapi) | 0.3.x | Windows API 绑定 | Windows | | [windows](https://docs.rs/windows) | 0.54.x | Windows API 绑定 | Windows | | [nix](https://docs.rs/nix) | 0.27.x | Unix API 绑定 | macOS/Linux | | [zip](https://docs.rs/zip) | 2.2.x | ZIP 压缩库 | 全平台 | | [walkdir](https://docs.rs/walkdir) | 2.5.x | 目录遍历库 | 全平台 | | [regex](https://docs.rs/regex) | 1.x | 正则表达式 | 全平台 | | [trust-dns-resolver](https://docs.rs/trust-dns-resolver) | 0.23.x | DNS 解析 | 全平台 | | [rusqlite](https://docs.rs/rusqlite) | 0.31.x | SQLite 数据库 | 全平台 | | [chrono](https://docs.rs/chrono) | 0.4.x | 日期时间处理 | 全平台 | | [uuid](https://docs.rs/uuid) | 1.x | UUID 生成 | 全平台 | | [arboard](https://docs.rs/arboard) | 3.4.x | 跨平台剪贴板 | 全平台 | --- ## 🛠️ 功能详解 ### 1. 端口管理 查看系统端口占用情况，快速定位并终止占用进程。 **功能特性**： - ✅ 查看所有端口占用列表（协议、本地地址、端口、远程地址、状态、PID、进程名） - ✅ 按端口号精确查询 - ✅ 终止占用端口的进程（保护系统关键进程 PID 0 和 4） - ✅ 获取网络信息（IP/Gateway/DNS/MAC） - ✅ 支持排序（按协议、地址、端口、状态、PID、进程名） **平台差异**： - **Windows**: 使用 `netstat -ano` 和 `tasklist /FO CSV /NH` 命令 - **macOS/Linux**: 使用 `lsof -i -nP` 或 `netstat -anp` 命令 **Tauri 命令**： ```rust get_port_list() // 获取所有端口列表 get_port_by_number() // 根据端口号查询 kill_process_by_pid() // 终止指定 PID 进程 get_network_info() // 获取网络信息 ``` **数据结构**： ```rust pub struct PortInfo { pub protocol: String, // TCP / UDP pub local_address: String, // 0.0.0.0 pub local_port: u16, // 8080 pub foreign_address: String, // *:* pub state: String, // LISTENING / ESTABLISHED pub pid: u32, // 1234 pub process_name: String, // chrome.exe pub can_kill: bool, // 是否可终止 } ``` ### 2. 文件粉碎 安全删除文件和文件夹，支持顽固文件处理。 **功能特性**： - ✅ 拖拽上传文件/文件夹 - ✅ 点击选择文件/文件夹 - ✅ 显示文件大小和项数 - ✅ 安全删除策略（三级） - Windows: 直接删除 → 获取权限 → 重启后删除（`MoveFileExW`） - macOS/Linux: `shred` 命令覆盖 → 直接删除 - ✅ 删除进度显示 **平台差异**： - **Windows**: 使用 `takeown` 和 `icacls` 获取权限，`MoveFileExW` 实现重启后删除 - **macOS/Linux**: 使用 `shred` 命令或覆盖写入后删除 **Tauri 命令**： ```rust shred_files() // 粉碎文件或文件夹列表 get_file_size() // 获取文件/文件夹大小 get_path_info() // 获取路径详细信息 ``` ### 3. 环境管理 (vfox) 管理多语言 SDK 版本，需要先安装 [vfox](https://github.com/version-fox/vfox)。 **功能特性**： - ✅ 查看已安装插件和 SDK 状态 - ✅ 插件市场（37个插件，支持搜索和分类筛选） - ✅ 安装/卸载 SDK 版本 - ✅ 切换当前版本（本地/全局/项目） - ✅ 搜索可用版本 - ✅ 启动时自动同步数据到本地缓存（避免启动时调用 vfox 命令） - ✅ 缓存过期时间可配置（默认 5 分钟） **插件分类**： - Runtime（运行时）：Node.js, Deno, Bun, pnpm - Language（编程语言）：Python, Go, Kotlin, Zig, Lua, Ruby, PHP, R, Julia, Scala, Erlang, Elixir, Rust - JDK：GraalVM, Adoptium, Azul, IBM, Microsoft, RedHat, Oracle - Tool（工具）：Flutter, Dart, .NET, Maven, Gradle, Clang, CMake, Tomcat **支持的 SDK**： | 语言 | 插件名称 | |------|---------| | Node.js | nodejs/nodejs | | Python | python/python | | Go | golang/golang | | Java | java/adoptium-jdk | | Rust | rust/rust | | Zig | zig/zig | | Bun | bun/bun | | Deno | deno/deno | | Kotlin | kotlin/kotlin | | Flutter | flutter/flutter | | 更多... | 见插件市场 | **缓存机制**： ```rust pub struct VfoxCache { pub plugins: Vec, pub sdks: Vec, pub cached_at: u64, pub vfox_installed: bool, pub vfox_version: Option, } ``` **Tauri 命令**： ```rust // 缓存同步 sync_vfox_data() // 同步 vfox 数据到缓存 get_cached_vfox_data() // 从缓存获取数据 refresh_vfox_cache() // 强制刷新缓存 is_vfox_cache_valid() // 检查缓存是否有效 get_vfox_cache_status() // 获取缓存状态 set_vfox_cache_ttl() // 设置缓存过期时间 get_vfox_cache_config() // 获取缓存配置 set_vfox_auto_sync() // 设置启动时自动同步 // SDK 管理 get_vfox_status() // 获取已安装插件和 SDK vfox_add_plugin() // 添加插件 vfox_install() // 安装 SDK 版本 vfox_use() // 切换 SDK 版本 vfox_uninstall() // 卸载 SDK 版本 vfox_search() // 搜索可用版本 vfox_update_plugin() // 更新插件 vfox_remove_plugin() // 删除插件 // ... 更多命令见 vfox_sync.rs 和 vfox.rs ``` ### 4. 文件压缩 将文件或文件夹压缩为 ZIP 格式。 **功能特性**： - ✅ 单文件压缩 - ✅ 文件夹递归压缩 - ✅ 自动命名输出文件 **Tauri 命令**： ```rust compress_files() // 压缩文件或文件夹 get_compress_output_path() // 获取压缩输出路径 ``` ### 5. JSON 工具 JSON 格式化、可视化和编辑工具，提供专业的 JSON 编辑体验。 **功能特性**： - ✅ Monaco Editor 集成（VS Code 核心编辑器） - 语法高亮 - 实时错误检测 - 括号匹配 - 自动格式化 - JSON 压缩 - ✅ JSON 可视化树 - 递归树形结构展示 - 展开/折叠节点 - 类型徽章（object/array/string/number/boolean/null） - 节点搜索高亮 - ✅ 节点操作 - 新增节点（支持所有 JSON 类型） - 编辑节点（支持类型转换） - 删除节点 - 数组元素拖拽排序 - ✅ 数据持久化 - localStorage 自动保存 - 500ms 防抖优化 - 存储管理工具 - ✅ 双向同步 - 编辑器 → 树形视图实时同步 - 树形视图 → 编辑器实时同步 - 错误处理和提示 **技术实现**： - **Monaco Editor**: VS Code 核心编辑器，提供专业编辑体验 - **vuedraggable**: Vue 3 原生拖拽库，用于数组元素排序 - **递归组件**: JsonTreeNode 组件支持无限深度树形结构 - **路径操作**: 基于 JSONPath 的深度节点操作 **组件结构**： ```vue JsonFormatter.vue (主页面) ├── JsonEditor.vue (Monaco 编辑器) └── JsonTree.vue (树形视图) └── JsonTreeNode.vue (递归节点) ``` **工具函数** (`src/utils/jsonPath.ts`)： ```typescript getValueByPath() // 通过路径获取值 setValueByPath() // 通过路径设置值 deleteValueByPath() // 通过路径删除值 addNodeByPath() // 通过路径添加节点 getNodeType() // 获取节点类型 getDisplayValue() // 获取显示值 parseValue() // 解析输入值 pathToString() // 路径转字符串 parsePathString() // 字符串转路径 ``` **持久化 Hook** (`src/composables/useJsonStorage.ts`)： ```typescript useJsonStorage(key) // JSON 数据持久化 ├── data // 响应式数据 ├── loadFromStorage() // 加载存储数据 ├── saveToStorage() // 保存数据 ├── clearStorage() // 清除存储 └── hasStoredData() // 检查是否有存储 ``` ### 6. 系统设置 配置应用程序行为。 **功能特性**： - ✅ 开机自启动（全平台支持） - Windows: 注册表 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run` - macOS: LaunchAgent `~/Library/LaunchAgents/com.standalone.samagement.plist` - Linux: XDG Autostart `~/.config/autostart/com.standalone.samagement.desktop` - ✅ 右键菜单集成（仅 Windows） - 注册表 `HKCU\Software\Classes\*\shell\WinToolkitShred` - 注册表 `HKCU\Software\Classes\*\shell\WinToolkitCompress` - 使用 VBScript 实现完全静默执行（避免终端闪烁） - ✅ 启动最小化 - ✅ 关闭行为（最小化到托盘/退出） - ✅ 主题切换（浅色/深色/跟随系统） **应用配置**： ```rust pub struct AppSettings { pub start_minimized: bool, pub close_action: String, // "minimize" or "exit" } ``` **配置文件位置**: `settings.json`（与可执行文件同级目录） **Tauri 命令**： ```rust set_auto_start() // 设置开机自启 is_auto_start_enabled() // 检查开机自启状态 set_context_menu() // 设置右键菜单（仅 Windows） is_context_menu_enabled()// 检查右键菜单状态（仅 Windows） set_start_minimized() // 设置启动最小化 get_start_minimized() // 获取启动最小化设置 set_close_action() // 设置关闭行为 get_close_action() // 获取关闭行为 ``` ### 6. 文本/代码编辑器 专业的文本和代码编辑器，支持多种编程语言和 Markdown 格式。 **功能特性**： - ✅ Monaco Editor 集成（VS Code 核心编辑器） - 语法高亮（支持 40+ 种编程语言） - 代码折叠、查找替换 - 自动缩进、括号匹配 - ✅ Markdown 专属支持 - 15 种常用语法快捷提示（标题、粗体、斜体、链接、图片、代码块、表格等） - 实时预览模式切换 - Markdown 渲染样式优化 - ✅ 大文件支持 - 支持 200MB 以下文件直接打开 - 编辑器针对大文件优化 - ✅ 右键集成 - Windows 右键菜单"用 SaManagement 打开" - 支持 40+ 种文本/代码扩展名 **支持的语言**： JavaScript, TypeScript, Python, Rust, Go, Java, C, C++, PHP, Ruby, SQL, Shell, HTML, CSS, Vue, YAML, JSON, TOML, INI, XML, Markdown, 等 **Tauri 命令**： ```rust read_text_file() // 读取文本文件内容 save_text_file() // 保存文本文件 get_file_info() // 获取文件信息 ``` ### 7. 网络工具 提供基础网络诊断功能，帮助你排查网络问题。 **功能特性**： - ✅ Ping 测试 - 自定义目标域名/IP - 设置测试次数和超时时间 - 延迟趋势图表（Chart.js 折线图） - 实时显示丢包率和延迟统计 - ✅ 路由追踪 (Traceroute) - 显示数据包经过的每一跳 - IP 地址、主机名解析 - 三次延迟测量 - ✅ DNS 查询 - 支持 A/AAAA/CNAME/MX/TXT 记录类型 - 显示 TTL 和解析结果 **Tauri 命令**： ```rust run_ping() // 执行 Ping 测试 run_traceroute() // 执行路由追踪 run_dns_query() // 执行 DNS 查询 ``` ### 8. 系统清理 安全地清理系统垃圾文件和无效注册表项。 **功能特性**： - ✅ 磁盘清理 - 临时文件（%TEMP%） - 系统临时文件（Windows/Temp） - 缩略图缓存 - 回收站 - 用户缓存（Unix） - 清理前显示可释放空间 - 实时进度条和文件统计 - **安全保护**：C 盘仅清理缓存文件，不触及系统重要文件 - ✅ 注册表清理（仅 Windows） - 无效卸载项扫描 - 废弃文件关联清理 - 无效启动项检测 - 清理前自动备份（.reg 文件） - 按严重性分级显示（低/中/高） **Tauri 命令**： ```rust scan_disk_cleanup() // 扫描可清理项 execute_disk_cleanup() // 执行磁盘清理 scan_registry_issues() // 扫描注册表问题 execute_registry_cleanup() // 执行注册表清理 ``` ### 9. 剪贴板历史 自动捕获和管理你的剪贴板复制历史。 **功能特性**： - ✅ 系统级剪贴板监听 - 后台自动捕获文本内容 - 每 500ms 轮询检测新内容 - 防重复机制 - ✅ 历史管理 - 搜索过滤历史记录 - 点击条目重新复制到剪贴板 - 置顶重要记录 - 分页加载更多 - 清空时保留置顶记录 - ✅ 设置选项 - 开关自动捕获 - 设置保留条数上限 **Tauri 命令**： ```rust start_clipboard_monitor() // 启动剪贴板监听 stop_clipboard_monitor() // 停止剪贴板监听 get_clipboard_history() // 获取历史记录 add_clipboard_item() // 添加剪贴板记录 copy_to_clipboard() // 复制指定历史到剪贴板 get_clipboard_content() // 获取剪贴板内容 toggle_pin() // 切换置顶状态 delete_history() // 删除历史记录 clear_history() // 清空历史记录 ``` ### 10. 快捷键管理 设置全局快捷键快速启动应用或执行系统操作。 **功能特性**： - ✅ 应用快捷启动 - 设置全局快捷键快速打开程序/文件 - 文件选择器定位可执行文件 - ✅ 系统快捷操作 - 锁屏、休眠等系统操作快捷键 - ✅ 快捷键录制 - 点击输入框直接按键录制组合键 - 显示为 `Ctrl + Alt + K` 格式 - ✅ 冲突检测 - 实时检测与已注册快捷键的冲突 - 检测与系统快捷键的冲突 - ✅ 真正的系统级快捷键 - 使用 `tauri-plugin-global-shortcut` 插件 - 应用后台运行时也能触发 - 启动/关闭时自动注册/注销 **Tauri 命令**： ```rust load_hotkey_config() // 加载快捷键配置 save_hotkey_config() // 保存快捷键配置 register_hotkey() // 注册全局快捷键 unregister_hotkey() // 注销快捷键 execute_hotkey_action() // 执行快捷键动作 check_hotkey_conflict() // 检测快捷键冲突 ``` ### 11. 系统资源监控 实时查看系统资源使用情况。 **功能特性**： - ✅ CPU 使用率实时监控 - ✅ 内存使用情况（已用/总量/百分比） - ✅ 网络流量监控（上行/下行速率） - ✅ 磁盘使用率（各分区独立显示） - ✅ 实时趋势图表（60秒历史） - ✅ 刷新频率可配置 --- ## 📁 项目结构 ``` win-toolkit/ ├── src/ # Vue 前端 │ ├── main.ts # 应用入口 │ ├── App.vue # 根组件（侧边栏布局） │ ├── components/ # 公共组件 │ │ ├── index.ts # 组件导出 │ │ ├── FeatureCard.vue # 功能卡片 │ │ ├── StatCard.vue # 统计卡片 │ │ ├── StatusBadge.vue # 状态徽章 │ │ ├── ConfirmDialog.vue # 确认对话框 │ │ ├── DropZone.vue # 拖拽上传区 │ │ ├── EmptyState.vue # 空状态提示 │ │ ├── ThemeSwitch.vue # 主题切换 │ │ ├── JsonEditor.vue # JSON 编辑器组件 │ │ ├── JsonTree.vue # JSON 可视化树 │ │ └── JsonTreeNode.vue # JSON 树节点 │ ├── composables/ # 组合函数 │ │ ├── useConfirm.ts # 确认对话框逻辑 │ │ └── useJsonStorage.ts # JSON 数据持久化 │ ├── data/ # 静态数据 │ │ └── vfox-plugins.ts # vfox 插件列表（37个插件） │ ├── router/ # 路由配置 │ │ └── index.ts # Vue Router 配置（5个路由） │ ├── styles/ # 样式系统 │ │ ├── design-tokens.css # 设计令牌（CSS 变量） │ │ └── main.css # 全局样式 │ ├── stores/ # Pinia 状态管理（空目录） │ ├── utils/ # 工具函数 │ │ └── jsonPath.ts # JSON 路径操作工具 │ └── views/ # 页面视图 │ ├── Home.vue # 首页 │ ├── PortManager.vue # 端口管理页面 │ ├── VfoxManager.vue # vfox 环境管理页面 │ ├── Shredder.vue # 文件粉碎页面 │ ├── JsonFormatter.vue # JSON 工具页面 │ ├── Settings.vue # 设置页面 │ ├── SystemMonitor.vue # 系统资源监控页面 │ ├── TextViewer.vue # 文本/代码编辑器页面 │ ├── NetworkTools.vue # 网络工具页面 │ ├── SystemCleaner.vue # 系统清理页面 │ ├── ClipboardHistory.vue # 剪贴板历史页面 │ └── HotkeyManager.vue # 快捷键管理页面 ├── src-tauri/ # Rust 后端 │ ├── src/ │ │ ├── main.rs # 应用入口（CLI 模式处理） │ │ ├── lib.rs # 库入口 │ │ ├── commands/ # Tauri 命令 │ │ │ ├── mod.rs # 命令模块导出 │ │ │ ├── file.rs # 文件操作命令 │ │ │ ├── port.rs # 端口管理命令 │ │ │ ├── vfox.rs # vfox 管理命令 │ │ │ ├── vfox_sync.rs # vfox 缓存同步命令 │ │ │ ├── settings.rs # 设置命令 │ │ │ ├── viewer.rs # 文本编辑器命令 │ │ │ ├── monitor.rs # 系统监控命令 │ │ │ ├── network.rs # 网络工具命令 │ │ │ ├── cleaner.rs # 系统清理命令 │ │ │ ├── clipboard.rs # 剪贴板历史命令 │ │ │ └── hotkeys.rs # 快捷键管理命令 │ │ ├── services/ # 服务模块 │ │ │ ├── mod.rs # 服务模块导出 │ │ │ ├── file_shredder.rs # 文件粉碎服务 │ │ │ ├── file_compressor.rs # 文件压缩服务 │ │ │ ├── port_killer.rs # 端口管理服务 │ │ │ ├── context_menu.rs # 右键菜单服务 │ │ │ ├── app_settings.rs # 应用配置服务 │ │ │ └── vfox_cache.rs # vfox 缓存服务 │ │ └── utils/ # 工具函数 │ │ ├── mod.rs # 工具模块导出 │ │ └── command.rs # 命令执行工具 │ ├── build.rs # 构建脚本 │ ├── Cargo.toml # Rust 依赖配置 │ └── tauri.conf.json # Tauri 应用配置 ├── public/ # 静态资源 │ └── icon.svg # 应用图标 ├── docs/ # 文档目录 │ ├── api/ # API 文档 │ ├── design/ # 设计文档 │ ├── manual/ # 用户手册 │ ├── requirements/ # 需求文档 │ ├── tests/ # 测试文档 │ ├── reports/ # 报告汇总 │ │ ├── code-review/ # 代码审查报告 │ │ ├── verification/ # 验证报告 │ │ ├── tasks/ # 任务清单 │ │ ├── root-temp/ # 根目录临时报告 │ │ └── scripts/ # 脚本文件 │ └── images/ # 功能截图 │ ├── win-toolkit-home.jpg # 主页截图 │ ├── win-toolkit-port.jpg # 端口管理截图 │ └── win-toolkit-shredder.jpg # 文件粉碎截图 ├── package.json # Node.js 配置 ├── pnpm-lock.yaml # pnpm 锁文件 ├── tsconfig.json # TypeScript 配置 ├── tsconfig.node.json # Node TypeScript 配置 ├── tsconfig.optimized.json # 优化 TypeScript 配置 ├── vite.config.ts # Vite 配置 ├── README.md # 项目说明文档 ├── AGENTS.md # 项目上下文文档 ├── LICENSE # 许可证文件 ├── index.html # HTML 入口 ├── .gitignore # Git 忽略配置 ├── .cargo/ # Cargo 配置目录 │ └── config.toml # Cargo 配置 ├── .ruff_cache/ # Ruff 缓存目录 ├── dist/ # 构建输出目录 ├── node_modules/ # Node.js 依赖 └── temp/ # 临时文件目录 ``` --- ## 🔧 开发指南 ### CLI 模式 应用支持命令行参数直接执行功能： | 命令 | 功能 | 平台 | |------|------|------| | `SaManagement shred ` | 粉碎文件（显示输出） | 全平台 | | `SaManagement shred-silent ` | 粉碎文件（静默模式） | 全平台 | | `SaManagement compress ` | 压缩文件（显示输出） | 全平台 | | `SaManagement compress-silent ` | 压缩文件（静默模式） | 全平台 | | `SaManagement port` | 直接打开端口管理页 | 全平台 | | `SaManagement vfox` | 直接打开环境管理页 | 全平台 | | `SaManagement settings` | 直接打开设置页 | 全平台 | | `SaManagement view-text ` | 直接打开文本编辑器查看文件 | 全平台 | | `SaManagement --minimized` | 启动时最小化到托盘 | 全平台 | **路径解析**: 支持多文件路径解析（空格分隔，引号包裹） ### 代码规范 - **前端**：Vue 3 Composition API + `