CONTRIBUTING.md

贡献指南

感谢你帮助改进 Photo Insight。项目接受错误修复、测试、文档、可访问性、本地化和非商业使用场景相关的功能贡献。

开始之前

1. 搜索已有 Issue，避免重复工作。
2. 较大的功能或界面变化应先创建讨论 Issue。
3. 安全漏洞必须按照 SECURITY.md 私下报告。
4. 不要提交没有明确再分发许可的照片、地图、字体或其他素材。

本地开发

需要 macOS 13+ 和完整 Xcode。

git clone https://github.com/SamsonRuan/Photo-Insight.git
cd Photo-Insight
./script/build_and_run.sh

提交前运行：

swift test --disable-sandbox
BUILD_ARCHS=native ./scripts/build-app.sh

Pull Request 要求

• 每个 PR 聚焦一个问题，并关联对应 Issue。
• 描述动机、实现方式、验证结果和用户可见变化。
• 行为变化应增加或更新测试。
• UI 变化应附上前后截图，并检查中英文和浅色/深色模式。
• 不提交 .build、dist、outputs、签名证书、密钥、真实照片或本机用户状态。
• 保留第三方版权和许可证声明。

许可与署名

提交贡献即表示你有权提交相关内容，并同意按 PolyForm Noncommercial License 1.0.0 向公众提供该贡献。你保留自己贡献的版权。

该许可证允许非商业使用、修改和分发，但不授予商业使用权。若未来需要对包含第三方贡献的版本提供商业许可，维护者必须另行取得相关贡献者授权。

参与社区还意味着同意遵守 行为准则。