Repository navigation
Releases
whale-pet-live2d 0.2.3 — 改包名(应用市场审核意见)
按应用市场审核意见修改后重新构建。
审核意见:提交包中的业务类使用了 run.halo.whalepetlive2d 包名,容易造成 Halo 平台代码
与第三方插件代码的归属混淆。要求改用开发者或产品自己的 Java 包名,同步更新组件注册。
本次改动:
- Java 包名
run.halo.whalepetlive2d→io.github.zqy857.whalepetlive2d(基于开发者
GitHub 账号的反向域名),Gradlegroup同步修改; - 组件注册文件
META-INF/plugin-components.idx由 Halo Gradle 插件按编译产物重新生成,
现在记录的是io.github.zqy857.whalepetlive2d.WhalePetLive2dPlugin与
...WhalePetLive2dHeadProcessor;构建产物里已没有任何run/halo路径。
功能、配置、前台行为均无变化,对外可见的只有 jar 内部的包路径。
验证:真 Halo 2.26.0 上 24 项冒烟全过(安装 / 启用 / 注入 / 前台渲染 / 软导航自愈 /
控制台图标 / 设置读取 / 禁用),产物自洽检查 41 项全过。
装这个版本(0.2.3)。
whale-pet-live2d 0.2.2 — 修:控制台看不到插件图标
修一个只在控制台里看得见的问题:插件图标没显示,显示成了插件名首字「鲸」。
根因:plugin.yaml 的 spec.logo 之前写成 /plugins/whale-pet-live2d/assets/logo/logo.png。
Halo 文档规定这个字段是 URL 或相对 src/main/resources 的文件路径 —— 上面那种裸路径
两者都不是,Halo 当相对路径去找,找不到就回退成显示名字首字。
改法:图标放到 src/main/resources/logo.png,plugin.yaml 写 logo: logo.png。
控制台实际请求的是 /plugins/whale-pet-live2d/assets/logo.png?version=0.2.2(Halo 自己会带版本号)。
顺带补了一条测试(tools/halo-smoke.mjs):真的用浏览器打开控制台插件页,断言我们那张图标的
src 命中插件资源路由、且图片解码成功(naturalWidth > 0)。之前只验"图标 URL 返回 200",
所以这个问题漏过去了 —— 现在漏不掉了。
其余与 0.2.1 相同(要求 Halo ≥ 2.21,已在 2.21.0 / 2.26.0 实测;Cubism Core 不随包分发;
模型 CC BY-NC-SA 4.0 非商业;角色是社区同人二创,与 DeepSeek 官方无关)。
装这个版本(0.2.2)。
whale-pet-live2d 0.2.1 — 新图标(头部特写)
插件图标换成透明背景的头部特写(512×512)。
旧的图标是宠物预览图:600×600、白底整张不透明、人是全身小图 —— 缩到 Halo 控制台里
48 px 就成了"白方块上一个小人"。新图标由桌面端应用图标裁成正方形并留一点边距,
小尺寸下也认得出来。
其余与 0.2.0 相同:要求 Halo ≥ 2.21(已在 2.21.0 / 2.26.0 实测 23 项全过);
插件 id whale-pet-live2d;上游 A8Chann/dsh-pet-live2d(MIT);
模型 CC BY-NC-SA 4.0(非商业,署名 上善无形 / ZipZipPipe / 氵六青);
Cubism Core 不随包分发;角色是社区同人二创,与 DeepSeek 官方无关。
装这个版本(0.2.1):静态资源路径带版本号,旧版浏览器里的 o.2.0 缓存不会影响它。
whale-pet-live2d 0.2.0 — Halo 2.x 桌宠插件(首次发布)
把 DSH 桌宠移植到 Halo 2.x:装一个 Java 插件就有一只可拖动、跟随鼠标、右键面板换装的
Live2D 桌宠;评论框聚焦 / 提交评论 / 站内搜索这些页面事件会让她换动作与表情。
- 要求 Halo ≥ 2.21(2.21 起 Halo 要求 Java 21)。已在 2.21.0 与 2.26.0 上实测全绿。
- 插件 id
whale-pet-live2d,显示名「鲸鱼娘桌宠(Live2D)」。 - 上游:A8Chann/dsh-pet-live2d(MIT,DSH 桌宠);
本仓库是它的 fork,Halo 插件部分由 zqy857 新增维护。 - Live2D Cubism Core 不随包分发(默认走 Live2D 官方 CDN,插件设置里可改成自建地址);
模型与贴图是 CC BY-NC-SA 4.0(署名 · 非商业 · 相同方式共享,版权:上善无形 / ZipZipPipe / 氵六青)。 - 角色形象是社区基于 DeepSeek 元素的同人二创,与 DeepSeek 官方无任何关系。
安装
控制台 → 插件 → 安装 → 上传 whale-pet-live2d-0.2.0.jar → 启用。前台刷新即可看到她。
这个版本修掉的三个真问题
- 主题 banner 加载不出来:注入的
<script/>是自闭合的,HTML 里 script 不能自闭合 ⇒
解析器把后面的一切(</head>、<body class="… enable-banner …">、主题配置元素)当成
脚本文本吞掉。现在按完整闭合标签输出。 - 升级后浏览器还在跑旧 JS:Halo 给插件静态资源的响应头是
max-age=31536000(一年)⇒
公开路径改成带版本号(/plugins/whale-pet-live2d/assets/v0.2.0/…),升级即换 URL。 - 切页面后桌宠不见了/位置失效:主题的软导航(Swup 之类)会重写
<head>,删掉注入的
样式表与脚本标签,canvas 也可能被换掉。现在位置/层级/交互底线走行内、样式表用副本补回、
画布与挂载点都有 watchdog 自愈。
验证方式(都能自己复现)
node tools/build-halo-plugin.mjs --check # 产物与源同步
cd tools/browser-test && node run-suite.mjs halo halo-tree # 静态托管契约 + 产物自洽(不需要 Halo)
node tools/halo-smoke.mjs --base <你的 Halo> --jar <jar> --user <管理员> --pass <密码> # 真 Halo 冒烟 23 项