Contributing.zh.CN

参与贡献

感谢你对 VirtualPaper 的贡献热情！

快速开始

1. Fork 仓库并在本地克隆。
2. 安装 .NET 8.0 SDK。
3. 在 Visual Studio 2022 或 Rider 中打开 src/VirtualPaper.sln。
4. 构建解决方案——所有依赖通过 NuGet 自动还原。

项目结构

项目	角色
VirtualPaper	核心后端服务（壁纸控制、播放管理、屏保）
VirtualPaper.UI	WinUI 3 主应用壳
VirtualPaper.WpSettingsPanel	壁纸设置面板
VirtualPaper.DraftPanel	壁纸创作 / 草稿面板
VirtualPaper.PlayerWeb	基于 WebView2 的壁纸播放进程
VirtualPaper.ML	AI 功能模型（ONNX）
VirtualPaper.Core.Test	单元测试——后端
VirtualPaper.UI.Test	单元测试——UI ViewModel

运行测试

dotnet test src/VirtualPaper.Core.Test/VirtualPaper.Core.Test.csproj
dotnet test src/VirtualPaper.UI.Test/VirtualPaper.UI.Test.csproj

提交变更

• 在提交 PR 之前，先开 Issue 讨论重大变更。
• 遵循现有代码风格（通过 .editorconfig 检查）。
• 所有新功能应包含单元测试。
• PR 标题应遵循前缀规范：feat:、fix:、refactor:、docs:。

本地化

翻译文件位于 src/VirtualPaper.UI/Strings/ 目录下。 每种语言对应一个独立的 .resw 文件。以 zh-CN 文件为基础开始翻译即可。