# Live2DWebCanvas 免费基础版

WordPress 看板娘基础插件。2.3.0 将旧版 Live2D 与依赖 Cubism Core 的新版模型拆分，避免在免费包中携带被付费开关锁住的实现，并分别管理许可和分发。

**当前是未发布的拆分草稿，不应直接覆盖生产站点。** 技术测试通过也不等于获得 WordPress.org 重新开放或第三方许可批准。

中文说明见本文及 [完整中文说明](readme.zh-CN.txt)。仅 [目录专用说明](readme.txt) 保留英文，以符合 [WordPress.org 的说明文件语言要求](https://make.wordpress.org/plugins/2025/07/28/requiring-the-readme-to-be-written-in-english/)。

## 两个版本

| 功能 | Free（本仓库） | Pro（独立增强插件） |
|---|---|---|
| 旧版 Live2D 模型及贴图切换 | 支持，无需 Pro；普通模型不要求官网账号 | 复用 Free |
| 气泡、布局、工具栏、截图、消息净化、资源缓存 | 共享实现 | 复用 Free |
| WordPress AI、聊天界面及外部服务接入 | 保留；外部服务仍按提供方条款使用 | 复用 Free |
| Cubism Core、新版模型、专用托管及渲染控制 | 不包含、不自动下载 | 由 Pro 提供 |

Pro 依赖 Free，不是替换 Free 的另一个完整插件。获取入口：**<https://www.live2dweb.com/Downloads/WordPressPro>**。已有用户使用原账号核对对应权益，不需要为同一权益重复付款。账号升级后，在插件登录页重新保存 Key 可刷新站点权益。

此后公共 Git 只包含 Free 和共享代码。历史没有改写，过去公开的内容不会因此消失。Pro 安装包私有分发也不意味着浏览器收到的脚本或模型无法被查看、复制；签名资源地址不是 DRM。

## 旧版本升级：先迁移，后替换

1. 备份数据库、完整旧插件和旧 `model` 目录，暂时关闭自动更新。**不要先停用、卸载或删除旧版本**，旧版的停用逻辑可能删除设置。
2. 有 Pro 权益的用户先安装 Pro。在旧完整版本仍启用时，Pro 只显示兼容性及迁移提示，不重复加载新版 API/渲染器。
3. 点击“备份设置并迁移旧模型”。迁移逐文件校验并复制到 WordPress uploads 下的 `live2d-models`，校验成功后才切换；原文件保留，设置及授权快照保存在私有数据库选项 `live2d_model_migration_backup`。
4. 确认迁移成功后，更新 Free，再检查 Pro 状态和前台。迁移失败时不要继续替换；错误会说明冲突或不支持的文件。不要把备份中的账号 Key 放入公开目录或提交 Git。
5. 不使用 Pro 的旧用户：升级前由站点管理员备份数据库并将已验证的旧模型完整复制到 `wp-content/uploads/live2d-models`（自定义 uploads 路径按站点实际配置）。完成备份、校验后再更新；不要依赖更新完成后的代码挽救已被删除的旧目录。

新安装的模型放在 uploads 持久目录。尚有旧目录且未完成迁移时仍使用旧目录，不静默切换。多站点共用旧模型目录不自动迁移，须由网络管理员先备份并逐站处理。自动复制需要目标文件系统支持硬链接以保证发布时不覆盖并发写入；不支持时保留原数据并明确报错。

Free 缺少兼容且已授权的 Pro 时，仅暂停已保存的新版模型，不自动换角色。Free 从 2.3.0 起，停用默认不删除设置、授权或模型；卸载默认保留数据库数据，但 WordPress 仍会删除插件目录，因此旧模型必须先迁走。

## 安全修复

- CVE-2026-92895：访客只能访问管理员已配置的模型；不信任客户端清单，不允许访客入队下载。
- 文件上传、下载及 ZIP 解包校验路径、扩展名、内容和符号链接；下载任务记录并复查管理员授权。
- 新版模型的远程清单、资源及重定向固定到已校验的公网 IPv4，保持 TLS 校验，不支持该链路的 HTTP 代理。
- 账号绑定要求管理员与 nonce；保留手动 Key 登录。无效凭据不覆盖旧值，令牌续期更新账号权益。
- 消息、搜索标题、引用和每次 AI 流式片段经过 DOMPurify；工具栏只允许 HTTP(S) 导航。
- 内置 WordPress AI 后端需要站长明确启用及已登录的 WordPress 用户。

更新不会删除攻击者已经植入的文件。受影响站点仍需检查数据库、模型目录及其他站点文件。

## 构建

`live2d_sdk` 是普通 Free 源码目录，不再是子模块；完整 SDK 子模块由私有 Pro 项目维护。jQuery 和 Moment 使用 WordPress 自带版本。

```powershell
npm ci
npm --prefix .\live2d_sdk ci
npm run build
```

回归测试、夹具、测试工具及安装包验证由私有项目维护，不随公开 Git 或插件安装包分发。

## 发布阻塞与许可

- 本项目自有代码保留 [MIT 许可](LICENSE)；上游 `journey-ad/live2d_src` 的 GPL v2.0 及其他第三方许可不被重新许可。
- 新版 Cubism Core 已移出 Free，Pro 保留其原始许可文件。但**“旧引擎免费”不等于“GPL 兼容”**：旧引擎、改编的 Framework 和模型预览资源仍需要明确的许可及可读源码依据；当前不宣称它们已通过 WordPress.org 审核。
- `download.live2dweb.com` 的证书主机名问题须由服务端修复。在此之前不会关闭 TLS 验证或回退 HTTP，受影响的经典模型下载会失败。
- 生产 COS 私有桶、包对象及签名过期验证、官网部署和 WordPress.org 复审须另行完成。没有推送 Git、提交 SVN、上传 Pro 包或发送复审邮件。

使用帮助：<https://jiangweifang.github.io/wp-live2d/>。旧教程中关于单包包含新版模型的说明须按上述拆分规则理解。本插件不是 Live2D Inc. 的官方产品。
