跳到主要内容

Chrome / Edge 扩展

除了 WordPress 插件，本项目还提供一个 Chrome / Edge 浏览器扩展 Live2D Web Canvas，让你在 任何网页 右下角都能挂一个看板娘。它和 WordPress 插件是 两个独立产品，账号通用，但配置完全分开。

1. 安装地址​

浏览器安装链接
Google ChromeChrome Web Store · 搜索 "Live2D Web Canvas"
Microsoft EdgeEdge Add-ons · 搜索 "Live2D Web Canvas"

安装后地址栏右侧会出现扩展图标，点开可以打开 popup（快捷开关）或进入「选项」页（完整设置）。

找不到？ Chrome / Edge 商店审核可能因地区被屏蔽。可在本项目 GitHub release 页面下载 .crx / .zip 用开发者模式手动加载（仅限了解风险的用户）。

2. 卸载​

浏览器卸载步骤
Chrome地址栏输入 chrome://extensions → 找到 Live2D Web Canvas → 点「移除」 → 确认
Edge地址栏输入 edge://extensions → 找到 Live2D Web Canvas → 点「移除」 → 确认

或者直接在地址栏右侧的扩展图标上右键 → 从 Chrome / Edge 中删除。

卸载后浏览器会一并清除该扩展在 chrome.storage 与 IndexedDB 中保存的所有数据（偏好设置、登录令牌、已下载的 V1 模型）。

3. 它能做什么 / 不能做什么​

能做：

  • 在你访问的任何网站右下角挂一个 Live2D 看板娘（不读取所在网页的任何内容，仅根据鼠标位置做朝向动画 —— 详见 隐私声明）。
  • 开箱自带几款经典 V1 模型（22 / 33、Pio / Tia、Shizuku、舰これ Murakumo、超次元海王星等），下载到 IndexedDB 离线使用。
  • 登录付费账号后，可以填自己的 modelAPI 加载 V2（Cubism 4+）模型。
  • 可调头部锚点、缩放倍数、看板娘位置、画布尺寸、提示气泡频率、工具栏按钮等。

不能做：

  • 不读取访问的网页内容、URL、Cookie、表单或浏览历史。
  • 不收集鼠标点击、滚动、击键操作。
  • 不收集地理位置 / IP 地址 / 设备指纹。

完整数据使用清单见 浏览器扩展隐私政策。

4. 登录（仅在使用 V2 时需要）​

选项页 → 登录 标签 → 「使用网页登录」。它会跳转到 https://www.live2dweb.com/SingleLogin 完成登录，登录成功后页面会自动关闭并把访问令牌写入 chrome.storage.local。

  • 登录态 仅本地，不会跨设备同步。
  • 仅在你主动登录时才会发生网络请求，扩展不收集你访问的网页 URL / 标题。
  • 退出登录会清除本地令牌。

如果你只想用免费的 V1 模型，无需登录。

5. 模型设置​

选项页 → 基础设置 → 模型 → 模型来源，是一个二选一下拉：

模型来源含义付费？
本地模型（V1）从扩展自带的 V1 模型库中选一个已下载的模型 + 一套贴图。先去「V1 模型库」标签把想用的模型下载下来。免费
自定义 URL（付费）填一个你自己的 modelAPI，加载 V2（Cubism 4+）模型。两种填法与 WordPress 插件一致：直链 .json 或目录根 / + modelDir 列表。需要登录 + 付费

5.1 V1 模型库​

选项页 → V1 模型库 标签：列出所有可用的 V1 模型（带 64×64 缩略图、状态徽章），点「下载」会把模型文件存到浏览器的 IndexedDB（不会上传到任何服务器）。

  • 多贴图型（如 22 / 33 / Pio / Tia）：单个 model.moc + 多套贴图，下方 Texture ID 下拉就是从 *.textures.json 解析出来的贴图组。
  • 多皮肤型（如超次元海王星 / 舰これ / Shizuku Talk）：每个"皮肤"是一个独立的子模型（各自的 model.moc），Texture ID 下拉里列出的是子目录名。

5.2 自定义 URL（V2）​

登录付费账号后，模型来源选「自定义 URL（付费）」，下方会出现 modelAPI 和 modelDir 两个输入。填法见 modelAPI / modelDir 怎么填。

浏览器扩展端 没有「托管到本站 / 防盗链」开关。扩展是直接从 modelAPI 拉模型加载，所以请保证 modelAPI 本身就支持 CORS（必须允许 chrome-extension://... 或 * 作为 Origin）。

6. 其他设置 tab​

  • 基础设置：启用开关、模型、头部锚点 (headPos)、模型缩放、看板娘位置 (X/Y)、画布尺寸。
  • 工具栏设置：右下角小工具按钮（截图、切换、设置等）的开关。
  • 提示消息选项：默认提示文案、触发频率。
  • 高级设置：开发调试用，一般不用动。
  • V1 模型库：见上一节。

7. 与 WordPress 插件的关系​

项目WordPress 插件浏览器扩展
挂在哪里你自己的 WP 站点用户浏览器，所有网页
谁来配置站长（一次配置全站生效）每个用户在自己浏览器配
V1 模型来源插件内置 + 远程创意工坊扩展内置（IndexedDB 缓存）
V2 自定义 URL付费 + 「托管到本站」可选付费，无本地缓存（直连）
账号同一个 live2dweb.com 账号同上，但授权令牌互不共享，需要分别登录