suipian 1.0.1

SuiPian (碎片) - File disguise and restoration tool, hide files in plain sight

SuiPian (碎片)

File disguise and restoration tool - hide files in plain sight.

将任意文件拆散伪装成看似普通的文本文件，再用密码还原。

Features

• Hide: Embed any file (images, documents, etc.) inside a seemingly normal text file
• Reveal: Restore a hidden file from a morphed file using the password
• Validate: Check if a file is a valid morphed file
• Info: Get metadata about a morphed file

Requirements

• Python 3.10+
• lz4
• cryptography

Installation

pip install suipian

Or install from source:

pip install -e .

Quick Start

CLI

Hide a file:

suipian hide image.png readme.txt -o output.txt -p mypassword

Reveal a hidden file:

suipian reveal output.txt -o restored.png -p mypassword

Validate a morphed file:

suipian validate output.txt

Get info:

suipian info output.txt

Python API

from suipian import hide_file, reveal_file, validate_morph

result = hide_file(
    source="image.png",
    carrier="readme.txt",
    output="output.txt",
    password="secret"
)

result = reveal_file(
    morphed="output.txt",
    output="restored.png",
    password="secret"
)

result = validate_morph(file="output.txt")
print(result.success)
print(result.data)

Agent Integration

from suipian.tools import TOOLS, dispatch

Development

pip install -e ".[dev]"
pytest tests/test_unified_api.py -v

License

GPL-3.0