遇到问题如何寻求帮助

2/25/2024

# 一、尝试自行解决问题

Mars3D 有非常大量的用户,所以你遇到过的问题,很可能别人在此之前也遇到并解决了。通过查看文档以及使用搜索引擎搜索关键字,可以帮助你自助地在第一时间解决问题,而不需要依赖社区的帮助。

因此,在做其他操作前,请确保现有文档等资料无法解决你的问题。可以尝试查看或搜索的资料包括:

请先确保现有文档等资料无法解决你的问题

# 二、梳理问题

为了快速理解高效地解决您的问题,强烈建议一次性梳理清楚您的问题或需求,如果是问题时请整理可复现问题的最简代码再进行沟通。

# 1. 如果是提问题或需求: 请组织语言一次性描述清楚

(1) 期望的结果是什么? 尽可能将您的想实现的需求描述完整。

(2) 现状是什么? 当前是如何操作或编写代码的?

  • 描述清楚问题或操作的 所在场景及步骤,尽可能的让我们可以复现。
  • 附上当前 F12 的错误提示/js 代码截图/页面运行效果 的完整截图(复杂的可手机拍下视频)

# 2. 如果是调试代码:请整理一个最简可复现的代码

如果问题比较复杂或者我们测试人员很难重现,那么建议您整理下代码,发送重现问题的最简单代码包给我们开发人员帮忙排查,这将使得他人更方便地复现你的问题。

(1) Mars3D 的类及方法使用相关问题:请整理代码,在功能示例或开源的项目模版中参考已有示例页面和代码,创建一个重现问题的代码发我们。

(2) Vue 或者其他环境集成相关问题:请创建一个干净并可复现问题的工程,一起打包(注意:node_modules目录不要一起打包进去)后发我们。

(3) 如果依赖后端服务,请提供在线服务地址或离线的 mock 数据。

例子应尽可能以最简单的方式复现你的问题,去除不必要的配置项和数据,可以让帮助你的人更快速地定位问题,从而让你的问题更快得到解决。

# 三、发布问题

梳理好问题后,请您直接发布在Gitee码云开源平台: https://gitee.com/marsgis/mars3d/issues (opens new window)

发布问题后,我们会有专职运维人员 24小时内 定时处理回复(有响应) , 7天内 动态清零(有结果) 所有问题。

# 1. 新建issues问题

(1) 登录个人gitee帐号(可微信扫码登录)后,单击“新建issues”

image

(2) 按上面梳理问题章节要求,填写问题内容,并上传相关代码、截图、附件。

注意:

(1)一次性描述清楚:避免简单的一句话或一张图片(看图猜问题),可以简短描述清楚问题,并提供F12 的错误提示/js 代码截图/页面运行效果手机拍视频粘贴关键代码方式辅助理解问题。

(2)上传可运行的代码:复杂问题,建议基于某个示例复现问题后提供示例的map.js;或上传独立独立运行的项目代码包。

image

(3) 完成问题提交,查阅问题

image

(4) 建议微信扫码关注gitee公众号,并绑定个人gitee帐号,可及时收到消息提醒。

# 2. 付费悬赏解决问题

有些问题或需求需要花费解决问题人员大量时间,如果您想节省自身时间,让群友给您快速、开心的解决问题,建议您通过付费悬赏方式悬赏解决单个问题,并且这是一种双赢的选择。

image

为了保障资金安全,建议使用gitee中(第3方平台)直接悬赏并支付宝支付,这是个人对个人行为,与mars3d无关,请确认问题解决后再进行验收, 验收后gitee平台才将费用转给解决问题的个人。

# 3. 涉密代码的发送

如果代码不方便发送在gitee公网,您可以发送代码至mars3d官方运维人员邮箱:whd@marsgis.cn,也可加运维人员企业微信后私发代码(但注意代码不要发群里),并说明对应的问题gitee链接。

# 四、微信技术交流群

微信沟通是最快捷高效的方式,大家可以加我们 技术交流群 (opens new window) 进行直接沟通交流。 目前我们团队安排了相关人员在微信群内进行运维,每天与用户进行交流,解答用户的问题、梳理并记录用户的问题和需求(也是发布在上面章节描述的Gitee平台,我们使用Gitee平台来管理问题及流转),最终解决反馈用户的问题。

目前mars3d官方提供三类微信群对用户进行服务和交流 :免费公开交流群、已授权用户交流群、VIP付费指导群,目前不接受任何用户的私聊沟通私拉群沟通技术问题,有问题请在 此三类群内公开沟通讨论 或 直接发布Gitee平台 (涉密代码可私发)。

重要原则:

  1. 一次性描述清楚:提问题时,避免简单的一句话或一张图片(看图猜问题),可以简短描述清楚问题,并提供F12 的错误提示/js 代码截图/页面运行效果手机拍视频方式辅助理解问题。
  2. 提供独立可运行的代码:代码问题时,建议在我们官网示例开源的项目模版中可以复现问题后,反馈对应代码给我们调试解决,必须能够独立运行,无法运行的代码,无法排查问题。
  3. 尽量多参与回答其他用户:交流群是大家互相交流学习的,众人拾柴火焰高,你知道的问题也欢迎大家互相解答交流。

# 1.免费公开交流群

公开的,任何人员均可以加入,无限制。

# 2.已授权用户交流群

已购买Mars3D授权、项目模版等的相关用户组成的群,也同时是售后服务群,处理问题优先级高于“免费公开交流群”,无需额外付费。

# 2.VIP付费指导群(额外付费)

在免费公开群为大家提供服务时,我们是争取最大可能的做到:所有问题有问必回、有始有终

但也可能一些因素,比如:

  • 我们运维人员处理的问题过多,时间和精力有限,无法完美详细的处理好所有问题。
  • 单位情况特殊,涉密数据、代码比较多,不方便公开渠道讨论
  • 您的技术人员经验不够、问题比较多
  • 项目时间紧、问题比较紧急
  • 熟悉Mars3D的员工已离职,新入职的员工处于懵逼状态

您也可以考虑额外付费购买官方提供的更高效、更私密的VIP付费指导服务(1V1) (opens new window), 我们会建立一对一的私密指导群,该群内只有双方单位人员组成,最优先响应、处理贵单位相关问题。具体可以联系我们 (opens new window)咨询。

这是公司对公司行为,提供合同发票,需公对公转账。

最后更新: 2/27/2024, 2:27:19 PM