# kb-bot —— 飞书群知识库问答机器人

> 群里 @机器人 提问 → 查知识库 → 带溯源回复。**长连接，无需公网服务器。**
> 底座：lark-cli（bot 身份自管凭据，不入库）。详见 `docs/08-飞书双向前端方案.md`。

## 组件

| 文件 | 作用 |
|---|---|
| `subscribe.sh` | 起 WebSocket 长连接，把 @机器人 群消息事件落到 `events/` |
| `handle.py` | 轮询 `events/`，抽问题→调 `/kb-ask`→`lark-cli` 回复 |
| `send.sh` | 手动发消息（验证发消息通路用） |

## 分步验证

```bash
# P2-a 发消息：查群 id 后手动发一条
lark-cli im +chat-search --query "你的群名"
bash tools/kb-bot/send.sh oc_xxxxx "**kb-bot 上线测试**"

# P2-b 收消息：起长连接，去群里 @机器人 说句话，看 events/ 是否落文件
bash tools/kb-bot/subscribe.sh        # 前台观察

# P2-c 闭环：另开一个终端跑消费者
python3 tools/kb-bot/handle.py --watch
```

## 常驻部署（验证通过后）

跑在任一常开机器（Mac mini / VPS 皆可，长连接不挑落点）：

```bash
nohup bash tools/kb-bot/subscribe.sh > /tmp/kb-bot-sub.log 2>&1 &
nohup python3 tools/kb-bot/handle.py --watch > /tmp/kb-bot-handle.log 2>&1 &
```

稳定后再包成 launchd(macOS)/systemd(Linux) 常驻服务。

## 铁律（继承知识库）

- 机器人**只读**知识库，绝不写/删。
- 答案强制带 `source_link` 溯源；无据回「知识库暂无」，**绝不编造**（由 `/kb-ask` 保证）。
- `events/` 与 `.seen-msg-ids` 是运行时产物，已 gitignore。