qing
c7ef7e715c
问题：收到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日志
92 lines
4.9 KiB
Markdown
92 lines
4.9 KiB
Markdown
# BotOps — aibox 智能体 TUI 前端
|
||
|
||
复刻并增强 [aibox/client.py](../aibox/client.py)，基于 [Textual](https://textual.textualize.io/) 的现代化终端 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 清屏 |
|
||
|
||
## 安装与运行
|
||
|
||
```bash
|
||
cd BotOps
|
||
|
||
# 一键初始化（创建 venv + 安装依赖）
|
||
bash _set.sh
|
||
|
||
# 启动
|
||
bash _run.sh # 默认 ws://localhost:8765
|
||
bash _run.sh ws://your-host:8765 # 指定 aibox 地址
|
||
```
|
||
|
||
### Nuitka 编译为独立二进制
|
||
|
||
```bash
|
||
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 增量流式渲染、任务独立侧栏、自动重连、快捷键支持
|