ZipCracker

**Summary:** Major refactor with new wrapper, expanded documentation, improved workflows, and added attack references. - Added `scripts/openclaw_zipcracker.py` as the preferred engine wrapper, superseding raw script calls. - Introduced extensive reference documentation and attack playbooks under `/references`. - Reworked documentation for clearer workflow guidance, usage scenarios, and decision trees. - Detailed new command-line flags and attack strategies, including CRC32, mask, template KPA, and `bkcrack` integrations. - Deprecated old main scripts and flattened legacy usage in favor of the OpenClaw skill wrapper. - Expanded multilingual trigger phrases and CTF challenge coverage.

🌟 ZipCracker V2.0.0 (Agent-Native Edition) Author: asaotomo (Hx0 Team) This major release transforms ZipCracker from a standard CLI tool into a fully autonomous, Agent-ready weapon natively integrated with the OpenClaw ecosystem. 🤖 AI Agent Integration [New] Quiet/Agent Mode (-q): Suppresses real-time progress bars and terminal noise to prevent LLM token overflow and support CI/CD pipelines. [New] Tactical SKILL.md: Empowers OpenClaw Agents to autonomously request OSINT clues from users and dynamically generate custom social engineering dictionaries on the fly. [Changed] Zero-Interaction Execution: Completely removed all blocking input(y/n) prompts to ensure seamless, headless automation. ⚡ Engine Enhancements [Enhanced] Auto CRC32 Collision: Instantly and silently cracks small files (<= 6 bytes) without halting the cracking pipeline. [New] AES Auto-Healing: Dynamically detects AES encryption and missing pyzipper dependencies, automatically executing pip install in the background to prevent script failure. 📝 Structure & Docs [Changed] Unified Naming: Simplified the core script name to ZipCracker.py. [Updated] Global README: Added OpenClaw integration notes and detailed mask attack documentation.

**Changelog for zipcracker v1.1.4** - Migrated documentation format: replaced detailed Chinese SKILL.md with an English, OpenClaw-standard YAML/Markdown file. - Updated all usage examples and instructions to reference ZipCracker.py (renaming from zipcracker.py). - Removed legacy install, registration, and extra documentation files (install.sh, requirements.txt, clawhub.json, QUICKSTART.md). - Clarified attack modes, usage patterns, and response expectations for both users and assistants.## Description Hi OpenClaw Team! 👋 This PR introduces **ZipCracker**, a powerful, multi-threaded ZIP password cracking tool developed by the Hx0 Team (Author: asaotomo). By adding this skill, OpenClaw Agents will now have the native ability to automatically analyze, repair, and crack password-protected `.zip` files through natural language commands—making it an incredibly useful tool for security researchers, CTF players, and everyday users who forgot their archive passwords. ## Key Features * **Auto-Repair Pseudo-Encryption:** Automatically detects and fixes pseudo-encrypted ZIP files without needing a password. * **Smart Dictionary Attacks:** Supports custom dictionary files, directories, and falls back to a built-in 1-6 digit numeric generator. * **Advanced Mask Attacks:** Allows users to specify password patterns (e.g., `?d?d?d?l` for 3 digits + 1 lowercase) to drastically reduce cracking time. * **CRC32 Collision:** Automatically attempts hash collisions for extremely small files (< 6 bytes) hidden inside the archive. * **AES Support:** Fully supports modern AES-encrypted ZIPs (if `pyzipper` is installed). ## 🤖 Optimizations for OpenClaw Agent To ensure this tool plays perfectly with LLM context windows, I have specifically added a **Quiet/Agent Mode (`-q` flag)**. * When the Agent calls the script, it will suppress the real-time progress bar (`\r` loops) and interactive `(y/n)` prompts. * It outputs strictly what the Agent needs to read: the final success status and the cracked password, preventing any token overflow or context degradation. ## Example Prompts for Testing Once loaded, you can test the Agent with prompts like: > *"I have an encrypted file named `flag.zip`. The password is exactly 4 digits. Please use ZipCracker to unlock it for me."* > *"Agent, use a mask attack on `secret.zip`. The password starts with 'admin' followed by 3 numbers."* ## Checklist - [x] Tested locally with OpenClaw. - [x] Included `SKILL.md` with clear instructions for the Agent. - [x] Updated `README.md` to reflect Agent usage (`-q` flag). - [x] Code does not contain any malicious payloads. Looking forward to seeing this in the official ClawHub! Let me know if any adjustments are needed.

## ZipCracker Skill v1.1.3 - No file changes detected in this release. - Functionality, documentation, and behavior remain the same as the previous version (v1.1.1).

- 移除 _meta.json 文件，精简了技能元数据文件结构 - 其他功能与文档保持不变

v1.1.1 重点：适配 OpenClaw Agent、支持标准 JSON 输出。 - 新增 `--agent` 参数，专为 OpenClaw Agent 设计，支持静默后台执行与结构化 JSON 结果输出 - 移除命令行阻塞操作，实现无交互自动化 - 优化安装注册流程，完善技能元数据文件 - 文档更新，新增 OpenClaw 智能助手应用指引

ZipCracker Skill 1.0.0 - 初始版本发布，基于 Hx0 战队 ZipCracker v1.0 项目适配 - 集成 OpenClaw Skill 平台 - 支持伪加密检测修复、字典攻击、CRC32 碰撞、掩码攻击和 AES 加密破解 - 增强多线程性能，自动智能线程调整 - 优化用户交互和字典管理