Skip to content

feat(chat): 流式配速 + 就地编辑重发 + 单入口回退(0.4.14–0.4.16) - #12

Merged
CjiW merged 3 commits into
masterfrom
agent/peer/reveal-batch/paced-text-reveal-plus-sse-eve
Nov 3, 2026
Merged

CjiW merged 3 commits into
masterfrom
agent/peer/reveal-batch/paced-text-reveal-plus-sse-eve

Conversation

@CjiW

@CjiW CjiW commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

概述

三个面向"手感"的改动:

  1. 配速显示 + 事件合批(0.4.14):流式文本不再"一阵一阵蹦",改为按积压量匀速吐字;SSE 事件按 60ms 窗口合批。
  2. 就地编辑重发(0.4.15):Rewind 从"选消息 → 回退 → 再打字"改成"用户消息下方点编辑 → 改完确认 → 回退并重发"。
  3. 单入口 + 只回退不发送(0.4.16):删掉顶栏的回退对话框,编辑框里多一个「仅回退」。

1. 配速显示 + 事件合批(0.4.14)

借鉴 getpaseo/paseo 移动端:agent-stream/text-reveal.ts、docs/agent-stream-performance.md、timeline/session-stream-reducers.ts。

ui/TextReveal.kt

  • 到达只更新目标长度,显示速率由积压反推:computeRevealStep(backlog, elapsedMs) 每帧推进 backlog * elapsed / 150ms(向上取整、至少 1 字)。
  • 首次整段、结束 snap:revealed 初值 text.length,streaming = false 立刻显示全文 —— 历史消息、重挂载无需特判。
  • 字素安全切点:看切点之后是否附加成分 / ZWJ / 低位代理,是就整簇后退(emoji、组合音标不闪半字形)。
  • head + tail 切分(stableBlockBoundary,避开未闭合 ``` 围栏):head 只在整块写完时变,命中 MarkdownText 内部的 `remember(text)`;每帧只重解析短 tail。

chat/EventBatcher.kt

Flow<T>.batchByWindow(windowMs = 60, maxBatch = 64):leading + trailing。窗口里第一条立刻发(否则每回合首字多等一个窗口),随后最多再攒 60ms;ChatViewModel 把一批事件在一个 _state.update 里 fold 完。

配套:内容增长时粘底(ChatScreen)

配速让正文每帧长一点,靠"尾部指纹变化"触发贴底会滞后一个合批窗口。新增盯 layoutInfo 的 effect:跟随状态下按 deficit 单次 scrollBy;isScrollInProgress 为真(用户手势)立即停手。

2. 就地编辑重发(0.4.15)

旧流程:顶栏「回退」→ 选消息 → 等 rewind + 历史重载 → 草稿回到输入框 → 才能改 → 发送。中间那段空白用户只能干等。

  • 每条用户消息下方有「编辑」按钮(canRewindTurn():持久化历史 id、正文非空、无回合在跑、不在回退中)。
  • 点开 EditMessageDialog:预填原文、自动聚焦;改完点「确定并重新发送」才发起回退。
  • ChatViewModel.rewindTo(...):rewindHistory → 等历史整体重载落地 → 再决定发不发。
    先发再重载会让新消息挂在旧列表上、SSE 回声多出一条;不重载直接发则看起来像"消息发丢了"。
  • 回退期间 ChatUiState.rewinding 置位,禁用所有编辑入口,避免连锁回退。

3. 单入口 + 仅回退(0.4.16)

  • 删掉顶栏「回退」对话框(RewindDialog、rewindMessage、History 按钮):两个入口只会让文案和状态各说一套话。
  • 编辑对话框第三个动作 「仅回退」:只截断历史、什么都不发,编辑后的文字通过 ChatUiState.draft 回填输入框(UI 消费后 consumeDraft()),用户再决定发不发。

提交清单

版本 提交 内容
0.4.14 77ad9bc feat: paced reveal for streamed text + SSE event batching
0.4.15 2ea36d3 feat: edit-and-resend right under the user message
0.4.16 7b6dc98 feat: single rewind entry with an explicit "rewind only" action

验证

  • 113 个单测全部通过,新增:
    • TextRevealTest 17 个:步长(积压/时长/上限/horizon=0)、字素安全切点(代理对/组合音标/ZWJ 家庭 emoji)、稳定块边界(空行、围栏内外)
    • EventBatcherTest 7 个:leading 立即发、突发合成 trailing 批、跨窗口拆分、maxBatch 切分、顺序与零丢失、批次数收敛
    • RewindRulesTest 5 个:历史 id / 空正文 / 回合运行中 / 回退中
  • :app:lintVitalRelease、:app:assembleRelease 通过
  • 三个版本都已在真机验证(内部分发,不在仓库里)

说明

  • 状态层(ChatReducer)仍存全文,配速只作用于渲染切片 —— 复制、选中、滚动几何和屏幕一致。
  • 「编辑后重发」只带文字,原消息的附件不会回填(历史接口不返回 upload keys)。
  • 计划后续:把贴底收敛成显式 BottomAnchorController(请求枚举 + post-layout 校验)、加 Compose UI 回归用例(Maestro)。

关联

  • 新增 docs/agent/streaming.md(链路 + 「不要做的事」)、更新 docs/agent/chat.md(单入口 + 两个动作)

CjiW added 2 commits October 28, 2026 04:08
流式输出时文字一阵一阵地蹦,是「到达节奏」直接决定的;调小合批窗口只会让块更小更频繁。
这里的做法参考 Paseo 移动端(agent-stream/text-reveal.ts):

- ui/TextReveal.kt: 到达只更新目标长度,显示速率由积压反推
  (每帧 backlog*elapsed/150ms,至少 1 字);首次整段、结束 snap;
  切点按字素簇回退,emoji/组合字符不闪半字形;
  按稳定块边界切 head+tail,每帧只重解析短 tail
- chat/EventBatcher.kt: SSE 事件 leading + 60ms trailing 合批,
  一批事件在一个 _state.update 里 fold 完,不再每 token 重组
- ChatScreen: 内容增长时按 layout deficit 粘底(配速时最后一行不被压住)
- 单测:TextRevealTest 17 + EventBatcherTest 7,全量 108 个通过
- docs/agent/streaming.md 记录整条链路与「不要做的事」
旧流程是「先回退(等接口 + 重载历史)→ 再把草稿塞回输入框 → 才能打字」,中间那段空白
用户只能干等。改成先输入、确认后才回退:

- 每条用户消息下方新增「编辑」按钮(canRewindTurn 判定:有历史 id、正文非空、
  没有回合在跑、不在回退中)
- EditMessageDialog:预填原文、自动聚焦;点「确定并重新发送」才发起 rewind
- ChatViewModel.rewindAndResend(): rewind → 等历史整体重载落地 → 再 send,
  避免新消息挂在旧列表上、SSE 回声多出一条
- ChatUiState.rewinding:回退期间禁用所有编辑入口
- 新增 ui/RewindRules.kt(纯函数)+ RewindRulesTest 5 个用例;全量 113 个测试通过
- docs/agent/chat.md 补「两条入口 + 顺序为什么不能换」
@CjiW CjiW changed the title feat(chat): 流式文本配速显示 + SSE 事件合批 (0.4.14) feat(chat): 流式文本配速显示 + 就地编辑重发(0.4.14 / 0.4.15) Oct 28, 2026
… (0.4.16)

- 删掉顶栏「回退」对话框(RewindDialog.kt / rewindMessage / History 按钮):入口只保留
  用户消息下方的「编辑」,两个入口只会让文案和状态各说一套话
- 编辑对话框新增「仅回退」:只截断历史、不重新发送,编辑后的文字回填到输入框
- rewindAndResend → rewindTo(historyId, text, resend):resend=false 时把文字放进
  ChatUiState.draft,UI 回填输入框后 consumeDraft() 清空
- docs/agent/chat.md 更新为单入口 + 两个动作
@CjiW CjiW changed the title feat(chat): 流式文本配速显示 + 就地编辑重发(0.4.14 / 0.4.15) feat(chat): 流式配速 + 就地编辑重发 + 单入口回退(0.4.14–0.4.16) Oct 28, 2026
@CjiW
CjiW merged commit d9c39f4 into master Nov 3, 2026
1 check passed
@CjiW
CjiW deleted the agent/peer/reveal-batch/paced-text-reveal-plus-sse-eve branch November 3, 2026 02:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant