🚀 快速开始

欢迎使用 绿驿管家！按照以下步骤，三分钟内即可开始使用：

第一步：首次配置

首次启动应用后，请前往"设置"页面进行基本配置：

  • 必须设置：绿色软件安装目录 - 这是存放所有软件解压后文件的根目录
  • 可选设置：软件归档目录 - 用于存放添加软件时上传的原始压缩包
  • 若不设置归档目录，则默认为安装目录下的 ~archives 文件夹

第二步：添加软件

有两种方式添加绿色软件：

  • 点击添加：点击主页"添加"按钮，选择压缩包或可执行文件
  • 拖拽添加：将文件直接拖拽到主界面即可

若解压后检测到多个可执行文件，会弹出"选择主程序"对话框供您选择。

第三步：启动软件

在主页上单击软件图标即可启动主程序，享受便捷的绿色软件管理体验！

📚 主要功能说明

软件管理

主页是软件管理中心，您可以：

  • 启动软件：单击软件项启动主程序
  • 备选启动：软件目录包含多程序时，可选择其他可执行文件启动
  • 打开位置：右键选择"打开软件文件夹"或"打开归档文件夹"
  • 创建备份：右键选择"创建备份"，为当前软件创建备份
  • 删除软件：点击"删除"图标，移除软件管理

批量扫描与归档

在主页的更多菜单中使用"扫描当前目录软件"：

  • 可选择是否为每个子目录创建备份 ZIP（默认创建）
  • 扫描结束后若发现"可关联的归档"，会进入"统一关联"对话框
  • 逐项选择要关联的归档或为未选择项创建备份
  • 扫描/归档过程有可视化进度与结果摘要

归档管理

在"归档管理"页面可执行以下操作：

  • 还原：从归档/备份进行安装（支持重复处理：备份现有、覆盖还原）
  • 手动关联：将某个归档/备份手动关联至已托管软件
  • 创建备份：为选定软件创建带时间戳的 ZIP 备份
  • 打开目录：打开归档/备份目录
  • 删除文件：删除归档或备份（删除备份会同步清除其关联）

视图与排序

绿驿管家 提供灵活的视图和排序选项：

  • 视图切换：点击视图按钮在列表/网格模式间切换
  • 拖拽排序：列表模式下可直接拖拽调整顺序
  • 批量调整：通过"调整软件顺序"对话框批量调整

⚙️ 配置说明

目录配置

  • 安装目录：绿色软件的根目录，扫描与解压的目标位置
  • 归档目录：默认使用安装目录下的 ~archives
  • 备份目录：归档目录下的 backup 子目录
  • 备份文件命名为 名称-YYYYMMDD_HHMMSS.zip

可执行文件识别

  • 最大搜索深度：配置搜索可执行文件的最大深度（默认：3 层）
  • 扩展名列表：配置识别的可执行文件扩展名（默认：exe, bat）
  • 添加/还原时，将在安装目录内扫描可执行文件
  • 单一结果自动选定，多个结果需手动选择

归档处理

  • 移除多余嵌套目录：选择"解压后移除多余嵌套目录"（默认开启）
  • 当压缩包内只有单个文件夹时，自动提取其内容到安装目录

外观设置

  • 字体选择：可选择应用字体（默认：Microsoft YaHei UI）

💾 数据与存储

配置存储

  • 应用配置保存在可执行文件同级的 data/app_data.json
  • 使用 app_data.lock 进行独占锁写入，避免并发覆盖

托管软件列表

  • 存放在"归档目录"根下的 software_list.json
  • 配套 software_list.lock 进行锁保护
  • 保存托管条目的 id/name/installPath/executablePath/archivePath/backupPath/sortOrder 等信息

运行时状态

  • 如"安装目录是否存在""是否为备份归档"等状态不会持久化
  • 仅用于 UI 呈现与交互判断

🔄 重复与冲突处理

添加/还原时若检测到与现有软件或文件路径冲突：

  • 重命名后添加：系统会提供安全的重命名建议
  • 覆盖现有：可先备份，再覆盖还原

🔁 重新托管

当安装目录丢失且仍有归档时：

  • 列表项会显示"重新托管"入口
  • 支持从归档恢复安装
  • 可处理重复冲突

❓ 常见问题

Q: 绿驿管家 支持哪些操作系统？

A: 绿驿管家 目前仅支持 Windows 桌面系统（Windows 10 或更高版本）。

Q: 支持哪些压缩包格式？

A: 支持 ZIP、TAR、7Z、RAR 等常见压缩格式。
（支持 RAR/7Z 等格式需自行安装 7-Zip）

Q: 如何备份我的软件配置？

A: 您可以备份以下文件： data/app_data.json（应用配置）和归档目录下的 software_list.json（托管列表）。

Q: 可以在虚拟机中运行吗？

A: 可以，绿驿管家 可以在 Windows 虚拟机中正常运行。

Q: 如何卸载 绿驿管家？

A: 由于是绿色软件，只需删除 CarryDock 文件夹即可。您的软件配置和数据会保留在原目录中。