Skip to content

feat(agent): Codex 式插话 — Enter 插话、Tab 排队、托盘持久化、不并发第二个 Run - #229

Merged
avabbbb merged 1 commit into
mainfrom
feat/agent-steer-queue
Nov 19, 2026
Merged

avabbbb merged 1 commit into
mainfrom
feat/agent-steer-queue

Conversation

@avabbbb

@avabbbb avabbbb commented Nov 19, 2026

Copy link
Copy Markdown
Owner

What and why / 改了什么、为什么

Codex 式插话:Run 在跑时不再并发开第二个 Run,而是让用户「插一句」或「排到后面」。外观沿用 OfferU 现有胶囊 / 玻璃 Token,紫色 = Agent。

  • Enter = 插话:Run 在跑时发送键变「插话」,Enter 经 POST /api/agent/runtime/runs/:id/steer 把这句话交给正在跑的 Run,下一步之前送到模型(后端已有,服务端同时把它存进对话);气泡上方紫色小标「插话」。返回 not_running 或请求失败时,消息从对话里撤下、放回队首,不丢。
  • Tab = 排队:放进输入框上方的托盘 AgentQueueTray;这一轮结束、且不在等用户(Ask / 可恢复)、没报错时,依次自动发出。每条可「插话 / 发送」「拉回输入框改」「删除」。
  • 托盘持久化:localStorage offeru.agent.queue.v1,按对话分开,新对话第一次保存后跟过去;刷新后读回的条目标为未就绪(不自动发,要点发送),避免页面一打开就自己发消息。
  • 不并发第二个 Run:输入框、建议胶囊、其他页面(drainAgentCompose)在 Run 进行中来的请求一律插话 / 排队;附件在 Run 进行中不发(提示等这一轮结束)。
  • lib/agentSteerQueue.ts(纯函数:按键意图、入队 / 队首 / 移除 / 按对话筛选 / 下一条 / 重绑定 / 读写存储)、agentRuntimeApi.steer、docs/design/components.md。

怎么测的 / Testing

  • backend-ts: 新增「运行中插话」契约测试(Run 卡在第一步时 steer → steered;第二步请求里有这句 user 消息;对话里顺序是 问 / 插话 / 答;结束后 steer → not_running);vitest ✅、typecheck ✅。
  • frontend: 新增 agentSteerQueue.test.ts(Enter/Tab 意图含输入法组合、Shift、无文字;入队上限、队首、按对话、重绑定、存储往返与坏数据)、AgentQueueTray.test.tsx(渲染、插话 / 发送 / 修改 / 删除回调、恢复条目与暂停提示);typecheck ✅、vitest ✅、design:audit ✅ 0 new、build ✅。

风险 / Risk

  • 低
  • 中:改了输入框 Enter / Tab 行为(只在 Run 进行中)
  • 高

怎么撤回 / How to revert

revert 这个 PR;无数据变更(队列只在浏览器 localStorage)。

Checklist

  • Tests or checks run / 已运行测试或检查
  • AI-assisted / AI 辅助:yes

@avabbbb
avabbbb merged commit da873c5 into main Nov 19, 2026
13 checks passed
@avabbbb
avabbbb deleted the feat/agent-steer-queue branch November 19, 2026 07:47
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