问题:收到interrupt_ack时仅显示系统通知,没有立即收尾前端状态: - 思考区域一直停留在"💭 思考中..."状态,不会更新 - AI回复状态未重置,后续残留chunk可能继续追加 - 服务端不发送reasoning_end,思考区域无法正常结束 修复: - ChatView新增abort_reasoning()方法:中断时将思考区域标签更新为"🛑 思考已中断"(保留已展示内容) - append_reasoning()增加_ai_finalized检查,中断后丢弃残留思考片段,防止重新创建思考区域 - app.py收到interrupt_ack时:先abort_reasoning()更新思考区域,再finish_ai()收尾AI状态,最后显示系统通知 - 中断后服务端发来的残留chunk/reasoning/complete均被安全忽略(append_ai已有_finalized检查,finish_ai幂等) - 更新README v1.3日志
182 lines
7.9 KiB
Python
182 lines
7.9 KiB
Python
"""聊天视图:用户/AI/系统消息 + AI 回复流式 Markdown 渲染。
|
||
|
||
服务端协议(aibox/aibox.py output_callback 原样透传 msg_type):
|
||
- chunk 增量片段(正式回答内容),直接 append 到 AI 消息
|
||
- reasoning_start 思考开始信号,创建思考区域(在AI回答之前)
|
||
- reasoning 思考内容增量片段,追加到思考区域
|
||
- reasoning_end 思考结束信号
|
||
- complete 收尾信号:chunk 流式是内容权威来源,complete 仅用于收尾;
|
||
仅当流式完全丢帧(未建 widget 且无内容)时,用 full_text 补建
|
||
|
||
顺序保证:不预创建空AI widget,按消息到达顺序自然挂载。
|
||
- 先到 reasoning_start → 思考区域挂在最后
|
||
- 后到 chunk → AI回答挂在思考区域之后
|
||
- 无思考直接 chunk → AI回答挂在最后
|
||
"""
|
||
from textual.containers import VerticalScroll
|
||
from textual.widgets import Markdown, Static
|
||
|
||
|
||
class ChatView(VerticalScroll):
|
||
"""可滚动聊天区。AI 回复用单个 Markdown 部件增量 append,实现流式渲染。
|
||
|
||
不预创建空widget:避免重排复杂性,消息按接收顺序自然挂载,
|
||
天然保证思考过程在正式回答之前。
|
||
滚动策略:每条新消息挂载后调用 anchor() 锚定底部——之后内容增长
|
||
(流式 append)容器会自动保持吸底;用户上翻时 Textual 自动脱锚,
|
||
下一条新消息再重新锚定。
|
||
"""
|
||
|
||
def __init__(self, **kwargs):
|
||
super().__init__(**kwargs)
|
||
self._ai_widget: Markdown | None = None
|
||
self._reasoning_widget: Static | None = None
|
||
self._ai_text = ""
|
||
self._reasoning_text = ""
|
||
self._ai_finalized = True # 初始无活跃 AI 消息
|
||
|
||
@property
|
||
def ai_text(self) -> str:
|
||
return self._ai_text
|
||
|
||
def _anchor_bottom(self):
|
||
"""锚定吸底(需在布局刷新后执行,否则滚到的是旧位置)。"""
|
||
self.call_after_refresh(self.anchor)
|
||
|
||
async def add_user(self, text: str):
|
||
await self.mount(Static(f"👤 你: {text}", classes="msg-user", markup=False))
|
||
self._anchor_bottom()
|
||
|
||
async def add_system(self, text: str, css_class: str = "msg-system"):
|
||
await self.mount(Static(text, classes=css_class, markup=False))
|
||
self._anchor_bottom()
|
||
|
||
async def start_ai(self):
|
||
"""开始AI回复(标记状态,不预创建空widget)。
|
||
|
||
为保持顺序正确,空widget不在此处创建。第一个chunk到来时才创建AI widget,
|
||
此时思考widget(如果有)已经先挂载,顺序自然正确。
|
||
"""
|
||
if not self._ai_finalized:
|
||
return
|
||
self._ai_text = ""
|
||
self._ai_finalized = False
|
||
|
||
async def start_reasoning(self, hint: str = "🤔 思考中..."):
|
||
"""开始展示思考过程区域。直接挂载在当前末尾位置。"""
|
||
if self._reasoning_widget is not None:
|
||
return
|
||
self._reasoning_text = ""
|
||
self._reasoning_widget = Static(hint + "\n", classes="msg-reasoning", markup=False)
|
||
await self.mount(self._reasoning_widget)
|
||
self._anchor_bottom()
|
||
|
||
async def append_reasoning(self, delta: str):
|
||
"""追加思考内容增量。"""
|
||
if not delta:
|
||
return
|
||
if self._ai_finalized:
|
||
# 已收尾(中断/完成),丢弃残留的思考片段
|
||
return
|
||
if self._reasoning_widget is None:
|
||
await self.start_reasoning()
|
||
self._reasoning_text += delta
|
||
# 限制思考内容显示长度(最多显示最后 3000 字符,避免思考过长占满屏幕)
|
||
display = self._reasoning_text
|
||
if len(display) > 3000:
|
||
display = "...(前略)\n" + display[-3000:]
|
||
self._reasoning_widget.update(f"💭 思考中...\n{display}")
|
||
self.call_after_refresh(self.scroll_end, animate=False)
|
||
|
||
async def end_reasoning(self):
|
||
"""结束思考区域,更新提示文字。"""
|
||
if self._reasoning_widget is not None and self._reasoning_text:
|
||
# 思考结束后保持展示,更新标签为已完成
|
||
display = self._reasoning_text
|
||
if len(display) > 3000:
|
||
display = "...(前略)\n" + display[-3000:]
|
||
self._reasoning_widget.update(f"💭 思考过程({len(self._reasoning_text)}字符)\n{display}\n{'─' * 30}")
|
||
# 思考区域保留显示,不删除
|
||
|
||
async def abort_reasoning(self):
|
||
"""中断思考区域(用户Ctrl+C),更新提示文字为已中断。"""
|
||
if self._reasoning_widget is not None:
|
||
if self._reasoning_text:
|
||
display = self._reasoning_text
|
||
if len(display) > 3000:
|
||
display = "...(前略)\n" + display[-3000:]
|
||
self._reasoning_widget.update(f"🛑 思考已中断({len(self._reasoning_text)}字符)\n{display}")
|
||
else:
|
||
self._reasoning_widget.update("🛑 思考已中断")
|
||
|
||
async def _ensure_ai_widget(self):
|
||
"""确保AI widget存在(第一次chunk到来时创建)。"""
|
||
if self._ai_widget is None:
|
||
self._ai_widget = Markdown("", classes="msg-ai")
|
||
await self.mount(self._ai_widget)
|
||
self._anchor_bottom()
|
||
|
||
async def append_ai(self, delta: str):
|
||
"""追加增量片段(服务端 chunk 为增量语义,直接拼接)。"""
|
||
if not delta:
|
||
return
|
||
if self._ai_finalized:
|
||
# 收尾后收到的延迟 chunk,丢弃以避免在上一条回复后追加脏数据
|
||
return
|
||
# 第一次收到chunk时创建widget(此时思考widget如果存在已经在前面了)
|
||
await self._ensure_ai_widget()
|
||
self._ai_widget.append(delta)
|
||
self._ai_text += delta
|
||
# anchor 状态下容器会自动吸底;保险起见刷新后再滚一次
|
||
self.call_after_refresh(self.scroll_end, animate=False)
|
||
|
||
async def finish_ai(self, full_text: str = ""):
|
||
"""收尾一条 AI 消息。
|
||
|
||
chunk 流式追加是内容权威来源,complete 只做收尾:
|
||
- 已收尾则直接返回(防止 dialogue_ended + complete 双发导致重复挂载)
|
||
- widget 存在且有流式内容:保持已渲染内容不变,仅清空引用
|
||
- widget 存在但无内容(异常场景)且有 full_text:用 full_text 填充
|
||
- widget 不存在(未收到任何 chunk)且有 full_text:补建
|
||
- widget 不存在且无内容:正常无内容场景
|
||
"""
|
||
if self._ai_finalized:
|
||
return
|
||
w = self._ai_widget
|
||
self._ai_widget = None
|
||
|
||
if w is not None:
|
||
if self._ai_text:
|
||
# 有流式内容,chunk 已完整渲染,直接保留,不做替换
|
||
pass
|
||
elif full_text:
|
||
# widget存在但没收到任何chunk(异常):用full_text填充
|
||
w.update(full_text)
|
||
self._ai_text = full_text
|
||
else:
|
||
# widget存在但没有任何输出:移除空框(正常不会走到这里,因为不预创建)
|
||
await w.remove()
|
||
else:
|
||
# widget不存在(start_ai后没收到任何chunk),有full_text则补建
|
||
if full_text:
|
||
self._ai_text = full_text
|
||
self._ai_widget = Markdown(full_text, classes="msg-ai")
|
||
await self.mount(self._ai_widget)
|
||
self._ai_widget = None
|
||
self._anchor_bottom()
|
||
|
||
self._ai_text = ""
|
||
self._reasoning_widget = None
|
||
self._reasoning_text = ""
|
||
self._ai_finalized = True
|
||
self.call_after_refresh(self.scroll_end, animate=False)
|
||
|
||
async def reset(self):
|
||
"""清空聊天区(/clear)。"""
|
||
self._ai_widget = None
|
||
self._reasoning_widget = None
|
||
self._ai_text = ""
|
||
self._reasoning_text = ""
|
||
self._ai_finalized = True
|
||
await self.remove_children()
|