将 Dreamer-Paul 的 Typecho Pio 2.4 插件移植到 GopherInk。插件在公开页面显示 Live2D 看板角色,支持多个本地模型切换、外链模型、左右位置、画布尺寸、静态/固定/可拖动模式、移动端隐藏、时间问候和自定义交互提示。
- 将本目录放在 GopherInk 的
plugins/目录中。 - 在 GopherInk 根目录执行
make build。 - 在后台插件页面启用
pio。 - 打开插件设置的“模型”选项卡,按页面显示的目录放入模型并保存选择。
插件不内置任何 Live2D 模型。启用后会创建:
<data 目录>/extensions/plugin-pio/models/
model-a/
model.json
model.moc
textures/
motions/
model-b/
model.json
...
data 目录由 GopherInk 启动配置决定,不要求固定为项目根目录下的 data/。后台模型页会显示实际绝对路径。
模型目录由运行中的 GopherInk 直接读取,并通过 /plugin/pio/models/<模型名>/... 提供。新增、替换或删除模型文件后不需要重新编译;回到模型页重新扫描并保存选择即可。目录只识别包含有效 model.json 的直接子文件夹。
本插件使用 Pio 2.4 附带的 Cubism 2 WebGL 运行库。模型配置需要包含顶层 model 字段,并应使用与该运行库兼容的 .moc 模型。Cubism 3/4 的 model3.json 和 .moc3 不能由这套旧版运行库直接渲染。
“模型”页允许每行填写一个完整的 HTTP/HTTPS model.json URL,最多 20 个。外链模型及其纹理、动作文件所在服务器必须返回允许浏览器跨域读取的 CORS 响应头,否则配置文件可以访问但模型仍无法加载。
本地模型和外链模型可以同时启用,前台换装按钮会按后台保存顺序循环切换。与原插件使用固定字符长度截取目录、兼容标量/数组配置的方式不同,移植版直接读取目录项并统一使用换行分隔的多值配置,避免模型名称截断和单模型保存异常。
| Typecho 原插件能力 | GopherInk 公开接口 |
|---|---|
Widget_Archive->header/footer |
HookFrontendHead / HookFrontendFooter |
| 插件配置表单 | ConfigProvider 与 AdminPageProvider |
扫描 models/ |
Runtime.PluginDataDir + os.ReadDir |
| 公开模型资源 | RegisterRoute + Runtime.PluginDataDir |
| 插件 JS/CSS | StaticProvider + Runtime.PluginURL |
| 保存动态模型选择 | Runtime.CurrentUser + ValidateCSRF + SetOption |
| 当前语言 | Runtime.Language + 插件自己的翻译表 |
StaticProvider 只承载编译期固定的 l2d.js、pio.js、样式和关闭后恢复按钮图片。模型使用磁盘目录路由,因此不会进入 Go 二进制,也不会因为更换模型而要求重新编译。
当前核心无需增加专用的“静态目录注册”接口。Runtime.PluginDataDir 提供跟随 GopherInk 数据目录配置的插件私有目录,带尾斜杠的 RegisterRoute 可以承接目录下的动态子路径;插件组合这两个底层接口即可安全地实现运行时模型目录。
模型列表必须在每次打开管理页时重新扫描,因此不能只使用编译期固定的 ConfigSchema。本插件使用 AdminPageProvider 渲染模型页,并将保存请求提交到插件自己的 POST 路由。当前核心的 AdminPageActionProvider 不向插件传递原始请求,而且该调用路径没有替插件完成 CSRF 校验,无法安全地处理这类动态表单;保存路由因此显式调用 Runtime.CurrentUser 和 Runtime.ValidateCSRF。这是核心管理页动作接口仍可完善的地方,但不影响本插件在不修改核心代码时完整实现功能。
- 修复原插件用固定字符长度截取模型目录导致名称错误的问题。
- 修复单模型与多模型配置形态不一致的问题。
- 修复站点根地址遗漏非标准端口的问题。
- 修复 Android/iOS UA 判断被 JavaScript
-1真值干扰的问题。 - 修复自定义提示分支引用未定义变量的问题。
- 删除夜间按钮的
eval,改为点击用户指定的主题模式按钮 CSS 选择器。 - 对模型公开路由禁止目录浏览、符号链接、路径穿越和非模型资源扩展名。
- 对模型页保存操作独立校验管理员身份和 CSRF token。
- 原项目:https://github.com/Dreamer-Paul/Pio
- 原作者:Dreamer-Paul
- 许可证:GNU GPL v2,详见 LICENSE
本移植版包含原项目的前端运行代码并进行了修改,因此继续按照 GPL v2 分发。原仓库附带的示例模型没有编译或复制到本插件中,用户应自行确认所使用模型、纹理、动作和声音资源的授权。