
Execute código ARM64 preservado no Node ou em um navegador; inspecione pixels de imagens decodificadas e memória inicializada.
Execute código nativo preservado. Reabra seu estado inicializado. O Capsulith empacota funções ARM64 selecionadas, seus contratos de chamada e memória própria para Node ou para o navegador. Mantenha as instruções originais e retome um objeto inicializado em um novo worker, sem a aplicação original.
Abra o workbench de imagens nativas e escolha Load & run example. O caso QOI preparado é executado localmente sem conta, servidor de upload, binário original ou compilador.

O PNG usa RGBA decodificado pelo navegador como linha de base explícita de comparação; a entrada apenas QOI não tem comparação independente de pixels de origem. As imagens são limitadas a 256 pixels por dimensão e 1 MiB. Esta é uma demonstração de componente nativo preparado com fonte conhecida, não um novo codec nem recuperação universal de formato. Código-fonte original do QOI, contratos, controles nativos/FFmpeg independentes e comandos Node autônomos.
Traga uma pequena imagem PNG ou QOI. O codificador original extraído grava um arquivo QOI, um decodificador nativo separado retorna seus pixels, e você pode inspecionar bytes RGBA individuais. Preserve a alocação de pixels inicializada, feche o worker e então restaure e libere-a em um novo worker.
Experimente a demonstração de objeto no navegador sem chave e pressione Run lifecycle. Ela executa as instruções extraídas reais localmente; não chama um servidor para gerar resultados.
Baixe o wheel Python na release, então:
python3 -m pip install capsulith-0.3.1-py3-none-any.whl
capsulith studio
Abra http://127.0.0.1:6359. A função Studio mantém o decodificador LZ4 e os espécimes xxHash. Abra Object studio, escolha Open original LZ4 example e depois Run lifecycle para criar, comprimir, salvar um dicionário, criar checkpoint, restaurar, continuar e liberar um stream compilado real. Nenhuma chave de API ou serviço pago é necessário. Python 3.10+ e Capstone são necessários para extração; o navegador executa através do emulador WebAssembly incluído. Node 20+ é necessário apenas para CLI ou chamadas Node exportadas.
O Studio aceita uma dylib Mach-O ARM64, inventaria suas funções, extrai uma raiz selecionada e permite editar buffers, argumentos de registro, entradas escalares e tipo de retorno. A visualização de dependências conecta helpers/imports aos locais de chamada reais e às instruções originais. Eventos de execução vinculam-se à região de memória nomeada e ao código original. Execuções interrompidas mostram evidência parcial sem uma alegação de resultado bem-sucedido.
Export portable capsule baixa os bytes atuais, contrato e entradas, runners Node/browser, backend fixado, código-fonte completo do backend/scripts de build e licenças. Descompacte e execute node run.cjs, ou sirva essa pasta via HTTP e abra seu runner de navegador independente. Python, Capstone e o binário original são desnecessários para essas chamadas. A API exportada aceita entradas diferentes, suporta cancelamento e impõe os limites declarados.
Original LZ4 methods, restored dictionary access and exact native comparison in the object Studio
O object Studio importa JSON de módulo extraído ou lê seu artefato Mach-O ARM64 próprio com métodos nomeados explicitamente declarados. Inspecione as raízes, chunks e dependências reais; aloque buffers de chamador nomeados a partir de hex ou de um arquivo local; escolha um método e forneça referências de região tipadas ou inteiros. O mapa de memória mostra regiões reais próprias e inicialização, com bytes brutos opacos em vez de campos adivinhados. Retornos, intervalos de acesso, contadores e eventos limitados vêm das instruções originais.
Salve um checkpoint antes de uma operação que você possa precisar desfazer. Restaurar um módulo correspondente preserva endereços de guest e IDs de região, mas cria uma nova identidade de instância; re-vincule referências por ID de região. Editar entradas revoga evidências obsoletas, e uma falha ou cancelamento requer um checkpoint anterior ou uma nova instância. A liberação nativa e a liberação de buffer do chamador são operações de ciclo de vida explícitas e separadas. O runtime nunca adivinha se ponteiros nativos ainda se referem a um buffer.
O exemplo de CLI usa arquivos do repositório. A instalação do wheel acima não coloca examples/ ou runtime/ no seu diretório de trabalho. A partir de um diretório sem uma pasta Capsulith existente, clone o repositório e execute os comandos a partir de sua raiz:
git clone https://github.com/nazeeh111/Capsulith.git
cd Capsulith
capsulith module examples/lz4/liblz4.dylib \
--methods examples/native-objects/methods.json --out stream.module.json
node runtime/object-cli.cjs examples/native-objects/start.json \
--module stream.module.json --checkpoint-out first.checkpoint.json
# The first Node process has ended. This command opens a fresh worker.
node runtime/object-cli.cjs examples/native-objects/continue.json \
--module stream.module.json --checkpoint first.checkpoint.json
capsulith export-module stream.module.json \
--checkpoint first.checkpoint.json --out stream-object.zip
Escolha novos nomes de saída; os comandos de exportação de módulo, checkpoint e objeto recusam-se a sobrescrever ficheiros existentes. Os programas de operação fornecidos são específicos do ciclo de vida documentado do LZ4. Os módulos genéricos necessitam dos seus próprios métodos declarados pelo chamador e programas de operação.
Uma exportação de objeto contém o módulo de instruções original, bytes de checkpoint retidos opcionais, runners independentes para Node/browser, o Studio do objeto, o runtime e os scripts de compilação/fonte do backend correspondente, licenças e um manifesto de ficheiros com bytes, SHA256 e permissões. Sirva a pasta e abra index.html para restaurar o checkpoint incluído sem endpoints de API, ou execute node run.cjs your-operations.json --checkpoint checkpoint.json. Binários originais, pacotes Python e compiladores são desnecessários para a execução. Um checkpoint inclui bytes retidos do chamador; inspecione-os antes de partilhar. Consulte a API de objetos e o formato de operação e o exemplo nativo.
Um descodificador legado, checksum ou rotina binária isolada pode tornar-se numa pequena API reutilizável. O Capsulith mostra quais bytes e dependências viajam com ele, onde a execução lê e escreve, e porque é que uma funcionalidade não pode ser extraída quando requer estado não suportado.
capsulith inspect legacy.dylib
capsulith extract legacy.dylib --root _decode \
--contract decode-contract.json --out decode.capsule.json
capsulith run decode.capsule.json --inputs input.json
capsulith export decode.capsule.json --inputs input.json --out decoder.zip