koishi-plugin-steaminfo-xiaoheihe
Version:
通过小黑盒网站搜索并生成截图获取 steam 游戏信息
82 lines (51 loc) • 3.37 kB
Markdown
# koishi-plugin-steaminfo-xiaoheihe
[](https://www.npmjs.com/package/koishi-plugin-steaminfo-xiaoheihe)
一个为 [Koishi](https://koishi.chat/) 设计的插件，允许用户通过指令搜索小黑盒上的内容，并返回一个包含游戏信息的截图。
## ✨ 功能
- 对小黑盒游戏详情页进行截图。
- 提取游戏标题和在线人数。
- 支持配置小黑盒 Cookie 以访问需要登录才能查看的内容。
## 🚀 安装
**前往 Koishi 插件市场，搜索 `steaminfo-xiaoheihe` 并安装。**
## 📝 使用
启用插件后，向机器人发送指令即可：
- **`小黑盒 <游戏名称>`**
- 别名: **`xiaoheihe <游戏名称>`**
**示例：**
```
小黑盒 三角洲行动
```
机器人将会回复包含该游戏信息的高清截图。
## ⚙️ 配置项
所有配置项均可在插件的设置界面中进行修改。
### 身份验证
- **cookies**: (选填，但建议填写) 登录小黑盒后获取的Cookie字符串。提供后可以正常使用搜索功能，并访问需要登录才能查看的内容。
### 高级设置
- **waitTimeout**: 页面加载的超时时间（毫秒）。
- **renderDelay**: 在内容框架出现后，额外等待渲染的时间（毫秒），用于确保图片等动态内容加载完成。
- **deviceScaleFactor**: 截图清晰度。设置为 `2` 可获得更清晰的“视网膜”截图效果。
- **imageType**: 截图的图片格式。`jpeg` 文件较小，`png` 画质无损但文件较大。
- **imageQuality**: 图片质量，仅在格式为 `jpeg` 时生效。
### 显示设置
- **showGameTitle**: 是否在截图前显示“游戏名”文本。
- **showOnlineCount**: 是否在截图前显示“当前在线”文本。
### 调试
- **debug**: 启用后，将在控制台输出详细的运行日志，方便排查问题。
---
### 如何获取小黑盒 Cookie？
1. 在你的电脑浏览器（推荐 Chrome 或 Edge）中，访问并登录 [小黑盒官网](https://www.xiaoheihe.cn/)。
2. 登录成功后，在当前页面按 `F12` 键，打开“开发者工具”。
3. 切换到“网络” (Network) 面板。
4. 按 `F5` 刷新一下页面，此时面板中会显示很多网络请求。
5. 在请求列表中，随便点击一个发往 `www.xiaoheihe.cn` 的请求。比如 [](https://postimg.cc/Hrd3j2pq)
6. 在右侧新出现的窗口中，找到“请求标头” (Request Headers) 部分。
7. 找到名为 `cookie:` 的一行，右键点击它，选择“复制值” (Copy value)。
8. 将复制的整段字符串粘贴到本插件配置项的 `cookies` 输入框中即可。
## ⚠️ 免责声明
- 本插件通过模拟浏览器操作访问公开的网页信息，所有数据均来自小黑盒 (xiaoheihe.cn)。
- 本插件仅供学习和技术交流使用，用户应自觉遵守相关法律法规及网站的用户协议。
- 因滥用本插件或因小黑盒网站结构变更导致的任何问题，开发者不承担任何责任。
- 请勿将本插件用于任何商业或非法用途。
## 📄 License
本插件使用 [MIT License](https://github.com/WhiteBr1ck/koishi-plugin-steaminfo-xiaoheihe/blob/main/LICENSE) 授权。
© 2025, WhiteBr1ck.