获取帮助并请求增强功能
Langflow GitHub 仓库是 Langflow 社区不可或缺的一部分。
除了提供关于 Langflow 的一般协助外,该仓库还是报告错误(bug)和请求增强功能的最佳场所,以确保它们能够被 Langflow 维护者跟踪。
GitHub issues
Langflow 仓库中的 Issues 页面会实时更新错误报告和功能请求。
提示
推动请求或错误处理的最佳方式是在现有的 issue 下发表评论。活跃度高的 issue 更容易引起贡献者的关注。
在报告错误或提交功能请求之前,请先搜索是否存在类似的现有 issue。使用 Langflow 仓库的标签(labels)可以帮助您过滤搜索结果。
GitHub discussions
如果您在代码或 Langflow 的一般使用方面需要帮助,可以访问 Langflow GitHub Discussions 页面,或者通过其他 Langflow 社区渠道进行联系。
Langflow 团队不通过电子邮件提供个人支持,团队认为公开讨论凭借其可发现性,能够帮助到更多的用户。
社区指南与提示
由于 Issues 和 Discussion 页面是公开的,Langflow 团队要求您在提交问题和 issue 时遵循以下指南:
- 提供尽可能多的细节:仅仅说明某个功能无法正常工作是没有帮助的。Langflow 团队需要详细信息以便重现并找到问题所在。
- 准确解释哪里出了问题:包括错误消息和关于代码如何失败的描述,而不只是失败这一事实。
- 回溯您的步骤:解释错误发生前发生了什么,您预期会发生什么,以及您最近所做的任何更改(例如升级 Langflow 或某个依赖项)。
- 描述您的环境:包括您的操作系统、Langflow 版本、Python 版本,以及任何其他可能导致该问题的环境相关细节。
- 包含失败代码的代码片段:请务必省略任何敏感值,并且仅提供与失败相关的部分,而不是整个脚本。提供代码片段可以使重现错误、排除故障并提供针对性建议变得更加容易。
- 如果您的提交包含长段的代码、日志或堆栈跟踪,请将它们包裹在 details 标签中 (
<details> 在此处粘贴代码 </details>) 以折叠内容,使您的提交更易于阅读。
- 如果您的提交包含长段的代码、日志或堆栈跟踪,请将它们包裹在 details 标签中 (
- 省略敏感信息:除了您公开的 GitHub 个人资料上可用的信息外,请不要包含敏感或个人身份数据,例如安全密钥、全名、身份证号、地址和电话号码。
- 保持友善:虽然任何软件中的错误都可能令人沮丧,但请记住,您的消息是由想要提供帮助的真人阅读的。虽然您不必过分恭维,但无需通过无礼的行为来获取支持。
- 您的 issues 和 discussions 都会关联到您的 GitHub 账户,互联网上的任何人(包括当前和潜在的雇主及同事)都可以阅读它们。
- Langflow 仓库是一个公开的 GitHub 仓库,因此受 GitHub 社区行为准则的约束。