0 Fork 0

Files

T

qing c7ef7e715c fix(botops): v1.3 - 适配服务端中断机制，Ctrl+C立即可靠停止

问题：收到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日志

2026-08-01 14:12:27 +08:00

4.9 KiB

Raw Blame History

BotOps — aibox 智能体 TUI 前端

复刻并增强 aibox/client.py，基于 Textual 的现代化终端 UI，连接 aibox 微服务（WebSocket，默认 ws://localhost:8765）。

相比 client.py 的增强

能力	client.py	BotOps
AI 回复渲染	纯文本流式 / 一次性静态渲染	Markdown 增量流式渲染（无闪烁）
终端管理	手搓光标/提示符	Textual 部件框架（多面板布局）
任务事件	混在对话流里	独立侧栏（task_process / task_status / task_error）
自动重连	✅（已移植）	✅ 指数退避 2s→30s，`/disconnect` 抑制
快捷键	Ctrl+C 中断	Ctrl+C 中断 / Ctrl+Q 退出 / Ctrl+L 清屏

安装与运行

cd BotOps

# 一键初始化（创建 venv + 安装依赖）
bash _set.sh

# 启动
bash _run.sh                        # 默认 ws://localhost:8765
bash _run.sh ws://your-host:8765    # 指定 aibox 地址

Nuitka 编译为独立二进制

bash _inst.sh        # 产出 ./botops.bin（单文件，无需 Python 环境）
./botops.bin [ws://host:port]

命令

本地命令（不发给服务器）：/connect /disconnect /interrupt /clear /status /help /quit
其余 / 命令透传给 aibox 服务器（与 client.py 行为一致）

结构

BotOps/
├── app.py            # Textual App：布局 + 消息路由 + 快捷键
├── ws_client.py      # WebSocket 协议层（自动重连）
├── commands.py       # 斜杠命令注册表
├── _run.sh           # 启动脚本
├── _set.sh           # 初始化脚本（venv + 依赖安装）
├── _inst.sh          # Nuitka 编译脚本（产出 botops.bin）
├── requirements.txt  # Python 依赖
└── widgets/
    ├── __init__.py
    ├── chat_view.py  # 聊天区：AI 回复 Markdown 增量流式渲染
    └── status_bar.py # 底部状态栏（连接状态）

协议说明

与 aibox 服务端协议完全兼容（详见 aibox/client.py 注释）：

发送：{"type":"message","content":...} / {"type":"command","command":"/..."} / {"type":"interrupt",...}
接收：
- chunk（增量片段）：服务端 chunk_buffer 发送后即清零，前端直接 append_ai 拼接，为内容权威来源
- reasoning_start（思考开始）：创建灰色斜体思考区域，实时展示 AI 思考过程
- reasoning（思考流）：思考内容增量片段，追加到思考区域（超长自动折叠显示最后 3000 字符）
- reasoning_end（思考结束）：思考结束，切换到正式回答
- 顺序保证：不预创建空 AI widget，按消息到达顺序自然挂载（reasoning_start→reasoning→chunk），思考区域必然在 AI 正式回答之前
- complete（收尾信号）：chunk 流式已完整渲染，complete 仅用于收尾（重置状态）
- line（过程行）：🔧 工具调用提示、工具输出，路由到任务侧栏；助手前缀/思考提示在聊天区已由对应区域承载，不重复展示
- info（系统信息）：过滤"Conversation started"/"对话开始"等隐式通知，避免污染聊天流
- dialogue_ended / dialogue_reset / task_added / task_process / task_status / task_error / interrupt_ack / error / command_result / connection_ack / notification / pong

更新日志

v1.3

✅ 适配服务端中断机制（Ctrl+C可靠停止）：
- 收到 interrupt_ack 时立即收尾前端状态：调用 abort_reasoning() 将思考区域更新为"🛑 思考已中断"标签，调用 finish_ai() 结束AI回复状态
- 新增 ChatView.abort_reasoning() 方法：中断时更新思考区域标签（保留已展示的思考内容）
- append_reasoning() 增加 _ai_finalized 检查，中断后丢弃残留的思考片段防止重新创建思考区域
- 中断后服务端发来的残留 chunk/reasoning/complete 消息均被安全忽略，不会污染UI

v1.2

✅ 彻底修复思考区域顺序问题：移除预创建空 AI widget 的逻辑，改为第一次收到 chunk 时才创建 widget。按消息到达顺序自然挂载（reasoning_start→reasoning→chunk），从根本上保证思考区域始终在正式回答之前
✅ 简化 complete 处理逻辑：仅作为收尾重置状态信号，不再进行补建逻辑

v1.1

✅ 支持 DeepSeek 思考模式展示：新增 reasoning_start/reasoning/reasoning_end 消息处理，思考内容以灰色斜体区域展示
✅ 超长思考内容自动折叠（显示最后 3000 字符）
✅ 过滤"Conversation started"/"对话开始"等隐式系统通知，避免在回答末尾显示无用信息

v1.0

初始版本：Markdown 增量流式渲染、任务独立侧栏、自动重连、快捷键支持

4.9 KiB Raw Blame History Unescape Escape

BotOps — aibox 智能体 TUI 前端

相比 client.py 的增强

安装与运行

Nuitka 编译为独立二进制

命令

结构

协议说明

更新日志

v1.3

v1.2

v1.1

v1.0

4.9 KiB

Raw Blame History