Live2D 看板娘
让🉑爱的二次元少女住进你的浏览器
 |
 |
 |
 |
| 🩶Potion 的Pio酱 |
🩵Potion 的Tia酱 |
💚Potion 的Tia酱 |
💙Bilibili Live的22娘 |
——支持 2233娘、来自Potion Maker的Pio酱、Tia酱等等多位可爱角色，小娘子们会在你浏览网页时陪伴左右，提醒你喝水休息、帮你管理待办、播报天气信息，还会时不时说些俏皮话。
访客人数：
快速开始
1. 环境准备
首先得有个脚本管理器：
2. 脚本安装
3. 使用指南
- 装好脚本后随便打开个网页，右下角就会出现一个萌萌的看板娘啦（如下图所示↓）
- 把鼠标移上去，右边会出现一排小图标（这就是她的工具栏）
▸ ⚙️ 首次配置
方式一： 点击页面看板娘右侧工具栏的 齿轮图标 ⚙
方式二： 右上角扩展 → 脚本管理器 → 找到脚本菜单 → 点击「⚙ 看板娘设置」
配置步骤：
- 📝 在「基础」标签里给自己起个昵称（看板娘会用这个昵称称呼你哦~ 默认叫"宝宝"）
- 🔆 在「天气」标签里填你的城市（默认是广州，别忘了改成你那儿）
反馈与支持
- 反馈建议：欢迎在 赞赏留言 或者 反馈处 或者 评论区 或者 wx 提交
Bug报告 或 功能建议，作者会认真考虑
- 赞赏支持 — 点击看板娘工具栏赞赏图标（☕）
定制功能：
▸ 工具栏功能
看板娘右边那排图标都是干啥的：
| 图标 |
功能 |
说明 |
| 🏠 |
回首页 |
点一下回到网站首页，迷路了就用它 |
| 💬 |
一言 |
随机来句优美的话，一颗赛艇 |
| 🔆 |
天气 |
告知今天的天气情况，比打开天气 App 快多了 |
| 👤 |
换人 |
看腻了？换个小娘子 |
| 🪄 |
换装 |
给小娘子换套新衣服 |
| 📷 |
拍照 |
给看板娘拍张照（保存为 live2d.png） |
| 📋 |
待办 |
打开你的待办清单 |
| ⚙️ |
设置 |
各种参数都在这里调 |
| ☕ |
赞赏 |
觉得好用可以请萌萌的作者喝杯咖啡 |
| ❌ |
关闭 |
暂时让她消失（3秒后淡出） |
▸ 配置面板详解
1. 基础设置
- 昵称配置 — 看板娘将使用此名称称呼你（支持
{nickname} 变量）
- 黑名单开关 — 启用/禁用黑名单功能
- 黑名单列表 — 每行一个域名或关键词（如 localhost、127.0.0.1）
- 快捷添加 — 一键将当前网站添加到黑名单
- 恢复默认 — 重置为初始默认配置
2. 天气设置
- 省份配置 — 无需添加"省"后缀（如：广东、浙江、北京）
- 城市配置 — 无需添加"市"后缀（如：广州、深圳、杭州）
- 测试功能 — 点击"立即获取天气"验证配置
- 天气显示 — 分 4 段展示（基本信息/温度风力/空气质量/健康提示）
3. 健康提醒
- 总开关 — 启用/禁用所有健康提醒
- 工作时段 — 9:00-23:00（仅在此时段内提醒）
- 喝水提醒 — 默认 30 分钟间隔，可自定义台词
- 休息提醒 — 默认 60 分钟间隔，可自定义台词
- 坐姿提醒 — 默认 45 分钟间隔，可自定义台词
- 睡眠提醒 — 默认 23:00 触发，每天仅提醒一次
- 台词变量 — 使用
{nickname} 显示昵称
4. 自定义台词
- 点击回应 — 点击看板娘时的反馈（8 条默认台词）
- 空闲对话 — 1 分钟无操作后 30% 概率触发（4 条默认台词）
- 早安问候 — 5:00-11:00 时段（3 条默认台词）
- 午安问候 — 11:00-13:00 时段（3 条默认台词）
- 下午问候 — 13:00-18:00 时段（3 条默认台词）
- 晚安问候 — 18:00-22:00 时段（3 条默认台词）
- 深夜问候 — 22:00-5:00 时段（3 条默认台词）
- 台词格式 — 每行一句，支持 HTML 标签（如 Element UI 图标）
5. 待办事项
- 定时提醒 — 指定时间点触发（如 14:30）
- 间隔提醒 — 周期性循环提醒（如每 30 分钟）
- 任务管理 — 点击圆圈完成，点击 × 删除
- 徽章显示 — 标签页显示待办数量
- 数据持久化 — 自动保存到 GM_getValue/GM_setValue
核心功能
- 多模型支持 — 2233娘、Pio酱、Tia酱、Neptune...多位角色任你挑选，几乎每位小娘子都有独特的服装和动作
- 智能对话系统 — 早上问好、中午催饭、晚上催睡，关心你
- 健康提醒系统 — 每30分钟提醒喝水，每小时提醒休息，还会督促你的坐姿和睡眠时间
- 待办事项管理 — 帮你记住那些总是忘记的事，到点了会跳出来提醒你
- 天气查询功能 — 点一下就知道今天要不要带伞，比打开天气 App 还快
- 每日一言 — 随机展示一句优美的句子，偶尔能治愈你疲惫的心灵
- 模型换装系统 — 看腻了？点一下换个小娘子，还可换装Play
- 精美配置面板 — 简约风格的设置界面
- 黑名单管理 — 不想让她出现在某些网站？加个黑名单就行
模型支持
脚本通过 live2d.fghrsh.net API 集成以下模型系列：
| 系列 |
模型 |
说明 |
| Bilibili Live |
2233娘（22号、33号） |
B站官方看板娘，多套服装 |
| Potion Maker |
Pio、Tia |
超多服装，包含节日限定 |
| 超次元海王星 |
Neptune、Blanc、Vert、Noir 等 |
多角色多形态（普通/泳装/经典） |
| 舰队 Collection |
村雨 |
含表情与动作 |
| ShizukuTalk |
静流（48号、睡衣版） |
含表情与姿势 |
默认模型：Potion Maker Pio（modelId=1, texturesId=53）
切换方式：点击工具栏"换人"图标顺序切换，点击"换装"图标随机更换服装
兼容性
| 浏览器 |
支持状态 |
测试版本 |
备注 |
| Chrome |
✓ 完美 |
80+ |
推荐使用 Tampermonkey |
| Firefox |
✓ 完美 |
75+ |
推荐使用 Violentmonkey |
| Edge |
✓ 完美 |
Chromium 88+ |
推荐使用 Tampermonkey |
| 360 浏览器 |
✓ 完美 |
极速模式 |
兼容模式不支持 |
| QQ 浏览器 |
✓ 完美 |
极速模式 |
兼容模式不支持 |
| Safari |
△ 有限 |
14+ |
部分 CSS 特性受限 |
依赖要求：
- jQuery 3.3.1+
- jQuery UI 1.12.1+
- 支持 ES6 语法（箭头函数、模板字符串、解构赋值）
- 支持 CSS3 动画与变换
常见问题
Q: 看板娘不显示？
A: 排查步骤：
- 确认脚本已启用（脚本管理器图标显示数字）
- 检查当前网站是否在黑名单中（默认屏蔽 localhost、127.0.0.1）
- 打开控制台（F12）查看是否有
[Live2D] 开头的日志
- 检查是否在 iframe 中（脚本会自动跳过 iframe 环境）
- 尝试刷新页面或清除浏览器缓存
- 确认网络可访问 cdn.jsdelivr.net（加载依赖库）
Q: 天气查询失败？
A: 可能原因与解决方案：
- 省份或城市名称错误 — 无需添加"省"或"市"后缀，如填写"广东"而非"广东省"
- 城市代码未收录 — 脚本内置个多个城市代码，部分小城市可能不支持
- 网络连接问题 — 检查是否可访问 t.weather.itboy.net
- API 限流 — 天气 API 可能有访问频率限制，稍后再试
- 测试方法 — 在设置面板点击"立即获取天气"进行测试
Q: 看板娘提醒过于频繁？
A: 调整方案：
- 在配置面板关闭不需要的健康提醒功能
- 增加提醒间隔时间（如将喝水提醒从 30 分钟改为 60 分钟）
- 减少自定义台词数量（台词越少，重复率越高）
- 调整工作时段（默认 9:00-23:00，可在代码中修改）
Q: 对话框位置能改吗？
A: 对话框固定在看板娘左上方，小三角箭头指向看板娘右下角（right: 30px）。如需调整，可修改 CSS 中的 .waifu-tips 样式。
灵感来源
本项目基于以下优秀开源项目开发：
fghrsh/live2d_demo — Live2D 看板娘
/
く__,.ヘヽ. / ,ー､ 〉
＼ ', !-─‐-i / /´
／｀ｰ' L/／｀ヽ､
/ ／, /| , , ',
ｲ / /-‐/ ｉ L_ ﾊ ヽ! i
ﾚ ﾍ 7ｲ｀ﾄ ﾚ'ｧ-ﾄ､!ハ| |
!,/7 '0' ´0iソ| |
|.从" _ ,,,, / |./ |
ﾚ'| i＞.､,,__ ,.イ / .i |
ﾚ'| | / k_７/ﾚ'ヽ, ﾊ. |
| |/i 〈|/ i ,.ﾍ | i |
.|/ / ｉ： ﾍ! ＼ |
kヽ>､ﾊ ,.ﾍ､ /､!
!'〈//｀Ｔ´', ＼ ｀'7'ｰr'
ﾚ'ヽL|i,,ンﾚ|ノ
ﾄ-,/ |_./
'ｰ' !,.
许可证
GPL-2.0 License © 2025 yyy.
提示：看板娘会陪伴你的浏览过程，点击互动会有特殊反应。如遇问题请先查看常见问题章节。
更新日志
v1.0.0 (2026-01-XX)
初始版本发布
- ✓ 集成 Live2D 模型展示系统（基于 fghrsh/live2d_demo）
- ✓ 添加自动问候系统（五时段自动问候）
- ✓ 添加健康提醒功能（喝水/休息/坐姿/睡眠）
- ✓ 集成天气查询
- ✓ 集成每日一言（v.api.aa1.cn）
- ✓ 实现待办事项管理（定时/间隔双模式）
- ✓ 设计简约风格配置面板（六大功能模块）
- ✓ 实现消息优先级系统
- ✓ 添加黑名单管理功能
- ✓ 支持模型与服装切换
- ✓ 支持自定义台词与昵称变量
