PhotoCraft LogoPhotoCraft

Guias PhotoCraft

Documentação prática destilada do projeto upstream storytold/photocraft—instaladores, fluxos PSD, CLI pronta para agentes e compilação a partir do código-fonte. O PhotoCraft está em alpha inicial: espere arestas por polir e consulte as notas de release da versão que transferir.

O que é o PhotoCraft

O PhotoCraft é uma reimplementação open source, clean-room, do Adobe Photoshop em Rust puro. Oferece camadas, máscaras, camadas de ajuste, estilos de camada, texto, vetores, pincéis e ficheiros PSD/PSB reais numa app nativa—offline, com licença dupla MIT ou Apache-2.0, para usar e estudar.
Menus, atalhos, painéis e ferramentas são intencionalmente familiares. Um compositor GPU em wgpu (Metal, Vulkan, DX12, WebGPU), tiles copy-on-write e filtros multithread mantêm a edição local e rápida—sem necessidade de shell Electron na app de desktop.
  • Estado: alpha inicial. Grande parte da superfície de funcionalidades do Photoshop existe de alguma forma, mas ainda não substitui o Photoshop no dia a dia em todos os fluxos profissionais.
  • Maiores lacunas hoje: funcionalidades de IA/generativas, algumas ferramentas em falta, profundidade em tipografia e fluxos pro, e compatibilidade com plugins.
  • Expectativa honesta: cada item de menu do Photoshop pode estar ligado a um comando, mas a ligação não é paridade comportamental total. Prefira o roadmap e notas de paridade upstream para o panorama mais recente.
  • Nota sobre marcas: Adobe e Photoshop são marcas registadas da Adobe Inc. O PhotoCraft é independente e não está afiliado à Adobe.

Transferir e instalar

Instaladores e pacotes oficiais para macOS, Windows, Linux, FreeBSD e a build web vêm anexados a cada release no GitHub. Comece na página Transferir deste site ou abra a página Releases upstream para todos os artefactos e checksums.

Prefira a página Transferir em photocraftdl.com para ligações selecionadas, ou explore GitHub Releases para builds de cada plataforma. Cada release inclui SHA256SUMS.txt para verificar o que transferiu.

Pacotes por plataforma (padrão de nome de ficheiro)

PlataformaO que obter
WindowsInstaladores MSI e ZIPs portáteis para x64, arm64 e x86 (ex.: photocraft-<ver>-windows-x64.msi). Instaladores e executáveis estão assinados por código.
macOSDMG universal Apple silicon + Intel (photocraft-<ver>-macos-universal.dmg), assinado e notarizado. CLI opcional: photocraft-cli-<ver>-macos-universal.zip.
LinuxAppImage, Flatpak, .deb, .rpm e tarball para x86_64 e aarch64. AppImage pode auto-atualizar via AppImageUpdate (.zsync).
FreeBSDTarball x86_64 com layout tipo /usr/local (instale dependências de runtime com pkg, depois descompacte).
Webphotocraft-web-<ver>.zip — site estático que corre num browser moderno; aloje-o em qualquer servidor estático ou experimente o editor no browser noutro sítio deste site quando disponível.

Início rápido Linux Flatpak

  • O bundle Flatpak precisa do runtime freedesktop do Flathub; flatpak oferece instalá-lo.
  • flatpak install --user photocraft-<version>-linux-x86_64.flatpak (ou a build aarch64)
  • flatpak run ai.storyteller.photocraft

Dica Linux AppImage

  • Sem instalação. Na primeira execução pode registar ícone de launcher e entrada de menu em ~/.local/share para o dock mostrar o ícone do PhotoCraft no Wayland.
  • Defina PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1 para saltar a integração com o ambiente de trabalho.

Notarização CLI macOS

O zip da CLI está assinado com o mesmo Developer ID que a app e notarizado pela Apple. Um binário nu não pode levar ticket agrafado como o DMG; a primeira execução pode verificar a notarização online. Pode verificar com:

  • ditto -x -k photocraft-cli-<version>-macos-universal.zip .
  • spctl --assess --type install -vv photocraft-cli-<version>-macos-universal/photocraft-cli
  • Espere algo como: accepted, source=Notarized Developer ID.

FreeBSD 14 (x86_64)

  • pkg install libxkbcommon wayland libX11 libXcursor libXrandr libXi libxcb mesa-libs vulkan-loader gtk3 fontconfig freetype2 alsa-lib
  • tar -xzf photocraft-<version>-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local
  • photocraft

Primeiro arranque e edição do dia a dia

Abra um documento, conheça a superfície de ferramentas familiar e saiba algumas particularidades Linux/Wayland antes de mergulhar em idas e vindas PSD ou automação.

Inicie o PhotoCraft e abra uma imagem ou PSD com Ficheiro › Abrir, ou passe um caminho ao arrancar a partir do terminal (por exemplo photocraft image.psd após compilar a partir do código). A edição fica na sua máquina—não há conta na cloud obrigatória para as ferramentas principais.

O que pode esperar incluído

  • 53 ferramentas—marquees, laços, Seleção de objeto/rápida, pincéis, reparação, texto, caneta/formas, dodge/burn e mais.
  • Camadas bem feitas — grupos, máscaras de recorte, máscaras de pixel e vetor, camadas de preenchimento e ajuste, objetos inteligentes com filtros inteligentes, modos de mistura, opacidade/preenchimento e histórico.
  • Camadas de ajuste que mantêm edições vivas (Níveis, Curvas, Vibrance, Matiz/Saturação e muitas mais) sem destruir pixels originais.
  • Estilos de camada como Sombra projetada, Brilhos, Relevo e emboss, Contorno e sobreposições—utilizáveis também em camadas de texto.
  • Texto, vetores e filtros com pré-visualização ao vivo de filtros dentro de seleções; Transformação livre com histórico completo.
  • Profundidades de cor — RGB, Escala de cinzentos, CMYK e Lab a 8/16/32 bits por canal, com gestão de cor ICC em Rust puro.

Arrastar e largar Wayland (Linux)

Numa sessão Wayland, ficheiros largados na janela podem ainda não abrir—limitação na stack de janelas sob egui. Alternativas:

  • Use Ficheiro › Abrir, ou copie uma imagem no gestor de ficheiros e cole com Ctrl+V.
  • Para restaurar arrastar e largar, arranque sob XWayland: WAYLAND_DISPLAY= photocraft, ou o mesmo padrão para AppImage / Flatpak com sockets X11 conforme documentado upstream.

Exportar e temas

  • Use Exportar como para formato, qualidade, transparência e escala com pré-visualização e estimativa de tamanho; Exportação rápida pode gravar PNG num clique.
  • Alterne entre Pro escuro, Studio arejado e Classic nas preferências da app.

PSD, formatos e idas e vindas

O suporte PSD do PhotoCraft é uma crate autónoma escrita a partir da especificação pública da Adobe e testada contra corpora reais—não um wrapper fino em torno de código proprietário.

Abra, edite e guarde documentos Photoshop em camadas. O upstream reporta que ao regravar mantém a renderização de 307 de 309 ficheiros de teste psd-tools (e bons resultados em corpora mistos). Um ficheiro regravado não é byte-idêntico à fonte: recursos de imagem, registos de camada e a composição são reescritos. Blocos raw e descritores não suportados são preservados quando possível em vez de descartados.

Formatos além de PSD

  • PSD / PSB — incluindo documentos grandes, 16/32 bits, CMYK e Lab.
  • TIFF em camadas — dados de camada Photoshop em TIFF, qualquer ordem de bytes.
  • OpenRaster — leitura/escrita com camadas, grupos e modos de mistura (Krita, MyPaint, GIMP).
  • Paint.NET PDN3 — leitura com camadas editáveis; SVG pode abrir como formas ou colocar como Smart Object vetorial.
  • Formatos planos — PNG, JPEG, TIFF, WebP, GIF, BMP, TGA, ICO, QOI, PNM, OpenEXR, Radiance HDR, mais o nativo .pcraft.
  • Opcional / limitado: HEIC só leitura em builds oficiais; escrita AVIF com funcionalidade opcional; documentos Affinity abrem só leitura com avisos para partes não suportadas.

Dicas para trabalho PSD fiável

  • Guarde cópias de PSDs fonte importantes antes de idas e vindas intensivas enquanto avalia o comportamento em alpha inicial.
  • Se algo parecer errado após regravar, note SO, tamanho do documento, número de camadas e captura de ecrã ao abrir issue upstream.
  • Para detalhes de codec por formato, veja a matriz de capacidades de codecs upstream na documentação do repositório.

CLI, batch e agentes

Cada item de menu, ferramenta e diálogo passa por um registo de 500+ comandos. A UI, CLI, canal de controlo JSON e servidor MCP chamam o mesmo motor—tudo o que pode clicar, um script ou agente também pode conduzir.

Exemplo de edição headless (nomes de comando e parâmetros seguem a ajuda CLI upstream da sua versão instalada):
  • photocraft-cli run wave.psd --cmd filter.sharpen.smartSharpen --params '{"amount":80}' --cmd layer.newAdjustmentLayer.curves --params '{"points":[[0,0],[64,48],[192,212],[255,255]]}' --out wave-final.png
  • photocraft-cli batch --actions grade.json --in ./raw --out ./graded
  • photocraft-cli batch --help — cada subcomando explica-se a si próprio.
  • photocraft-cli mcp — deixe um agente conduzir o PhotoCraft via MCP (headless ou ligado a uma app em execução).

Canal de controlo desktop

A app desktop pode expor um canal de controlo autenticado, só loopback (photocraft --control) para inspecionar estado da UI, conduzir ferramentas com eventos de ponteiro e capturas offscreen. O upstream documenta o protocolo em docs/control-protocol.md.

Compilar a partir do código-fonte

Clone o repositório upstream, execute a app desktop em modo release e, opcionalmente, aponte para craft-fonts para fontes CJK de UI/tipo incluídas.

Precisa de uma toolchain Rust recente. Novos contribuidores e agentes de IA devem começar pelo AGENTS.md upstream, depois a árvore docs/ e o livro de documentação.

Execução desktop mínima

  • git clone https://github.com/storytold/photocraft
  • cd photocraft
  • cargo run --release -p photocraft -- image.psd
  • cargo test --workspace — execute a suite de testes quando alterar código.

Fontes japonesas / CJK opcionais (craft-fonts)

Fontes japonesas para a UI e ferramenta Tipo vêm de craft-fonts, entrada de build opcional (builds release desktop incluem sempre). Sem isso, o PhotoCraft usa fontes CJK do sistema:

  • git clone https://github.com/storytold/craft-fonts ../craft-fonts
  • CRAFT_FONTS_DIR="$PWD/../craft-fonts" cargo run --release -p photocraft

Corpora de teste

  • O PhotoCraft é testado contra ficheiros reais (PSDs oracle, psd-tools, ag-psd, PngSuite), fixados e verificados por checksum.
  • Obtenha com cargo xtask corpus --all e execute com cargo xtask test-corpus (detalhes em docs/development.md upstream).

Manter-se alinhado com o upstream

Flags, nomes de pacotes e estado de paridade mudam a cada release. Prefira o README, notas de Releases e docs do commit ou tag que fez checkout em vez de snapshots comunitários mais antigos. Repositório upstream: github.com/storytold/photocraft.

Obter ajuda

Quando algo falhar, abra um issue com o SO, tamanho do documento, número de camadas e captura de ecrã. Também pode perguntar no Discord ArtCraft ligado a partir da página do projeto upstream.
Guias PhotoCraft | Instalação, PSD, CLI e compilação