superset-feedback

Superset 反馈

帮助用户将其关于 Superset 的反馈整理成规范的报告，并提交到他们选择的渠道。将他们在命令后输入的内容视为初始内容。

1. 收集背景信息（尽力而为，不要因此阻塞）

并行运行；任何命令失败都跳过：

• 运行 superset --version 和 uname -sm，获取环境信息
• 运行 superset auth whoami，获取已登录的用户／组织信息（仅限私密提交）

除非询问用户并获得明确同意，否则不要包含仓库内容、终端输出或日志。

对于错误，还要征求用户同意（切勿自行假定）：

• 截图 — 如果是视觉问题且可以截图，询问用户是否愿意附上截图。证据胜过描述。
• 诊断信息 — 询问用户是否愿意通过 --diagnostics 标志附上诊断包（CLI 版本、操作系统、最近 200 行应用日志）。获得同意前，告诉用户日志可能包含文件路径和项目名称。

2. 分类并起草

根据用户的描述，将反馈归类为错误、功能请求或一般反馈；仅在确实无法判断时才提问。然后起草：

• 标题 — 单行，使用祈使语气，具体明确
• 发生了什么／你希望实现什么 — 用用户的语气写 2 至 5 句话
• 复现步骤 — 仅限错误，使用编号列表
• 环境 — Superset 版本、操作系统（仅限错误）

3. 询问提交渠道

展示完整草稿，然后询问用户（如果有 ask_user 工具则使用，否则直接提问），并严格提供以下选项：

1. 私密发送给 Superset 团队
2. 创建公开 GitHub issue
3. 先编辑草稿
4. 取消

在用户明确选择 1 或 2 之前，绝不要提交任何内容。用户编辑草稿时，循环处理。

4. 提交

私密提交：

• 如果 superset feedback --help 执行成功（退出码为 0），通过标准输入提交（注意：--body-file=- 中等号不可省略；用空格分隔的 - 会被解析器拒绝）：

  superset feedback submit --type bug --title "..." --body-file=- <<'EOF'
  <drafted report>
  EOF
  

  只有在第 1 步获得用户同意后，才添加 --attach /path/to/screenshot.png（路径以逗号分隔，总计不超过 10MB）和／或 --diagnostics。提交内容会通过用户的 Superset 账号发送，副本会抄送给用户，团队会回复到该账号的电子邮箱。
• 如果缺少 CLI 或未登录（superset auth whoami 执行失败），先询问用户是否运行 superset auth login；如果用户拒绝，则改用电子邮件：提供可点击的 mailto 链接（mailto:[email protected]?subject=<url-encoded title>&body=<url-encoded body>），并同时打印原始草稿，方便用户复制。

公开提交：

• 先检查是否存在重复 issue：运行 gh search issues -R superset-sh/superset "<key terms>" --limit 5。如果找到匹配的现有 issue，展示该 issue，并询问用户是否要在那里发表评论（gh issue comment），而不是新建 issue；只有在用户确认问题确实不同时，才创建新 issue。
• 如果已安装 gh 且 gh auth status 执行成功：运行 gh issue create -R superset-sh/superset --title "..." --body "..."（通过 heredoc 或临时文件写入正文，切勿在命令中直接转义嵌入）。
• 否则，在浏览器中打开预填表单：https://github.com/superset-sh/superset/issues/new?title=<url-encoded>&body=<url-encoded>。

5. 确认

向用户报告 issue 链接（公开提交），或确认已发送的内容及收件人（私密提交）。如果任何操作失败，请展示草稿，确保用户写的内容不会丢失。