archi bot 产品文档

本译文为机器生成(测试版)。以英文指南为准。

支持

发送反馈

使用全局反馈按钮,从任意 Console 页面发送一条快速、结构化的留言。选择类型和影响程度,添加主题和详细信息,保留附带的页面和账户上下文,并保存返回的标识符以便后续跟进。

客户管理员客户成员

最近更新

“发送反馈”对话框,包含类型和影响程度选择框、主题和详细信息字段、投递上下文部分,以及“包含页面和账户上下文”复选框。
使用安全数据的 Console 渲染示例:反馈对话框捕获类型、影响程度、主题、详细信息、可选的投递上下文,以及附带的页面和账户上下文。

反馈按钮位于 Console 侧边栏底部,在每个页面上都可用。它会打开一个简短的表单,让你无需中断当前工作即可向 ISM 团队发送一条快速留言。可用于报告 bug、受阻情况、指引缺口、过时文档、功能请求或一次小小的成功。

这是结构化支持工单的轻量级补充。如果你需要带有严重程度的分类工单,请改用“支持”选项卡(参见 /support-handoff/)。两种途径捕获的是同一类上下文。

打开反馈对话框

  1. 查看 Console 侧边栏底部,导航下方的位置。
  2. 选择反馈按钮(它显示一个聊天气泡图标)。
  3. 发送反馈对话框会在当前页面上方打开。

对话框标题为发送反馈,并带有提示语“分享发生了什么、你需要什么,以及什么本会有所帮助。”

“发送反馈”对话框,显示类型和影响程度选择框、主题和详细信息字段、投递上下文部分,以及“包含页面和账户上下文”复选框。

选择类型和影响程度

第一行有两个选择框:

  1. 类型 — 这是哪种留言。选项为Bug受阻指引缺口过时文档请求成功
  2. 影响程度 — 它有多重要。选项为普通紧急正面

选择最接近的一项。对于工作报告,Bug普通影响程度是默认的起点;只有当某事确实在阻碍你时,才将影响程度提升到紧急

填写主题和详细信息

  1. 主题 — 一行摘要,例如“更新后工作区启动失败。”此字段限制为 140 个字符。
  2. 详细信息 — 发生了什么、你当时想做什么以及你的预期。此字段最多可容纳 5000 个字符。

主题详细信息均为必填项。在两者都填写之前,发送按钮将保持禁用状态。

保持文本描述性但安全:不要将机密值、令牌、一次性链接或账户数据粘贴到任一字段中。

添加投递上下文(可选)

详细信息下方是一张投递上下文卡片,描述为“添加此问题在进入实施前所需的评审和 QA 详细信息。”此处每个选择框默认为不确定,因此如果你不确定,可以完全不管这一部分。填写它有助于团队更快地分流留言。

字段它捕获的内容
UI 界面你在哪里看到的:不确定、React Console 视图、WebCentral 视图、Console 和 WebCentral,或无可见 UI。
原型图或截图是否需要视觉素材:不确定、不需要、评审前需要、已附上,或生成视觉指南。
文档影响哪些文档受影响:不确定、无需更新文档、公开文档、用户指南、设置说明,或支持手册。
评审和 QA预期的检查级别:不确定、仅评审、浏览器冒烟测试、数据库或迁移检查、LSP 或静态检查、目标 QA,或完整评审和 QA。
持久环境环境影响:不确定、无持久环境影响、仅默认值或配置、需要目标 QA,或预期为升级候选。
路由、组件或 WebCentral 版本自由文本字段,例如“/ci-review、SharedDrivePage 或 WebCentral 2025.02。”

路由字段为纯文本,限制为 300 个字符。保持标识符通用;不要包含任何敏感内容。

保留附带的页面和账户上下文

底部是包含页面和账户上下文复选框,默认处于选中状态。当它打开时,留言会携带当前页面路径和你的账户上下文,这样团队无需你描述就能看到你当时所在的位置。

除非你有特定理由,否则请保持勾选。仅当你不愿附带该上下文时才取消勾选。

发送并保存标识符

  1. 选择发送。提交期间按钮会显示“正在发送…”。
  2. 成功后,表单顶部会出现一条确认信息,内容为已作为 <identifier> 发送,有时还带有在 Linear 中打开链接。
  3. 复制标识符并保存以便后续跟进。Console 中没有过往反馈的列表,因此这一引用就是你的记录。
  4. 选择关闭以关闭对话框。

如果发送失败,则会显示错误提示。请检查你的连接并重试;如果一直失败,请从“支持”选项卡打开一个结构化工单。

何时使用反馈,何时使用支持工单

当你想从任意页面快速发送留言时,尤其是想顺便标记 bug、缺口或成功时,请使用反馈。当你需要一个分类的、按严重程度排序、有明确下一负责人的工单时,请使用支持选项卡。该流程参见 /support-handoff/,报告问题前可尝试的步骤参见 /troubleshooting/

相关指南

完成标志

  • 类型和影响程度与实际发生的情况相符。
  • 主题和详细信息已填写(两者均为发送所必需)。
  • 敏感值未出现在主题、详细信息和路由字段中。
  • 你已保存返回的标识符以便后续跟进。