## 📹 YouTube 监控插件测试与调试指南 (yt-recommend)

本模块主要用于管理员手动检查 API 数据抓取情况，以解决推送遗漏或 API 故障诊断的问题。

### 📋 前置条件

* 插件配置中必须填入有效的 **Google YouTube Data API v3 Key**。

* 目标博主必须已经通过 yt.add 等指令添加到了数据库中。

* 指令需要在已订阅该博主的群组或频道中运行。

### 1. 强制检查指令 yt.test

用于模拟一次完整的抓取流程，以确认 API 是否能正常获取到该博主的最新数据。它会自动分离出最新的一条视频和最新的一条社区帖子。

* **指令格式**： yt.test <博主名称>

* **示例**： yt.test hololive

**结果说明**：

* **Found!**：API 成功返回了数据。

* **API 未返回任何...数据**：说明在最近的 50 条动态中，没有该类型的内容。社区帖子（帖子）很常见，因为很多博主不常发。

### 2. 深度调试指令 yt.debug

用于查看 API 返回的原始数据列表，用于更细致的“诊断”，例如判断是否有新视频被错误地过滤掉。

* **指令格式**： yt.debug <博主名称>

**核心逻辑**：

1. 统计最近 50 条动态中，视频、帖子、其他类型的数量。

2. 列出前 15 条数据的类型、时间和标题摘要。

**符号图例**：

* 📺 \[upload]：上传的视频（包括直播回放、Shorts、首播）。

* 📝 \[bulletin]：社区动态（纯文字、投票或图片贴）。

* ❓ \[其他]：通常不作为通知内容。

### 🔑 诊断提示

* 如果 yt.debug 返回了列表，但平时没有自动推送，可能是上次更新时间记录的逻辑问题。

* 如果 yt.debug 直接报错或返回空列表，可能是 API Key 配额耗尽，或频道 ID 错误。

* 此指令每次调用都会消耗一定的 API 配额，请勿频繁使用。