字典解密助手ArchiveHelperWpfv1.0.12详细使用说明书
ArchiveHelperWpf 使用说明
经过不懈努力，终于完成比较实用的版本，支持了更多的格式，分卷，自解压，这里呈现详细使用说明书。
本文档详细介绍 ArchiveHelperWpf 的功能、按钮、右键菜单、设置项、交互细节与常见问题，方便你快速上手与查阅。
概览
- 目标：批量测试/解压压缩包，提供高效的密码尝试与解压流程。
- 特点：
- 支持拖拽/粘贴添加任务。
- 批量“直接解压”统一确认与并发处理。
- 非侵入式总体进度显示在 Windows 任务栏。
- 解压仅使用 7z.exe；密码校验使用库进行快速验证。
- 右键“使用 WinRAR 打开”，便于手动处理特殊场景。
安装与运行
- Windows 平台，.NET 8 桌面环境。
- 解压发布包后，直接运行
ArchiveHelperWpf.exe。 - 首次运行自动创建配置文件（
AppConfig），并保存窗口大小等偏好。
主窗口布局与基本操作
- 窗口包含三个核心区块：
- 任务列表 DataGrid（名称：
TaskGrid） - 日志区（查看过程信息）
- 工具按钮/菜单（顶部或上下文菜单）
- 任务列表 DataGrid（名称：
添加任务
- 拖拽文件/文件夹到窗口。
- 通过剪贴板粘贴路径：
- 窗口激活且非文本输入框聚焦时，按 Ctrl+V 即可添加路径。
- 任务可能来自“添加文件/目录”菜单（若你的版本包含）。
双击行为
- 在任务列表内双击：
- 自动“重试所有非成功任务”，并立即执行开始（Start）。
- 用于快速重跑剩余失败项。
工具栏按钮与动作（示例）
- 开始：启动处理队列：测试/解压等操作。
- 暂停/继续：运行中可暂停，暂停后可继续。
- 停止：终止当前进行中的任务（尽量有序停止）。
- 重试失败（原引擎）：将失败任务按“原始引擎策略”重试一次。
- 再次解压全部：针对已存在解压目标的二次处理流程。
注：实际按钮命名或布局可能略有差异，请以界面为准。多数操作在任务项右键菜单也可找到等效入口。
任务列表右键菜单
- 删除选中：从队列中移除任务（不删除磁盘文件）。
- 打开所在目录：打开该任务对应文件所在文件夹。
- 使用 WinRAR 打开：
- 直接用 WinRAR 打开所选压缩文件。
- 首次会自动检测
winrar.exe（注册表、Program Files 常见路径、PATH）。 - 未找到时会弹出文件选择对话框让你手动指定；路径保存到配置
WinRARPath。 - 多选时会为每个文件分别启动一个 WinRAR 进程（避免被 WinRAR 识别为“新建压缩”）。
- 直接解压：
- 无需密码（快捷键 Alt+E）
- 使用剪贴板密码（快捷键 Alt+B）
- 使用自定义密码（弹出输入框）
- 多选时：
- 统一弹出一次确认（如目标目录、是否删除源文件/临时文件等）。
- 之后并发处理所有选中任务，减少弹窗干扰、提升效率。
解压流程与确认策略
- 输出目录在你点击“解压确认”后即时获取，若不存在会自动创建。
- 解压后“删除源文件/删除临时文件”均需要弹窗确认，默认不会自动删除。
- 删除空父目录（若已空）会自动执行，无需再次确认。
- 任务栏总体进度会根据所有任务整体完成度动态更新，避免与列表/标题栏 UI 竞争。
密码与校验
- 密码校验使用库进行快速验证，避免频繁落盘。
- 提供“使用剪贴板密码”“使用自定义密码”的直接解压路径，便于快速尝试。
- 密码字典管理：
- 支持“临时密码”与“永久密码”集合。
- UI 会将两者联合显示，新增永久项时做焦点保护，避免编辑被刷新打断。
- ZIP SFX（自解压）等特殊格式也支持快速打开/校验（内部已做分流，无需用户关心实现细节）。
设置（Settings）
打开设置窗口（Views/SettingsDialog.xaml）可配置以下项目（不同版本可能略有差异）：
- 使用统一 UI 更新逻辑（
UseUnifiedUiUpdates，默认：关闭）- 切换 UI/日志刷新模式，以适配不同设备和列表规模的性能表现。
- 关闭：采用原有逻辑；开启：采用统一更新策略。
- 弹窗父窗口确保（Owner）（
EnsureDialogOwner，默认：关闭）- 让弹窗绑定到当前活跃/主窗口，提升前台聚焦一致性，避免遮挡。
- 7z -t7z 回退尝试（
EnableT7zFallback，默认：关闭）- 当一次 7z 调用失败时，自动切换一次
-t7z参数重试。 - 仅回退一次，避免死循环。
- 当一次 7z 调用失败时，自动切换一次
- WinRAR 路径（
WinRARPath）- 供“右键 → 使用 WinRAR 打开”使用。
- 首次自动探测；也可在此手动查看/修改。
- 启动与窗口偏好
- 启动居中（
LaunchCentered）：窗口加载后居中到当前工作区。 - 窗口大小记忆（
WindowWidth/WindowHeight）：关闭前记录下次还原（仅在非最大化时写入）。
- 启动居中（
设置变更会保存到配置（ConfigService.Save），重启后继续生效。
快捷键
- 任务列表内：
- 双击：重试所有“非成功”任务并立即启动。
- 窗口激活且非文本输入聚焦时：
- Ctrl+V：将剪贴板中的文件/文件夹路径添加为任务。
- 右键菜单（直接解压）：
- Alt+E：“无需密码”直接解压。
- Alt+B：“使用剪贴板密码”直接解压。
日志与状态
- 窗口标题根据运行/暂停状态动态显示“（运行中）/（已暂停）”。
- 日志区展示每个任务的关键步骤与错误信息。
- Windows 任务栏显示“总体进度”。
与外部工具的关系
- 解压：仅使用
7z.exe。 - “使用 WinRAR 打开”：仅负责启动 WinRAR，后续操作完全由 WinRAR 手动处理。
- 7z 类型回退：可选开启
EnableT7zFallback，降低格式识别误差的影响。
常见问题（FAQ）
- 多选“使用 WinRAR 打开”为何会弹出多个 WinRAR？
- 设计如此。WinRAR 对多个参数可能触发“新建压缩”。为确保“打开查看”预期，故多选时逐文件分别启动。
- 首次“使用 WinRAR 打开”提示找不到 winrar.exe？
- 在弹出的文件选择框中指定正确路径。成功选择后会保存到
WinRARPath，下次无需重复。
- 在弹出的文件选择框中指定正确路径。成功选择后会保存到
- 为什么会询问是否删除源文件/临时文件？
- 防止误删；删除空父目录会自动执行，无需确认。
- 任务栏进度不显示？
- 确认系统为 Windows 7+ 且未禁用任务栏进度。若仍异常，请反馈日志。
使用建议
- 大批量任务优先使用“直接解压”中的批量路径，减少弹窗、提升效率。
- 固定密码建议放入“永久密码”，临时尝试放入“临时密码”，方便管理。
- 对疑难格式可尝试在设置中开启
EnableT7zFallback。
版本要点
- v1.0.11：新增任务栏总体进度、-t7z 回退尝试、WinRAR 右键打开（首次集成）。
- v1.0.12：修复多选“使用 WinRAR 打开”误进入“压缩”的问题，改为逐文件分别启动。
需要软件的可以留言或者私信我取得联系，注意不免费。
反馈与支持
- 如遇崩溃或异常，请提供错误提示、日志片段与复现步骤。
- 欢迎提出优化建议（并发策略、UI 行为、更多快捷操作等）。