第23章 功能请求与 Bug 报告
功能请求与 Bug 报告
如何为 Pangolin 提交功能请求和报告 Bug
我们欢迎社区贡献,共同帮助改进 Pangolin。为了确保你的反馈得到妥善追踪和优先处理,请根据问题或请求所属的组件,选择对应的代码仓库提交。
选择正确的仓库
Pangolin 由多个组件组成。想获得最快的响应,请把请求或 Bug 报告提交到与所用组件对应的仓库。
服务端组件
Pangolin:Dashboard 和核心平台,使用 Discussions 和 Issues。
Newt:站点与网络连接器,使用 Issues。
Gerbil:WireGuard 接口管理服务,使用 Issues。
用户客户端
Windows App:Pangolin 的 Windows 桌面应用,使用 Issues。
Linux App:Pangolin 的 Linux 桌面应用,使用 Issues。
Android App:Pangolin 的 Android 移动应用,使用 Issues。
Apple Apps:适用于 macOS、iOS 和 iPadOS 的 Pangolin 应用,使用 Issues。
Pangolin CLI:面向 Linux 和 macOS 环境的 Pangolin CLI 客户端,使用 Issues。
功能请求
我们鼓励你在 Pangolin 仓库的 GitHub Discussions 区提交功能请求。这样社区可以:
- 为自己希望实现的功能投票
- 对提议的功能提供反馈和建议
- 讨论实现细节与替代方案
- 帮助确定接下来优先开发哪些功能
获得社区支持(投票和积极反馈)的功能请求,更有可能被优先安排开发。
Bug 报告
Bug 报告应提交到相关仓库的 GitHub Issues:
服务端组件:
- Pangolin:fosrl/pangolin/issues
- Newt:fosrl/newt/issues
- Gerbil:fosrl/gerbil/issues
用户客户端:
- Windows App:fosrl/windows-linux/issues
- Linux App:fosrl/windows-linux/issues
- Android App:fosrl/android/issues
- Apple Apps:fosrl/apple/issues
- Pangolin CLI:fosrl/cli/issues
- Olm:fosrl/olm/issues
使用正确的仓库可以确保:
- Bug 在整个生命周期中得到妥善追踪
- 开发者能及时看到并快速修复
- 便于版本追踪和回归测试
- 识别并合并重复问题
请尽可能提供详细信息,帮助开发者快速复现和修复问题。
提交之前
- 先搜索已有的讨论和 Issues,避免重复提交
- 提供清晰、详细的说明
- 附上复现步骤(针对 Bug)
- 在最新版本的 Pangolin 上测试
- 确认问题是否与环境相关
其他渠道
安全问题:如发现安全漏洞,请在相关仓库创建 GitHub security advisory,以确保问题得到保密、负责任的处理。
一般问题:可使用 GitHub Discussions 的 "Q&A" 分类提问,或来 Discord 与我们交流。