pulsareonbot 77d788d7a5 feat(Live2D): 设备端 Firefox kiosk 全屏渲染 Live2D 角色
Cubism Core 闭源且无 aarch64 Linux native 库,无法纯 Rust 原生渲染。
设备有 X11+kwin+Firefox 140+OpenGL,用 Firefox kiosk 模式全屏渲染
Live2D 模型(复用 Web 端 Cubism SDK),是 aarch64 上唯一可行路径。

1. src/plugins/http/live2d_display.html — 设备端专用全屏 Live2D 页面
   - 纯 Canvas 渲染,无 UI 控件
   - 轮询 /api/live2d/talking 驱动嘴部动效
   - 自动从 /api/config 读取 live2d_model 路径

2. src/plugins/http/mod.rs — HttpState 加 live2d_talking AtomicBool
   - set_live2d_talking/getter 方法

3. src/plugins/http/routes.rs
   - 新增 GET /live2d-display.html 路由
   - 新增 GET /api/live2d/talking 路由(设备端轮询)
   - chat_text_route 对话开始时 set_live2d_talking(true)
   - 回复后按字数估算时长延迟 set_live2d_talking(false)

4. src/plugins/video/mod.rs — Live2D 模式管理 Firefox kiosk 进程
   - ConfigReloaded render_type=live2d:停止视频,启动 firefox --kiosk
   - ConfigReloaded render_type=video:杀掉 Firefox,恢复视频播放
   - stop() 清理 Firefox 子进程
2026-07-07 13:24:57 +08:00

ShowenV2 — 数字生命窗口平台

基于 Rust 的跨平台插件微内核架构,支持全息/VR/AR/屏幕显示承载虚拟宠物、数字人、AI 歌姬、3D 模型等数字生命内容。

架构概览

ShowenV2/
├── src/
│   ├── core/              # 插件微内核
│   │   ├── message.rs     # 类型安全消息协议 (Serialize/Deserialize)
│   │   ├── plugin.rs      # Plugin trait 定义
│   │   ├── service_manager.rs  # 生命周期管理 + 消息路由 + 错误策略
│   │   ├── config.rs      # 配置解析/验证
│   │   ├── dispatch.rs    # 文本命令解析
│   │   ├── plugin_abi.rs  # C FFI 类型 (动态插件边界)
│   │   ├── dynamic_plugin.rs   # DynamicPlugin (libloading)
│   │   ├── plugin_loader.rs    # plugin_store/ 扫描/加载
│   │   ├── version_manager.rs  # 版本切换/回退/GC
│   │   └── plugin_repo.rs     # 远程仓库 HTTP 客户端
│   └── plugins/           # 功能插件
│       ├── video/         # 视频播放引擎 (OpenCV)
│       ├── http/          # Web UI + REST API (warp)
│       ├── ble/           # BLE 配网 (D-Bus BlueZ)
│       ├── wifi/          # WiFi 管理 (nmcli)
│       ├── device/        # 设备能力 (Display/SleepInhibit/Backlight/Cursor)
│       └── screen/        # 屏幕管理 (thin wrapper转发到 device)
├── plugin-sdk/            # 动态插件开发 SDK
├── plugins/
│   └── example-plugin/    # 示例动态插件 (cdylib)
├── configs/               # 配置文件 (状态机 JSON)
├── clients/               # 外部控制客户端应用
└── souls/                 # 团队成员档案

技术栈

  • 语言: Rust (edition 2021)
  • 视频: OpenCV 0.66
  • HTTP: warp + tokio
  • BLE: D-Bus + BlueZ (GATT)
  • WiFi: nmcli
  • 插件加载: libloading
  • 远程仓库: ureq + flate2 + tar

动态插件系统

ShowenV2 支持两种插件模式:

  1. 静态插件 — 编译时链接6 个内置插件 (video, http, ble, wifi, device, screen)
  2. 动态插件 — 运行时加载 .so 文件,通过 extern "C" FFI + JSON 序列化通信

动态插件特性:

  • 多版本管理 (plugin_store/ 目录结构)
  • 远程仓库下载安装 (HTTP + tar.gz)
  • 错误自动回退 (AutoRollback / DisableAndLog)
  • REST API 管理 (/api/plugins/*)

快速开始

# 验证配置
cargo run -- --validate --config configs/dog_state_machine.json

# 运行
cargo run -- --config configs/dog_state_machine.json

# 测试
cargo test --workspace

硬件与平台定位

  • 平台定位: ShowenV2 是通用数字生命窗口平台,不局限于“全息宠物播放器”
  • 分辨率支持: 支持 8K 以内所有分辨率显示
  • 显示类型: 支持 AR、VR、XR、普通屏幕、全息显示、投影、LED 矩阵,以及任何可运行的显示设备
  • 当前调试环境: Debian 11 KDE 桌面 (ARM64 / aarch64)
  • 跨平台策略: 当前以 Linux/ARM64 为主,架构已为扩展到其他平台预留空间
Description
No description provided
Readme 29 MiB
Languages
Rust 72.7%
Dart 24.1%
HTML 2.2%
Shell 0.8%
Java 0.2%