From f186b71ca51e83837db60de13322394bb5e6d348 Mon Sep 17 00:00:00 2001 From: murilo ijanc Date: Tue, 24 Mar 2026 21:41:06 -0300 Subject: Initial commit Import existing tesseras.net website content. --- book/pt-br/commands/create.html | 329 +++++++++++++++++++++++++++++++++++++ book/pt-br/commands/create.html.gz | Bin 0 -> 7281 bytes book/pt-br/commands/export.html | 307 ++++++++++++++++++++++++++++++++++ book/pt-br/commands/export.html.gz | Bin 0 -> 7162 bytes book/pt-br/commands/init.html | 288 ++++++++++++++++++++++++++++++++ book/pt-br/commands/init.html.gz | Bin 0 -> 6653 bytes book/pt-br/commands/list.html | 283 +++++++++++++++++++++++++++++++ book/pt-br/commands/list.html.gz | Bin 0 -> 6480 bytes book/pt-br/commands/verify.html | 307 ++++++++++++++++++++++++++++++++++ book/pt-br/commands/verify.html.gz | Bin 0 -> 6795 bytes 10 files changed, 1514 insertions(+) create mode 100644 book/pt-br/commands/create.html create mode 100644 book/pt-br/commands/create.html.gz create mode 100644 book/pt-br/commands/export.html create mode 100644 book/pt-br/commands/export.html.gz create mode 100644 book/pt-br/commands/init.html create mode 100644 book/pt-br/commands/init.html.gz create mode 100644 book/pt-br/commands/list.html create mode 100644 book/pt-br/commands/list.html.gz create mode 100644 book/pt-br/commands/verify.html create mode 100644 book/pt-br/commands/verify.html.gz (limited to 'book/pt-br/commands') diff --git a/book/pt-br/commands/create.html b/book/pt-br/commands/create.html new file mode 100644 index 0000000..992c33d --- /dev/null +++ b/book/pt-br/commands/create.html @@ -0,0 +1,329 @@ + + + + + + create - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes create

+

Criar uma tessera a partir de um diretório de arquivos.

+

Uso

+
tes create <CAMINHO> [OPÇÕES]
+
+

Argumentos

+
+ + + + + + + +
ArgumentoDescrição
<CAMINHO>Diretório contendo os arquivos a incluir
+
+

Opções

+
+ + + + + + + + + + + + + +
OpçãoDescriçãoPadrão
-n, --non-interactivePular promptsdesativado
--dry-runPré-visualizar o que seria incluídodesativado
--visibility <VALOR>Nível de visibilidade: public, private, circlepublic
--language <CÓDIGO>Código de idioma (ex.: en, pt-BR)en
--tags <LISTA>Tags separadas por vírgulanenhuma
--location <DESC>Descrição do localnenhuma
--data-dir <CAMINHO>Diretório base para armazenamento de dados~/.tesseras
+
+

Formatos de arquivo suportados

+
+ + + + + + + + + + + +
ExtensãoTipoTipo de memória
.jpg, .jpegImagem (JPEG)Momento
.pngImagem (PNG)Momento
.wavÁudio (WAV PCM)Momento
.webmVídeo (WebM)Momento
.txtTexto puro (UTF-8)Reflexão
+
+

Arquivos com outras extensões são ignorados.

+

Inferência de tipo de memória

+

O comando atribui automaticamente um tipo de memória baseado no formato do arquivo:

+
    +
  • Arquivos de texto (.txt) são classificados como Reflexão — pensamentos, crenças ou opiniões
    • +
  • Todos os outros formatos são classificados como Momento — uma foto, gravação ou vídeo de algo acontecendo
    • +
+

Exemplos

+

Pré-visualizar antes de criar

+
tes create ./minhas-fotos --dry-run
+
+

Criar com metadados

+
tes create ./ferias-2026 \
+    --tags "ferias,verao,praia" \
+    --location "Florianópolis, Brasil" \
+    --language pt-BR \
+    --visibility public
+
+

Modo não-interativo

+
tes create ./diario --non-interactive --tags "cotidiano"
+
+

Níveis de visibilidade

+
+ + + + + + + + + +
NívelQuem pode acessar
publicQualquer pessoa (padrão)
privateApenas você (e herdeiros designados)
circlePessoas explicitamente escolhidas
+
+

O que acontece internamente

+
    +
  1. Varre o diretório em busca de arquivos suportados
    2. +
  2. Calcula um hash BLAKE3 para cada arquivo
    3. +
  3. Atribui um tipo de memória baseado na extensão do arquivo
    4. +
  4. Gera um MANIFEST listando todos os arquivos com seus checksums
    5. +
  5. Assina o MANIFEST com sua chave privada Ed25519
    6. +
  6. Armazena os arquivos e metadados no banco de dados local
    7. +
  7. Exibe o hash de conteúdo que identifica unicamente esta tessera
    8. +
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + diff --git a/book/pt-br/commands/create.html.gz b/book/pt-br/commands/create.html.gz new file mode 100644 index 0000000..ec31381 Binary files /dev/null and b/book/pt-br/commands/create.html.gz differ diff --git a/book/pt-br/commands/export.html b/book/pt-br/commands/export.html new file mode 100644 index 0000000..3a74307 --- /dev/null +++ b/book/pt-br/commands/export.html @@ -0,0 +1,307 @@ + + + + + + export - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes export

+

Exportar uma tessera como um diretório autocontido.

+

Uso

+
tes export <HASH> <DESTINO>
+
+

Argumentos

+
+ + + + + + + + +
ArgumentoDescrição
<HASH>Hash de conteúdo da tessera (64 caracteres hexadecimais)
<DESTINO>Diretório de destino
+
+

Opções

+
+ + + + + + + +
OpçãoDescrição
--data-dir <CAMINHO>Diretório base para armazenamento de dados (padrão: ~/.tesseras)
+
+

Estrutura de saída

+

A exportação cria um diretório chamado tessera-<hash> dentro do destino:

+
tessera-9f2c4a1b.../
+├── MANIFEST                    # Índice em texto puro com checksums
+├── README.decode               # Instruções de decodificação legíveis por humanos
+├── identity/
+│   ├── creator.pub.ed25519     # Chave pública do criador
+│   └── signature.ed25519.sig   # Assinatura do MANIFEST
+├── memories/
+│   ├── <hash-conteudo>/
+│   │   ├── media.jpg           # Arquivo de mídia principal
+│   │   ├── context.txt         # Contexto humano em UTF-8 puro
+│   │   └── meta.json           # Metadados estruturados
+│   └── .../
+├── schema/
+│   └── v1.json                 # Esquema JSON para validação de metadados
+└── decode/
+    ├── formats.txt             # Explicação de todos os formatos usados
+    ├── jpeg.txt                # Como decodificar JPEG
+    ├── wav.txt                 # Como decodificar WAV
+    └── json.txt                # Como decodificar JSON
+
+

Exemplo

+
tes export 9f2c4a1b3e7d8f0cabc123def4567890... ./backup
+
+
Exported to ./backup/tessera-9f2c4a1b3e7d8f0cabc123def4567890...
+
+

Característica principal: autocontido

+

O diretório exportado é projetado para ser legível sem o software Tesseras. Ele inclui:

+
    +
  • MANIFEST — um arquivo em texto puro listando cada arquivo com seu checksum BLAKE3, legível por qualquer editor de texto
    • +
  • README.decode — instruções legíveis por humanos para compreender o conteúdo
    • +
  • decode/ — explicações detalhadas de cada formato de arquivo usado (JPEG, WAV, JSON, UTF-8)
    • +
+

Isso significa que alguém daqui a milhares de anos, sem conhecimento algum sobre o Tesseras, ainda pode entender e acessar as memórias.

+

Casos de uso

+
    +
  • Backup — exporte para um disco externo, pendrive ou armazenamento em nuvem
    • +
  • Compartilhamento — entregue a alguém uma cópia completa de uma tessera
    • +
  • Arquivamento — armazene em mídia de escrita única (DVD, Blu-ray, fita)
    • +
  • Migração — mova tesseras entre máquinas sem precisar do banco de dados
    • +
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + diff --git a/book/pt-br/commands/export.html.gz b/book/pt-br/commands/export.html.gz new file mode 100644 index 0000000..f46f7e5 Binary files /dev/null and b/book/pt-br/commands/export.html.gz differ diff --git a/book/pt-br/commands/init.html b/book/pt-br/commands/init.html new file mode 100644 index 0000000..1c6a1c9 --- /dev/null +++ b/book/pt-br/commands/init.html @@ -0,0 +1,288 @@ + + + + + + init - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes init

+

Inicializar identidade e banco de dados local.

+

Uso

+
tes init
+
+

Descrição

+

Configura seu ambiente Tesseras local. Este é o primeiro comando que você deve executar após instalar o Tesseras.

+

O comando cria:

+
+ + + + + + + + + + +
CaminhoConteúdo
~/.tesseras/identity/Par de chaves Ed25519 para assinar tesseras
~/.tesseras/db/Banco de dados SQLite para indexação
~/.tesseras/blobs/Armazenamento de blobs para arquivos de memória
~/.tesseras/config.tomlArquivo de configuração
+
+

Opções

+
+ + + + + + + +
OpçãoDescrição
--data-dir <CAMINHO>Diretório base para armazenamento de dados (padrão: ~/.tesseras)
+
+

Idempotente

+

Executar init novamente é seguro. Se uma identidade já existe, ela é preservada:

+
tes init
+
+
Ed25519 identity already exists
+Database initialized
+Tesseras initialized at /home/user/.tesseras
+
+

Diretório de dados personalizado

+
tes --data-dir /mnt/usb/tesseras init
+
+

Isso cria toda a estrutura de diretórios em /mnt/usb/tesseras/ ao invés do local padrão.

+

O que acontece internamente

+
    +
  1. Cria a estrutura de diretórios (identity/, db/, blobs/)
    2. +
  2. Gera um par de chaves Ed25519 (a chave privada permanece local, a chave pública identifica você)
    3. +
  3. Executa as migrações SQLite para configurar o esquema do banco de dados
    4. +
  4. Escreve um config.toml padrão
    5. +
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + diff --git a/book/pt-br/commands/init.html.gz b/book/pt-br/commands/init.html.gz new file mode 100644 index 0000000..71a0cf6 Binary files /dev/null and b/book/pt-br/commands/init.html.gz differ diff --git a/book/pt-br/commands/list.html b/book/pt-br/commands/list.html new file mode 100644 index 0000000..dd85099 --- /dev/null +++ b/book/pt-br/commands/list.html @@ -0,0 +1,283 @@ + + + + + + list - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes list

+

Listar todas as tesseras locais.

+

Uso

+
tes list
+
+

Opções

+
+ + + + + + + +
OpçãoDescrição
--data-dir <CAMINHO>Diretório base para armazenamento de dados (padrão: ~/.tesseras)
+
+

Saída

+

Exibe uma tabela com as seguintes colunas:

+
+ + + + + + + + + + + +
ColunaDescrição
HashPrimeiros 16 caracteres do hash de conteúdo
CreatedData de criação (AAAA-MM-DD)
MemoriesNúmero de memórias na tessera
SizeTamanho total (B, KB, MB ou GB)
VisibilityNível de visibilidade (public, private ou circle)
+
+

Exemplo

+
tes list
+
+
Hash             Created     Memories  Size    Visibility
+9f2c4a1b3e7d8f0c 2026-02-14         3  284 KB  public
+a3b7c2d9e4f01823 2026-02-10         1   12 KB  private
+f8e7d6c5b4a39201 2026-01-28        12    4 MB  public
+
+

Banco de dados vazio

+

Se nenhuma tessera foi criada ainda:

+
tes list
+
+
No tesseras found.
+
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + diff --git a/book/pt-br/commands/list.html.gz b/book/pt-br/commands/list.html.gz new file mode 100644 index 0000000..f94f885 Binary files /dev/null and b/book/pt-br/commands/list.html.gz differ diff --git a/book/pt-br/commands/verify.html b/book/pt-br/commands/verify.html new file mode 100644 index 0000000..b340413 --- /dev/null +++ b/book/pt-br/commands/verify.html @@ -0,0 +1,307 @@ + + + + + + verify - Guia do Usuário Tesseras + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

Keyboard shortcuts

+
+

Press ← or → to navigate between chapters

+

Press S or / to search in the book

+

Press ? to show this help

+

Press Esc to hide this help

+
+
+
+
+ + + + + + + + + + + + + +
+ +
+
+ + + + + + + +
+
+

tes verify

+

Verificar integridade de uma tessera armazenada.

+

Uso

+
tes verify <HASH>
+
+

Argumentos

+
+ + + + + + + +
ArgumentoDescrição
<HASH>Hash de conteúdo da tessera (64 caracteres hexadecimais)
+
+

Opções

+
+ + + + + + + +
OpçãoDescrição
--data-dir <CAMINHO>Diretório base para armazenamento de dados (padrão: ~/.tesseras)
+
+

O que é verificado

+
    +
  1. Validade da assinatura — verifica a assinatura Ed25519 sobre o MANIFEST
    2. +
  2. Integridade dos arquivos — recalcula o hash BLAKE3 de cada arquivo e compara com o MANIFEST
    3. +
+

Códigos de saída

+
+ + + + + + + + +
CódigoSignificado
0Verificação passou — todos os arquivos intactos, assinatura válida
1Verificação falhou — arquivos corrompidos ou assinatura inválida
+
+

Exemplos

+

Verificação bem-sucedida

+
tes verify 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
+
+
Tessera: 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
+Signature: VALID
+  [OK] memories/a1b2c3d4/media.jpg
+  [OK] memories/e5f6a7b8/media.txt
+  [OK] memories/c9d0e1f2/media.wav
+Verification: PASSED
+
+

Verificação com falha

+

Se um arquivo foi modificado ou corrompido:

+
Tessera: 9f2c4a1b3e7d8f0cabc123def456789012345678abcdef0123456789abcdef01
+Signature: VALID
+  [OK] memories/a1b2c3d4/media.jpg
+  [FAILED] memories/e5f6a7b8/media.txt
+  [OK] memories/c9d0e1f2/media.wav
+Verification: FAILED
+
+

Casos de uso

+
    +
  • Verificações rotineiras de integridade — verifique periodicamente que suas tesseras armazenadas não foram corrompidas
    • +
  • Após transferência — verifique após copiar tesseras para um novo dispositivo ou meio de armazenamento
    • +
  • Verificação de confiança — confirme que uma tessera recebida de outra pessoa não foi adulterada
    • +
+ +
+ + +
+
+ + + +
+ + + + + + + + + + + + + + + + + + + + + + + + +
+ + diff --git a/book/pt-br/commands/verify.html.gz b/book/pt-br/commands/verify.html.gz new file mode 100644 index 0000000..d2015d9 Binary files /dev/null and b/book/pt-br/commands/verify.html.gz differ -- cgit v1.2.3