Rays 社区与反馈渠道汇总
快速选择：你该去哪个渠道
| 你的需求 | 推荐渠道 | 说明 |
|---|---|---|
| 想反馈 Bug | GitHub Issues | 最正式，维护者一定会看 |
| 有功能建议 | GitHub Issues | 或 Discussions |
| 想问用法 | GitHub Discussions / Telegram | 实时社区有人答 |
| 想贡献代码 | GitHub Pull Request | 先 Fork 再 PR |
| 想帮忙翻译 | Weblate | 逐句协作，不用改代码 |
| 想讨论开发 | Discord / Telegram | 和同好聊聊实现 |
| 找历史版本 | GitHub Releases | 所有 release 的 apk 和源码 |
GitHub（主要渠道）
仓库地址：github.com/SkyD666/Rays-Android
Issues（Bug 报告 + 功能请求）
- 可以搜索有没有人提过相同问题（先搜再提，避免重复）
- 提 Bug 时请包含：Rays 版本号、Android 版本、手机型号、复现步骤、期望行为、实际行为
- 功能请求时描述清楚：为什么需要、解决什么问题、期望效果
- 维护者（SkyD666）会定期处理
Discussions（讨论区）
- 比 Issues 更开放，可以讨论任何和 Rays 相关的话题
- 用法疑问、配置问题、最佳实践都可以在这里问
- 社区成员会帮忙解答
Pull Request（代码贡献）
贡献代码的流程：
- Fork Rays-Android 仓库
- 创建一个分支（命名建议
feature/xxx或fix/xxx） - 在分支上修改代码
- 提交 Pull Request 到主仓库
- 维护者 review 合入
PR 不需要完美——提交思路正确、有基本测试的代码就行，维护者会一起完善。
Releases（版本发布）
- 所有历史版本的 release 在这里
- 每个 release 通常包含：apk 下载、更新日志、源码
- 关注 Watch 仓库可以收到新 release 的通知
Telegram 群组
README 里有 Telegram 邀请链接（t.me/SkyD666Chat）。
- 实时交流，比 GitHub 更即时
- 日常吐槽、小问题、闲聊都可以
- 维护者本人可能也在群组里
Discord 服务器
同样在 README 里有邀请链接。
- 分了不同频道（开发讨论、翻译、闲聊等）
- 比较适合分主题深入讨论
- 比 Telegram 群组结构化
Weblate（翻译贡献）
README 里有翻译入口链接（hosted.weblate.org/engage/rays/）。
- 不需要代码基础，注册账号就能参与翻译
- Weblate 提供上下文、截图参考、自动补全等工具
- 翻译进度会在 GitHub README 里实时显示
- 每种语言的翻译完成后自动合入
反馈技巧
提 Bug 时
❌ 不要只说"闪退了" ✅ 要说清楚：
Rays v4.0.2 / Android 14 / 小米 13 Ultra复现：搜"原神" → 点一个搜索结果 → 长按 → 闪退期望：长按弹出上下文菜单实际：应用崩溃
提功能建议时
❌ 不要只说"我想要云同步" ✅ 要说清楚：
场景：我有两台 Android 手机，表情库想保持同步现状：只能手动导出导入建议：支持 Nextcloud / WebDAV 自动同步（如果 Rays 已经支持 WebDAV 但你不知道，就去文档里找）
不要做的事
- 不要把 Bug 报告发到 Telegram/Discord 私聊维护者——应该发到 GitHub Issues，方便其他人搜索和跟进
- 不要发纯发泄贴——带着问题描述和期望行为，维护者更容易理解你的痛点
- 不要催维护者——开源项目是义务维护的
同作者的其他项目
如果你喜欢 Rays，可能也会对同作者 SkyD666 的其他项目感兴趣：
| 项目 | 描述 |
|---|---|
| PodAura | RSS 播客工具，订阅、下载、播放一站式 |
| Raca | 本地收藏管理，记录和搜索抽象段落、评论区小作文 |
| NightScreen | 夜间护眼，降低屏幕亮度减少眼睛疲劳 |
这些项目同样是 Jetpack Compose + Material You + MVI 架构，界面风格统一。