Metadata-Version: 2.4
Name: qwenpaw-llmvtuber-channel
Version: 1.0.0
Summary: QwenPaw LLMVTuber Channel - WebSocket频道，对接Open-LLM-VTuber前端
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: websockets>=12.0

# qwenpaw-llmvtuber-channel

QwenPaw 自定义频道插件，把 [Open-LLM-VTuber](https://github.com/Open-LLM-VTuber/Open-LLM-VTuber) 桌面端连到 QwenPaw Agent。

## 架构

```
LLMVTuber 桌面端 ←WS→ llmvtuber-channel ←ACP→ QwenPaw Agent
```

前端连过来，Agent 处理回复，Live2D 正常渲染。

## 安装

```bash
pip install qwenpaw-llmvtuber-channel
```

或者在 agent.json 里配 npx（需要 npm 包）：

```json
{
  "llmvtuber": {
    "enabled": true,
    "host": "0.0.0.0",
    "port": 8765
  }
}
```

然后放 `custom_channels/llmvtuber_channel.py` 到 QwenPaw 的工作目录下。

## WebSocket 协议

详见 [doc/ws_protocol.md](doc/ws_protocol.md)

### 前端→后端
| type | 说明 |
|:---|:---|
| `text-input` | 文字消息 |
| `heartbeat` | 心跳（每15s） |
| `interrupt-signal` | 打断AI回复 |

### 后端→前端
| type | 说明 |
|:---|:---|
| `set-model-and-conf` | 初始化握手 |
| `full-text` | AI回复 |
| `heartbeat-ack` | 心跳回复 |
| `error` | 错误信息 |

## 开发

```bash
pip install -e .
```

## 许可证

MIT
