注意:该插件为 早柚核心(gsuid_core) 的扩展,需要先安装好 GsCore 才能使用
安装方式一:手动克隆到 GsCore 插件目录后重启 Core:
cd /path/to/gsuid_core/gsuid_core/plugins git clone https://github.com/MimoKit/MikuSnap.git安装方式二:下载 ZIP 解压到插件目录后重启 Core
插件依赖已写入
pyproject.toml,新版 GsCore 会自动检查安装;如果你的 GsCore 版本不会自动处理依赖,请在同一 Python 环境中手动安装:pip install "httpx>=0.25.0" "playwright>=1.40.0" "Pillow>=10.0.0" playwright install chromium插件交流请加群:798949533
- 监听聊天中的 http/https 链接,自动用 Playwright 截图并发送
- 支持手动指定 URL 截图
- 默认深色模式渲染,支持
prefers-color-scheme: dark的网站自动切换暗色主题 - 智能过滤视频站(B站/YouTube/抖音等)、直链(图片/文件/压缩包)、内网地址
- 超长网页按视口高度用 Pillow 本地切成多张发送
- 限制同时运行的截图任务数,避免刷屏
- 可在 GsCore 控制台(webconsole)管理全部配置
帮助:
网页截图帮助
截图帮助
手动截图:
网页截图 https://example.com
网页快照 https://example.com
自动截图不需要命令,群聊/私聊中直接发送带链接的消息即可触发(可在配置中关闭)。
配置项可在 GsCore 控制台中修改,一般只需要关注下面几项:
| 配置 | 默认值 | 说明 |
|---|---|---|
| 启用 MikuSnap | ✅ | 总开关,关闭后手动命令和自动解析都不执行 |
| 自动解析网页链接 | ✅ | 是否自动监听聊天中的链接 |
| 深色模式 | ✅ | 以 prefers-color-scheme: dark 渲染网页 |
| 单条消息最多处理链接数 | 2 | 避免一条消息大量链接刷屏 |
| 最大并发截图数 | 1 | 同时运行的 Playwright 任务数 |
| 长网页分图 | ✅ | 超长网页本地切成多张发送 |
| 浏览器视口宽度 | 1365 | Chromium 页面宽度 |
| 浏览器视口高度 | 900 | Chromium 页面高度 |
| 跳过内网/本机地址 | ✅ | 跳过 localhost、内网、保留地址 |
更多配置(发送样式模板、超时参数、日志开关等)请在控制台查看。
MikuSnap/
├── __init__.py # 外层入口(包标记)
├── __nest__.py # 嵌套加载标记
├── pyproject.toml
├── ICON.png # 插件图标
└── MikuSnap/
├── __init__.py # Plugins 注册 + 子模块导入
├── __full__.py
├── mikusnap_config/ # 配置(config_default + StringConfig)
├── mikusnap_capture/ # 手动/自动截图触发器
├── mikusnap_help/ # 帮助系统(register_help)
├── mikusnap_status/ # core 状态注册
└── utils/ # 截图服务、配置读取、资源路径
- 本项目仅供学习使用,请勿用于商业用途。
- 本项目采用 GNU General Public License v3.0(GPLv3) 开源。你可以使用、修改和分发,但需保留许可证与版权声明;分发修改版时按 GPLv3 继续开放对应源码。