PhotoCraft GitHub：仓库、源码构建与许可证

仓库概览

PhotoCraft GitHub 仓库里有什么？

仓库对 PhotoCraft 的介绍是：一款用纯 Rust 从零写成的开源照片编辑器。它是一个 Cargo workspace：桌面应用位于 apps 目录下，引擎被拆分成可复用的 crate，另有一本文档手册（book）涵盖架构、文件格式、自动化和安全。

开发相当活跃。在我们查看的当天，仓库有数百个未关闭的 issue 和 pull request，v0.7.0 版本下附带了所有平台的安装程序。

从源码开始

如何从 GitHub 构建 PhotoCraft

构建需要较新的 Rust 工具链，外加几分钟的编译时间。

1. 1

   安装 Rust 1.90 或更高版本

   PhotoCraft 需要 Rust 1.90+。如果还没装 Rust，可以从 rustup.rs 获取 rustup 来安装，然后确认版本。

   rustc --version

2. 2

   克隆并运行

   克隆仓库，以 release 模式构建并启动桌面应用。在 -- 之后传入文件路径，可以直接打开文档。

   git clone https://github.com/storytold/photocraft.gitcd photocraftcargo run --release -p photocraft# 启动时打开一个 PSDcargo run --release -p photocraft -- image.psd

3. 3

   运行测试

   workspace 自带测试套件，项目还会用固定版本的真实 PSD 和 PNG 文件集进行测试。

   cargo test --workspace

4. 4

   可选：内置 CJK 字体

   发布版本的构建内置了来自另一个仓库的字体，用于显示日文及其他 CJK 文字。没有它，PhotoCraft 会回退到系统中已安装的字体。

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

面向开发者

为脚本化而设计

有一个设计决策让 PhotoCraft 有别于大多数编辑器：每个操作都是一条命令。

法律事项

PhotoCraft 许可证：Apache-2.0 与 MIT

PhotoCraft 采用 Apache License 2.0 和 MIT License 双重许可，这也是 Rust 生态中大多数项目采用的组合。两者都属于宽松许可证：只要保留许可证和版权声明，你就可以使用、修改和再分发这些代码，包括用于商业用途。

许可证覆盖的是源代码。名称和标识是另一回事，所以 fork 版本或第三方网站不应自称是官方的 PhotoCraft。

以上只是通俗的概括，不构成法律建议。在再分发任何内容之前，请先阅读仓库中的 LICENSE 文件。

参与进来

如何反馈 bug 并参与贡献

1. 1

   提交一个有用的 issue

   维护者希望你提供操作系统、文档尺寸、图层数量和一张截图。提交前请先搜索已有的 issue。

2. 2

   阅读贡献指南

   在发起 pull request 之前，先读 AGENTS.md 和 docs 文件夹，其中说明了架构和编码规范。

3. 3

   和团队交流

   功能建议、抢先版本和日常讨论都在 ArtCraft 的 Discord 中进行，官方网站和 README 里都有链接。