问题跟踪器

观看会话时即可将其转为工单:播放器中的一个按钮、您自己填写的描述,以及已附加的回放链接。

1. 为什么手动触发

MousePlayer 中的其他桥接都会自动触发。此桥接不会,这正是设计的全部用意。

工单意味着某个人要处理的工作。如果每次愤怒点击都创建一张,看板就会堆满无人分流处理的事项;不到一周,团队就会把它们过滤掉——真正的问题也会一起被过滤掉。

因此,触发者是您。观看会话、发现问题、按下按钮,再写下所见。录制链接已经放入描述;判断由您作出。

按钮仅对所有者和管理员显示,分享链接视图中绝不显示。收到录制分享的人不应能在您的跟踪器中创建工单。

2. 五种跟踪器及各自所需信息

创建位置需要提供
Jira项目中的问题站点 URL、账户电子邮箱、API 令牌、项目键、问题类型
Linear团队中的问题API 密钥、团队 ID
Asana项目中的任务个人访问令牌、项目 ID
Trello列表中的卡片密钥、令牌、列表 ID
GitHub仓库中的问题个人访问令牌、owner/repo

一个卡片,每次选择一个提供商。日后添加第二个跟踪器是更改选择,并非迁移。

标识符从哪里来

在浏览器中打开团队或项目时,可在 URL 中看到 Linear 团队 ID 和 Asana 项目 ID。Trello 列表 ID 在这五者中最难获取:在看板 URL 后附加 .json ,然后找到所需列表。Jira 项目键是每个问题编号前的前缀,例如前缀 ACME 出现在问题编号 ACME-1234中。

3. 工单中的链接由服务器构建

描述由您填写,回放链接则不是:链接由我们根据您实际观看的会话在服务器端组装,表单无法影响它。

这很重要,因为工单中的链接会被其他人点击。如果链接来自浏览器,精心构造的请求就可能将任意地址放到团队面前,而且看起来像来自自己的工具。

HTTP 200 不等于工单存在

Linear 使用 GraphQL 返回结果,而 GraphQL 拒绝时会返回 200 OK ,并带有 errors 数组。如果桥接只看状态码,就会对从未创建的工单报告成功。我们读取正文。

跟踪器返回新问题标识符时,我们会将其放进确认消息,使您能够核实它确实存在,而非只相信绿色提示。

4. 刻意不提供的功能

不自动创建工单

原因见上文。如果需要自动化,Webhook 桥接可将挫败感信号发送至 Zapier 或 Make,由您在那里决定什么值得创建工单。

不双向同步

关闭工单不会改变 MousePlayer 中的任何内容,MousePlayer 也不会重新打开它。只实现一个半方向的同步,比完全没有更糟,因为人们会开始依赖它。

不添加附件

录制保留在我们这里,也在我们这里观看。将视频导出到跟踪器,会把个人数据推送至保留规则不同于您与访客约定规则的系统。

令牌以 AES-256-GCM 加密存储,不再显示,也绝不放入内部队列。此调用直接由请求执行,在您等待期间完成。

5. GitLab、Azure DevOps 与 ClickUp

又增加了三种跟踪器,使用同一个按钮,同样手动触发。

需要提供
GitLab主机、项目 ID 和令牌,也支持自有 GitLab
Azure DevOps组织、项目、工作项类型和 PAT
ClickUp列表 ID 和个人令牌

GitLab 询问主机,因为您可能自行托管

与其他平台不同,GitLab 经常自行托管,因此主机是可填写字段,而非固定值。若使用的是该服务,请粘贴 gitlab.com 。

Azure DevOps 同时有两个特殊之处

正文是 JSON Patch 文档,而非对象,内容类型必须为 application/json-patch+json ,否则返回 415。URL 中工作项类型前的美元符号是地址的一部分,并非我们忘记填写的占位符。

ClickUp 需要纯令牌

前面不要加 Bearer 。在令牌前加上这个词会被以 401 拒绝,看起来与令牌错误完全相同。

此处提及的所有商标均属于各自所有者。MousePlayer 与这些提供商不存在商业关系。