如何提交漏洞

快捷方式： BUGREPORT

此指引介绍了如何在维基媒体的错误追踪系统（更多信息参见PhabricatorPhabricator）中写一个好的漏洞报告或功能请求。有效的漏洞报告更容易被解决。

漏洞报告需要用英语写。如果你不会英语，试着去用机器翻译，比如Google翻译。

提交要领

• 精确
• 明确：说明如何重现问题，说明步骤，以便其他人重现bug
• 每份报告中只提一个问题

提交之前

您可以重现此问题吗？

在软件的最新版中尝试重现问题，检查它是否已经被修复了。如果是在维基百科中的一个bug你可以在最新版的test2.wikipedia.org中试试看。

有人已提交了此问题吗？

使用维基媒体的错误追踪系统的搜索框查看您的bug是否已被提报。您也可以在高级搜索页面执行更多高级搜索。

报告新bug或功能请求

如果您在最新版中发现了没有提报过的bug，那么：

1. 前往phabricator.wikimedia.org并点击左侧边栏的“Maniphest”。
2. 选择右上角的“Create task（创建任务）”。
3. 您可能需要登录（或者注册）您的账号（参见“创建您的账户Phabricator/Help#Creating_your_account”）。
4. 至少填写下列内容：
   • 标题：一句话解释问题（而不是您建议的解决方法）。
     • 好的： "Selecting gender is not functional."
     • 差的： "Software crashes."
   • 分配给：您應忽略此字段：开发人员将会在他们计划工作于这个任务时设置它。
   • 优先权: 你應忽略这条提示：总体来说，优先权是取决于那些开发者是否有计划去处理漏洞。（参见：“设置优先权”）
   • 描述：问题的完整说明，应尽可能详细。可以包含：
     • 对于bugs：
       • 重现步骤：能重现所述问题的最简且方便参照的步骤。需包含所有特殊设置步骤。

         例子：

         1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
         2. Make sure you are logged in;
         3. Select "My Preferences" menu;
         4. Go to "Gender" and select female gender from box list;
         5. Click "Save" button.

       • 实际结果：执行上述步骤后程序出现了什么情况。

         例子：

         "There is no female gender in front of my user name."

       • 期望结果：程序正常时应实现的效果。

         例子：

         "My gender is shown in front of my user name."

     • 对于功能请求：
       • 描述您的目标以及为什么设定该目标。用户故事是一个传达的有效途径。

         例子：

         "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"

     • 也请您提供任何其他可能有用的信息，例如：
       • 网页浏览器、皮肤或者您发现了漏洞的计算机系统；
       • 到您遇到错误的一个或多个页面的链接或比较页；
       • 该问题的出现是每次、偶尔、仅在某些页面或仅在特殊条件下。
   • 附件：您可以附上日志文件或者屏幕截图Help:Screenshots （但请您确保上传的文件不包括任何机密信息）。
   • 选择您发现错误的标签（项目）：
     • 開發人員找工作是為條目去努力。為了確定合適的項目，使用在右上方的搜索功能來找到其描述。
     • 例如：MediaWiki-General-or-Unknown用于wiki软件自身，或Wikimedia-Site-Requests用于维基媒体网站上的配置更改（参见“选择项目Phabricator/Help#Selecting_projects”）。
   • 订阅者：你應忽略这条提示：假如你知道某些特定用户，并且这些用户在你提出漏洞后会很乐意得到通知。

检查报告是否完整，然后按下“Create Task（创建任务）”按钮。这样错误报告会保存到数据库，别人很快就会看到。

感谢您协助提升MediaWiki软件以及维基媒体项目！

報告一個 JavaScript 錯誤

See also: Help:Locating broken scripts

当您遭遇一个可能与JavaScript有关的错误时，尽您最大努力去确认错误消息，并将其复制在错误报告中。

提供所有你所擁有的信息是特別重要的，因為即使是系統管理員對錯誤日誌也沒有任何存取權。 如果您不确定您使用的一项功能是否基于JavaScript，尝试禁用Javascript。

在報告中包含截圖總是有幫助的。 它最簡單的方法來判断你在談論的是哪些功能，而且往往能提供信息來縮小誤差。 小心隱藏你不想分享的知訊，像其他打開了的瀏覽器選項或最小化聊天窗口。

参见

• 如何有效的报告 bug 作者 Simon Tatham
• Phabricator 礼节
• 缺陷管理/缺陷管理生命周期
• 撰写一个有效的权限报告或功能诉求
• 如何创建一个有效的缺陷报告 (过期)

• 维基百科：错误报告和功能请求