Skip to content

About

为 GopherInk 移植的 Pio Live2D看板娘插件

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

GopherInk Pio

将 Dreamer-Paul 的 Typecho Pio 2.4 插件移植到 GopherInk。插件在公开页面显示 Live2D 看板角色,支持多个本地模型切换、外链模型、左右位置、画布尺寸、静态/固定/可拖动模式、移动端隐藏、时间问候和自定义交互提示。

编译与启用

  1. 将本目录放在 GopherInk 的 plugins/ 目录中。
  2. 在 GopherInk 根目录执行 make build。
  3. 在后台插件页面启用 pio。
  4. 打开插件设置的“模型”选项卡,按页面显示的目录放入模型并保存选择。

插件不内置任何 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 能力映射

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。

许可证与来源

本移植版包含原项目的前端运行代码并进行了修改,因此继续按照 GPL v2 分发。原仓库附带的示例模型没有编译或复制到本插件中,用户应自行确认所使用模型、纹理、动作和声音资源的授权。

About

为 GopherInk 移植的 Pio Live2D看板娘插件

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages