StreamControls (parar, tentar de novo, erro e limites)

未关闭
#1,206 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

Start in packages/ui/src/lib: git grep -il "StreamControl" returns nothing, so both components are new; read an existing component such as MessageBubble or Popover to copy the library's props and export conventions. The AC reference paths sit in a private repo and cannot be opened, so the acceptance criteria are the spec. Done means StreamControls and ChatError exported from the package with tests for the four checks: one user question after retry, 409 mapped to run_in_progress, a single role="alert" with focus on the retry button, and the error sound throttled per id.

由索引模型根据 Issue 内容生成。

描述

area:a11y area:components enhancement

Versão: @codeatlasdev/ui 4.6.0 · código lido em main (950628f2) · classe: lacuna (migração do AC)

Problema

O AC depende deste comportamento hoje e a lib não o oferece. Sem ele, a migração perde qualidade no desktop, no mobile ou no PWA.

O que a lib já oferece (para não duplicar) e o que falta

Conferido com git grep -il "StreamControl" origin/main -- packages/ui/src/lib (950628f2): nenhum resultado. Peças reaproveitáveis que existem: MessageBubble, VirtualList, ConversationItem, CodeSnippet (./code), CopyButton, Chip/ChipRow, Popover, Sheet, Spinner, toast.

Referência no AC

Caminhos do repo AC (repo privado, só caminho):

packages/ui/src/components/chat/chat-composer.tsx:293-297 (botão Parar); apps/seller/src/hooks/copilot/use-copilot-thread.ts:160-166 (retry); apps/seller/src/components/copilot/chat-messages.tsx:10-26 (ERROR_COPY por regex sobre error.message), :23-24 (fallback "Algo deu errado"), e os dois Callout de "A resposta não foi concluída" e "Erro ao gerar resposta"; apps/seller/src/components/copilot/copilot-provider.tsx:60-66 (som de erro a cada erro).

Defeitos do AC (leitura do código, não executado): - use-copilot-thread.ts:164: retry chama sendMessage({ text }), que acrescenta uma nova mensagem do usuário. A falha anterior fica no histórico: a conversa passa a ter a pergunta duas vezes e o servidor guarda as duas.

  • ERROR_COPY não cobre o 409 de seller-chat.ts:72-74 ("Resposta em andamento nesta conversa."): cai em "Algo deu errado".
  • Não há limite de uso, quota nem aviso de tokens. O 429 tem texto, mas o que o servidor de fato devolve não é verificado.
  • Não há "regenerar" para uma resposta específica: só repete a última pergunta.

Proposta

<StreamControls status onstop onretry onregenerate> e <ChatError code message onretry> que recebe um código (run_in_progress, rate_limited, network, timeout, unknown), não texto livre. onretry remove a falha anterior antes de reenviar, ou reenvia com messageId.

Critério de aceite (testável)

  • Após erro e "Tentar de novo", a conversa tem uma única pergunta do usuário (contagem igual antes e depois).
  • 409 mostra "Já há uma resposta em andamento nesta conversa." (código run_in_progress).
  • Erro é anunciado uma vez (role="alert") e o foco vai ao botão de tentar de novo.
  • Som de erro toca no máximo uma vez por falha (throttle por id).

Mãe: #1089

主要语言
TypeScript
星标
6
派生
3
平均合并
5 小时 21 分钟
30 天内合并 PR
378

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/ui 的其他 Issue

查看 codeatlasdev/ui 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。