# 傅卿何 example

**Repository Path**: Tloml-Starry/Plugin-Example

## Basic Information

- **Project Name**: 傅卿何 example
- **Description**: 傅卿何的小型插件仓库
- **Primary Language**: JavaScript
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 32
- **Forks**: 7
- **Created**: 2023-01-28
- **Last Updated**: 2026-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Plugin-Example

> 一套给 [Yunzai-Bot V3](https://gitee.com/Le-niao/Yunzai-Bot) 和 [A-Yunzai](https://gitee.com/ningmengchongshui/azai-bot) 用的单文件小插件，对接公开 API，丢进目录就能跑。

![插件数量](https://img.shields.io/badge/插件-18个-blue)
![最后测试](https://img.shields.io/badge/最后测试-2026--11--04-brightgreen)

本库持续更新，以"好玩的现成接口"为主。发现好接口欢迎提 [issues](https://gitee.com/Tloml-Starry/Plugin-Example/issues)。
插件报错、功能不适配，同样请提 [issues](https://gitee.com/Tloml-Starry/Plugin-Example/issues) 或直接联系[作者](https://gitee.com/Tloml-Starry)。

---

## 快速开始

**方式一：整仓克隆（推荐）**

```bash
cd Yunzai-Bot
git clone https://gitee.com/Tloml-Starry/Plugin-Example.git ./plugins/Plugin-Example
```

克隆后重启 Bot 即可。插件在 `plugins/Plugin-Example/JavaScript/` 下，相对引用 `../../lib/...` 正好指向 Bot 根目录的 `lib`，所以**整个仓库必须放在 `plugins/<任意目录名>/` 这一层**，别再往里多套一层文件夹。

**方式二：单文件安装**

挑需要的 `.js` 丢进 `plugins/example/`（或任意 `plugins/<目录>/`），重启生效。

> ⚠️ 文件名里带 `[` `]` `&` 空格 等字符，直接用 curl / 浏览器直链下载会因为 URL 编码问题 404。单文件安装请用 Git 克隆后复制，或在网页上"另存为"。

**通用要求**

- Node.js 环境随 Bot 自带来，无需额外装包；`node-fetch`、`puppeteer` 均使用 Bot 内置的。
- 无需 Redis，数据走本地 JSON。

---

## 插件总览

### 游戏 / 工具对接

| 插件 | 指令 | 前置 | 状态 |
| --- | --- | :---: | :---: |
| CS2库存查询 | `cs库存查询`、`绑定steamid<17位>` | Steam 库存需公开 | ✅ |
| Epic免费游戏 | `#喜加一` | — | ✅ |
| 光遇身高查询 | `身高查询`、`绑定sid/fc/key`、`设置公共key` | [t1qq](https://api.t1qq.com) Key | 🔑 |

### 群管理 / 实用

| 插件 | 指令 | 前置 | 状态 |
| --- | --- | :---: | :---: |
| 留言板 | `查看留言板[页码]`、`留言 <内容>`、`点赞留言<ID>`、`热门留言`、`删除留言<ID>` | 主人权限可删 | ✅ |
| 发言榜 | `#发言榜`、`#昨日发言榜` | — | ✅ |
| 群打卡·续火·抽字符 | `执行打卡`、`执行续火` | 需改文件配置 | ✅ |
| 手机号估价 | `手机号估价<11位号码>` | — | ✅ |

### 娱乐

| 插件 | 指令 | 前置 | 状态 |
| --- | --- | :---: | :---: |
| 电子木鱼 | `敲木鱼`、`[今日/本群]功德榜`、`木鱼记录` | — | ✅ |
| 塔罗牌 | `塔罗牌` | — | ✅ |
| 答案之书 | `答案之书` | — | ✅ |
| 发病语录 | `发病语录` | — | ✅ |
| 狗屁不通 | `狗屁<主题>` / `gp<主题>` | — | ✅ |
| 文字找茬 | `文字找茬[简单/普通/困难]`、`结束文字找茬`、`列<行>横<列>` | — | ✅ |
| 表情包搜索 | `表情包搜索<关键字>` | — | ✅ |
| 抽象网名生成 | `网名生成<关键字>` | — | ✅ |
| 碧蓝档案文字图 | `BA<开头>:<结尾>` | 前后各限 64 字 | ✅ |
| 抖音AI图生图 | `抖音AI生图` + 图片 | — | ✅ |
| 刷听歌时长 | `查询听歌时长`、`#Q音登录` → `over` → `刷听歌时长` | QQ音乐登录态 | ⚠️ |

**状态说明**：✅ 正常 ｜ 🔑 需自备 Key ｜ ⚠️ 上游接口故障，代码无损，等接口恢复即可用。

---

## 需要手动改的地方

这些都写在文件顶部，改数字/开关即可，不用改逻辑：

| 文件 | 可调项 | 说明 |
| --- | --- | --- |
| `[Task]群打卡&诗词续火&抽字符 V1.1.js` | 群号、执行时间 | 文件内有详细注释 |
| `刷听歌时长.js` | `num` | 刷取遍数，上限 412 |
| `刷听歌时长.js` | `mid` | 指定音乐 ID，[获取方法](https://gitee.com/Tloml-Starry/Plugin-Example/raw/master/PICTRUE/QQ音乐ID获取.png) |
| `狗屁不通.js` | `length` | 文章长度，10–10000 |
| `抽象网名生成.js` | `num` | 生成数量，上限 50 |
| `[Sky]身高查询[用户自填Key].js` | — | Bot 内 `绑定key` 或 `设置公共key`，不用改文件 |

---

## 数据存放

留言板、发言榜、电子木鱼、文字找茬等数据存在 **Bot 根目录的 `data/` 下**（本地 JSON，不用 Redis）。备份/迁移时记得带上。

---

## 测试与维护状态

最近一次全量测试：**2026-11-04**，方式为 `node --check` 语法检查 + 接口实况调用 + 数据解析冒烟测试。当前仓库保留 **18 个**插件，语法检查全部通过。

**因上游失效移除**

| 插件 | 原因 |
| --- | --- |
| New Bing | 上游 ovoa.cc 全站加了 JS 反爬，返回 HTML 挑战页，`response.json()` 必然抛错 |
| [陈泽][丁真][孙笑川]语音合成 | 同上 |
| Steam在线游戏人数排行 | 上游 `yujn.cn/api/steam.php` 已停更（2023-08 后再无维护），官方示例返回的就是"没有获取到数据" |
| 福布斯全球富豪榜 | 上游 `yujn.cn/api/fbs.php` 同上 |
| 随机滑稽 | 图库资源目录 404，图片和索引 JSON 均已不可访问 |

**按维护计划下线**

以下插件功能正常或可修复，但依赖外部游戏数据源、维护成本高，已从本库下线。如需使用，可从 git 历史中取回对应提交。

| 插件 | 说明 |
| --- | --- |
| 原神世界BOSS | 依赖 miao-plugin 的 `MysInfo` 与 mihoyo 静态 JSON |
| 原神背包查询 | 同上 |
| 卡池信息查询 | 依赖 mihoyo 卡池记录 JSON |
| 鸣潮卡池查询 | 依赖库洛卡池记录 JSON |
| 王者战绩查询 | 上游 `wzzj.php` 返回 500，`wzyd.php` 连官方示例 ID 都返回"参数有误" |
| 最近节日查询 | 依赖第三方节日接口 |
| 手机处理器排行榜 | 依赖 `yujn.cn` 排行接口 |
| 手机跑分排行榜 | 同上 |

**待上游恢复**

| 插件 | 现状 |
| --- | --- |
| 刷听歌时长 | `QQMusic_RunTime` 返回"该 Api 暂时无法访问，可能在维护中"；登录取二维码的接口正常 |

---

## 更新日志

**2026-11-04**
- 下线 8 个依赖外部游戏数据源的插件（详见上方"按维护计划下线"）。
- 全量测试 31 个插件，移除 5 个因上游失效的插件。
- 修复抖音AI图生图、原神世界BOSS、鸣潮卡池查询的接口问题。
- 重写 README：指令全部按代码实际正则校对（旧文档里 CS2、手机号估价等指令写法有误），补充前置条件与测试状态。
- 移除 README 中的访问量统计。

**2024-11-13**
- 移除多个插件的直链下载说明，简化安装步骤。

---

## 致谢

| 提供方 | 涉及插件 |
| --- | --- |
| [OIAPI](https://oiapi.net/) | 刷听歌时长丨抖音AI图生图丨碧蓝档案文字图丨塔罗牌丨狗屁不通丨文字找茬丨答案之书丨表情包搜索丨发病语录 |
| [独角兽API](https://d.ovooa.cc/) | 手机号估价 |
| [遇见API](https://api.yujn.cn/) | 抽象网名生成 |

## 联系我

- QQ：[3620060826, 1947425850]（大号常冻，急事加小号）
- QQ群：1030599760
- 也可以直接在[主页](https://gitee.com/Tloml-Starry)私信

## License

见 [LICENSE](./LICENSE)。