从玩家到贡献者：Sunshine社区共建指南

🌟 为什么选择参与Sunshine社区？

Sunshine作为自托管的游戏流媒体服务器（Game Streaming Server），让玩家能够通过Moonlight在各种设备上享受低延迟的游戏串流体验。这个开源项目的成长离不开每一位社区成员的贡献——无论是代码改进、本地化翻译，还是文档优化。本文将带你从零开始，一步步成为Sunshine社区的活跃贡献者，用技术热情连接全球玩家。

读完本文你将获得：
✅ 3种快速参与贡献的入门方式
✅ 本地化翻译全流程指南
✅ 代码提交规范与测试技巧
✅ 社区协作工具与资源清单

🚀 贡献者入门路径

1️⃣ 文档优化：让技术更易懂

Sunshine的官方文档位于docs/目录，包含从安装到高级配置的完整指南。即使你不是开发者，也可以通过以下方式完善文档：

• 修正错别字与格式：通过PR改进docs/getting_started.md中的安装步骤
• 补充使用场景：为docs/configuration.md添加家庭网络环境下的端口转发示例
• 翻译文档内容：将README.md翻译成你的母语（需遵循国际化规范）

2️⃣ 代码贡献：从修复小问题开始

即使是编程新手，也能通过修复简单bug积累经验。推荐从以下文件入手：

• 配置解析：src/config.cpp中处理配置文件的逻辑
• 日志系统：src/logging.cpp优化错误提示信息
• 测试用例：为tests/unit/test_network.cpp补充边界条件测试

开发工具推荐：

工具	用途
CLion	C++开发IDE（提供免费开源许可）
Visual Studio Code	轻量级编辑器，配合C/C++插件
Docker	通过docker/ubuntu-22.04.dockerfile快速搭建开发环境

3️⃣ 本地化翻译：让Sunshine走向世界

Sunshine已支持多语言界面，你可以通过Crowdin平台参与翻译，或直接修改本地化文件：

1. Web界面翻译
   编辑src_assets/common/assets/web/public/assets/locale/en.json，添加新字符串：

   {
     "index": {
       "welcome": "欢迎使用Sunshine串流服务"
     }
   }
   

2. C++代码国际化
   在src/main.cpp中使用boost::locale::translate包裹用户可见文本：

   std::string welcome_msg = boost::locale::translate("欢迎使用Sunshine");
   

3. 翻译状态监控
   通过社区翻译仪表盘查看进度：
   

🔧 开发流程全解析

环境搭建

# 克隆仓库
git clone https://gitcode.com/GitHub_Trending/su/Sunshine
cd Sunshine

# 构建项目
cmake -B build -G Ninja -S .
ninja -C build

# 运行测试
./build/tests/test_sunshine

代码规范

• 代码风格：遵循.clang-format配置，提交前执行：

  python ./scripts/update_clang_format.py
  

• 提交信息：使用[模块名] 简明描述格式，例如：[input] 修复手柄按键映射反转问题

测试验证

• 单元测试：新增功能需覆盖tests/unit/对应模块
• 性能测试：使用./build/tests/test_sunshine --gtest_filter=Performance.*验证编码延迟
• 跨平台测试：通过docker/目录下的镜像验证Linux发行版兼容性

🤝 社区协作与支持

沟通渠道

• Discord：加入LizardByte社区服务器（需科学上网）
• GitHub Issues：使用bug报告模板提交问题
• 开发者会议：每周三20:00（UTC+8）举行线上同步会（会议链接在Discord公布）

贡献者激励

• 代码合并奖励：活跃贡献者可获得定制周边（T恤、贴纸）
• 权限升级：持续贡献者将获得仓库写权限，参与核心决策
• 技术影响力：你的代码将被全球数十万Moonlight用户间接使用

📝 下一步行动清单

1. star项目：在项目主页点击⭐支持
2. 挑选任务：查看good first issue
3. 提交PR：参考PR模板创建你的第一个贡献
4. 加入社区：在Discord中自我介绍并@管理员获取新手指导

记住：即使是最小的改进（如修复一个错别字），也是对社区的宝贵贡献。开源的本质是协作，我们期待你的加入！

封面图：Sunshine社区贡献者可视化地图（数据截至2025年Q3）