Live2D 看板娘

让🉑爱的二次元少女住进你的浏览器

🩶Potion 的Pio酱	🩵Potion 的Tia酱	💚Potion 的Tia酱	💙Bilibili Live的22娘

——支持 2233娘、来自Potion Maker的Pio酱、Tia酱等等多位可爱角色，小娘子们会在你浏览网页时陪伴左右，提醒你喝水休息、帮你管理待办、播报天气信息，还会时不时说些俏皮话。

访客人数：

快速开始

1. 环境准备

首先得有个脚本管理器：

• 油猴Tampermonkey
• 脚本猫ScriptCat

2. 脚本安装

• 脚本链接(ScriptCat) 点击安装

3. 使用指南

1. 装好脚本后随便打开个网页，右下角就会出现一个萌萌的看板娘啦（如下图所示↓）
2. 把鼠标移上去，右边会出现一排小图标（这就是她的工具栏）
3. 

▸ ⚙️ 首次配置

方式一： 点击页面看板娘右侧工具栏的 齿轮图标 ⚙
方式二： 右上角扩展 → 脚本管理器 → 找到脚本菜单 → 点击「⚙ 看板娘设置」

配置步骤：

1. 📝 在「基础」标签里给自己起个昵称（看板娘会用这个昵称称呼你哦~ 默认叫"宝宝"）
2. 🔆 在「天气」标签里填你的城市（默认是广州，别忘了改成你那儿）

反馈与支持

• 反馈建议：欢迎在 赞赏留言 或者 反馈处 或者 评论区 或者 wx 提交Bug报告 或 功能建议，作者会认真考虑
• 赞赏支持 — 点击看板娘工具栏赞赏图标（☕）

定制功能：

• 联系作者 ，留言——可联系作者 +v

▸ 工具栏功能

看板娘右边那排图标都是干啥的：

▸ 配置面板详解

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 集成以下模型系列：

默认模型：Potion Maker Pio（modelId=1, texturesId=53）
切换方式：点击工具栏"换人"图标顺序切换，点击"换装"图标随机更换服装

兼容性

依赖要求：

• jQuery 3.3.1+
• jQuery UI 1.12.1+
• 支持 ES6 语法（箭头函数、模板字符串、解构赋值）
• 支持 CSS3 动画与变换

常见问题

Q: 看板娘不显示？

A: 排查步骤：

1. 确认脚本已启用（脚本管理器图标显示数字）
2. 检查当前网站是否在黑名单中（默认屏蔽 localhost、127.0.0.1）
3. 打开控制台（F12）查看是否有 [Live2D] 开头的日志
4. 检查是否在 iframe 中（脚本会自动跳过 iframe 环境）
5. 尝试刷新页面或清除浏览器缓存
6. 确认网络可访问 cdn.jsdelivr.net（加载依赖库）

Q: 天气查询失败？

A: 可能原因与解决方案：

1. 省份或城市名称错误 — 无需添加"省"或"市"后缀，如填写"广东"而非"广东省"
2. 城市代码未收录 — 脚本内置个多个城市代码，部分小城市可能不支持
3. 网络连接问题 — 检查是否可访问 t.weather.itboy.net
4. API 限流 — 天气 API 可能有访问频率限制，稍后再试
5. 测试方法 — 在设置面板点击"立即获取天气"进行测试

Q: 看板娘提醒过于频繁？

A: 调整方案：

1. 在配置面板关闭不需要的健康提醒功能
2. 增加提醒间隔时间（如将喝水提醒从 30 分钟改为 60 分钟）
3. 减少自定义台词数量（台词越少，重复率越高）
4. 调整工作时段（默认 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）
• ✓ 实现待办事项管理（定时/间隔双模式）
• ✓ 设计简约风格配置面板（六大功能模块）
• ✓ 实现消息优先级系统
• ✓ 添加黑名单管理功能
• ✓ 支持模型与服装切换
• ✓ 支持自定义台词与昵称变量