sanqiPanax/jieyaTool

dsh-auto-extract（原 jieyaTool v2）

从 jieyaTool v1.0（GUI 手动改后缀解压）进化为 DSH 插件：对 Agent 说一句话，全自动批量递归解压。

一个 DeepSeek Harness (DSH) 自动解压插件。解决「一次性下载几十个压缩包、后缀被改、多层嵌套、每层密码不同、带分卷/SFX」的批量解压痛点——零人工右键、零手动选后缀。

🎬 演示

真实执行记录（非摆拍）：

演示

完整视频: dist/演示.mp4

✨ 核心能力

| 能力 | 说明 |
|---|---|
| 🧬 魔数识别真实格式 | 不信扩展名。伪装成 .jpg / .mp4 / .7z删除 / .7删除z / .是7z / 无后缀,按文件头判断真实格式(7z/rar/zip/gz/xz/sfx) |
| 🔍 exe 智能探测 | 用 7-Zip 探测 exe 是否为 SFX 自解压;Type=PE 的普通程序 exe(游戏成品)绝不误解压 |
| 🔁 递归下钻 | 解出的新压缩包自动入队继续解,直到不再产出压缩包(实测 4 层套娃全自动) |
| 🔑 多密码自动尝试 | 全局密码文件(每行一个)+ 动态密码:解出内容出现「第二层密码:xxx」(目录名/文件名/txt)自动学习用于后续层;顺序=动态→全局→空 |
| 📦 SFX/分卷处理 | .part2.rar/.002/.r00 等附属卷自动跳过,由主卷(.part1.exe/.001)带出;成功解压的中间压缩包自动清理 |
| 🛡️ 安全 | 输出到源目录旁 _extracted,原始文件只读不动;解压先进临时目录,失败只清临时目录;工具运行库目录(gameSaveBackup/node_modules/locales)自动跳过防误递归 |
| 🚫 私有格式归类 | 7z/WinRAR 都不识别的自定义封装(如 RC-SFX .sfxv)识别为普通文件不动,不误删不卡死 |

🚀 安装

本地开发安装(file 指向仓库目录)
cd ~/.dsh/profiles/web
package.json 的 dependencies 加:
"dsh-auto-extract": "file:F:/ownWork/jieyaTool"
dsh.profile.bundles 加:
"dsh-auto-extract"
pnpm install

重启 dsh 生效

🎮 使用(对 Agent 说一句即可)

用户: 我下载了一堆包在 E:\downloads\batch1,后缀都乱七八糟,密码在 secret.txt 里,帮我全解了
Agent: auto_extract_run(sourceDir="E:\downloads\batch1", secretFile="E:\downloads\batch1\secret.txt")

🛠 工具

| 工具 | 作用 |
|---|---|
| auto_extract_run | 批量递归解压一个目录(核心) |
| auto_extract_probe | 识别单文件真实格式(是压缩包还是普通文件) |
| auto_extract_status | 检查 7-Zip 环境 |

📊 实战验证

两个真实测试场全自动解压,0 人工干预:

E:\Hgame\39(5/6 链):
- 22222.7z删除 → 3 层 7z 套娃 → hero_legend.exe 游戏
- 飞天小女警.jpg(伪装)→ Kendo.exe 游戏
- Over·Empir(无后缀)→ Game.exe 游戏(5.2GB)
- C097999.jpg(伪装 Rar5)→ 魔術師『恵』游戏
- AL2695.sfx.part1+2(RAR5 SFX 分卷)→ 自动发现「白菜」动态密码 → Goodbye_Eternity 游戏

E:\Hgame\40(6/6 链,12 个压缩包):
- 87.7z删 → 2 层 → C157000 Game.exe(跳过 MTool 存档目录)
- 黑手.7删除z → 多层 → 被黑手浸染的玫瑰与百合 Game.exe
- 神之血.txt(伪装 rar)→ The Blood of Yidhra.exe(4.1GB)
- C142666_分卷(part1-3)→ zip→rar→zip 4 层套娃 → ウミノイエ Game.exe
- Guilty Hell Ⅱ_2.是7z → GuiltyHell2_alpha.exe(12.6GB)
- PCC153444.7z → 私の雇い主は変態店長 Game.exe

📁 结构

jieyaTool/
├── package.json          ← 插件清单(dsh.bundle.patch)
├── cordis.patch.yml      ← bundle 激活行
├── lib/
│   ├── index.js          ← 插件壳(注册 auto_extract_* 工具)
│   └── archive-core.js   ← 纯 Node 解压引擎(无第三方依赖)
└── README.md

⚙️ 依赖

- Node ≥ 18
- 7-Zip(自动探测 C:\Program Files\7-Zip\7z.exe / E:\7-Zip\7z.exe 等,或设 SEVENZIP_PATH)

🧩 与 v1.0 对比

| | jieyaTool v1.0(GUI) | 本插件 v2.0 |
|---|---|---|
| 识别格式 | 手动选后缀强制改名 | 魔数自动识别(伪装/无后缀都行) |
| 嵌套 | 单层 | 自动递归到尽头 |
| 密码 | 单密码记忆 | 多密码列表 + 层内动态发现 |
| 分卷 | 手动 | 自动配对跳过附属卷 |
| SFX | 不支持 | 自动探测(排除成品 exe) |
| 调用方式 | 手动拖文件 | 对 Agent 说一句即可 |

⚠️ 已知边界

- 私有自解压格式(RC 自定义 SFX、.sfxv 加密分卷)7-Zip 不识别,无法命令行自动化,需双击 exe 图形解压
- 需本机装 7-Zip